Tracking API, gönderim etiketleri olmadan çalışabilir mi? 3PL ve pazaryeri siparişleri takip edilebilir mi?
Evet. Bir taşıma API'si, işletmeniz gönderi etiketi oluşturmasa da çalışabilir; bunun için bir taşıyıcının veya gönderi ortağının takip edilebilir bir gönderi oluşturmuş olması ve API'nin desteklediği kullanılabilir bir takip numarasına ya da başka bir tanımlayıcıya erişebilmeniz gerekir. Bu durum, bir üçüncü taraf lojistik sağlayıcısının (3PL) veya pazaryerinin gönderim işlemlerini yönettiği durumlarda yaygındır. Buradaki ayrım, ile hiçbir gönderi tanımlayıcısına sahip olmamanız arasındadır: ilki genellikle uygulanabilirdir; ikincisi ise API'nin takip edebileceği hiçbir şey bırakmayabilir.

Bir satıcı, pazaryeri işletmecisi veya entegrasyon ekibi için pratik görev, her siparişi onu fiilen gönderen tarafça oluşturulan gönderiyle ilişkilendirmektir. Bunun için etiket oluşturma üzerinde kontrol sahibi olmanız değil, doğru verilere erişiminiz olması gerekir.
Etiketi oluşturmadığınızda bir takip API'sinin ihtiyaç duyduğu şeyler
Bir gönderi etiketi, gönderi tanımlayıcısı üretmenin yollarından biridir; ancak normalde bir takip API'sinin okuduğu girdi bu değildir. Takip entegrasyonları genellikle etiket başka bir yerde oluşturulduktan sonra sağlanan gönderi verileriyle çalışır. Bağlantıyı tasarlamadan önce, çoğu zaman birbirinin yerine kullanılabilen üç kaydı birbirinden ayırın:
- Sipariş kimliği: Mağazanızdaki, pazaryeri hesabınızdaki veya sipariş yönetim sisteminizdeki bir satın alımı tanımlar. Birden fazla ürünü ve birden fazla gönderiyi kapsayabilir.
- Karşılama veya paket kimliği: Bir 3PL ya da pazaryeri sistemindeki bir karşılama işlemini veya paketi tanımlar. Biçimi ve anlamı ilgili sisteme bağlıdır.
- Taşıyıcı takip numarası: Taşıyıcının ve takip hizmetinin bu numarayı kabul etmesi koşuluyla, takip amacıyla bir gönderiyi tanımlar.
Dahili sipariş kimliğiniz, doğru müşteri siparişini bulmanıza yardımcı olur. Bu kimlik otomatik olarak bir taşıyıcı takip numarası işlevi görmez. Yaygın entegrasyon modeli, takip numarasını 3PL'den veya pazaryerinden almak, bu numarayı takip API'si üzerinden kaydetmek ya da sorgulamak ve döndürülen gönderi bilgilerini ilgili sipariş veya paketle ilişkilendirerek saklamaktır.
Bir taşıyıcı adı veya kodu da gerekli olabilir. Bazı hizmetler taşıyıcıyı otomatik olarak belirlemeyi deneyebilir; ancak özellikle tanımlayıcılar taşıyıcılar arasında çakıştığında veya bir sipariş birden fazla teslimat ağı üzerinden ilerlediğinde bu durum varsayılmak yerine test edilmelidir. Bir uygulamaya karar vermeden önce API'nin kabul ettiği tanımlayıcıları, taşıyıcı seçimi kurallarını, kayıt gerekliliklerini ve durum alanlarını belgelerinden kontrol edin.
3PL tarafından gönderilen siparişleri takip etme
Bir 3PL siparişi paketlediğinde, etiketi satın aldığında ve paketi taşıyıcıya teslim ettiğinde işletmeniz etiketi hiç görmeyebilir. Yine de bu süreç sonucunda oluşan gönderi ayrıntılarına ihtiyacınız vardır. 3PL'ye takip numaralarını, taşıyıcı bilgilerini, paket tanımlayıcılarını ve karşılama talebinde bulunurken sağladığınız sipariş referansını hangi sistemin veya veri akışının sunduğunu sorun.
Uygulanabilir bir 3PL akışı genellikle şöyledir:
- Mevcut karşılama süreciniz üzerinden siparişi ve kalıcı bir referansı 3PL'ye gönderin.
- Paket düzeyinde takip numarasını ve mevcutsa taşıyıcıyı içeren bir karşılama onayı alın.
- Bu paketi doğru müşteri siparişi ve ürünlerle eşleştirin.
- Desteklenen gönderi tanımlayıcısını takip API'sine gönderin veya API'nin öngördüğü arama sürecini kullanın.
- Takip güncellemelerini paketle ilişkilendirerek kaydedin, ardından operasyon ekibinize veya müşterinize sipariş düzeyinde bir görünüm sunun.
Eşleştirme adımı özellikle dikkat gerektirir. Tek bir sipariş depodan iki koli halinde çıkabilir veya bir ürün diğerlerinden daha geç gönderilebilir. Her iki durumda da tüm siparişi doğru biçimde açıklayan tek bir paket durumu yoktur. Paket düzeyindeki kayıtları koruyun ve sipariş düzeyindeki mesajları bunlardan türetin. Örneğin, yalnızca ilk paketi teslim edildi diye siparişi teslim edilmiş olarak işaretlemeyin.
Düzeltmelerin nasıl iletileceği konusunda 3PL ile anlaşın. Etiketler iptal edilebilir, paketler yeniden paketlenebilir ve ilk takip numarası değiştirilebilir. Entegrasyonunuz, yeni numarayı aynı siparişle ilişkilendirebilmeli ve her iki numarayı da süresiz olarak etkin gönderiler şeklinde göstermemelidir.
Pazaryeri gönderimi kontrol ettiğinde pazaryeri siparişlerini takip etme
Pazaryeri gönderimi benzer bir teknik soru, ancak farklı bir erişim sorusu ortaya çıkarır. Pazaryeri veya onun karşılama ortağı etiketi oluşturabilir; ancak satıcı yalnızca hesabının, sipariş iş akışının veya yetkilendirilmiş entegrasyonunun sunduğu gönderi ayrıntılarını alabilir. Bir takip API'si, pazaryerinin size sunmadığı bir takip numarasını sağlayamaz.
Her sipariş için karşılama modelini belirleyerek başlayın. Satıcı tarafından gönderilen siparişlerde paket verilerinin kaynağı kendi gönderim iş akışınız veya 3PL olabilir. Pazaryeri tarafından gönderilen siparişlerde ise gönderi bilgilerinin kaynağı pazaryeri olabilir ve satıcıya sunulan alanlar farklılık gösterebilir. Sipariş sayfasında teslimat durumunun görünmesinin, ayrı bir API'ye kaydedilmeye uygun bir taşıyıcı takip numarasının da sağlandığı anlamına geldiğini varsaymayın.
Pazaryeri takip edilebilir bir numara sağlıyorsa, bunu amaçladığınız sistemde almanıza ve kullanmanıza izin verildiğini doğrulayın. Ardından takip API'sinin bu tanımlayıcıyı kabul edip etmediğini ve ortaya çıkan olayların pazaryeri durumunun ötesinde yararlı bilgiler sağlayıp sağlamadığını test edin. Pazaryeri yalnızca kendi sipariş veya teslimat referansını sunuyorsa, açıkça desteklenen bir arama yöntemi olup olmadığını kontrol edin. Dahili pazaryeri sipariş kimliğini taşıyıcı numarasıymış gibi göndermeyin ve güvenilir sonuç beklemeyin.
Pazaryerinin sipariş durumunu ve takip API'sinin gönderi durumunu ayrı tutun. Pazaryeri, karşılama onaylandıktan sonra bir siparişi gönderildi olarak tanımlayabilirken taşıyıcı takibi hâlâ kabul taraması göstermeyebilir. Bu kayıtlar farklı soruları yanıtlar ve farklı zamanlarda güncellenebilir.
Etiketsiz takibin sorunu çözmeyeceği durumlar
“Etiketi bizim oluşturmamış olmamız” bir engel değildir. Aşağıdaki durumlar engel olabilir:
- Hiçbir gönderi oluşturulmamış olması: Karşılama işlemi kullanılabilir bir tanımlayıcı üretmeden önce sorgulanabilecek bir taşıyıcı gönderisi olmayabilir. Yalnızca sipariş onayı, bir paketin taşıma sürecinde olduğunun kanıtı değildir.
- Tanımlayıcının sizin için mevcut olmaması: Bir 3PL veya pazaryeri numarayı elinde tutabilir ve yetkilendirilmiş iş akışınız üzerinden size sunmayabilir. Bu veri erişimi sorununu kaynağında çözün.
- Tanımlayıcının desteklenmemesi: Bir referans numarası, yalnızca pazaryerine ait bir kod veya desteklenmeyen bir taşıyıcı biçimi seçilen API ile çalışmayabilir. Kabul edilen girdileri belgelerde ve bir test gönderisiyle doğrulayın.
- Paketin henüz yeni bir taramaya sahip olmaması: Bir numara, taşıyıcı kabul olayı kaydetmeden önce oluşturulabilir. Boş veya değişmemiş bir sonucu, numaranın geçersiz olduğuna dair otomatik kanıt olarak değil, incelenmesi gereken bir durum olarak değerlendirin.
- Takibin kısıtlı veya eksik olması: Taşıyıcı, hizmet veya gönderi iş akışı, müşteriye sunacağınız kullanım senaryosunun gerektirdiği olayları sağlamayabilir. Gerçek olay kalitesini temsili gönderiler kullanarak doğrulayın.
Bu sınırlar önemlidir; çünkü bir API eksik fiziksel olayları oluşturamaz veya başka bir tarafın sipariş verilerine erişim sağlayamaz. API'nin değeri, gerekli tanımlayıcı ve izinler mevcut olduğunda desteklenen takip bilgilerini alıp düzenlemesinde yatar.
Bu iş akışı için bir API nasıl değerlendirilir?
17TRACK'in Tracking API'si, ekibinizin etiket satın alma aracı yerine kendi sistemlerinde gönderi takip verilerine ihtiyaç duyduğu durumlarda incelenmeye değer bir seçenektir. geliştirici belgeleri, kabul edilen kayıt alanlarını, desteklenen taşıyıcıları, yanıt yapısını, kimlik doğrulamayı ve kullanım senaryonuz için mevcut güncelleme iletim yöntemlerini doğrulamanız gereken yerdir. Genel bir takip API'sinin varlığından belirli bir 3PL, pazaryeri veya özel tanımlayıcı için destek olduğu sonucunu çıkarmayın.
Herhangi bir sağlayıcıyı seçmeden veya devreye almadan önce küçük bir test grubu oluşturun. Taşıyıcı numarasına sahip bir 3PL siparişini, hesabınızın numara sunduğu bir pazaryeri siparişini, birden fazla paket içeren bir siparişi, ilk taramasından önce oluşturulmuş bir numarayı ve daha sonraki teslimat olayına sahip bir gönderiyi dahil edin. Değişiklikler veya uluslararası aktarmalar olağansa bunları da ekleyin. Test yalnızca bir isteğin başarılı bir HTTP yanıtı döndürüp döndürmediğini değil, operasyonel soruları da yanıtlamalıdır:
- Gerçekte aldığınız tanımlayıcıları manuel olarak yeniden yazmadan iletebiliyor musunuz?
- Her takip kaydını doğru sipariş ve paketle güvenilir biçimde ilişkilendirebiliyor musunuz?
- Olay açıklamaları, zaman damgaları ve taşıyıcı bilgileri müşteri mesajlarınız ve destek iş akışlarınız için yeterli mi?
- Sisteminiz yinelenen güncellemeleri, eksik olayları, numara değişikliklerini ve başarısız istekleri nasıl yönetecek?
- Pazaryeri ve müşteri verilerini amaçlanan kullanımınız, bu veriler için geçerli erişim koşullarına uygun mu?
Entegrasyonun kendisi için hem orijinal kaynak kaydını hem de takip API'si kaydını koruyun. Sipariş referansını, paket referansını, gönderilen takip numarasını, mevcutsa taşıyıcı bilgilerini ve her güncellemenin alındığı zamanı saklayın. Böylece bir uyumsuzluğu araştırmak kolaylaşır ve bir API olayının tüm karşılama geçmişiymiş gibi sunulması önlenir. API, belirli aralıklarla kontrol etme ile desteklenen bir iletim mekanizması üzerinden güncelleme alma arasında seçim sunuyorsa, tercihinizi belgelenen davranışa ve zamanında güncelleme ihtiyacınıza göre yapın; iki yaklaşım da hata yönetimi gereksinimini ortadan kaldırmaz.
Pratik karar
Başka bir taraf paketi gönderiyor ve size kullanma yetkinizin bulunduğu desteklenen bir gönderi tanımlayıcısı veriyorsa etiket oluşturmadan bir takip API'si kullanın. Önce 3PL'den veya pazaryerinden güvenilir bir paket veri akışı sağlayın. Ardından tanımlayıcıları ve takip olaylarını API'nize ve sipariş eşleştirme mantığınıza göre test edin. Elinizde yalnızca bir sipariş kimliği veya pazaryeri durumu varsa, taşıyıcı takibi entegrasyonuna yatırım yapmadan önce kaynak verilerindeki bu boşluğu giderin.
SSS
Bir siparişi yalnızca mağazamın sipariş numarasını kullanarak takip edebilir miyim?
Genellikle bir taşıyıcı takip API'si üzerinden bunu yapamazsınız. Mağazanızın sipariş numarası, satın alımı kendi sisteminizde tanımlar. Belirli hizmet açıkça sizin sipariş referansı türünüzle aramayı desteklemiyorsa genellikle ilgili gönderi tanımlayıcısına ihtiyacınız vardır.
3PL'nin takip numaralarını kullanmak için iznine ihtiyacım var mı?
Gönderi verilerine sözleşmesel ve teknik erişiminizi doğrulayın. Bir 3PL, karşılama veri akışının parçası olarak takip numaralarını zaten döndürüyor olabilir; ancak entegrasyon yetkilendirilmiş bir kanal kullanmalı ve müşteri verilerini uygun şekilde ele almalıdır.
3PL bir numara gönderdikten sonra API neden hiçbir hareket göstermiyor?
Numara, taşıyıcının ilk kaydedilen taramasından önce oluşturulmuş olabilir. Tanımlayıcının ve taşıyıcının doğru olup olmadığını, ilk etiketin değiştirilip değiştirilmediğini ve daha sonraki bir sorgunun olay üretip üretmediğini kontrol edin. Karşılama kaydını incelemeden “henüz tarama yok” durumunu “gönderilmedi” ile eş anlamlı kabul etmeyin.
Bir pazaryeri siparişi birkaç paket halinde gönderilirse ne olur?
Mevcut her paket tanımlayıcısını ayrı ayrı takip edin ve tüm paketleri aynı siparişle ilişkilendirin. Tek bir teslim edilmiş paketin tüm siparişin tamamlanmış görünmesine neden olmaması için müşteriye sunulan sipariş durumunu münferit paket durumundan ayrı tutun.
Kaynaklar
- 17TRACK Tracking API — gönderi takip entegrasyonunu değerlendirmeye yönelik ürün bilgileri.
- 17TRACK API Documentation — kabul edilen girdileri ve entegrasyon davranışını kontrol etmeye yönelik teknik referans.


