Yurt Dışı Depolar Yerel Teslimatları İzlemek İçin Tracking API'lerini Nasıl Kullanabilir?
Denizaşırı depolar, her çıkış paketini taşıyıcısı ve takip numarasıyla ilişkilendirerek, takip olaylarını depo veya sipariş yönetim sistemlerine aktararak ve teslimat istisnalarını atanmış görevlere dönüştürerek yerel teslimatları izlemek için takip API'lerini kullanabilir. En kullanışlı kurulum, etiket oluşturma ile taşıyıcı kabulünü birbirinden ayırır, gönderi geçmişini korur ve operasyon ekiplerine yalnızca hangi paketlerin yeni bir duruma sahip olduğunu değil, hangi paketlerin işlem gerektirdiğini bildirir.
Bu kılavuz, satıcının ana pazarının dışında envanter bulunduran ve siparişleri varış pazarındaki müşterilere gönderen depolara odaklanır. Bu ekipler için denizaşırı takip, depo sevkiyat kayıtlarını yerel taşıyıcının teslimat süreciyle ilişkilendirmelidir. Bu bağlantı; depo yöneticilerinin, taşıma koordinatörlerinin ve satıcı destek ekiplerinin aynı gönderi kaydı üzerinden çalışmasına yardımcı olur.
17TRACK Order Tracking — Müşterileri teslimat durumu hakkında bilgilendirin ve DTC markalı satın alma sonrası deneyimini iyileştirin. Daha Fazla Bilgi →Depo görünürlüğünün nerede sona erdiğini ve taşıyıcı görünürlüğünün nerede başladığını belirleyin
Bir depo yönetim sistemi, bir siparişin toplandığını, paketlendiğini, etiketlendiğini ve sevkiyat alanına yerleştirildiğini kaydedebilir. Ancak bu kayıtlar tek başına taşıyıcının paketi kabul ettiğini kanıtlamaz. Bir takip API'si, taşıyıcı tarafından bildirilen olayları ekler; ancak depo teslim kaydının yerini alamaz veya hiç gerçekleşmemiş fiziksel bir tarama oluşturamaz.
17TRACK API Global Shipment Tracking Solution — Kolay, doğru ve güvenilir paket takibi için tek bir API üzerinden dünya çapında 3.500'den fazla taşıyıcıya bağlanın. Ücretsiz Deneyin →Üç kilometre taşını ayrı tutun: teslim alınmaya hazır, depo kayıtlarına göre teslim edilmiş ve taşıyıcının takip olaylarına göre kabul edilmiş. Bu ayrım, şirket içinde sevk edilmiş görünen ancak taşıyıcı hareketi bulunmayan paketlerin araştırılmasını kolaylaştırır.
Örneğin, bir paket teslim alma manifestosunda görünüyorsa ancak kabul olayı yoksa sonraki adım yükleme kayıtlarını kontrol etmek ve teslim alma taşıyıcısıyla iletişime geçmektir. Paketi kayıp olarak sınıflandırmak için erkendir. Taşıyıcı zaten başarısız bir teslimat girişimi bildirmişse uygun işlem farklıdır: nedeni araştırın ve sonraki adımı satıcı veya yetkili alıcı iletişim kişisiyle koordine edin.
API'yi bağlamadan önce gönderi kaydını oluşturun
Temel unsur, müşteri siparişi, fiziksel paket ve taşıyıcı takip tanımlayıcısı arasındaki güvenilir ilişkidir. Paket tanımlayıcısı yerine sipariş numarası kullanmayın. Bir sipariş depodan birkaç paket halinde çıkabilir ve yenileme gönderisinin kendi kaydı olmalıdır.
| Kayıt | Önerilen alanlar | Operasyonel amaç |
|---|---|---|
| Gönderi kimliği | Dahili gönderi kimliği, sipariş kimliği, paket kimliği, satıcı hesabı | Bölünmüş gönderileri ve farklı müşterileri ayrı tutmak. |
| Taşıyıcı kimliği | Taşıyıcı tanımlayıcısı, takip numarası, biliniyorsa hizmet | Doğru takip isteğini göndermek ve araştırmaları yönlendirmek. |
| Depo teslimi | Depo, sevkiyat zamanı, teslim alma referansı, manifesto referansı | Fiziksel sevkiyat kanıtını taşıyıcı olaylarıyla karşılaştırmak. |
| Takip geçmişi | Ham olay, eşlenmiş durum, olay zamanı, alınma zamanı, sağlanmışsa konum | Kanıtları korumak ve olay zamanlamasını bildirim gecikmelerinden ayırmak. |
| İstisna iş akışı | Sorun türü, sorumlu, sonraki işlem, inceleme son tarihi, çözüm | Takip bilgilerini sorumluluğu belirlenmiş işe dönüştürmek. |
Biçimlendirmenin korunması için takip numaralarını metin olarak saklayın. Depo etiket oluşturma sırasında taşıyıcıyı zaten biliyorsa, yalnızca numara tanımaya güvenmek yerine bu kimliği entegrasyon üzerinden iletin. Ayrıca orijinal, yenileme, iade ve sonraki teslimat paketleri arasındaki ilişkileri, her birinin geçmişini üzerine yazmadan koruyun.
Okumaya devam edin: Avrupa Teslimatları İçin Gönderi Takip API'si Nasıl SeçilirDeponun taşıyıcı karmasına uygun bir entegrasyon seçin
Bir depo, taşıyıcılarıyla doğrudan entegre olabilir veya çok taşıyıcılı bir takip API'si kullanabilir. Doğrudan entegrasyon, özellikle taşıyıcıya özgü veriler gerektiğinde, az sayıda taşıyıcı kullanan istikrarlı bir operasyon için pratik olabilir. Deponun çeşitli teslimat ağları arasında ortak bir takip arayüzüne ihtiyacı olduğunda çok taşıyıcılı bir API değerlendirmeye değerdir.
İlgili makale: Çok Taşıyıcılı Takip: Nedir, Faydaları Nelerdir ve Nasıl Çalışır?17TRACK'in Tracking API'si bu entegrasyon modeli için uygun bir seçenektir. Gönderi kaydı, takip bilgilerinin alınması ve takip güncellemelerinin sisteminize nasıl uyacağını değerlendirmek için resmî API belgelerini kullanın. Genel taşıyıcı kullanılabilirliğini, gerekli her olayın döndürüleceğinin kanıtı olarak görmek yerine, her deponun kullandığı taşıyıcı ve hizmet kombinasyonlarını doğrulayın.
Bağlantıyı gerçek operasyonel gereksinimlere göre değerlendirin:
- Sisteminiz, sevkiyat yoğunluklarında oluşturulan paketleri güvenilir biçimde kaydedebiliyor mu?
- Gerçekte satın aldığınız yerel teslimat hizmetleri için hangi olaylar döndürülüyor?
- Başarısız istekler, yinelenen kayıtlar ve geçersiz taşıyıcı tanımlayıcıları nasıl ele alınıyor?
- Güncellemeler nasıl iletiliyor veya alınıyor ve kaçırılan güncellemeler nasıl uzlaştırılabiliyor?
- Hesabınız için hangi kullanım sınırları, saklama koşulları, güvenlik kontrolleri ve ticari şartlar geçerli?
Bir takip bağlantısının etiket satın alma, adres düzeltme, teslimatı yeniden planlama veya talep oluşturma işlemlerini içerdiği varsayılmamalıdır. İlgili ürün belgeleri bunu açıkça doğrulamadıkça bunları ayrı iş akışları olarak ele alın.
Sevkiyatı, takip güncellemelerini ve istisna yönetimini birbirine bağlayın
1. Paketleri kontrollü bir sevkiyat aşamasında kaydedin
Etiket onayı veya sevkiyat onayı gibi tutarlı bir kayıt tetikleyicisi seçin. Etiket oluşturma sırasında kayıt yapmak, teslim alınmadan kalan paketleri görünür kılabilir; ancak iptal edilen etiketlerin de ele alınmasını gerektirir. Yalnızca sevkiyattan sonra kayıt yapmak kullanılmayan kayıtları azaltır, fakat etiket oluşturma ile fiziksel teslim arasındaki aralığı gizleyebilir.
Hangi tetikleyiciyi seçerseniz seçin, kayıt sonucunu paketle ilişkilendirerek kaydedin. Başarısız kayıtlar uygulama günlüklerinde kaybolmak yerine yeniden deneme veya düzeltme kuyruğuna girmelidir. Tekrarlanan işlemlerin yinelenen iş kayıtları oluşturmasını önlemek için kararlı bir dahili tanımlayıcı kullanın.
2. Güncellemeleri alın, ancak gösterge tablosunu doğruluk kaynağı yapmayın
API'nin belgelenmiş seçeneklerine bağlı olarak güncellemeler istekler yoluyla alınabilir veya webhook bildirimleriyle iletilebilir. Webhook, sağlayıcıda bir güncelleme olduğunda sisteminize gönderilen bir mesajdır; yoklama ise sisteminizin bilgiyi istemesi anlamına gelir.
Webhook tabanlı uygulamalarda gelen mesajları sağlayıcının belgelenmiş doğrulama yöntemiyle doğrulayın. Kabul edilen mesajları onaylamadan önce kalıcı olarak kaydedin, ardından eşzamansız olarak işleyin. Yinelenen mesajlar ve sırası dışında gelen olaylar için tasarım yapın. Her sağlayıcının aynı şekilde davrandığını varsaymak yerine belgelenmiş yanıt ve yeniden deneme gereksinimlerine uyun.
Yoklama için etkin gönderilere ve çözülmemiş istisnalara öncelik verirken geçerli kullanım sınırları içinde kalın. Destekleniyorsa güncelleme geçmişi eksik görünen gönderileri kontrol etmek için uzlaştırma istekleri kullanın. Veri alma hatalarını taşıyıcı teslimat istisnalarından ayrı kaydedin: kopuk bir bağlantı, paketin hareket etmeyi durdurduğunun kanıtı değildir.
3. Orijinal kanıtları korurken durumları normalleştirin
Kabul bekleniyor, transit halinde, teslimat için yolda, teslimat denendi, teslim edildi ve iade hareketi gibi az sayıda operasyonel kategori oluşturun. Bunlar önerilen depo kategorileridir; her taşıyıcının eşleşen olaylar sağlayacağına dair bir vaat değildir.
Orijinal açıklamayı eşlenmiş kategorinin yanında koruyun. “Teslim alınabilir” sessizce “teslim edildi”ye, “iade başlatıldı” ise “depoya geri alındı”ya dönüşmemelidir. Bilinmeyen veya eşlenmemiş bir duruma izin verin; böylece alışılmadık olaylar inceleme için görünür kalır.
Hem olay zaman damgasını hem de sisteminizin olayı aldığı zamanı saklayın. Sağlandığında orijinal saat dilimini veya ofseti koruyun ve tutarlı bir dahili zaman standardı kullanın. Geç gelen bir olay, yalnızca en son alındığı için gönderiyi otomatik olarak geriye taşımamalıdır; açık sıralama kuralları uygulayın ve geçmişi koruyun.
4. İstisnalara işlem sorumluları atayın
Bir uyarı ancak biri üzerinde işlem yapabiliyorsa faydalıdır. Eksik kabul taramalarını depo sevkiyat ekibine, alıcı girdisi gerektiren teslimat girişimlerini satıcının destek ekibine ve sürekli taşıyıcı hareketi sorunlarını taşıma koordinatörüne yönlendirin. Bunlar başlangıç için önerilen noktalardır; sorumluluklar deponun sözleşmelerini ve işletim modelini yansıtmalıdır.
Takip geçmişini, teslim referansını, son olayı, araştırma notlarını ve sonraki inceleme zamanını her vakaya ekleyin. Tek bir duraklamış paketin her senkronizasyondan sonra yeni bir görev oluşturmasını önlemek için yinelenen uyarıları aynı açık sorun altında gruplayın.
Uyarıları rastgele zamanlayıcılara değil, hizmet beklentilerine göre ayarlayın
Yeni taraması olmayan bir paketin gecikmiş veya kayıp sayılacağı evrensel bir süre yoktur. Uyarı eşiklerini taşıyıcı hizmetine, teslim alma programına, çalışma günlerine, varış noktasına ve satıcının taahhüdüne göre yapılandırın. Dahili inceleme eşiğini müşteriye yönelik teslimat vaadinden ayrı tutun.
- Teslimden sonra kabul yok: Eskalasyon yapmadan önce teslim alma kaydını ve taşıyıcı onayını kontrol edin.
- Beklenen aralığın ötesinde hareket yok: Son olayı, hizmet beklentilerini ve bilinen operasyonel kesintileri inceleyin.
- Başarısız teslimat girişimi: Sonraki işlemin taşıyıcıya mı, satıcıya mı yoksa alıcıya mı ait olduğuna karar vermeden önce nedeni okuyun.
- İade hareketi: İade iş akışını hazırlayın; ancak fiziksel teslim ve gerekli inceleme tamamlanmadan satılabilir envanteri artırmayın.
- Teslim edildi ancak itiraz edildi: Bir araştırma başlatın ve mevcut teslimat kanıtlarını arayın; yalnızca durumu şikâyetin çözüldüğü şeklinde değerlendirmeyin.
Takip, sürekli paket konumunu değil, bildirilen gönderi olaylarını yansıtır. Son güncelleme zaman damgasını göstermek, canlı GPS görünürlüğü izlenimi vermeden personelin bilginin güncelliğini anlamasına yardımcı olur.
Her ekibe kullanılabilir bir görünüm sağlayın
Depo sorumluları sevkiyattan kabule kadar olan istisnalara ihtiyaç duyar. Taşıma koordinatörleri taşıyıcıya özgü kuyruklara ve bekleyen vakalara ihtiyaç duyar. Satıcı destek ekipleri açık bir gönderi zaman çizelgesine ve üzerinde anlaşılmış sonraki işleme ihtiyaç duyar. Ortak bir veri modeli, her kullanıcının her satıcının gönderilerine erişmesine izin vermeden bu görünümleri destekleyebilir.
Çok müşterili bir depo için satıcı düzeyindeki erişimi yalnızca gösterge tablosu filtreleriyle değil, sunucu tarafında uygulayın. API kimlik bilgilerini tarayıcı kodundan uzak tutun, alıcı bilgilerine erişimi kısıtlayın ve saklama ile silme kurallarını tanımlayın. Takip referanslarına veya tanılama günlüklerine gereksiz kişisel veriler koymaktan kaçının.
Yararlı ölçümler arasında takip için başarıyla kaydedilen sevk edilmiş paketlerin oranı, taşıyıcı kabul olayı bulunanların oranı, sevkiyattan kabule kadar geçen süre, çözülmemiş istisnaların yaşı ve entegrasyon işleme hataları bulunur. Her paydanı ve zaman temelini tanımlayın. Zamanında teslimatı ölçüyorsanız genel bir teslimat süresi yerine belgelenmiş bir vaat veya hizmet taahhüdüyle karşılaştırın.
İş akışını genişletmeden önce pilot uygulama yapın
Açıkça tanımlanmış bir depo, taşıyıcı kümesi ve satıcı grubuyla başlayın. İptal edilen etiketler, bölünmüş siparişler, eksik ilk taramalar, başarısız teslimat girişimleri, yinelenen bildirimler, sırası dışında gelen olaylar ve iadeler gibi zor kayıtların yanı sıra normal teslimatları da dahil edin. Uygun olduğunda yetkili test verilerini veya geçmiş kayıtları kullanın; üretimde taşıyıcı olayları uydurmayın.
Başlatmadan önce kabul kriterleri üzerinde anlaşın. Sevk edilen her paketin ya başarılı bir kayıt kaydı ya da sorumlusu belirlenmiş bir hata vakası olmalıdır. Yeniden oynatılan mesajlar yinelenen görevler oluşturmamalıdır. Takip olayları kaynaklarına kadar izlenebilir kalmalı ve kullanıcılar başka bir satıcının kayıtlarını görmemelidir.
Operasyon personeli istisna kuyruğunu güvenilir biçimde yönetebildiğinde ve teknik personel başarısız güncellemeleri kurtarabildiğinde genişletin. Pratik amaç durumlarla dolu bir gösterge tablosu değildir. Amaç, depo sevkiyatından taşıyıcı teslimatına kadar izlenebilir bir bağlantı ve bu yolculuk ilgi gerektirdiğinde açık sorumluluktur.
SSS
Bir takip API'si depo yönetim sisteminin yerini alabilir mi?
Hayır. Bir takip API'si gönderi görünürlüğü sağlar. Depo sistemi envanter kontrolü, toplama, paketleme ve fiziksel sevkiyat kayıtları gibi faaliyetlerden sorumlu olmaya devam eder. Taşıyıcı olaylarının depo kanıtlarının yerini almadan bağlam eklemesi için ikisini paket tanımlayıcıları üzerinden bağlayın.
Bir takip API'si gerçek zamanlı GPS konumu sağlar mı?
Bunu varsaymayın. Paket takibi genellikle bildirilen olaylardan ve konumlardan oluşur. Güncelleme zamanlaması taşıyıcıya ve entegrasyona bağlıdır. Sürekli araç veya paket konumu ayrıca doğrulanmış bir yetenek gerektirir.
Bir pakette takip güncellemesi olmadığında personel ne yapmalıdır?
Önce kayıt başarısını, taşıyıcı kimliğini ve takip numarasının doğruluğunu kontrol edin. Ardından son olayı depo teslim kanıtı ve beklenen hizmet zaman çizelgesiyle karşılaştırın. Hangi ekibin eskalasyon yapması gerektiğine karar vermeden önce entegrasyon hatalarını eksik taşıyıcı taramalarından ayrı araştırın.
Takip olayları otomatik olarak geri ödemeleri veya envanter güncellemelerini tetikleyebilir mi?
Bir iş akışını bilgilendirebilirler, ancak sonuç doğuran işlemler ek kontroller gerektirir. Bir teslimat istisnası mutlaka geri ödeme hakkı oluşturmaz ve iade hareketi fiziksel depo teslimini kanıtlamaz. Para veya stok kayıtlarını değiştirmeden önce satıcı politikalarını, yetkilendirme kontrollerini ve kabul prosedürlerini uygulayın.
Bölünmüş siparişler satıcı destek ekiplerine nasıl görünmelidir?
Her paketi üst siparişin altında ayrı ayrı gösterin. Bir paketin teslim edilmesi, başka bir paket transit halinde kaldığında tüm siparişi tamamlandı olarak işaretlememelidir. Yenileme ve iade gönderilerini bağlantılı ancak ayırt edilebilir tutun.
Kaynaklar
- 17TRACK Tracking API — takip API'si entegrasyon seçeneği için resmî ürün referansı.
- 17TRACK API Documentation — kayıt, takip istekleri, güncelleme işlemleri ve uygulama gereksinimlerini doğrulamak için teknik referans. Bu kılavuzdaki operasyonel iş akışları ve uyarı kuralları önerilerdir; sağlayıcının veya taşıyıcının davranışları için garanti değildir.


