N11 nedir?
N11, Türkiye’nin köklü pazaryerlerinden biridir. Satıcı olarak N11 mağazanız üzerinden satış yaparsınız; ürün listeleme, sipariş alma ve tahsilat akışı N11’in kontrolündedir. Kendi e-ticaret sitenizin aksine müşteriyle doğrudan ilişki kurmaz; alıcıyla aranızda N11 durur. Bu durum faturalama tarafında önemli farklar yaratır: sipariş verisine ancak N11 İş Ortağı API üzerinden ulaşırsınız ve N11, alıcı bilgilerinin bir kısmını sizinle hiç paylaşmaz. Bu yüzden N11’da faturalama, kendi sitenizdeki bir eklenti kurulumundan tamamen farklı işler — sunucunuza bir eklenti koymazsınız, siparişi pazaryerinin API’sinden çekersiniz.
Paraşüt nedir?
Paraşüt, Türkiye’deki KOBİ’lerin tercih ettiği bulut tabanlı ön muhasebe ve e-fatura yazılımıdır. e-fatura ve e-arşiv mükellefiyetiniz için GİB ile bağlantıyı sağlar; cari hesap, gelir-gider takibi, banka entegrasyonları ve raporlama tek panelde toplanır. Paraşüt GİB özel entegratörü olarak fatura kesim yetkisine sahiptir, yani N11 siparişinizin faturası Paraşüt üzerinden doğrudan GİB’e iletilir. Bulut tabanlı olduğu için sunucuda kurulu bir program değildir; N11’dan çekilen sipariş verisi API üzerinden Paraşüt’e yazılır.
Neden N11 ve Paraşüt entegre edilmeli?
N11’da her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Sipariş hacmi arttıkça N11 panelinden veya CSV indirip tek tek faturalamak sürdürülebilir olmaktan çıkar. Doğru kurulmuş bir entegrasyon şunları sağlar:
- Otomatik fatura kesimi: N11’a düşen sipariş İş Ortağı API üzerinden çekilir, Paraşüt’te otomatik e-arşiv veya e-fatura olarak kesilir — panele girip CSV indirme derdi biter.
- Doğru fatura türü: Bireysel alıcıya e-arşiv, kurumsal fatura talep eden alıcıya e-fatura — sistem ayrımı kendisi yapar.
- Komisyon görünürlüğü: N11’in kestiği satış komisyonu ve hizmet bedelleri Paraşüt’te gider olarak işlenir, hesabınıza yatan net tutar netleşir.
- Temiz cari kayıt: Aynı alıcı için mükerrer cari açılmaz, raporlama tutarlı kalır.
- GİB uyumu: Fatura kesimi Paraşüt üzerinden GİB’e otomatik gönderilir, manuel beyan derdi kalmaz.
Manuel akışta neredeyse tam zamanlı bir işe dönüşen N11 fatura takibi, otomatik akışta kendiliğinden yürür.
N11 Paraşüt entegrasyonu nasıl yapılır?
Önce dürüst olalım: N11 ile Paraşüt arasında tek tıkla kurulan resmi bir entegrasyon yok. Paraşüt’ün kendi pazaryeri bağlayıcıları N11 özelinde çoğu zaman yetersiz kalıyor; araya bir katman gerekiyor. Zeisoft olarak bu katmanı iki yoldan biriyle kuruyoruz — sipariş hacminize ve mevcut altyapınıza göre doğru olanı seçiyoruz:
- 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 üzerine custom köprü kuruyoruz.
- API erişimini açıyoruz: N11 İş Ortağı panelinden API anahtarı (appKey/appSecret) alınır; sipariş sorgulama 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ı Paraşüt tarafında kurgulanır.
- Test ediyoruz: Gerçek birkaç N11 siparişi üzerinde — bireysel, kurumsal fatura talebi, iade — fatura kesimini doğruluyoruz.
- Bakım veriyoruz: N11 İş Ortağı API kural değişikliklerini ve Paraşüt güncellemelerini takip etmek bakım anlaşmasıyla bizde kalır.
Lisanslar (N11 satıcılık, Paraşüt, varsa orchestration platformu) sizin tarafınızda; biz kurulum, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
N11-Paraşüt 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 talep edip VKN girdiyse e-fatura kesmek.
- Gecikmeli fatura. N11 İş Ortağı API gerçek zamanlı bildirim yerine sorgulama (polling) ile çalıştığından, sorgu aralığı geniş tutulursa fatura geç kesiliyor. Çözüm: sipariş sorgulama aralığını yoğunluğa göre 5-15 dakikaya ayarlamak ve doğru statüde tetiklemek.
- Komisyonun muhasebeye yansımaması. Sadece brüt satış faturalanıp N11 kesintileri kaydedilmediğinde, hesaba yatan net tutar ile defter tutmuyor. Çözüm: komisyon ve hizmet bedellerini hak ediş/ödeme raporundan okuyup Paraşüt’te gider olarak işlemek.
- İade sonrası fatura aktif kalması. N11’da iade onaylandığında Paraşüt’te fatura iptal/iade edilmezse KDV beyanı yanlış görünür. Çözüm: iade/iptal statü değişimini API’den yakalayıp iade akışını tanımlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.