N11 nedir?
N11, Türkiye’nin köklü pazaryerlerinden. 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 diğer büyük pazaryerlerinden önemli bir farkı var: Trendyol Express veya HepsiJet gibi her siparişi yutan güçlü bir kendi lojistik ağı dayatmaz. Satıcı, gönderiyi hangi kargo firmasıyla yapacağını büyük ölçüde kendisi seçer — bu yüzden N11’da kargo entegrasyonu istisna değil, operasyonun olağan parçasıdır.
Aras Kargo nedir?
Aras Kargo, Türkiye’nin en yaygın kargo ağlarından biri. Aras’ın gönderi oluşturma, takip numarası alma, etiket basma ve ücret sorgulama işlemleri için hem SOAP web servisi hem de REST API’si var. Pratikte en kritik nokta şube bağımlılığı: API erişim bilgileri (müşteri kodu, kullanıcı adı, şifre) anlaşmalı Aras şubesinden temin edilir ve entegrasyon kodunuzun şube tarafından sisteme tanımlanması gerekir — tanımlanmazsa “entegrasyon numarası sistemde tanımlı değil” hatası alırsınız. Bu hata Aras entegrasyonlarında en sık takılınan yerdir ve teknik koddan çok şube koordinasyonuyla çözülür.
Neden N11 ve Aras Kargo entegre edilmeli?
Önce dürüst çerçeve: N11’da varsayılan model, satıcının kargo firmasını kendisinin seçmesidir. N11 zaman zaman anlaşmalı veya teşvikli kargo seçenekleri sunabilir; bunlardan birini kullanmıyor ve gönderilerinizi Aras ile yapmayı tercih ediyorsanız, bu entegrasyon doğrudan o akışı otomatikleştirir. Aras’ı seçmeniz için makul nedenler: Aras’la avantajlı bir anlaşma fiyatınızın olması, gönderi bölgelerinizde Aras kapsama tercihi veya mevcut Aras altyapınızı N11 satışlarına genişletme isteği. Doğru kurulmuş bir entegrasyon şunları sağlar:
- Otomatik Aras gönderisi: N11 siparişi düştüğü anda Aras’ta gönderi kaydı açılır, kargo paneline el ile girmeniz gerekmez.
- Takip numarasının N11’a geri yazılması: Aras’tan dönen takip numarası N11 İş Ortağı API üzerinden siparişe işlenir; 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 bekler; otomasyon bu süreyi kaçırmanızı ve performans puanı kaybını önler.
- Şube kaynaklı hataların önlenmesi: Aras’taki entegrasyon kodu tanımı baştan doğru yapılır, “tanımlı değil” hatasıyla siparişlerin takılması yaşanmaz.
- Çoklu kanal tutarlılığı: Aynı Aras altyapısını e-ticaret sitenizle veya başka pazaryerlerinizle paylaşıp tek köprüden yönetebilirsiniz.
Büyük ebatlı ürün satıyor ya da Aras ile özel anlaşma fiyatınız varsa, bu akış N11 satışlarınızı manuel panel yükü olmadan yürütmenizi sağlar.
N11 Aras Kargo entegrasyonu nasıl yapılır?
N11 ile Aras arasında resmi bir tek tık eklenti olmadığı için iki yoldan biriyle ilerliyoruz: bir orchestration platformu (Sentos, Platin360 gibi) üzerinden ya da N11 İş Ortağı API ile Aras web servisini birbirine bağlayan custom köprü ile. Hangisi olursa olsun süreç şöyle işler:
- Mevcut sipariş hacminizi ve hangi siparişlerin Aras ile gönderileceğini birlikte belirliyoruz.
- Anlaşmalı Aras şubenizden API bilgilerini (müşteri kodu, kullanıcı adı, şifre) temin ediyor, entegrasyon kodunuzu şube sistemine tanımlatıyoruz — bu adım günler sürebilir, koordinasyonu biz yürütüyoruz.
- N11 İş Ortağı API tarafında onaylanan siparişleri çeken ve kargo akışına yönlendiren bağlantıyı kuruyoruz.
- Aras gönderi kaydı, etiket çıktısı (A4 veya termal/ZPL) ve takip numarasının N11 İş Ortağı API’ye geri yazılması köprüsünü tasarlıyoruz.
- Test aşamasında birkaç gerçek sipariş üzerinde uçtan uca deneme yapıyoruz; etiket çıktısını ve panel bildirimini şube doğrulamasıyla birlikte kontrol ediyoruz.
- Canlı geçişten sonra ilk günlerde yoğun izleme yapıyor, bakım anlaşmasıyla Aras servis ve N11 API değişikliklerini takip ediyoruz.
Sıkça karşılaşılan sorunlar
N11 + Aras kombinasyonunda sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Takip numarası N11’a hiç yazılmaması. Aras gönderisi açılıyor ama takip numarası N11 İş Ortağı API’ye işlenmiyor; sipariş “kargolanmadı” görünüp bildirim süresini aşıyor ve 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.
- “Entegrasyon numarası sistemde tanımlı değil” hatası. Aras şubesi barkod/entegrasyon kodunu sisteme girmediğinde gönderi oluşturma çağrısı baştan reddedilir. Çözüm: kurulum öncesi şubeyle koordinasyon ve test aşamasında kodun tanımlı olduğunu doğrulamak.
- Desi/ağırlık eksikliğiyle yanlış etiket. N11 ürün kataloğunda boyut bilgisi yoksa Aras etiketi hatalı desi ile basılır, kargo ücreti tutmaz. Çözüm: kurulumda ürün-desi eşlemesini tamamlamak ve çok ürünlü siparişlerde toplam desiyi otomatik hesaplatmak.
- İade adresi uyumsuzluğu. İade adresi değiştiği halde Aras parametreleri güncellenmeyince kargo eski şubeye yönlenir. Çözüm: adres değişikliklerini API seviyesinde otomatik yansıtan bir mekanizma kurmak ve iade akışını entegrasyona dahil etmek.
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.