Kargo entegrasyonu
MNG Kargo
Ne yapar
- MNG gönderilerini REST API üzerinden oluşturur; etiketi, barkodu ve takip numarasını siparişe döndürür.
- Teslimat durum olaylarını MNG'den webhook ile alır; böylece siparişler bir sorgulama turunu beklemeden güncellenir.
- Sipariş kapıda ödemeli verildiyse tahsil edilecek tutarı MNG'ye gönderir.
Sağlayıcının merkezi: Türkiye
MNG Kargo, Sürat, PTT ve HepsiJet ile aynı grupta, Kambloo'nun lansman kataloğunun parçasıdır. Adaptör MNG'nin REST API'sini kullanır ve Yurtiçi ile Aras'tan farklı olarak durum güncellemelerini webhook ile alır. Kambloo'nun hiçbir ücret almadığı bir Dahili Modüldür.
Kambloo ile nasıl çalışır
Adaptör ortak ShippingCarrier sözleşmesini uygular; böylece hangi firmayı seçerseniz seçin sipariş ekranı aynı görünür. Bir siparişi sevkiyat için onaylamak createShipment çağrısını yapar. MNG etiketi, barkodu ve takip numarasını döndürür. Etiket PDF'i dosya alanınızda saklanır ve tek başına ya da günün toplu yazdırmasının parçası olarak yazdırılabilir. Takip numarası siparişe yazılır ve takip bağlantısıyla müşteriye gönderilir.
Takip olay tabanlıdır. MNG her durum değişikliğini mağazanızın webhook adresine gönderir. Kambloo, kiracı bağlamını adresten kurar, verinin imzasını doğrular, ham olayı benzersiz bir olay kimliğiyle saklar ve işlemeyi bir kuyruk işine devreder. Adres bir saniyenin altında yanıt verir. Bir gönderi webhook işleyicisi gönderi durumunu ve sipariş zaman çizelgesini günceller; teslim edildi durumu siparişi kapatır ve iade süresini başlatır. Entegrasyon sağlık ekranı alınan son olayı ve yakın zamanlı hataları gösterir.
Webhook birincildir ama tek yol değildir. Standart takip işi, bir süredir bildirim yapmayan gönderiler için emniyet ağı olarak çalışmaya devam eder; böylece kaçan bir olay bir siparişi askıda bırakamaz.
Kapıda ödeme katalogdaki her firmadaki gibi çalışır: tutar gönderi oluşturulurken seçenek olarak iletilir, stok ayırması sipariş anında kesin düşüme çevrilir ve tahsilat firmanın raporuna karşı teyit edilir. Sepet fiyatı kendi MNG fiyat tablonuzdan gelir; desi ile gerçek ağırlığın karşılaştırmasına ve çıkış ile varış illerine göre hesaplanır.
Gerekenler
- REST API erişimi olan bir MNG Kargo müşteri sözleşmesi.
- MNG'nin webhook gönderebilmesi için yayında bir mağaza alan adı.
- Fiyat tablonuzun CSV hâli ve desi hesabı için ürün ölçüleri.
Kurulum adımları
Kısa sürüm. Mağaza yönetim panelinizdeki ekranlar aynı sırayı izler.
- MNG Kargo modülünü Market'ten kurun. Ücretsizdir.
- MNG API bilgilerinizi Ayarlar > Kargo > MNG Kargo altına girin.
- Durum olaylarının Kambloo'ya ulaşması için mağazanızın webhook adresini MNG'ye kaydettirin.
- Fiyat tablonuzu CSV olarak yükleyin ve bir test siparişi gönderin.
- MNG'yi hizmet verdiğiniz bölgeler için etkinleştirin.
MNG Kargo hakkında sorular
Webhook ile takibin sorgulamaya göre avantajı ne?
Durum değişiklikleri, bir sonraki 30 dakikalık sorguyu beklemek yerine MNG kaydettikten saniyeler sonra gelir. Müşteri bildirimleri daha erken çıkar ve sipariş zaman çizelgesi daha isabetli olur.
Webhook güvenli mi?
Evet. Olaylar mağazanızın merkezi webhook adresine düşer, hiçbir şey işlenmeden önce imza denetlenir ve her olay kimliği bir kez saklanır. Tekrarlanan gönderimler yok sayılır.
Tek bir siparişte kargo firmasını değiştirebilir miyim?
Evet. MNG gönderisini, teslim alınmadan önce siparişten iptal edin ve kurulu başka bir firmayla yeni bir gönderi oluşturun.