Yurtiçi Kargo entegrasyonu, e-ticaret siparişleriniz için Yurtiçi Kargo'da gönderi kaydını yazılımdan açmak, gönderiyi sorgulamak, iptal etmek, iade kodu tanımlamak ve kapıda ödemeli gönderileri yönetmektir. Yurtiçi'nin gönderi servisi SOAP yapısındadır; canlı ve test ortamlarının servis tanımları herkese açıktır.
İlgili içerikler: Kargo entegrasyonu rehberi · Aras Kargo entegrasyonu · PTT Kargo entegrasyonu · Pazaryeri entegrasyonu
Başvuru ve Web Servis Bilgileri
- Kurumsal müşteri olun: Yurtiçi'nin müşteri başvuru formunda firma adı, sözleşme türü, adres ve günlük ortalama kargo sayısı isteniyor. Başvurular bölge müdürlükleri üzerinden yürütülüyor.
- Web servis kullanıcısı: Servis her istekte
wsUserNamevewsPasswordalır. Bu bilgileri sözleşmeden sonra satış yetkilinizden isteyin; test ortamı bilgilerini ayrıca isteyin. - Canlı servis:
https://ws.yurticikargo.com/KOPSWebServices/ShippingOrderDispatcherServices?wsdl - Test servisi:
https://testwebservices.yurticikargo.com/KOPSWebServices/ShippingOrderDispatcherServices?wsdl
Servisteki İşlemler
| İşlem | Ne için |
|---|---|
createShipment, createShipmentDetail | Gönderi kaydı oluşturma |
createShipmentWithDelivery | Gönderi ve teslimat bilgisiyle kayıt; barkod ve ZPL etiket verisi döner |
queryShipment, queryShipmentDetail | Gönderi durumu, hareketleri ve tahmini teslim tarihi |
cancelShipment | Gönderi iptali |
saveReturnShipmentCode, cancelReturnShipmentCode | İade kodu tanımlama ve iptal |
Gönderi Oluşturma Alanları
createShipment isteği bir ShippingOrderVO nesnesi taşır. Başlıca alanlar:
| Alan | İçerik |
|---|---|
cargoKey, invoiceKey | Sizin tarafınızdaki gönderi ve fatura anahtarları; sorgu ve iptalde kullanılır |
receiverCustName, receiverAddress, cityName, townName | Alıcı adı ve adresi |
receiverPhone1, emailAddress | Alıcı iletişim bilgisi |
desi, kg, cargoCount | Hacim, ağırlık ve parça sayısı |
waybillNo, description | İrsaliye numarası ve açıklama |
ttInvoiceAmount, ttCollectionType, ttDocumentId | Tahsilatlı gönderi (kapıda ödeme) bilgileri |
dcSelectedCredit, dcCreditRule | Kartla tahsilatta taksit bilgileri |
Yanıtta bir iş numarası (jobId) ve her gönderi için cargoKey, hata kodu ve hata mesajı döner. Her gönderinin sonucunu ayrı ayrı kontrol edin.
Gönderi Sorgulama ve Takip
queryShipment isteğinde sorgulanacak anahtarlar ve anahtar türü gönderilir. Yanıtta takip adresi (trackingUrl), toplam desi ve ağırlık, teslim tarihi, son durum ve hareket listesi bulunur. queryShipmentDetail ek olarak tahmini teslim tarihi ve mesafe gibi bilgiler döndürür.
Yurtiçi'nin kargo terimleri sayfasına göre gönderi kodu, fatura üzerindeki 12 haneli numaradır. Müşteri sitedeki gönderi sorgulama sayfasından gönderi kodu, fatura numarası veya diğer numaralarla sorgu yapabilir; e-ticaret gönderileri için ayrı bir sorgulama sayfası da var.
Kapıda Ödeme (Tahsilatlı Gönderi)
- Kapıda nakit veya kredi kartıyla tahsilat yapılabiliyor.
- Sayfaya göre her iki tip için web entegrasyonu veya Self-Servis hizmetiyle çalışılması gerekiyor ve tahsilatlı gönderi hizmet sözleşmesi şart.
- Nakit tahsilatlar sayfaya göre 3 iş günü içinde hesaba aktarılıyor.
- Kartla tahsilat İş Bankası ile geliştirilmiş bir uygulamayla yapılıyor.
İade
"Kolay İade" hizmeti, Yurtiçi ile kolay iade anlaşması yapmış e-ticaret siteleri için sunuluyor; müşteri iade kodunu şubede, akıllı kargo dolabında veya teslim noktasında kullanabiliyor. Entegrasyonda iade kodları saveReturnShipmentCode ile tanımlanır, cancelReturnShipmentCode ile iptal edilir.
Desi
Yurtiçi'ye göre desi, en, boy ve yüksekliğin santimetre cinsinden çarpılıp 3000'e bölünmesiyle bulunur. Ücrette ağırlık ile desiden büyük olan esas alınır. Ayrıntılar Kargo entegrasyonu rehberi'nde.
Sık Sorulan Sorular
Yurtiçi Kargo API'si REST mi?
Hayır. Herkese açık servis tanımına göre SOAP yapısında.
Kapıda ödeme bilgisi hangi alanla gönderilir?
Tutar ttInvoiceAmount, tahsilat tipi ttCollectionType alanıyla gönderilir. Hizmet için tahsilatlı gönderi sözleşmesi gerekir.
Yurtiçi gönderi kodu kaç haneli?
Yurtiçi'nin tanımına göre fatura üzerindeki gönderi kodu 12 hanelidir.
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.