efaturan
WHMCS logosuSatış kanalı entegrasyonu

WHMCS e-Fatura Entegrasyonu

efaturan, WHMCS yönetici API'siyle bağlanır ve ödenmiş faturaları kalemleriyle okur. Müşterinin vergi numarası sorgulanır; e-Fatura mükellefine e-Fatura, diğer müşterilere e-Arşiv Fatura kesilir. Yenileme faturaları da aynı akıştan geçer.

Erken erişim talep etNasıl bağlanır?
Belge türleri
e-Fatura ve e-Arşiv Fatura
Faturanın iletimi
PDF ve fatura linki
Siparişler
15 dakikada bir kontrol
Sunucu odasında tabletle çalışan teknik ekip
WHMCS siparişinin panelde faturalanmasını gösteren örnek görünüm: sipariş INV-48215, tutar ₺1.188,00, e-Fatura.

WHMCS ile otomatik faturalama

WHMCS e-Arşiv Fatura sürecinde efaturan ne yapar?

  1. 01

    Ödenmiş faturalar ya da siparişler

    Varsayılan olarak ödeme tarihi eşitleme aralığına giren WHMCS faturaları çekilir; yenileme faturaları da dahildir. İsterseniz yalnızca yeni siparişleri faturalayan sipariş modunu seçersiniz.

  2. 02

    KDV dahil/hariç algılama

    Otomatik ayarda faturadaki vergi tutarına bakılarak fiyatların KDV dahil mi hariç mi girildiği bulunur. Vergi uygulanmamış faturada varsayılan KDV oranınız kullanılır.

  3. 03

    Promosyon kalemi indirime dönüşür

    Faturadaki eksi tutarlı promosyon kalemi, bağlı olduğu hizmetin ya da önceki satırın indirimi olarak yazılır. Sıfır tutarlı kalemler faturaya girmez.

  4. 04

    Vergi numarası ve vergi dairesi eşleme

    Müşteri profilindeki Vergi Numarası alanı ya da seçtiğiniz özel müşteri alanı VKN/TCKN olarak okunur. Vergi dairesini ayrı bir özel alanda tutuyorsanız onu da eşleyebilirsiniz.

Kurulum

WHMCS API kimliği nasıl oluşturulur?

  1. 1

    API rolü tanımlayın

    WHMCS yönetici panelinde Manage API Credentials ekranını açın. API Roles sekmesinde GetInvoices, GetInvoice, GetClientsDetails, GetOrders ve GetOrderStatuses eylemlerine izin veren bir rol oluşturun.

  2. 2

    Kimlik üretin

    API Credentials sekmesinde bu rolle yeni bir kimlik oluşturun. Identifier ve Secret yalnızca bir kez gösterilir; yönetici kullanıcının rol grubunda API Access izni açık olmalıdır.

  3. 3

    IP iznini verin

    WHMCS API'si varsayılan olarak IP ile kısıtlıdır. General Settings → Security altındaki API izinli IP listesine efaturan sunucu IP'sini ekleyin ya da configuration.php dosyasında $api_access_key tanımlayın.

  4. 4

    Mağazayı ekleyin

    Mağaza Ayarları'nda WHMCS kartını açın; WHMCS adresi, API Identifier ve API Secret alanlarını doldurun. Erişim anahtarı tanımladıysanız onu da girip "Bağlantıyı test et" ile doğrulayın.

WHMCS bağlantısı için panelde istenen bilgiler: WHMCS adresi, API Identifier, API Secret, API Erişim Anahtarı (isteğe bağlı), Faturalanacak kayıtlar, Fiyatlar KDV dahil mi?, Varsayılan KDV oranı, VKN/TCKN alanı, Vergi dairesi özel alan ID'si, Hesap kredisiyle ödenen faturalar.
Tablette ve kâğıtta satış raporları

Ayrıntılar

Hosting faturalarında KDV ve hesap kredisi kuralları

WHMCS kayıtları fatura bazında okunduğu için bazı durumlar otomatik faturalanmaz. Her kaydın nedeni sipariş listesinde kendi satırında yazar.

  • Faturalanacak kayıtlar ayarını faturalamaya başladıktan sonra değiştirmeyin. Fatura ve sipariş modunda kayıt numaraları farklı olduğundan aynı satış iki kez faturalanabilir.
  • Hesap kredisiyle ödenen faturalar varsayılan olarak atlanır, çünkü kredi yüklemesinin (Add Funds) ayrıca faturalandığı kabul edilir. "Faturala" seçilirse aynı tutar iki kez faturalanabilir.
  • WHMCS müşteri kaydında vergiden muaf (taxexempt) işaretli müşterinin faturası ve ikinci seviye vergi (tax2) içeren faturalar elle kontrol için bekletilir.
  • Kurumsal fatura için müşteri kaydında şirket adı ve 10 haneli VKN birlikte bulunmalıdır. VKN yoksa fatura kişi adına, TCKN da yoksa nihai tüketici adına düzenlenir.
  • Sipariş modunda iptal edilmiş ya da sahte (Fraud) işaretli siparişler faturalanmaz. Ödemesi bekleyen sipariş, ödeme alındıktan sonraki eşitlemede gelir.
  • Kesilen fatura WHMCS kurulumunuza geri yüklenmez. Mağaza ayarında açarsanız alıcıya NES e-posta servisiyle gönderilir; panelden PDF ya da herkese açık link olarak da paylaşılabilir.

Tek panel

WHMCS faturalarınız diğer belgelerinizle aynı yerde

Entegrasyonlar

Diğer satış kanalları

Tüm entegrasyonlar

Sık sorulan sorular

Hosting firmaları için e-Fatura: sık sorulan sorular

Kurulumla ilgili ayrıntılar için bağlantı adımlarına bakabilirsiniz.

WHMCS bağlantısı için hangi bilgiler gerekiyor?

Kurulumun kök adresi, API Identifier ve API Secret. IP kısıtlaması yerine erişim anahtarı kullanıyorsanız API Erişim Anahtarı alanını da doldurursunuz. Belgelerin düzenlenmesi için panelde NES hesabınızın API anahtarı da tanımlı olmalıdır.

Yenileme faturaları da faturalanır mı?

Evet, varsayılan Ödenmiş faturalar modunda. Yenileme faturası vadesinden önce oluşturulmuş olsa da ödendikten sonraki ilk eşitlemede çekilir ve faturalanır.

Fiyatlarım KDV hariç; tutarlar doğru hesaplanır mı?

Fiyatlar KDV dahil mi? alanını Otomatik bırakırsanız her faturanın vergi tutarına bakılarak bu ayrım yapılır. WHMCS vergi ayarınızı biliyorsanız KDV dahil ya da KDV hariç seçeneğini doğrudan da işaretleyebilirsiniz.

Müşterinin vergi numarası nereden alınıyor?

Varsayılan olarak WHMCS müşteri profilindeki Vergi Numarası (tax_id) alanından. VKN/TCKN'yi özel bir müşteri alanında tutuyorsanız o alanın sayısal ID'sini VKN/TCKN alanı ayarına yazın.

Hesap kredisiyle ödenen faturalara ne oluyor?

Varsayılan ayarda atlanır ve sipariş listesinde nedeniyle görünür. Faturanın bir kısmı krediyle, kalanı başka bir yolla ödendiyse krediyle ödenmeyen kısmı elle faturalarsınız.

Kesilen fatura WHMCS tarafına gönderiliyor mu?

Hayır, bu entegrasyon WHMCS kayıtlarını yalnızca okur. Faturayı müşterinize NES e-posta servisiyle göndermeyi mağaza ayarından açabilir, panelden PDF ya da herkese açık linkini paylaşabilirsiniz.

Sipariş modunu ne zaman seçmeliyim?

Yalnızca yeni siparişleri faturalamak istiyorsanız. Bu modda ödenmiş siparişin bağlı faturası okunur ve sipariş durumlarına göre süzme yapılabilir; yenileme faturaları ise gelmez.

WHMCS siparişlerinizi faturalamaya başlayın

efaturan şu an davetle kullanılıyor. Erken erişim talebinizi bırakın; hesabınız açıldığında ilk faturaları NES test ortamında, belgeler GİB'e gitmeden birlikte kontrol edelim.
Erken erişim talep etGiriş yap