N11 nedir?
N11, Türkiye’nin köklü pazaryerlerinden biri. Satıcı olarak kendi e-ticaret siteniz yerine N11 Mağaza üzerinden satış yaparsınız; ürün listeleme, sipariş, tahsilat ve müşteri ilişkisi N11’in kontrolündedir. Alıcıyla aranızda N11 durur, bu yüzden sipariş verisine ancak N11 İş Ortağı API üzerinden ulaşırsınız ve alıcı bilgilerinin bir kısmını N11 sizinle hiç paylaşmaz. Trendyol veya Hepsiburada’dan farklı olarak N11’in kendine ait güçlü bir lojistik ağı yoktur — gönderimi kendi kargo firmanızla yaparsınız. Bu durum faturalama tarafını doğrudan etkilemez ama operasyonunuzu N11’in API kurallarına bağlar.
Logo nedir?
Logo, Türkiye’nin en köklü iş yazılımlarından biri. Logo Tiger orta-büyük ölçekli işletmelerde, Logo Go ise küçük-orta ölçekte muhasebe, stok, cari hesap, e-fatura ve e-arşiv işlemlerini tek çatı altında toplar. Önemli teknik özelliği on-premise (yerinde kurulum) mimarisidir: yazılım çoğunlukla kendi sunucunuzda veya yerel ağınızda çalışır. Bu, veri kontrolü açısından avantaj sağlarken N11 gibi bulut tabanlı pazaryeri API’leriyle doğrudan konuşamaması anlamına gelir — araya bir köprü katmanı gerekir.
Neden N11 ve Logo entegre edilmeli?
N11’da her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Satış hacminiz büyüdükçe siparişleri panelden tek tek Logo’ya girip faturalamak hem saatler alır hem hata üretir. Doğru kurulmuş bir N11-Logo akışı şunları sağlar:
- Otomatik fatura kesimi: Sipariş N11 İş Ortağı API’den çekilir, Logo’da e-arşiv veya e-fatura otomatik oluşur. Manuel CSV/panel indirme süreci biter.
- Doğru fatura türü: Bireysel alıcıya e-arşiv, VKN’li kurumsal talebe e-fatura — sistem ayrımı kendisi yapar.
- Komisyon mutabakatı: Brüt satış faturalanır, N11 komisyon ve kesintileri Logo’da ayrı gider kaydı olur; hak ediş raporuyla mutabakat tutar.
- Tutarlı cari hesap: Aynı alıcı için mükerrer cari açılmaz, Logo raporlaması temiz kalır.
- On-premise uyumu: Logo sunucunuzdaki kurulumu bozmadan, bulut pazaryeriyle güvenli köprü üzerinden bağlanır.
- GİB uyumu: Kesim Logo’nun e-fatura/e-arşiv modülü üzerinden GİB’e gider, mevzuat takibi size kalmaz.
Manuel akışta yoğun dönemlerde tek bir kişinin işine dönüşen N11 fatura takibi, otomatik akışta sipariş hacmi artsa bile kendiliğinden yürür.
N11 Logo entegrasyonu nasıl yapılır?
Önce dürüst olalım: N11 ile Logo arasında tek tıkla kurulan resmi bir bağlantı yok. Logo’nun on-premise yapısı ile N11’in bulut API’si arasına bir köprü katmanı gerekir. Zeisoft olarak bu akışı uçtan uca kuruyoruz:
- Mevcut süreci inceliyoruz: N11 sipariş hacminizi, kategori karmanızı ve mevcut Logo kurulumunuzu (Tiger mı Go mu, hangi sürüm, e-fatura modülü aktif mi) belirliyoruz.
- Yöntemi seçiyoruz: Logo Connect modülü mü yoksa N11 İş Ortağı API üzerinden custom REST köprü mü gerektiğini, hacminize ve iş kurallarınıza göre kararlaştırıyoruz.
- API erişimini açıyoruz: N11 İş Ortağı panelinden API anahtarı alınır; sipariş çekme aralığı ve fatura tetikleme statüsü yapılandırılır.
- Köprüyü kuruyoruz: Köprü katmanını N11 API ile Logo veritabanı arasında konumlandırıp güvenli bağlantıyı sağlıyor, sunucu erişimi/VPN gereksinimlerini netleştiriyoruz.
- Fatura kurallarını tanımlıyoruz: e-arşiv/e-fatura ayrımı, KDV haritalaması, komisyon gider kaydı ve cari eşleşme kuralları Logo tarafında kurgulanır.
- Test ediyoruz: Gerçek 5-10 N11 siparişi üzerinde — bireysel, kurumsal, iade — kesimi ve komisyon kaydını doğruluyoruz.
- Bakım veriyoruz: N11 API kural değişikliklerini ve Logo sürüm geçişlerini takip etmek bakım anlaşmasıyla bizde kalır.
Lisanslar (N11, Logo, varsa Logo Connect) sizin tarafınızda; biz kurulum, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
N11-Logo akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Logo sürüm güncellemesi köprüyü bozuyor. Logo’nun büyük sürüm geçişleri veritabanı yapısını değiştirebiliyor; custom köprü güncellenmezse fatura kesimi durur. Çözüm: bakım anlaşmasıyla her Logo güncellemesinden önce köprüyü test edip uyarlamak.
- Eksik alıcı bilgisi. N11 bireysel siparişlerde KVKK gereği TC kimlik bilgisini çoğunlukla vermez; e-fatura kesilmeye çalışılınca işlem başarısız olur. Çözüm: varsayılanı Logo’da e-arşiv olarak kurmak, sadece alıcı kurumsal fatura ve VKN girdiyse e-fatura mükellefi sorgulayıp e-fatura kesmek.
- Komisyon nedeniyle mutabakat tutmuyor. Fatura brüt tutardan kesilip N11 kesintileri Logo’ya işlenmediğinde, hesabınıza geçen net hak ediş Logo cirosuyla uyuşmaz. Çözüm: komisyon, hizmet bedeli ve kesintileri ayrı gider/cari kaydı olarak tanımlamak.
- İade sonrası fatura aktif kalması. N11’da iade onaylandığında Logo’daki fatura iptal/iade edilmezse KDV beyanı yanlış görünür. Çözüm: iade/iptal statü değişimini API’den yakalayıp Logo’da iade faturası kesim kuralını bağlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; canlıya çıktıktan sonra düzeltmek katbekat iş yükü yaratır.