Kargo entegrasyonu, e-ticaret sitenizdeki siparişler için kargo firmasında gönderi kaydını otomatik açmak, barkod ve etiketi almak, gönderiyi takip etmek ve iptal ya da iade işlemlerini yazılımdan yapmaktır. Türkiye'deki kargo firmalarının çoğu herkese açık, ayrıntılı bir geliştirici belgesi yayımlamıyor. Web servis bilgileri sözleşmeli müşteri olduktan sonra veriliyor.
İlgili içerikler: Pazaryeri entegrasyonu · Ticimax entegrasyonu · Entegrasyon rehberi
Kargo API'si Ne İşe Yarar?
- Gönderi oluşturma: Sipariş onaylanınca alıcı ve paket bilgileri kargo firmasına aktarılır.
- Barkod ve etiket: Pakete yapıştırılacak barkod yazılımdan alınır, şubede elle kayıt gerekmez.
- Takip: Gönderi hareketleri sorgulanır ve müşteriye takip bilgisi gösterilir.
- İptal ve iade: Teslim alınmamış gönderi iptal edilir, iade için kod üretilir.
- Tahsilatlı gönderi: Kapıda ödemeli siparişlerde tahsil edilecek tutar gönderiyle birlikte bildirilir.
Firmalara Göre Entegrasyon Bilgileri
| Firma | Servis türü | Test ortamı | Bilinen işlemler |
|---|---|---|---|
| Yurtiçi Kargo | SOAP | Var | Gönderi oluşturma, sorgulama, iptal, iade kodu |
| Aras Kargo | SOAP (.asmx) | Var | Sipariş kaydı, barkod, iptal, iade, fiyat hesaplama, sorgulama |
| PTT Kargo | SOAP | Var | Kabul kaydı, etiket, barkod sorgulama, gönderi hareketleri |
| DHL eCommerce (MNG) | Web servis / API portalı | Doğrulanamadı | Kargo sipariş ve raporlama servisleri |
| Sürat Kargo | SOAP (.asmx) | Yayında ama resmî olarak belgelenmemiş | Gönderi, barkod, takip, iptal, iade, kapıda ödeme |
| HepsiJet | REST (açık kaynak pakete göre) | Var (entegrasyon sunucusu) | Gönderi, takip, iptal (açık kaynak pakete göre) |
| Kolay Gelsin | REST (2019 tarihli belgeye göre) | Doğrulanamadı | Gönderi, iptal, durum, iade |
Her firmanın ayrıntılı rehberi aşağıda. "Doğrulanamadı" yazan bilgiler için firmanın satış temsilcisinden güncel belge isteyin.
Yurtiçi Kargo
Yurtiçi'nin gönderi servisi SOAP yapısındadır ve hem canlı hem test ortamının tanım dosyası herkese açıktır. Servis; gönderi oluşturma (createShipment), sorgulama (queryShipment), iptal (cancelShipment) ve iade kodu (saveReturnShipmentCode) gibi işlemleri içerir. Kapıda ödeme, firma sayfasında "Tahsilatlı Gönderi Hizmeti" adıyla geçiyor.
# Test ortamı servis tanımı
https://testwebservices.yurticikargo.com/KOPSWebServices/ShippingOrderDispatcherServices?wsdlAras Kargo
Aras Kargo'nun entegrasyon sayfası B2B, B2C ve C2C çözümleri sunduğunu yazıyor. Modeller arasında şubede sevkiyat, mobil sevkiyat, etiketin müşteri tarafından üretilmesi, tedarikçi ve iade, yurt dışı sevkiyat ve sorgulama servisi entegrasyonu var. Başvuru için satış veya müşteri temsilcisine yönlendiriliyor. Test servisinde sipariş kaydı (SetOrder), barkod (GetBarcode), iptal (CancelDispatch) ve fiyat hesaplama (GetPriceCalculation) gibi işlemler listeleniyor.
PTT Kargo
PTT'nin veri yükleme ve gönderi hareketi servisleri SOAP yapısındadır ve test ortamı da yayındadır. Veri yükleme servisinde kabul kaydı (kabulEkle) ve etiket alma (etiketGetir), takip servisinde barkoda göre hareket sorgulama (gonderiHareketBarkodSorgu) bulunur. Entegratör kaynaklarına göre müşteri numarası ve şifre PTT'den alınır, gönderiler için PTT'nin verdiği barkod aralığı kullanılır.
DHL eCommerce (eski MNG Kargo)
mngkargo.com.tr artık dhlecommerce.com.tr adresine yönleniyor. Firmanın e-ticaret entegrasyonu sayfasında kargo sipariş ve raporlama web servisleri sunulduğu, gönderi durumunun siteye ya da CRM'e yansıtılabildiği yazıyor. Tahsilatlı gönderi için sözleşmeli müşteri olmak gerekiyor.
API Bilgileri Nasıl Alınır?
- Kargo firmasıyla kurumsal müşteri sözleşmesi yapın.
- Satış temsilcinizden veya şubenizden web servis kullanıcı adı, şifre ve müşteri numarası isteyin. Test ortamı bilgilerini ayrıca isteyin.
- Tahsilatlı gönderi kullanacaksanız sözleşmeye eklendiğinden emin olun.
- Test ortamında gönderi oluşturma, etiket alma, sorgulama ve iptal akışlarını deneyin, sonra canlıya geçin.
Desi Nasıl Hesaplanır?
Kargo ücretinde paketin gerçek ağırlığı ile hacminden hesaplanan desi karşılaştırılır, büyük olan esas alınır. Sürat Kargo ve Yurtiçi Kargo'nun resmî sayfalarına göre yurt içi gönderide formül şudur:
desi = (en x boy x yükseklik) / 3000 # ölçüler santimetre
ücrete esas ağırlık = max(desi, kg)Örneğin 40 x 30 x 20 cm bir koli 8 desidir. Kolinin ağırlığı 5 kg ise ücrete 8 esas alınır. Yurt dışı gönderilerde bölen firmaya göre değişir: Sürat, Yurtiçi ve Aras 5000, DHL eCommerce 6000 kullanıyor. Çok parçalı gönderilerde hesap parça başına yapılır.
Pazaryeri Siparişlerinde Kargo
Pazaryerinin kargo anlaşmasıyla gönderilen siparişlerde ayrı bir kargo API'sine gerek kalmaz; takip numarası pazaryerinin kendi API'sinden gelir. Örneğin Trendyol'un sipariş paketleri yanıtında kargo firması ve takip numarası alanları bulunur. Ayrıntılar pazaryeri entegrasyonu yazısında.
Firma Firma Kargo Entegrasyonu Rehberleri
- Yurtiçi Kargo entegrasyonu: createShipment alanları, sorgulama, iade kodu, tahsilatlı gönderi.
- Aras Kargo entegrasyonu: SetOrder alanları, ZPL/EPL barkod, Aras Tahsilatlı.
- PTT Kargo entegrasyonu: kabulEkle2, etiket, gönderi hareketi, ödeme şartlı.
- DHL eCommerce (MNG Kargo) entegrasyonu: sipariş ve raporlama servisleri, ApiZone.
- Sürat Kargo entegrasyonu: web servis işlemleri, 14 haneli takip, kargo tipleri.
- HepsiJet entegrasyonu: platform dışı gönderi, kapıda ödeme, API akışı.
- Kolay Gelsin entegrasyonu: 30 kg / 40 desi sınırı, REST API akışı.
Sık Sorulan Sorular
Kargo API'si SOAP mı REST mi?
Yurtiçi, Aras ve PTT'nin herkese açık servis tanımları SOAP yapısındadır. Diğer firmalar için resmî bir belge bulunamadı.
Test ortamı var mı?
Yurtiçi Kargo, Aras Kargo ve PTT Kargo'nun test servisleri yayında. Test kullanıcı bilgilerini firmadan isteyin.
Birden fazla kargo firmasıyla çalışabilir miyim?
Evet. Her firmanın servisi ayrıdır. Yazılımda ortak bir "gönderi oluştur" katmanı kurup firma seçimini bu katmanın altına almak, sonradan firma eklemeyi kolaylaştırır. Ticimax gibi altyapılarda hazır kargo entegrasyonları da bulunur.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.