Aynı sipariş iki kez kargoya gitmesin: sipariş numarası eşleştirme ve güvenli yeniden deneme
Bağlantı koptuğunda ya da gönderi başarısız olduğunda çift gönderi oluşmadan nasıl yeniden denenir: SiparişTakip'te sipariş numarası eşleştirmesi.
SiparişTakip Ekibi2 dk okuma
Kargo entegrasyonunda en can sıkıcı hatalardan biri çift gönderidir: Aynı sipariş için iki gönderi oluşur, iki etiket basılır, bazen iki paket yola çıkar. Çoğu zaman sebep basittir: İstek gönderilir, yanıt gelmeden bağlantı kopar, mağaza yazılımı isteği tekrar gönderir.
Bu yazıda SiparişTakip'in çift gönderiyi nasıl önlediğini ve bir gönderiyi ne zaman, nasıl güvenle yeniden deneyebileceğinizi anlatıyoruz.
Her gönderi bir sipariş numarasına bağlıdır
Mağazanız gönderiyi API'ye iletirken siparişin numarasını da gönderir. SiparişTakip bu numarayı gönderinin anahtarı olarak kullanır: Aynı sipariş numarasıyla aynı kargo firmasına ikinci bir gönderi açılmaz.
Bu kural iki durumda işinize yarar:
- Bağlantı koptuğunda: İsteğin ulaşıp ulaşmadığını bilmiyorsanız aynı isteği tekrar göndermek güvenlidir. İlk istek ulaştıysa ikinci istek yeni bir gönderi açmaz; mevcut gönderinin bilgisi döner.
- Yazılım hatasında: Mağaza yazılımınız aynı siparişi yanlışlıkla iki kez gönderirse ikinci istek reddedilir ve hangi gönderinin zaten var olduğu bildirilir.
Başarısız gönderiyi yeniden göndermek
Bir gönderi kargo firmasında oluşmadan başarısız olabilir: eksik ya da hatalı adres, hesap bilgisinde bir sorun ya da kargo firmasının gönderiyi kabul etmemesi gibi. Bu durumda:
- Neden gönderinin üzerinde, API'de görünür.
- Bilgiyi düzeltirsiniz (örneğin adresi ya da kargo hesabı bilgilerinizi).
- Gönderiyi aynı sipariş numarasıyla yeniden gönderirsiniz. Yeni bir kayıt açılmaz; başarısız gönderi düzeltilmiş bilgilerle yeniden sıraya alınır.
Kargo firmasında oluşmadan başarısız olan gönderi hak tüketmez. Böylece yeniden deneme size ek maliyet çıkarmaz.
Siparişi başka bir firmayla göndermek
Sipariş numarası kargo firması başına tekildir. Bir siparişi farklı bir kargo firmasıyla göndermeye karar verirseniz, aynı sipariş numarasıyla o firmada yeni bir gönderi oluşturabilirsiniz. Birden çok firmayla çalışmanın sağladığı esneklik, numara eşleştirmesini bozmaz.
Mağaza yazılımınızda dikkat edilecekler
- Gönderi isteğinde her zaman siparişin kendi numarasını kullanın; her denemede yeni bir numara üretmeyin. Yeni numara, çift gönderiye karşı korumayı devre dışı bırakır.
- Yanıt alamadığınız isteği aynı bilgilerle tekrarlayın; yanıtı beklemeden ikinci bir sipariş kaydı açmayın. İsteğe bir tekrar anahtarı (`Idempotency-Key`) eklerseniz, aynı anahtarla tekrarlanan istek ilk isteğin yanıtını aynen döndürür.
- Gönderinin durumunu sipariş numarasıyla okuyun; gönderinin oluşup oluşmadığını, başarısızsa nedenini oradan görürsünüz.
Özet
SiparişTakip'te gönderi sipariş numaranıza bağlıdır. Aynı numarayla aynı firmaya ikinci gönderi açılmaz; bu sayede bağlantı kopsa da isteği güvenle tekrarlarsınız. Başarısız gönderi düzeltilip aynı numarayla yeniden gönderilir ve hak tüketmez. Akışın tamamı için nasıl çalışır sayfasına bakabilirsiniz.