Trendyol nedir?
Trendyol, Türkiye’nin en büyük pazaryeri. Satıcı olarak Trendyol Mağaza üzerinden satış yapıyorsanız ürün listeleme, sipariş, stok, fiyat ve kargo süreçlerinizi Trendyol Partner API üzerinden otomatize edebilirsiniz. Pazaryeri olduğu için Trendyol birçok operasyonel kararı — özellikle lojistiği — kendi kuralları çerçevesinde dayatır; entegrasyon tasarımı bu kuralların üzerine kurulur.
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.
Neden Trendyol ve Aras Kargo entegre edilmeli?
Önce dürüst çerçeve: Trendyol’da varsayılan lojistik Trendyol Express / TGO’dur ve çoğu satıcı için yeterlidir. Aras 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 Aras gönderisi: Sipariş satıcı kargoya düştüğü anda Aras’ta gönderi kaydı açılır, kargo paneline el ile girmeniz gerekmez.
- Takip numarasının Trendyol’a geri yazılması: Aras’tan dönen takip numarası Trendyol Shipment API üzerinden siparişe bildirilir; bu adım entegrasyonun en kritik halkasıdır.
- Trendyol kargo bildirim süresine uyum: Trendyol sipariş onayından sonra belirli sürede kargo bildirimi şart koşar; otomasyon bu süreyi kaçırmanızı ve ceza puanı almanızı ö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.
- Doğru kargo seçimi: Hangi siparişin Aras’a (satıcı kargo), hangisinin TGO’ya gideceği kurala bağlanır; karışıklık olmaz.
Büyük ebatlı ürün satıyorsanız veya Aras ile avantajlı bir anlaşma fiyatınız varsa, bu akış satıcı kargo tarafını TGO’nun manuel yükü olmadan yürütmenizi sağlar.
Trendyol Aras Kargo entegrasyonu nasıl yapılır?
Trendyol 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 Trendyol Partner 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 ürünlerin satıcı kargoya gideceğ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.
- Trendyol Partner API tarafında satıcı kargo siparişlerini ayırt eden akışı kuruyoruz.
- Aras gönderi kaydı, etiket çıktısı (A4 veya termal/ZPL) ve takip numarasının Trendyol Shipment API’ye 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ı 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 Trendyol API değişikliklerini takip ediyoruz.
Sıkça karşılaşılan sorunlar
Trendyol satıcı kargo + Aras kombinasyonunda sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Takip numarası Trendyol’a hiç yazılmaması. Aras gönderisi açılıyor ama takip numarası Trendyol Shipment API’ye bildirilmiyor; sipariş “kargolanmadı” görünüp ceza puanına yol açı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.
- TGO ve satıcı kargo siparişlerinin karışması. Tüm siparişler ayırt edilmeden Aras’a düşürülmeye çalışılınca TGO siparişleri için gereksiz Aras kaydı oluşuyor. Çözüm: Trendyol Partner API’den gelen kargo tipi bilgisine göre yalnızca satıcı kargo siparişlerini Aras akışına yönlendirmek.
- Desi/ağırlık eksikliğiyle yanlış etiket. Ürün katalogunda 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.
Dördü de kurulumda doğru tasarımla önlenebilir; canlıda fark edilince düzeltmek çok daha fazla iş yükü ve ceza puanı riski yaratır.