Kargo entegrasyonu

4 dk okuma · Güncelleme: 2026-10-01

ChatGPT, yardım metinlerini ve llms.txt dosyasını okuyarak yanıtlar.

Ne işe yarar?

Anlaşmalı kargo firması API bağlantısı.

Neden önemli?

Panelden etiket ve takip numarası üretmek için gereklidir.

Detaylı açıklama

Mağaza bağlantısı yalnızca kimlik bilgisi girişi değildir: sipariş çekim aralığı, otomatik fatura/stok seçenekleri ve kargo eşlemesi birlikte yapılandırılmalıdır.

Kargo entegrasyonu, pazaryeri anlaşmalı kargodan bağımsız bir taşıyıcı API bağlantısıdır (Sürat, Yurtiçi, Navlungo, Aramex vb.). Anlaşma numarası / müşteri kodu kargo firması panelindekiyle aynı olmalıdır. Kurulumdan sonra gerçek pakete yakın desi ile test gönderisi alın; 0 desi veya 1 gram birçok API’de reddedilir. Platformun kendi kargo barkodu (ör. Trendyol V2) ayrı rehberdedir.

Test aşaması: Yurtiçi Kargo ve DHL eCommerce (MNG) bağlantıları henüz genel kullanıma açık değildir. Entegrasyon formunda uyarı görürsünüz; sorun olursa Basit Kargo veya Shipink ile devam edilebilir.

Yurtiçi Kargo’da müşteri paneli şifresi değil, temsilcinin verdiği web servis kullanıcı adı / şifre girilir. DHL eCommerce (MNG) için kendi sözleşmenize ait müşteri numarası ve web şifresi kullanılır (pazaryeri anlaşmalı kargo bilgisi değil).

Ön koşullar

Oluşturulmuş ana mağaza.
Platform satıcı panelinde API erişimi ve gerekli izinler.

Adımlar (Menü > Entegrasyon Ayarları > Kargo)

Kargo firmasını listeden seçin.
Sözleşme ve API bilgilerini girin.
Test gönderisi ile etiket almayı deneyin.
Menü > Entegrasyon Ayarları > Kargo’dan firmayı seçin.
Sözleşme no, kullanıcı ve şifre/token alanlarını girin.
Varsayılan paket ölçüsü ve gönderici adresini kaydedin.
İptal edilebilir bir test siparişi veya test ortamında etiket alın.

Bağlantı doğrulama

Mağaza detayında Bağlantıyı test et ile API yanıtını doğrulayın.
Test başarılıysa tek sipariş çekimini manuel tetikleyin.
Mağaza logunda 401/403 yoksa token geçerlidir.
İlk 24 saatte sipariş, stok ve (varsa) fatura akışını ayrı ayrı kontrol edin.

Pazaryeri kargo vs kendi anlaşmanız

Trendyol/HB anlaşmalı kargoda etiket çoğu zaman platform API’sinden gelir. Kendi anlaşmanız varsa FastEntegre kargo entegrasyonu etiket üretir ve takip numarasını pazaryerine iletir. İkisini aynı siparişte karıştırmayın.

Kontrol listesi

API anahtarı platform panelinde aktif.
Bağlantı testi yeşil.
Sipariş senkron aralığı tanımlı.
Kargo ve fatura entegrasyonları (gerekiyorsa) ayrıca bağlandı.

Sık karşılaşılan hatalar

Etiket oluşmuyor — Anlaşma numarası ve müşteri kodunu kargo paneli ile karşılaştırın.
Etiket oluşmuyor — Anlaşma numarası ve müşteri kodunu kargo paneli ile karşılaştırın; gönderici il/ilçe zorunlu alanlarını doldurun.
Yetki / bayi kodu hatası — Kargo temsilcinizden API kullanıcısının etiket yetkisi olduğunu teyit edin.

Sık sorulan sorular

Birden fazla kargo firması bağlanır mı?

Evet. Siparişte veya mağaza varsayılanında hangisinin kullanılacağını seçin.

QZ Tray zorunlu mu?

Hayır. PDF indirip yazdırabilirsiniz. Yoğun depo için QZ pratiktir; etiket sorunları.

İlgili rehberler

Hâlâ çözülmedi?

Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, ekran görüntüsü ve tam hata metnini ekleyin.
WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.

Bu makale yardımcı oldu mu?