N11 nedir?
N11, Türkiye’nin köklü pazaryerlerinden biri. Satıcı olarak N11 Mağaza üzerinden satış yapıyorsanız ürün listeleme, sipariş, stok, fiyat ve kargo süreçlerinizi N11 İş Ortağı API üzerinden otomatize edebilirsiniz. N11’ın Trendyol gibi kendi siparişe dayatılan güçlü bir lojistik ağı yoktur; bunun yerine sipariş ekranında alıcıya anlaşmalı kargo seçenekleri sunar ve satıcının kendi kargo firmasıyla gönderim yapmasına geniş alan bırakır. Entegrasyon tasarımı bu yapı üzerine kurulur.
Yurtiçi Kargo nedir?
Yurtiçi Kargo, Türkiye’nin en yaygın şube ağına ve özellikle Anadolu’da geniş kapsama alanına sahip kargo firmalarından biri. Gönderi oluşturma, takip numarası alma, etiket basma ve ücret sorgulama için açık bir API’si vardır. Pratikteki en kritik nokta şudur: API açık olsa da çoğu e-ticaret platformu ve pazaryeri için resmi, hazır bir eklentisi yoktur — WooCommerce dahil yaygın altyapılarda bile bağlantı custom geliştirme ile kurulur. Ayrıca peşin/fatura ödeme tipi ve şube/şahıs gönderi ayrımı, entegrasyonun doğru yapılandırılmasını gerektiren Yurtiçi’ye özgü detaylardır.
Neden N11 ve Yurtiçi Kargo entegre edilmeli?
Önce dürüst çerçeve: N11’da varsayılan kargo yolu, sipariş sırasında alıcıya sunulan N11 anlaşmalı kargo seçenekleridir ve çoğu standart gönderi için bu yeterlidir. Yurtiçi Kargo entegrasyonu yalnızca satıcı kargo modunu kullandığınızda devreye girer. O senaryoda doğru kurulmuş bir entegrasyon şunları sağlar:
- Satıcı kargo siparişlerinde otomatik Yurtiçi gönderisi: Sipariş satıcı kargoya düştüğü anda Yurtiçi’de gönderi kaydı açılır, kargo paneline el ile girmeniz gerekmez.
- Takip numarasının N11’a geri yazılması: Yurtiçi’den dönen takip numarası N11 İş Ortağı API üzerinden siparişe bildirilir; bu adım entegrasyonun en kritik halkasıdır.
- N11 kargo bildirim süresine uyum: N11 sipariş onayından sonra belirli sürede kargo bildirimi şart koşar; otomasyon bu süreyi kaçırmanızı ve satıcı performans puanı kaybını önler.
- Resmi eklenti olmadan istikrarlı akış: Yurtiçi’nin hazır bir N11 eklentisi olmadığı için köprü baştan sizin akışınıza göre tasarlanır; yarım çalışan eklenti aramakla vakit kaybetmezsiniz.
- Doğru ödeme tipi ve doğru kargo seçimi: Peşin/fatura ödeme tipi otomatik belirlenir, hangi siparişin Yurtiçi’ye (satıcı kargo), hangisinin N11’ın kendi seçeneğine gideceği kurala bağlanır.
Büyük ebatlı ürün satıyorsanız veya Yurtiçi ile avantajlı bir anlaşma fiyatınız varsa, bu akış satıcı kargo tarafını manuel panel yükü olmadan yürütmenizi sağlar.
N11 Yurtiçi Kargo entegrasyonu nasıl yapılır?
Yurtiçi’nin N11 için resmi bir eklentisi olmadığından iki yoldan biriyle ilerliyoruz: bir orchestration platformu (Sentos, Platin360 gibi) üzerinden ya da N11 İş Ortağı API ile Yurtiçi web servisini birbirine bağlayan custom köprü ile. Hangisi olursa olsun süreç şöyle işler:
- Mevcut sipariş hacminizi ve hangi ürünlerin satıcı kargoya gideceğini birlikte belirliyoruz.
- Sözleşmeli Yurtiçi müşterisi olarak şubenizden entegrasyon erişim bilgilerini (müşteri kodu, kullanıcı adı, şifre) temin ediyoruz — bu adım birkaç gün sürebilir, koordinasyonu biz yürütüyoruz.
- N11 İş Ortağı API tarafında satıcı kargo siparişlerini ayırt eden akışı kuruyoruz.
- Yurtiçi gönderi kaydı, etiket çıktısı (A4 veya termal yazıcı), peşin/fatura ödeme tipi seçimi ve takip numarasının N11’a geri yazılması köprüsünü tasarlıyoruz.
- Test aşamasında 5-10 satıcı kargo siparişi üzerinde uçtan uca deneme yapıyoruz; etiket çıktısını, ödeme tipini ve panel bildirimini doğruluyoruz.
- Canlı geçişten sonra ilk günlerde yoğun izleme yapıyor, bakım anlaşmasıyla Yurtiçi servis ve N11 API değişikliklerini takip ediyoruz.
Sıkça karşılaşılan sorunlar
N11 satıcı kargo + Yurtiçi kombinasyonunda sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Takip numarası N11’a hiç yazılmaması. Yurtiçi gönderisi açılıyor ama takip numarası N11 İş Ortağı API’ye bildirilmiyor; sipariş “kargolanmadı” görünüp satıcı performans puanına yansıyor. Çözüm: takip numarasını gönderi kaydının hemen ardından panele geri yazan iki yönlü akış kurmak.
- “Kargo İşlem Görmemiş” durumu. Şube kargoyu entegrasyon yerine manuel kestiğinde hareket kaydı sisteme yansımaz, sipariş hem N11’da hem sizde takılı kalır. Çözüm: gönderi açıldığı halde hareketi gelmeyen siparişleri otomatik tespit edip uyaran kontrol kurmak.
- Yanlış ödeme tipi nedeniyle reddedilen gönderi. Peşin ve fatura ödemeli gönderiler ayrı yapılandırma ister; yanlış seçilince Yurtiçi gönderiyi reddeder. Çözüm: sipariş özelliğine göre doğru ödeme tipini otomatik seçen kuralları köprüye gömmek.
- Desi/ağırlık eksikliğiyle yanlış etiket. Ürün katalogunda boyut bilgisi yoksa Yurtiçi etiketi hatalı desi ile basılır, kargo ücreti tutmaz (desi = en x boy x yükseklik / 3000). Çözüm: kurulumda ürün-desi eşlemesini tamamlamak ve çok ürünlü siparişlerde toplam desiyi otomatik hesaplatmak.
Dördü de kurulumda doğru tasarımla önlenebilir; canlıda fark edilince düzeltmek çok daha fazla iş yükü ve performans puanı riski yaratır.