Skip to main content
AcasăBlogGhiduriTransport aerian de marfă vs. urmărirea coletelor transfrontaliere: de ce capabilități API aveți nevoie?

Transport aerian de marfă vs. urmărirea coletelor transfrontaliere: de ce capabilități API aveți nevoie?

17TRACK

Alegeți un API de urmărire a mărfurilor aeriene atunci când aplicația dvs. trebuie să urmărească scrisori de transport aerian, segmente de zbor, etapele de manipulare a mărfii și cantitățile expediate. Alegeți un API de urmărire a coletelor transfrontaliere atunci când aveți nevoie de actualizări la nivel de colet între transportatori, excepții de livrare și starea livrării pe ultimul kilometru. Dacă expedierile dvs. combină transport aerian consolidat cu livrarea individuală a coletelor, aveți nevoie de ambele niveluri de vizibilitate și de o modalitate fiabilă de a conecta identificatorii acestora.

Mărfuri aeriene vs. urmărirea coletelor transfrontaliere: ce funcționalități API sunt necesare

Pentru echipele de inginerie, operatorii logistici și companiile de comerț electronic, decizia de achiziție ține mai puțin de API-ul care returnează mai multe evenimente și mai mult de faptul că acele evenimente descriu unitatea de expediere pe care o gestionați efectiv. Un eveniment de sosire al companiei aeriene nu poate, de unul singur, să îi spună unui cumpărător unde se află coletul său sau când va ajunge la ușă.

Începeți cu unitatea de expediere, nu cu modul de transport

Mărfurile aeriene și coletele transfrontaliere nu sunt categorii de expediere reciproc exclusive. Un colet poate călători internațional cu avionul, în timp ce compania aeriană îl gestionează ca parte a unei expedieri consolidate mai mari. Distincția relevantă pentru alegerea API-ului este obiectul operațional urmărit.

Vizibilitatea asupra mărfurilor aeriene se concentrează de obicei pe o scrisoare de transport aerian și pe mișcarea de transport asociată. În funcție de sursă, datele pot descrie acceptarea, plecarea, sosirea, disponibilitatea mărfii și predarea. Vizibilitatea asupra coletelor se concentrează pe colete individuale și pe progresul acestora prin colectare, transport internațional, procesare la destinație și livrare.

O scrisoare de transport aerian principală poate reprezenta o mișcare consolidată care conține mai multe expedieri subiacente. Scrisorile de transport aerian secundare, etichetele coletelor și numerele de urmărire ale transportatorului de la destinație pot identifica niveluri diferite în cadrul acelei mișcări. Nu presupuneți că un furnizor de urmărire poate descoperi sau conecta automat toate aceste relații.

Domeniul decizieiUrmărirea mărfurilor aerieneUrmărirea coletelor transfrontaliere
Obiect principalScrisoare de transport aerian, expediere sau segment de transportColet individual și identificatorii săi de transportator
Întrebări operaționaleA fost marfa acceptată, transportată cu avionul, sosită sau predată?Unde se află coletul, ce îl blochează și a fost livrat?
Relații care trebuie păstrateReferințe principale și secundare, segmente, piese și mișcări divizateLegături comandă–colet, predări între transportatori, identificatori de înlocuire și retururi
Responsabil operațional tipicEchipa de expediere, transport sau operațiuni cargoEchipa de operațiuni ecommerce, servicii pentru clienți sau gestionarea livrărilor
Principalul risc de interpretareConsiderarea unui singur segment sau a unei sosiri parțiale drept finalizare a întregii expedieriConsiderarea unei predări sau a unui eveniment ambiguu de livrare drept primire de către cumpărător

Ce trebuie să accepte un API de urmărire a mărfurilor aeriene

Identitatea scrisorii de transport aerian și relațiile dintre expedieri

Întrebați ce identificatori acceptă API-ul și ce returnează fiecare căutare. Compatibilitatea cu o scrisoare de transport aerian principală nu stabilește automat compatibilitatea cu vizibilitatea la nivel secundar. Dacă operațiunile dvs. depind de expedieri secundare, solicitați o demonstrație folosind propriile referințe și surse de date autorizate.

Modelul de date trebuie să păstreze relațiile dintre expediere, segmentele sale de transport și orice porțiuni care se deplasează separat. Pentru fluxurile în care cantitatea este importantă, întrebați dacă numărul de piese și greutățile sunt disponibile la nivel de expediere, la nivel de eveniment sau la ambele niveluri. Un total la nivel de expediere nu înlocuiește informația despre cantitatea de marfă care a ajuns la un anumit aeroport.

Vizibilitatea segmentelor de transport și a manipulării

Solicitați suficient context pentru a diferenția o plecare de la origine de o plecare în cadrul unei conexiuni și o mișcare planificată de una efectivă. Câmpurile utile pot include aeroporturile de origine și destinație, referințe ale zborului, locațiile evenimentelor și marcajele temporale programate și efective. Disponibilitatea lor depinde de sursă și trebuie verificată, nu presupusă.

De asemenea, diferențiați mișcarea zborului de mișcarea mărfii. Faptul că o aeronavă sosește nu dovedește, de unul singur, că fiecare expediere asociată a fost încărcată, descărcată, procesată sau pusă la dispoziție. Întrebați dacă un eveniment este specific expedierii sau derivat dintr-un flux de date despre zbor.

Mișcări parțiale și semnificația etapelor

O expediere de marfă se poate deplasa în porțiuni. Sistemul dvs. nu ar trebui să marcheze întreaga expediere ca sosită doar pentru că există un eveniment de sosire pentru o parte a acesteia. Testați modul în care API-ul reprezintă zborurile multiple, cantitățile parțiale, rutele revizuite și corecțiile.

Definițiile etapelor necesită aceeași atenție. Predarea către un expeditor sau către o altă parte logistică nu înseamnă neapărat livrarea către destinatarul final. Solicitați furnizorului să explice semnificația operațională a evenimentelor de finalizare și păstrați această semnificație în modelul intern de statusuri.

Inițiativa ONE Record a IATA oferă o referință relevantă a industriei pentru partajarea datelor despre mărfuri și structuri de date standardizate. Totuși, o afirmație privind respectarea standardelor nu dovedește accesul la fiecare companie aeriană, operator, expediere sau etapă. Întrebați ce implementare, relații de date, permisiuni și surse operaționale sunt disponibile în realitate.

Ce trebuie să accepte un API de urmărire a coletelor transfrontaliere

Identificarea transportatorului și continuitatea predării

Călătoriile coletelor internaționale pot implica un operator de origine, un furnizor de logistică transfrontalieră și un transportator de livrare la destinație. O integrare ar trebui să vă ajute să mențineți continuitatea atunci când se schimbă identificatorul sau transportatorul responsabil.

Verificați dacă API-ul returnează numere de urmărire ulterioare, relații între transportatori sau doar evenimente pentru identificatorul transmis. Dacă aceste relații nu sunt disponibile, determinați dacă platforma dvs. de expediere, depozitul sau partenerul logistic le poate furniza. Nu promiteți conectarea automată de la un capăt la altul fără să o testați.

Detectarea transportatorului necesită și o soluție de rezervă. Modelele similare ale numerelor de urmărire pot crea ambiguități, astfel încât integrarea dvs. ar trebui să permită selectarea explicită a transportatorului sau o altă metodă documentată de dezambiguizare, acolo unde este acceptată.

Statusuri normalizate cu dovezi originale

Un model comun de statusuri facilitează automatizarea notificărilor între transportatori. Însă normalizarea nu ar trebui să elimine descrierea originală a evenimentului, locația, marcajul temporal sau transportatorul-sursă.

De exemplu, un status general de excepție poate reprezenta o problemă de adresă, o întârziere legată de vamă sau o încercare nereușită de livrare. Acestea necesită acțiuni diferite. Păstrați mesajul original și utilizați categorii specifice de excepții numai atunci când sursa le acceptă.

Rezultatele livrării și excepțiile care necesită acțiuni

Echipele responsabile de colete trebuie de obicei să diferențieze evenimentele „în curs de livrare”, „livrare încercată”, „disponibil pentru ridicare”, „livrat” și cele legate de retur. Întrebați ce distincții expune API-ul și dacă acestea sunt consecvente între transportatorii utilizați.

Tratați dovada livrării ca pe o cerință separată. Un status „livrat” nu garantează accesul la o semnătură, o fotografie, numele destinatarului sau un document. Confirmați disponibilitatea, permisiunile de acces, păstrarea și restricțiile de confidențialitate pentru serviciile relevante.

Informațiile vamale au, de asemenea, limite. Un eveniment de urmărire care menționează vama nu oferă neapărat un document de declarație, o explicație a taxelor sau o estimare fiabilă a eliberării. Construiți reguli de escaladare pe baza a ceea ce spune efectiv evenimentul, nu pe baza unui rezultat juridic sau vamal presupus.

Funcționalități necesare ambelor tipuri de API

Preluarea fiabilă a evenimentelor și recuperarea

Pentru fluxurile bazate pe evenimente, evaluați livrarea webhook-urilor, autentificarea, reîncercările, gestionarea duplicatelor și recuperarea după o întrerupere. Acestea sunt cerințe de achiziție care trebuie verificate, nu funcționalități presupuse pentru orice furnizor.

Proiectați consumatorul astfel încât să gestioneze mesajele duplicate și sosite în ordine greșită. Stocați separat ora evenimentului și ora la care sistemul dvs. a primit actualizarea. Dacă nu este disponibil un identificator stabil al evenimentului, definiți o abordare documentată de eliminare a duplicatelor folosind câmpurile disponibile.

Întrebați dacă puteți recupera istoricul evenimentelor unei expedieri după ce ați ratat notificări. Webhook-urile sunt utile pentru declanșarea activităților; un proces acceptat de recuperare sau reconciliere este cel care ajută la recuperare atunci când declanșatorul este ratat.

Actualitatea, proveniența și gestionarea marcajelor temporale

Separați trei ceasuri: momentul în care a avut loc evenimentul fizic, momentul în care sursa l-a publicat și momentul în care aplicația dvs. l-a primit. Nu toate sursele le expun pe toate trei, însă păstrarea separată a marcajelor temporale disponibile facilitează diagnosticarea întârzierilor.

De asemenea, diferențiați lipsa unui eveniment nou de o căutare eșuată. Un istoric neschimbat al expedierii poate reflecta un interval legitim între scanări, o întrerupere a sursei, un identificator nerecunoscut sau o problemă de integrare. Echipa dvs. operațională are nevoie de suficiente informații de diagnostic pentru a alege răspunsul potrivit.

Păstrați informațiile despre fusul orar atunci când sunt furnizate. Dacă marcajul temporal al sursei nu are fus orar, înregistrați această limitare în loc să îl convertiți în tăcere într-o oră globală aparent precisă.

Acces, costuri și controale operaționale

Confirmați autentificarea, izolarea conturilor, păstrarea datelor, procedurile de ștergere, limitele de solicitări și condițiile de asistență pentru producție. Datele de urmărire pot include informații personale, așadar colectați și expuneți doar ceea ce necesită fluxul dvs. de lucru.

Comparați condițiile comerciale cu volumul dvs. real de lucru. Întrebați ce este facturabil: o expediere înregistrată, o solicitare, o reîmprospătare sau o altă unitate. Clarificați modul în care sunt tratate numerele invalide, înregistrările duplicate, reurmărirea, căutările istorice și depășirile. Fără aceste definiții, un preț de referință nu reprezintă o comparație de cost fiabilă.

Când să utilizați un singur API și când să combinați sursele de date

Alegeți vizibilitatea axată pe mărfuri atunci când echipa dvs. acționează pe baza etapelor scrisorilor de transport aerian, a manipulării în aeroport, a eșecurilor de conexiune sau a sosirilor parțiale ale mărfii. Urmărirea coletelor nu înlocuiește în mod adecvat aceste fluxuri decât dacă detaliile necesare la nivel de marfă sunt demonstrate explicit.

Alegeți vizibilitatea axată pe colete atunci când echipa dvs. are nevoie de actualizări ale livrării la nivel de colet, notificări pentru clienți, evenimente ale transportatorului de la destinație și gestionarea excepțiilor de livrare. Un flux bazat doar pe scrisori de transport aerian nu este suficient pentru urmărirea livrării destinată cumpărătorului.

Combinați-le pe cele două atunci când gestionați transportul internațional pe distanțe lungi și livrarea individuală a coletelor. Păstrați înregistrări separate pentru consolidare și pentru coletele sale, apoi conectați-le prin referințe furnizate de propriul proces logistic sau de un flux verificat al unui partener.

De exemplu, un comerciant poate expedia un lot consolidat pe cale aeriană înainte de injectarea la destinație într-o rețea de colete. Înregistrați sosirea mărfii pentru consolidare. Actualizați fiecare colet numai atunci când există dovezi relevante pentru acel colet; nu transformați sosirea lotului la aeroport într-un eveniment de livrare pentru fiecare comandă.

Unde se potrivește 17TRACK

Pentru componenta de colete a acestei arhitecturi, 17TRACK's Tracking API este relevant pentru evaluarea integrării urmăririi între mai mulți transportatori. Utilizați documentația oficială a API-ului pentru a verifica integrarea în raport cu identificatorii necesari, câmpurile răspunsului, fluxul de notificări și limitele operaționale.

Nu considerați evaluarea unui API pentru colete drept confirmare a funcționalității pentru mărfuri aeriene. Dacă aveți nevoie și de relații principal–secundar, detalii ale segmentelor de zbor sau mișcări parțiale ale pieselor, solicitați confirmări explicite și răspunsuri de exemplu pentru aceste cerințe. Rolul potrivit al unui produs este determinat de fluxurile pe care le poate susține cu dovezi, nu de amploarea cuvântului „urmărire”.

Realizați o verificare a conceptului înainte de a vă angaja

Utilizați expedieri reprezentative de la transportatorii, pe rutele și cu tipurile de servicii pe care le folosiți efectiv. Includeți atât expedieri finalizate cu rezultate cunoscute, cât și expedieri active. O căutare reușită pentru o singură expediere simplă nu este suficientă pentru validarea integrării.

  1. Definiți decizia pe care trebuie să o susțină fiecare eveniment. Exemplele includ investigarea unei conexiuni cargo ratate, contactarea unui cumpărător cu privire la o problemă de adresă sau trimiterea unei notificări de livrare.
  2. Construiți un set de teste reprezentativ. Includeți predări între transportatori, perioade fără actualizări, încercări de livrare, retururi și mișcări divizate ale mărfii, acolo unde sunt relevante.
  3. Verificați acuratețea la nivel de obiect. Confirmați dacă fiecare eveniment se aplică unui zbor, unei expedieri, unei porțiuni sau unui colet individual.
  4. Comparați cu sursa operațională. Verificați etapele lipsă, marcajele temporale, locațiile, mesajele originale și gestionarea corecțiilor în raport cu înregistrările transportatorului sau ale partenerului la care aveți acces autorizat.
  5. Testați recuperarea în caz de defecțiune. Testați evenimente duplicate, evenimente întârziate, identificatori invalizi, transportatori ambigui, întreruperi ale webhook-urilor și reconcilierea.
  6. Validați aspectele economice și responsabilitatea. Estimați costul pe baza volumului dvs. de lucru și atribuiți responsabilitatea pentru problemele datelor-sursă, erorile de integrare și comunicarea cu clienții.

Stabiliți criteriile de acceptare înainte de a analiza rezultatele. Acestea ar trebui să acopere câmpurile necesare, semnificația evenimentelor, comportamentul de recuperare și întârzierile acceptabile ale actualizărilor pentru fiecare flux. O notificare pentru client și o intervenție asupra mărfii pot necesita praguri diferite.

Întrebări frecvente

Poate un singur API de urmărire să acopere mărfurile aeriene și coletele?

Este posibil, dar confirmați modelul de date și accesul la surse pentru ambele. Un punct final comun nu dovedește compatibilitatea cu cantitățile de marfă, segmentele de zbor, relațiile la nivel secundar sau predările coletelor. Solicitați demonstrații separate pentru cele două fluxuri.

Pot folosi un număr de scrisoare de transport aerian pentru a urmări un colet individual?

Nu neapărat. O scrisoare de transport aerian poate identifica o expediere mai mare, nu un colet individual. Aveți nevoie de o relație verificată între acea expediere și identificatorul coletului pentru a le conecta istoricele.

„Urmărirea în timp real” înseamnă o locație fizică continuă?

Nu presupuneți acest lucru. Urmărirea se poate baza pe evenimente operaționale publicate la intervale, nu pe telemetrie de localizare continuă. Întrebați ce declanșează actualizările, ce marcaje temporale sunt expuse și dacă datele de localizare provin dintr-o sursă separată de senzori.

Sunt webhook-urile mai bune decât interogarea periodică?

Webhook-urile sunt utile pentru primirea notificărilor despre evenimente fără solicitări repetate de status. Interogarea periodică sau un alt mecanism de recuperare poate susține în continuare reconcilierea și recuperarea. Alegeți o structură pe baza comportamentului și limitelor documentate ale furnizorului și a toleranței dvs. pentru actualizări ratate sau întârziate.

Dovedește un eveniment „livrat” că cumpărătorul a primit expedierea?

Nu în toate situațiile. Finalizarea transportului cargo poate descrie predarea către o parte logistică, în timp ce evenimentele de livrare a coletelor depind de procesul de livrare al transportatorului. Verificați definiția evenimentului și obțineți dovezi separate de livrare atunci când fluxul dvs. o impune.

Surse

  • IATA — ONE Record: referință a industriei pentru partajarea standardizată a datelor despre mărfuri; nu reprezintă o garanție privind acoperirea unui anumit API.
  • 17TRACK — Tracking API: referință oficială a produsului pentru evaluarea unei integrări de urmărire a coletelor.
  • 17TRACK — API documentation: referință tehnică pentru validarea cerințelor de implementare.