Hava Kargosu ve Sınır Ötesi Paket Takibi: Hangi API Yeteneklerine İhtiyacınız Var?
Uygulamanızın hava konşimentolarını, uçuş etaplarını, kargo elleçleme kilometre taşlarını ve sevkiyat miktarlarını takip etmesi gerektiğinde hava kargo takip API'sini seçin. Taşıyıcılar arasında paket düzeyinde güncellemeler, teslimat istisnaları ve son kilometre teslimat durumuna ihtiyaç duyduğunuzda sınır ötesi paket takip API'sini seçin. Gönderileriniz konsolide hava taşımacılığını bireysel paket teslimatıyla birleştiriyorsa her iki görünürlük katmanına ve tanımlayıcılarını birbirine bağlamak için güvenilir bir yönteme ihtiyacınız vardır.
Mühendislik ekipleri, lojistik operatörleri ve e-ticaret işletmeleri için satın alma kararı, hangi API'nin daha fazla olay döndürdüğünden çok, bu olayların gerçekten yönettiğiniz sevkiyat birimini açıklayıp açıklamadığıyla ilgilidir. Bir havayolunun varış olayı tek başına müşteriye paketinin nerede olduğunu veya kapısına ne zaman ulaşacağını söyleyemez.
Taşıma moduyla değil, sevkiyat birimiyle başlayın
Hava kargosu ve sınır ötesi paketler birbirini dışlayan gönderi kategorileri değildir. Bir paket uluslararası olarak uçakla taşınabilirken havayolu bunu daha büyük bir konsolide sevkiyatın parçası olarak ele alabilir. API seçimindeki ayrım, takip edilen operasyonel nesnedir.
Hava kargosu görünürlüğü genellikle bir hava konşimentosu ve ilişkili taşıma hareketi etrafında şekillenir. Kaynağa bağlı olarak veriler kabul, kalkış, varış, kargonun kullanılabilir olması ve teslimi açıklayabilir. Paket görünürlüğü ise bireysel paketlere ve bunların teslim alma, uluslararası taşıma, varış noktası işlemleri ve teslimat sürecindeki ilerlemesine odaklanır.
Bir ana hava konşimentosu, birden fazla alt sevkiyatı içeren konsolide bir hareketi temsil edebilir. Alt hava konşimentoları, paket etiketleri ve varış noktası taşıyıcısının takip numaraları bu hareket içindeki farklı seviyeleri tanımlayabilir. Bir takip sağlayıcısının tüm bu ilişkileri otomatik olarak keşfedebileceğini veya birbirine bağlayabileceğini varsaymayın.
| Karar alanı | Hava kargo takibi | Sınır ötesi paket takibi |
|---|---|---|
| Birincil nesne | Hava konşimentosu, konsinye veya taşıma etabı | Bireysel paket ve taşıyıcı tanımlayıcıları |
| Operasyonel sorular | Kargo kabul edildi mi, uçtu mu, vardı mı veya teslim edildi mi? | Paket nerede, onu ne engelliyor ve teslim edildi mi? |
| Korunması gereken ilişkiler | Ana ve alt referanslar, etaplar, parçalar ve bölünmüş hareketler | Sipariş-paket bağlantıları, taşıyıcı teslimleri, değiştirme tanımlayıcıları ve iadeler |
| Tipik aksiyon sahibi | Forwarding, taşıma veya kargo operasyonları ekibi | E-ticaret operasyonları, müşteri hizmetleri veya teslimat yönetimi ekibi |
| Ana yorumlama riski | Tek bir etabı veya kısmi varışı tüm sevkiyatın tamamlanması olarak değerlendirmek | Teslimi veya belirsiz teslimat olayını alıcının teslim alması olarak değerlendirmek |
Bir hava kargo takip API'si neleri desteklemelidir?
Hava konşimentosu kimliği ve sevkiyat ilişkileri
API'nin hangi tanımlayıcıları kabul ettiğini ve her aramanın ne döndürdüğünü sorun. Ana hava konşimentosu desteği, alt düzey görünürlüğün desteklendiğini otomatik olarak göstermez. Operasyonlarınız alt sevkiyatlara bağlıysa kendi referanslarınızı ve yetkili veri kaynaklarını kullanarak bir gösterim talep edin.
Veri modeli, sevkiyat ile taşıma etapları ve ayrı hareket eden bölümleri arasındaki ilişkileri korumalıdır. Miktara duyarlı iş akışlarında parça sayılarının ve ağırlıkların sevkiyat düzeyinde, olay düzeyinde veya her ikisinde mevcut olup olmadığını sorun. Sevkiyat düzeyindeki toplam, belirli bir havalimanına ne kadar kargonun ulaştığını bilmenin yerine geçmez.
Taşıma etabı ve elleçleme görünürlüğü
Bir aktarma kalkışını çıkış kalkışından, planlanan hareketi gerçek hareketten ayırt etmeye yetecek bağlamı isteyin. Yararlı alanlar çıkış ve varış havalimanlarını, uçuş referanslarını, olay konumlarını ve planlanan-gerçek zaman damgalarını içerebilir. Kullanılabilirlikleri kaynağa bağlıdır ve varsayılmak yerine doğrulanmalıdır.
Ayrıca uçuş hareketi ile kargo hareketini birbirinden ayırın. Bir uçağın varması tek başına ilişkili her sevkiyatın yüklendiğini, boşaltıldığını, işlendiğini veya kullanıma sunulduğunu kanıtlamaz. Bir olayın sevkiyata özgü mü yoksa uçuş akışından türetilmiş mi olduğunu sorun.
Kısmi hareketler ve kilometre taşı anlamı
Bir kargo sevkiyatı parçalar halinde hareket edebilir. Sırf bir kısmı için varış olayı mevcut diye sisteminiz tüm konsinyeyi varmış olarak işaretlememelidir. API'nin birden fazla uçuşu, kısmi miktarları, değiştirilmiş rotaları ve düzeltmeleri nasıl temsil ettiğini test edin.
Kilometre taşı tanımları da benzer incelemeyi gerektirir. Bir forwarding kuruluşuna veya başka bir lojistik tarafa teslim, nihai alıcıya teslim anlamına gelmez. Sağlayıcıdan tamamlanma olaylarının operasyonel anlamını açıklamasını isteyin ve bu anlamı dahili durum modelinizde koruyun.
IATA'nın ONE Record girişimi, kargo veri paylaşımı ve standartlaştırılmış veri yapıları için ilgili bir sektör referansı sağlar. Ancak bir standart iddiası her havayoluna, elleçleme kuruluşuna, sevkiyata veya kilometre taşına erişimin kanıtı değildir. Hangi uygulamanın, veri ilişkilerinin, izinlerin ve operasyonel kaynakların gerçekten mevcut olduğunu sorun.
Sınır ötesi paket takip API'si neleri desteklemelidir?
Taşıyıcı tanımlama ve teslim sürekliliği
Uluslararası paket yolculuklarında çıkış operatörü, sınır ötesi lojistik sağlayıcısı ve varış noktası teslimat taşıyıcısı bulunabilir. Bir entegrasyon, tanımlayıcı veya sorumlu taşıyıcı değiştiğinde sürekliliği korumanıza yardımcı olmalıdır.
API'nin sonraki taşıyıcıların takip numaralarını, taşıyıcı ilişkilerini mi yoksa yalnızca gönderdiğiniz tanımlayıcıya ait olayları mı döndürdüğünü kontrol edin. Bu ilişkiler kullanılamıyorsa bunları gönderim platformunuzun, deponuzun veya lojistik ortağınızın sağlayıp sağlayamayacağını belirleyin. Test etmeden otomatik uçtan uca bağlantı sözü vermeyin.
Taşıyıcı tespitinin de bir geri dönüş yöntemi olmalıdır. Benzer takip numarası kalıpları belirsizlik yaratabilir; bu nedenle entegrasyonunuz, desteklendiğinde açık taşıyıcı seçimine veya belgelenmiş başka bir ayrıştırma yöntemine izin vermelidir.
Orijinal kanıtlarla normalleştirilmiş durumlar
Ortak bir durum modeli, taşıyıcılar arasında bildirimleri otomatikleştirmeyi kolaylaştırır. Ancak normalleştirme, orijinal olay açıklamasını, konumu, zaman damgasını veya kaynak taşıyıcıyı silmemelidir.
Örneğin geniş kapsamlı bir istisna durumu adres sorununu, gümrük kaynaklı bir gecikmeyi veya başarısız teslimat girişimini temsil edebilir. Bunlar farklı eylemler gerektirir. Orijinal mesajı koruyun ve belirli istisna kategorilerini yalnızca kaynak bunları desteklediğinde kullanın.
Teslimat sonuçları ve uygulanabilir istisnalar
Paket ekiplerinin genellikle dağıtıma çıktı, teslimat denendi, teslim alma için hazır, teslim edildi ve iadeyle ilgili olayları birbirinden ayırması gerekir. API'nin hangi ayrımları sunduğunu ve bunların kullandığınız taşıyıcılar arasında tutarlı olup olmadığını sorun.
Teslimat kanıtını ayrı bir gereksinim olarak ele alın. Teslim edildi durumu imza, fotoğraf, alıcı adı veya belgeye erişimi garanti etmez. İlgili hizmetler için kullanılabilirliği, erişim izinlerini, saklama süresini ve gizlilik kısıtlamalarını doğrulayın.
Gümrük bilgilerinin de sınırları vardır. Gümrükten bahseden bir takip olayı, beyan kaydı, vergilerin açıklaması veya güvenilir bir serbest bırakma tahmini sağlamayabilir. Eskalasyon kurallarını varsayılan yasal veya gümrük sonucuna değil, olayın gerçekten söylediği şeye göre oluşturun.
Her iki API türünün ihtiyaç duyduğu yetenekler
Güvenilir olay alımı ve kurtarma
Olay odaklı iş akışları için webhook teslimini, kimlik doğrulamayı, yeniden denemeleri, yinelenen olayların işlenmesini ve kesinti sonrası kurtarmayı değerlendirin. Bunlar her sağlayıcının sunduğu varsayılan özellikler değil, doğrulanması gereken satın alma gereksinimleridir.
Tüketicinizi yinelenen ve sırası değişmiş mesajları işleyebilecek şekilde tasarlayın. Olay zamanını sisteminizin güncellemeyi aldığı zamandan ayrı saklayın. Kararlı bir olay tanımlayıcısı yoksa mevcut alanları kullanarak belgelenmiş bir tekilleştirme yaklaşımı tanımlayın.
Bildirimleri kaçırdıktan sonra bir sevkiyatın olay geçmişini alıp alamayacağınızı sorun. Webhook'lar işi tetiklemek için yararlıdır; desteklenen bir alma veya mutabakat süreci, tetikleyici kaçırıldığında kurtarmaya yardımcı olur.
Güncellik, veri kökeni ve zaman damgası işleme
Üç saati birbirinden ayırın: fiziksel olayın gerçekleştiği zaman, kaynağın bunu yayımladığı zaman ve uygulamanızın güncellemeyi aldığı zaman. Her kaynak bu üçünü sunmaz; ancak mevcut zaman damgalarını ayrı tutmak gecikmeleri teşhis etmeyi kolaylaştırır.
Aynı şekilde yeni olay olmamasını başarısız aramadan ayırın. Değişmemiş bir sevkiyat geçmişi, taramalar arasındaki meşru bir boşluğu, kaynak kesintisini, tanınmayan bir tanımlayıcıyı veya entegrasyon sorununu yansıtabilir. Operasyon ekibinizin doğru yanıtı seçebilmesi için yeterli tanılama bilgisine ihtiyacı vardır.
Sunulduğunda saat dilimi bilgilerini koruyun. Bir kaynak zaman damgasında saat dilimi yoksa bu sınırlamayı kaydedin ve bunu sessizce görünüşte kesin bir küresel saate dönüştürmeyin.
Erişim, maliyet ve operasyonel kontroller
Kimlik doğrulamayı, hesap izolasyonunu, veri saklamayı, silme prosedürlerini, hız sınırlarını ve üretim desteği düzenlemelerini doğrulayın. Takip yükleri kişisel bilgiler içerebilir; bu nedenle yalnızca iş akışınızın ihtiyaç duyduğu verileri toplayın ve gösterin.
Ticari koşulları gerçek iş yükünüzle karşılaştırın. Neyin ücretlendirildiğini sorun: kayıtlı sevkiyat, istek, yenileme veya başka bir birim. Geçersiz numaraların, yinelenen kayıtların, yeniden takibin, geçmiş aramalarının ve aşım ücretlerinin nasıl ele alındığını netleştirin. Bu tanımlar olmadan başlık fiyatı güvenilir bir maliyet karşılaştırması değildir.
Bir API ne zaman kullanılmalı, veri kaynakları ne zaman birleştirilmeli?
Kargo odaklı görünürlüğü seçin; ekibiniz hava konşimentosu kilometre taşları, havalimanı elleçlemesi, aktarma başarısızlıkları veya kısmi kargo varışları üzerinde işlem yapıyorsa. Gerekli kargo düzeyindeki ayrıntılar açıkça gösterilmedikçe yalnızca paket takibi bu iş akışları için yeterli bir alternatif değildir.
Paket odaklı görünürlüğü seçin; ekibiniz paket düzeyinde teslimat güncellemelerine, müşteri bildirimlerine, varış noktası taşıyıcısı olaylarına ve teslimat istisnası yönetimine ihtiyaç duyuyorsa. Tek başına hava konşimentosu akışı, alıcıya yönelik teslimat takibi için yeterli değildir.
İkisini birleştirin; uluslararası ana taşıma ve bireysel paket teslimatını yönetiyorsanız. Konsolidasyon ve paketleri için ayrı kayıtlar tutun, ardından bunları kendi lojistik sürecinizin veya doğrulanmış bir iş ortağı akışının sağladığı referanslarla birbirine bağlayın.
Örneğin bir satıcı, varış noktasında bir paket ağına aktarılmadan önce konsolide bir partiyi hava yoluyla gönderebilir. Kargo varışını konsolidasyona kaydedin. Her paketi yalnızca o paketle ilgili kanıt bulunduğunda güncelleyin; partinin havalimanına varışını her sipariş için teslim edildi olayına dönüştürmeyin.
17TRACK'in yeri
Bu mimarinin paket tarafı için 17TRACK's Tracking API, çok taşıyıcılı takip entegrasyonunu değerlendirmek açısından uygundur. Entegrasyonu gerekli tanımlayıcılarınız, yanıt alanlarınız, bildirim iş akışınız ve operasyonel sınırlarınızla karşılaştırmak için resmî API belgelerini kullanın.
Paket API'si değerlendirmesini hava kargo işlevselliğinin teyidi olarak görmeyin. Ana-alt ilişkilerine, uçuş etabı ayrıntılarına veya kısmi parça hareketlerine de ihtiyacınız varsa bu gereksinimler için açık teyit ve örnek yanıtlar isteyin. Bir ürünün doğru rolü, “takip” kelimesinin kapsamıyla değil, kanıtlayabildiği iş akışlarıyla belirlenir.
Taahhütte bulunmadan önce kavram kanıtı çalıştırın
Gerçek taşıyıcılarınızdan, rotalarınızdan ve hizmet türlerinizden temsili sevkiyatlar kullanın. Bilinen sonuçlara sahip tamamlanmış sevkiyatların yanı sıra canlı sevkiyatları da dahil edin. Tek bir basit sevkiyat için başarılı arama, entegrasyonu doğrulamak için yeterli değildir.
- Her olayın desteklemesi gereken kararı tanımlayın. Örnekler arasında kaçırılan bir kargo aktarmasını araştırmak, adres sorunu hakkında alıcıyla iletişime geçmek veya teslimat bildirimi göndermek bulunur.
- Temsili bir test seti oluşturun. İlgili olduğunda taşıyıcı teslimlerini, sessiz dönemleri, teslimat girişimlerini, iadeleri ve kargo bölünmüş hareketlerini dahil edin.
- Nesne düzeyinde doğruluğu kontrol edin. Her olayın uçuş, konsinye, bölüm veya bireysel paket için geçerli olup olmadığını doğrulayın.
- Operasyonel kaynakla karşılaştırın. Eksik kilometre taşlarını, zaman damgalarını, konumları, orijinal mesajları ve düzeltme işlemlerini erişim yetkinizin olduğu taşıyıcı veya iş ortağı kayıtlarıyla karşılaştırın.
- Hata kurtarmayı uygulayın. Yinelenen olayları, gecikmiş olayları, geçersiz tanımlayıcıları, belirsiz taşıyıcıları, webhook kesintilerini ve mutabakatı test edin.
- Ekonomiyi ve sahipliği doğrulayın. Maliyeti iş yükünüz üzerinden tahmin edin ve kaynak verisi sorunları, entegrasyon hataları ve müşteri iletişimi için sorumluluk atayın.
Sonuçları incelemeden önce kabul kriterlerini belirleyin. Bunlar her iş akışı için gerekli alanlarınızı, olay anlamını, kurtarma davranışını ve kabul edilebilir güncelleme gecikmelerini kapsamalıdır. Bir müşteri bildirimi ile kargo müdahalesi farklı eşikler gerektirebilir.
SSS
Tek bir takip API'si hava kargosunu ve paketleri kapsayabilir mi?
Potansiyel olarak evet; ancak her ikisi için veri modelini ve kaynak erişimini doğrulayın. Ortak bir uç nokta, kargo miktarları, uçuş etapları, alt konşimento ilişkileri veya paket teslimleri için desteği kanıtlamaz. İki iş akışı için ayrı gösterimler isteyin.
Bireysel bir paketi takip etmek için hava konşimentosu numarası kullanabilir miyim?
Gerekmez. Bir hava konşimentosu, bireysel paket yerine daha büyük bir konsinyeyi tanımlayabilir. Geçmişlerini birbirine bağlamak için bu konsinye ile paket tanımlayıcısı arasında doğrulanmış bir ilişkiye ihtiyacınız vardır.
“Gerçek zamanlı takip” sürekli fiziksel konum anlamına mı gelir?
Bunu varsaymayın. Takip, sürekli konum telemetrisi yerine aralıklarla yayımlanan operasyonel olaylara dayanabilir. Güncellemeleri neyin tetiklediğini, hangi zaman damgalarının sunulduğunu ve herhangi bir konum verisinin ayrı bir sensör kaynağından gelip gelmediğini sorun.
Webhook'lar polling'den daha mı iyidir?
Webhook'lar, tekrarlanan durum istekleri olmadan olay bildirimleri almak için kullanışlıdır. Polling veya başka bir alma mekanizması yine de mutabakatı ve kurtarmayı destekleyebilir. Tasarımı sağlayıcının belgelenmiş davranışına, sınırlarına ve kaçırılmış veya gecikmiş güncellemelere toleransınıza göre seçin.
Teslim edildi olayı alıcının gönderiyi teslim aldığını kanıtlar mı?
Her bağlamda değil. Kargo tamamlanması bir lojistik tarafa teslimi açıklayabilirken paket teslimat olayları taşıyıcının teslimat sürecine bağlıdır. Olay tanımını doğrulayın ve iş akışınız gerektirdiğinde ayrı teslimat kanıtı alın.
Kaynaklar
- IATA — ONE Record: standartlaştırılmış kargo veri paylaşımı için sektör referansı; belirli bir API'nin kapsamının garantisi değildir.
- 17TRACK — Tracking API: paket takip entegrasyonunu değerlendirmek için resmî ürün referansı.
- 17TRACK — API documentation: uygulama gereksinimlerini doğrulamak için teknik referans.


