N11 nedir?
N11, Türkiye’nin köklü pazaryerlerinden biridir. Satıcı olarak N11 Mağaza üzerinden satış yaparsınız; ürün listeleme, sipariş, tahsilat ve büyük ölçüde lojistik akışı pazaryerinin kurallarına tabidir. Bir e-ticaret sitenizden farklı olarak alıcıyla aranızda N11 durur, müşteriyle doğrudan ilişki kurmazsınız. Bu, faturalama tarafında belirleyici bir fark yaratır: sipariş verisine ancak N11 İş Ortağı API üzerinden ulaşırsınız ve alıcı bilgilerinin bir kısmını N11 sizinle hiç paylaşmaz.
Bir-Fatura nedir?
Bir-Fatura, uygun maliyeti ve sade kullanımıyla özellikle küçük ve orta ölçekli işletmelerin tercih ettiği bir GİB özel entegratörüdür. Bir muhasebe ya da ön muhasebe yazılımı değildir; cari hesap takibi, raporlama veya banka entegrasyonu beklemeyin. Görevi tek ve net: e-fatura ve e-arşiv faturalarını hızlı ve ekonomik biçimde kesip GİB’e iletmek. Yani Bir-Fatura, N11 siparişiniz için bir fatura kesim katmanıdır — siparişi muhasebeleştirmez, sadece faturasını üretir.
Neden N11 ve Bir-Fatura entegre edilmeli?
N11’da her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Bir-Fatura’yı tek başına kullandığınızda ise her siparişi N11 panelinden okuyup, müşteri bilgisini Bir-Fatura paneline elle girip fatura kesmeniz gerekir. Günde onlarca siparişte bu sürdürülebilir değil. Doğru kurulmuş bir entegrasyon şunları sağlar:
- Otomatik fatura kesimi: N11’a düşen sipariş İş Ortağı API üzerinden çekilir, Bir-Fatura’da otomatik e-arşiv veya e-fatura olarak kesilir.
- Doğru fatura türü: Bireysel alıcıya e-arşiv, VKN giren kurumsal alıcıya e-fatura — ayrımı sistem kendisi yapar.
- Panel mesaisinin bitmesi: CSV indirme, elle veri girişi ve kopyala-yapıştır hatası ortadan kalkar.
- Hacme dayanıklılık: Bir-Fatura’nın API limitleri kuyruk mantığıyla yönetilir, yoğun günde de fatura atlanmaz.
- GİB uyumu: Fatura kesimi Bir-Fatura üzerinden doğrudan GİB’e iletilir, manuel beyan derdi kalmaz.
Manuel akışta bir kişinin yarım gününü alan N11 fatura takibi, otomatik akışta kendiliğinden yürür.
N11 Bir-Fatura entegrasyonu nasıl yapılır?
Önce dürüst olalım: N11 ile Bir-Fatura arasında tek tıkla kurulan resmi bir entegrasyon yok. Bir-Fatura sipariş yönetmez, N11 da fatura kesmez; ikisinin arasına bir köprü gerekir. Zeisoft olarak bu köprüyü hacminize ve mevcut altyapınıza göre iki yoldan biriyle kuruyoruz:
- Mevcut süreci inceliyoruz: Aylık N11 sipariş hacmi, başka pazaryeri/site kullanıp kullanmadığınız ve fatura kurallarınız belirleniyor.
- Yöntemi seçiyoruz: Tek pazaryeri ve orta hacim için bir orchestration platformu (Sentos, Platin360 vb.) yeterli olabilir; özel iş kuralları veya çoklu kanal varsa N11 İş Ortağı API ile Bir-Fatura API’si arasına custom köprü kuruyoruz.
- API erişimini açıyoruz: N11 İş Ortağı panelinden API anahtarları alınır, Bir-Fatura tarafında API erişimi tanımlanır; sipariş çekme aralığı ve fatura tetikleme statüsü yapılandırılır.
- Fatura kurallarını tanımlıyoruz: e-arşiv/e-fatura ayrımı, KDV haritalaması ve eksik müşteri bilgisi senaryoları Bir-Fatura tarafında kurgulanır.
- Kuyruk ve hata yönetimini kuruyoruz: Bir-Fatura API limitlerine karşı kuyruk ve yeniden deneme mekanizması eklenir.
- Test ediyoruz: Gerçek 5-10 N11 siparişi üzerinde — bireysel, kurumsal, iade — fatura kesimini doğruluyoruz.
- Bakım veriyoruz: N11 API kural değişikliklerini ve Bir-Fatura güncellemelerini takip etmek bakım anlaşmasıyla bizde kalır.
Lisanslar (N11 hesabı, Bir-Fatura, varsa orchestration platformu) sizin tarafınızda; biz kurulum, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
N11-Bir-Fatura akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Eksik alıcı bilgisi. N11 bireysel siparişlerde KVKK gereği TC kimlik bilgisini çoğunlukla vermez. Çözüm: varsayılanı e-arşiv fatura olarak kurmak, sadece alıcı kurumsal fatura ve VKN girdiyse e-fatura kesmek.
- API limitine takılan fatura. Bir-Fatura’nın istek sınırları nedeniyle yoğun günde tüm siparişler aynı anda gönderilince fatura kesimi hata verir. Çözüm: araya kuyruk ve yeniden deneme mekanizması koyup fatura kesimini sıraya almak.
- Gecikmeli fatura. N11 İş Ortağı API webhook yerine sorgulama (polling) ile çalıştığından, sorgu aralığı geniş tutulursa fatura geç kesilir. Çözüm: sipariş çekme aralığını yoğunluğa göre 5-15 dakikaya ayarlamak ve doğru statüde tetiklemek.
- İade sonrası fatura aktif kalması. N11’da iade onaylandığında Bir-Fatura’da fatura iptal/iade edilmezse KDV beyanı yanlış görünür. Çözüm: iade/iptal statü değişimini API’den yakalayıp iade faturası akışını tanımlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.