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.
Yurtiçi Kargo nedir?
Yurtiçi Kargo, Türkiye’nin en köklü ve geniş şube ağına sahip kargo firmalarından biri; özellikle Anadolu’da yaygın kapsama alanı tercih sebebidir. Gönderi oluşturma, takip numarası alma, etiket basma ve ücret sorgulama için açık bir API’si var. Pratikte en kritik nokta şu: Yurtiçi’nin çoğu satış platformu için hazır, resmi bir eklentisi yoktur — WooCommerce gibi yaygın altyapılar dahil bağlantı çoğunlukla custom entegrasyon gerektirir. Ayrıca erişim bilgileri (müşteri kodu, kullanıcı adı, şifre) sözleşmeli müşteri olduktan sonra anlaşmalı şubeden temin edilir ve peşin/fatura ödemeli gönderiler ayrı yapılandırılır.
Neden Trendyol ve Yurtiçi 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. 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 Trendyol’a geri yazılması: Yurtiçi’den 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.
- Geniş Anadolu kapsaması: Yurtiçi’nin yaygın şube ağı, TGO’nun zayıf kaldığı bölgelerde satıcı kargo seçeneği olarak avantaj sağlayabilir.
- Doğru kargo seçimi: Hangi siparişin Yurtiçi’ye (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 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.
Trendyol Yurtiçi Kargo entegrasyonu nasıl yapılır?
Yurtiçi’nin Trendyol için hazır bir resmi eklentisi olmadığı için iki yoldan biriyle ilerliyoruz: bir orchestration platformu (Sentos, Platin360 gibi) üzerinden ya da Trendyol Partner API ile Yurtiçi API’sini 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.
- Yurtiçi ile sözleşmeli müşteri olmanızın ardından erişim bilgilerini (müşteri kodu, kullanıcı adı, şifre) anlaşmalı şubeden temin ediyoruz — bu adım günler sürebilir, şube koordinasyonunu biz yürütüyoruz.
- Trendyol Partner API tarafında satıcı kargo siparişlerini ayırt eden akışı kuruyoruz.
- Yurtiçi gönderi kaydı, etiket çıktısı (A4 veya termal/ZPL), peşin/fatura ödeme tipi seçimi 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ı, hareket kaydının sisteme düştüğünü ve panel bildirimini birlikte doğruluyoruz.
- Canlı geçişten sonra ilk günlerde yoğun izleme yapıyor, bakım anlaşmasıyla Yurtiçi API ve Trendyol API değişikliklerini takip ediyoruz.
Sıkça karşılaşılan sorunlar
Trendyol satıcı kargo + Yurtiçi kombinasyonunda sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- “Kargo İşlem Görmemiş” durumu. Şube kargoyu entegrasyon yerine manuel kesince gönderi yola çıkar ama hareket kaydı sisteme yansımaz; Trendyol’da sipariş “kargolanmadı” görünür ve ceza puanına yol açar. Çözüm: gönderi açıldıktan sonra belirli sürede hareket kaydı gelmezse uyaran kontrol ve şube süreçlerini baştan entegrasyon üzerinden işletmek.
- Takip numarası Trendyol’a hiç yazılmaması. Yurtiçi gönderisi açılıyor ama takip numarası Trendyol Shipment API’ye bildirilmiyor; sipariş “kargolanmadı” kalıp ceza puanı doğuruyor. Çözüm: takip numarasını gönderi kaydının hemen ardından panele geri yazan iki yönlü akış kurmak.
- TGO ve satıcı kargo siparişlerinin karışması. Tüm siparişler ayırt edilmeden Yurtiçi’ye düşürülmeye çalışılınca TGO siparişleri için gereksiz Yurtiçi kaydı oluşuyor. Çözüm: Trendyol Partner API’den gelen kargo tipi bilgisine göre yalnızca satıcı kargo siparişlerini Yurtiçi akışına yönlendirmek.
- 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. Çö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.