efaturan
WiseCP logosuSatış kanalı entegrasyonu

WiseCP e-Fatura Entegrasyonu

efaturan, WiseCP 5 kurulumunuzdaki ödenmiş faturaları yönetici API anahtarıyla okur. Alıcı bilgisi müşterinin varsayılan fatura adresinden alınır; ödeme komisyonu ve taksit farkı faturaya ayrı satır olarak eklenir.

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
WiseCP siparişinin panelde faturalanmasını gösteren örnek görünüm: sipariş INV-10382, tutar ₺2.398,80, e-Arşiv Fatura.

WiseCP ile otomatik faturalama

WiseCP fatura kesme sürecinde neler kendiliğinden işler?

  1. 01

    Yalnızca ödenmiş faturalar

    WiseCP panelinde ödendi durumundaki faturalar ödeme tarihine göre seçilir ve kalemleriyle okunur. Ödenmemiş, iptal ya da iade edilmiş kayıtlar faturalanmaz.

  2. 02

    Alıcı fatura adresinden

    Müşterinin varsayılan fatura adresindeki şirket adı, vergi numarası, vergi dairesi ve TC kimlik numarası kullanılır. Kurumsal adreste 10 haneli VKN varsa fatura şirket adına düzenlenir.

  3. 03

    Komisyon ve taksit farkı satırları

    Ödeme yönteminin komisyonu ve taksit farkı, kendi vergileriyle birlikte ayrı satır olur. Fatura düzeyindeki indirim satırlara tutarlarıyla orantılı dağıtılır.

  4. 04

    Genel toplam kontrolü

    Satırlardan hesaplanan toplam, WiseCP faturasındaki genel toplamla karşılaştırılır. Fark varsa fatura otomatik kesilmez ve iki tutar sipariş satırında gösterilir.

Kurulum

WiseCP 5 API anahtarı nasıl oluşturulur?

  1. 1

    API ekranını açın

    WiseCP yönetici panelinde Ayarlar › Genel › API sekmesine gidin (…/settings?general=api). Lisans planınız API'yi kapsamıyorsa bu ekran pasif görünür.

  2. 2

    Anahtarı izinlerle oluşturun

    Create API Credential ile anahtar oluşturup Invoices/GetInvoices, Invoices/GetInvoice, Clients/GetClientAddresses, Reference/GetCurrencies ve Reference/GetCountries izinlerini verin. wak_ ile başlayan anahtar yalnızca bir kez gösterilir.

  3. 3

    IP iznini ayarlayın

    Anahtarın izinli IP listesine efaturan sunucu IP'sini ekleyin ya da listeyi boş bırakın. Aksi hâlde istekler IP nedeniyle reddedilir.

  4. 4

    Mağazayı ekleyin

    Mağaza Ayarları'nda WiseCP kartını açın, WiseCP adresini ve yönetici API anahtarını girin. "Bağlantıyı test et" anahtarın gerekli izinleri taşıyıp taşımadığını da denetler.

WiseCP bağlantısı için panelde istenen bilgiler: WiseCP adresi, Yönetici API anahtarı, Fiyatlar KDV dahil mi?, Varsayılan KDV oranı, Hesap bakiyesiyle ödenen faturalar, Ücretsiz (0 tutarlı) siparişler.
Akıllı telefondan alışveriş yapan kişi

Ayrıntılar

WiseCP e-Arşiv Fatura kuralları

WiseCP faturasındaki bazı alanlar otomatik faturalamayı durdurur. Atlanan her kaydın nedeni sipariş listesinde yazar.

  • Entegrasyon WiseCP 5 ile gelen REST API'yi kullanır; WiseCP 3.x desteklenmez. wck_ ile başlayan müşteri anahtarları kabul edilmez, wak_ ile başlayan yönetici anahtarı gerekir.
  • Resmîleştirilmiş (formalized) faturalar başka yolla faturalanmış sayılır ve atlanır. Vergiden muaf (taxfree) faturalar istisna ya da ihracat faturası olarak elle düzenlenmek üzere bekletilir.
  • Hesap bakiyesiyle (Balance) ödenen faturalar varsayılan olarak atlanır; bakiye yüklemesinin ayrıca faturalandığı kabul edilir. Ücretsiz faturalar varsayılan olarak hiç listelenmez.
  • Ek vergi (additional tax), eksi tutarlı kalem ya da basılı fatura gönderim ücreti içeren faturalar elle kontrol için bekletilir.
  • Otomatik ayarda KDV dahil/hariç bilgisi faturanın vergi tipinden (taxation_type) okunur. Vergi uygulanmamış faturada tahsil edilen tutar KDV dahil kabul edilir ve varsayılan KDV oranı kullanılır.
  • Yönetici anahtarı dakikada 120 istekle sınırlıdır. Sınıra yaklaşıldığında efaturan sınırın sıfırlanmasını bekler ve kaldığı yerden devam eder.

Tek panel

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

Entegrasyonlar

Diğer satış kanalları

Tüm entegrasyonlar

Sık sorulan sorular

WiseCP entegrasyonu hakkında sık sorulan sorular

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

WiseCP 3 sürümüyle çalışır mı?

Hayır. Entegrasyon WiseCP 5 ile gelen REST API'yi kullanır. Eski 3.x API'sinin dokümanı artık yayında olmadığından bu sürüm desteklenmez.

Hangi API izinleri gerekiyor?

Faturalar için Invoices/GetInvoices ve Invoices/GetInvoice, alıcı adresi için Clients/GetClientAddresses, para birimi ve ülke listeleri için Reference/GetCurrencies ile Reference/GetCountries. Bağlantı testi eksik fatura ve müşteri izinlerini adıyla bildirir.

Alıcının vergi numarası nereden alınıyor?

Müşterinin varsayılan fatura adresinden. Kurumsal adreste şirket adı ve 10 haneli vergi numarası varsa fatura şirkete, yoksa adresteki TC kimlik numarasıyla kişiye kesilir; ikisi de yoksa nihai tüketici adına düzenlenir.

Kredi kartı komisyonu faturada görünür mü?

Evet. WiseCP faturasında ödeme komisyonu ya da taksit farkı varsa kendi vergi tutarıyla birlikte faturaya ayrı bir satır olarak eklenir.

Bakiyeyle ödenen faturalar neden atlanıyor?

Hesap bakiyesiyle ödenen faturalar ayarında varsayılan seçim "Faturalama (bakiye yüklemesini ayrıca faturalıyorum)" olduğundan bu faturalar atlanır. "Faturala" seçilirse aynı tutar iki kez faturalanabilir.

Kesilen fatura WiseCP paneline yükleniyor mu?

Hayır, entegrasyon WiseCP kayıtlarını yalnızca okur. Faturayı alıcıya NES e-posta servisiyle göndermeyi mağaza ayarından açabilir, panelden PDF ve UBL olarak indirebilirsiniz.

İlk bağlantıda ne kadar eski faturalar gelir?

Mağaza ayarında seçtiğiniz ilk eşitleme süresi kadar, yani 1 ile 30 gün arasında ödenmiş faturalar çekilir. Sonraki eşitlemeler varsayılan olarak 15 dakikada bir çalışır.

WiseCP 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