Lentorahti vs. rajat ylittävien pakettien seuranta: mitä API-ominaisuuksia tarvitset?
Valitse lentorahtiseurannan API, kun sovelluksesi on seurattava lentorahtikirjoja, lentoreittejä, rahdinkäsittelyn virstanpylväitä ja lähetysmääriä. Valitse rajat ylittävien pakettien seurannan API, kun tarvitset pakettikohtaisia päivityksiä eri kuljetusliikkeiltä, toimituspoikkeamia ja viimeisen toimitusvaiheen tilan. Jos lähetyksissäsi yhdistyvät konsolidoitu lentorahti ja yksittäisten pakettien toimitus, tarvitset molemmat näkyvyystasot sekä luotettavan tavan yhdistää niiden tunnisteet.
Tekniikkatiimeille, logistiikkaoperaattoreille ja verkkokauppayrityksille ostopäätös ei niinkään koske sitä, mikä API palauttaa enemmän tapahtumia, vaan sitä, kuvaavatko tapahtumat todella sitä lähetysyksikköä, jota hallinnoitte. Lentoyhtiön saapumistapahtuma ei yksinään kerro ostajalle, missä hänen pakettinsa on tai milloin se saapuu perille.
Aloita lähetysyksiköstä, älä kuljetusmuodosta
Lentorahti ja rajat ylittävät paketit eivät ole toisensa poissulkevia toimitusluokkia. Paketti voi matkustaa kansainvälisesti lentokoneella, samalla kun lentoyhtiö käsittelee sitä osana suurempaa konsolidoitua lähetystä. API-valinnan kannalta ratkaisevaa on seurattava operatiivinen kohde.
Lentorahdin näkyvyys keskittyy yleensä lentorahtikirjaan ja siihen liittyvään kuljetusliikkeeseen. Lähteestä riippuen tiedot voivat kuvata vastaanottoa, lähtöä, saapumista, rahdin saatavuutta ja luovutusta. Pakettien näkyvyys keskittyy yksittäisiin paketteihin ja niiden etenemiseen noudosta kansainväliseen kuljetukseen, määränpään käsittelyyn ja toimitukseen.
Master-lentorahtikirja voi edustaa konsolidoitua kuljetusta, joka sisältää useita taustalla olevia lähetyksiä. House-lentorahtikirjat, pakettitarrat ja määränpään kuljetusliikkeen seurantanumerot voivat tunnistaa kuljetuksen eri tasoja. Älä oleta, että seurannan tarjoaja pystyy automaattisesti löytämään tai yhdistämään kaikki nämä suhteet.
| Päätösalue | Lentorahdin seuranta | Rajat ylittävien pakettien seuranta |
|---|---|---|
| Ensisijainen kohde | Lentorahtikirja, lähetys tai kuljetusosuus | Yksittäinen paketti ja sen kuljetusliikkeen tunnisteet |
| Operatiiviset kysymykset | Vastaanotettiinko rahti, lennätettiinkö se, saapuiko se tai luovutettiinko se? | Missä paketti on, mikä estää sen etenemisen ja toimitettiinko se? |
| Säilytettävät suhteet | Master- ja house-viitteet, osuudet, kappaleet ja jaetut kuljetukset | Tilauksen ja paketin väliset linkit, kuljetusliikkeiden vaihdot, korvaavat tunnisteet ja palautukset |
| Tyypillinen vastuutiimi | Huolinta-, kuljetus- tai rahtitoimintojen tiimi | Verkkokaupan toimintojen, asiakaspalvelun tai toimitusten hallinnan tiimi |
| Suurin tulkintariski | Yhden osuuden tai osittaisen saapumisen käsittäminen koko lähetyksen valmistumiseksi | Luovutuksen tai epäselvän toimitustapahtuman käsittäminen ostajan vastaanotoksi |
Mitä lentorahdin seurannan APIn on tuettava
Lentorahtikirjan tunnistetiedot ja lähetyssuhteet
Selvitä, mitä tunnisteita API hyväksyy ja mitä kukin haku palauttaa. Master-lentorahtikirjan tuki ei automaattisesti tarkoita house-tason näkyvyyden tukea. Jos toimintasi perustuu house-lähetyksiin, vaadi esittely omien viitteidesi ja valtuutettujen tietolähteiden avulla.
Tietomallin tulisi säilyttää lähetyksen, sen kuljetusosuuksien ja erikseen liikkuvien osien väliset suhteet. Määräherkissä työnkuluissa selvitä, ovatko kappalemäärät ja painot saatavilla lähetys-, tapahtuma- vai molemmilla tasoilla. Lähetystason kokonaismäärä ei korvaa tietoa siitä, kuinka paljon rahtia saapui tietylle lentoasemalle.
Kuljetusosuuksien ja käsittelyn näkyvyys
Vaadi riittävästi kontekstia, jotta lähtöpaikan lähtö voidaan erottaa välilaskupaikan lähdöstä ja suunniteltu kuljetus toteutuneesta. Hyödyllisiä kenttiä voivat olla lähtö- ja määränpääasemat, lentoviitteet, tapahtumapaikat sekä aikataulun mukaiset ja toteutuneet aikaleimat. Niiden saatavuus riippuu lähteestä, joten se on varmistettava eikä oletettava.
Erota myös lentokoneen liike rahdin liikkeestä. Lentokoneen saapuminen ei yksinään todista, että jokainen siihen liittyvä lähetys lastattiin, purettiin, käsiteltiin tai asetettiin saataville. Selvitä, koskeeko tapahtuma tiettyä lähetystä vai perustuuko se lentotietosyötteeseen.
Osittaiset kuljetukset ja virstanpylväiden merkitys
Rahtilähetys voi liikkua osissa. Järjestelmän ei pidä merkitä koko lähetystä saapuneeksi vain siksi, että osa siitä on saanut saapumistapahtuman. Testaa, miten API esittää useat lennot, osittaiset määrät, muuttuneet reititykset ja korjaukset.
Myös virstanpylväiden määritelmät vaativat tarkastelua. Luovutus huolitsijalle tai toiselle logistiikkaosapuolelle ei välttämättä tarkoita toimitusta lopulliselle vastaanottajalle. Pyydä palveluntarjoajaa selittämään valmistumistapahtumien operatiivinen merkitys ja säilytä tämä merkitys sisäisessä tilamallissasi.
IATA:n ONE Record -aloite tarjoaa asiaankuuluvan alan viitteen rahtitietojen jakamiseen ja standardoituihin tietorakenteisiin. Standardien noudattamista koskeva väite ei kuitenkaan todista, että saatavilla ovat kaikki lentoyhtiöt, käsittelijät, lähetykset tai virstanpylväät. Selvitä, mikä toteutus, tietosuhteet, käyttöoikeudet ja operatiiviset lähteet ovat tosiasiassa saatavilla.
Mitä rajat ylittävien pakettien seurannan APIn on tuettava
Kuljetusliikkeen tunnistaminen ja luovutusten jatkuvuus
Kansainvälisiin pakettimatkoihin voi liittyä lähtömaan operaattori, rajat ylittävä logistiikkapalveluntarjoaja ja määränpään toimitusliike. Integraation tulisi auttaa säilyttämään jatkuvuus, kun tunniste tai vastuullinen kuljetusliike vaihtuu.
Tarkista, palauttaako API seuraavat seurantanumerot, kuljetusliikkeiden suhteet vai ainoastaan lähettämäsi tunnisteen tapahtumat. Jos nämä suhteet eivät ole saatavilla, selvitä, voiko toimitusalustasi, varastosi tai logistiikkakumppanisi toimittaa ne. Älä lupaa automaattista päästä päähän -linkitystä testaamatta sitä.
Kuljetusliikkeen tunnistaminen tarvitsee myös varamenetelmän. Samankaltaiset seurantanumeromallit voivat aiheuttaa epäselvyyttä, joten integraation tulisi mahdollistaa kuljetusliikkeen nimenomainen valinta tai muu dokumentoitu erottelumenetelmä, jos sitä tuetaan.
Normalisoidut tilat alkuperäisine todisteineen
Yhteinen tilamalli helpottaa ilmoitusten automatisointia eri kuljetusliikkeillä. Normalisointi ei kuitenkaan saa poistaa alkuperäistä tapahtumakuvausta, sijaintia, aikaleimaa tai lähteenä olevaa kuljetusliikettä.
Esimerkiksi laaja poikkeustila voi tarkoittaa osoiteongelmaa, tulliin liittyvää viivästystä tai epäonnistunutta toimitusyritystä. Nämä edellyttävät erilaisia toimia. Säilytä alkuperäinen viesti ja käytä tarkkoja poikkeusluokkia vain, kun lähde tukee niitä.
Toimitustulokset ja toiminnalliset poikkeamat
Pakettitiimien on yleensä erotettava toisistaan jakeluun lähtö, toimitusyritys, noutomahdollisuus, toimitettu ja palautukseen liittyvät tapahtumat. Selvitä, mitä erotteluja API tarjoaa ja ovatko ne yhdenmukaisia käyttämiesi kuljetusliikkeiden välillä.
Käsittele toimitustodistusta erillisenä vaatimuksena. Toimitettu-tila ei takaa allekirjoituksen, valokuvan, vastaanottajan nimen tai asiakirjan saatavuutta. Varmista tarvittavien palvelujen saatavuus, käyttöoikeudet, säilytys ja tietosuojarajoitukset.
Myös tullitiedoilla on rajoituksensa. Tullin mainitseva seurantatapahtuma ei välttämättä tarjoa tulli-ilmoitusta, selvitystä maksuista tai luotettavaa arviota vapautumisesta. Laadi eskalointisäännöt sen perusteella, mitä tapahtuma tosiasiassa sanoo, älä päätellyn oikeudellisen tai tullituloksen perusteella.
Molempien API-tyyppien tarvitsemat ominaisuudet
Luotettava tapahtumien vastaanotto ja palautuminen
Arvioi tapahtumapohjaisissa työnkuluissa webhook-toimitus, tunnistautuminen, uudelleenyritykset, kaksoiskappaleiden käsittely ja palautuminen käyttökatkon jälkeen. Nämä ovat varmistettavia hankintavaatimuksia, eivät ominaisuuksia, joita pitäisi olettaa jokaisen palveluntarjoajan tarjoavan.
Suunnittele kuluttajasi käsittelemään päällekkäiset ja väärässä järjestyksessä saapuvat viestit. Tallenna tapahtuma-aika erikseen siitä ajasta, jolloin järjestelmäsi vastaanotti päivityksen. Jos vakaata tapahtumatunnistetta ei ole saatavilla, määritä dokumentoitu kaksoiskappaleiden poistomenetelmä käytettävissä olevien kenttien avulla.
Selvitä, voitko hakea lähetyksen tapahtumahistorian menetettyjen ilmoitusten jälkeen. Webhookit ovat hyödyllisiä työn käynnistämiseen; tuettu haku- tai täsmäytysprosessi auttaa palautumaan, kun käynnistin jää väliin.
Tuoreus, alkuperä ja aikaleimojen käsittely
Erota kolme kelloa: milloin fyysinen tapahtuma tapahtui, milloin lähde julkaisi sen ja milloin sovelluksesi vastaanotti sen. Kaikki lähteet eivät paljasta kaikkia kolmea, mutta saatavilla olevien aikaleimojen erillään pitäminen helpottaa viiveiden diagnosointia.
Erota myös uuden tapahtuman puuttuminen epäonnistuneesta hausta. Muuttumaton lähetyshistoria voi tarkoittaa luonnollista skannausten välistä taukoa, lähdekatkosta, tunnistamatonta tunnistetta tai integraatio-ongelmaa. Toimintatiimisi tarvitsee riittävästi diagnostiikkatietoja oikean vastauksen valitsemiseen.
Säilytä aikavyöhyketiedot, kun ne toimitetaan. Jos lähteen aikaleimasta puuttuu aikavyöhyke, tallenna tämä rajoitus sen sijaan, että muuntaisit ajan hiljaisesti näennäisen tarkaksi maailmanlaajuiseksi ajaksi.
Käyttöoikeudet, kustannukset ja operatiiviset hallintakeinot
Varmista tunnistautuminen, tilien eristys, tietojen säilytys, poistomenettelyt, nopeusrajat ja tuotantotuen järjestelyt. Seurantakuormat voivat sisältää henkilötietoja, joten kerää ja paljasta vain työnkulkusi tarvitsema tieto.
Vertaa kaupallisia ehtoja todelliseen työmäärääsi. Selvitä, mistä laskutetaan: rekisteröidystä lähetyksestä, pyynnöstä, päivityshausta vai jostain muusta yksiköstä. Tarkenna, miten virheelliset numerot, päällekkäiset rekisteröinnit, uudelleenseuraaminen, histori haut ja kiintiön ylitykset käsitellään. Ilman näitä määritelmiä otsikkohinta ei ole luotettava kustannusvertailu.
Milloin käyttää yhtä APIa ja milloin yhdistää tietolähteitä
Valitse rahtiin keskittyvä näkyvyys, kun tiimisi toimii lentorahtikirjojen virstanpylväiden, lentoasemakäsittelyn, yhteyslentojen epäonnistumisten tai osittaisten rahdin saapumisten perusteella. Pelkkä pakettiseuranta ei korvaa näitä työnkulkuja riittävästi, ellei tarvittavaa rahtitason yksityiskohtaisuutta osoiteta nimenomaisesti.
Valitse paketteihin keskittyvä näkyvyys, kun tiimisi tarvitsee pakettikohtaisia toimituspäivityksiä, asiakasilmoituksia, määränpään kuljetusliikkeen tapahtumia ja toimituspoikkeamien hallintaa. Pelkkä lentorahtikirjasyöte ei riitä ostajille suunnattuun toimitusseurantaan.
Yhdistä nämä kaksi, kun hallinnoit kansainvälistä runkokuljetusta ja yksittäisten pakettien toimitusta. Säilytä konsolidoinnista ja sen paketeista erilliset tietueet ja yhdistä ne sitten oman logistiikkaprosessisi tai varmennetun kumppanisyötteen toimittamien viitteiden avulla.
Esimerkiksi kauppias voi kuljettaa konsolidoidun erän lentorahtina ennen sen syöttämistä määränpäässä pakettiverkostoon. Kirjaa rahdin saapuminen konsolidoinnin kohdalle. Päivitä kukin paketti vain, kun kyseiseen pakettiin liittyvää näyttöä on saatavilla; älä muuta erän lentoasemasaapumista jokaisen tilauksen toimitustapahtumaksi.
17TRACKin rooli
Tämän arkkitehtuurin pakettipuolella 17TRACKin Tracking API soveltuu usean kuljetusliikkeen seurannan integraation arviointiin. Käytä virallista API-dokumentaatiota tarkistaaksesi integraation suhteessa tarvitsemiisi tunnisteisiin, vastauskenttiin, ilmoitustyönkulkuun ja operatiivisiin rajoihin.
Älä käsittele paketti-APIn arviointia vahvistuksena lentorahdin toimivuudesta. Jos tarvitset myös master–house-suhteita, lentoreittien tietoja tai osittaisia kappaleliikkeitä, pyydä nimenomainen vahvistus ja esimerkkivastaukset näistä vaatimuksista. Tuotteen oikea rooli määräytyy sen perusteella, mitä työnkulkuja se pystyy todentamaan, ei sanan ”seuranta” laajuuden perusteella.
Suorita konseptitodistus ennen sitoutumista
Käytä todellisten kuljetusliikkeidesi, reittiesi ja palvelutyyppiesi edustavia lähetyksiä. Sisällytä mukaan tunnetuin tuloksin valmistuneita lähetyksiä sekä aktiivisia lähetyksiä. Yhden suoraviivaisen lähetyksen onnistunut haku ei riitä integraation vahvistamiseen.
- Määritä päätös, jota kunkin tapahtuman on tuettava. Esimerkkejä ovat väliin jääneen rahtiyhteyden tutkiminen, ostajaan yhteyden ottaminen osoiteongelmasta tai toimitusilmoituksen lähettäminen.
- Rakenna edustava testijoukko. Sisällytä kuljetusliikkeiden vaihdot, hiljaiset jaksot, toimitusyritykset, palautukset ja tarvittaessa rahdin jakautuneet kuljetukset.
- Tarkista kohdetason tarkkuus. Varmista, koskeeko kukin tapahtuma lentoa, lähetystä, osaa vai yksittäistä pakettia.
- Vertaa operatiiviseen lähteeseen. Tarkista puuttuvat virstanpylväät, aikaleimat, sijainnit, alkuperäiset viestit ja korjausten käsittely niiden kuljetusliikkeen tai kumppanin tietueiden perusteella, joihin sinulla on valtuutettu pääsy.
- Testaa virheistä palautuminen. Testaa päällekkäiset tapahtumat, viivästyneet tapahtumat, virheelliset tunnisteet, epäselvät kuljetusliikkeet, webhook-katkot ja täsmäytys.
- Vahvista talous ja vastuut. Arvioi kustannukset työmääräsi perusteella ja määritä vastuut lähdetietojen ongelmista, integraatiohäiriöistä ja asiakasviestinnästä.
Määritä hyväksymiskriteerit ennen tulosten tarkastelua. Niiden tulisi kattaa tarvittavat kentät, tapahtumien merkitys, palautumiskäyttäytyminen ja hyväksyttävät päivitysviiveet kussakin työnkulussa. Asiakasilmoitus ja rahtiin liittyvä toimenpide voivat edellyttää erilaisia kynnysarvoja.
UKK
Voiko yksi seuranta-API kattaa lentorahdin ja paketit?
Mahdollisesti, mutta vahvista kummankin tietomalli ja lähteiden käyttöoikeus. Yhteinen päätepiste ei todista rahtimäärien, lentoreittien, house-suhteiden tai pakettien luovutusten tukea. Pyydä erilliset esittelyt molemmista työnkuluista.
Voinko käyttää lentorahtikirjan numeroa yksittäisen paketin seuraamiseen?
Ei välttämättä. Lentorahtikirja voi tunnistaa suuremman lähetyksen yksittäisen paketin sijaan. Tarvitset varmennetun suhteen kyseisen lähetyksen ja pakettitunnisteen välille niiden historioiden yhdistämiseksi.
Tarkoittaako ”reaaliaikainen seuranta” jatkuvaa fyysistä sijaintia?
Älä oleta niin. Seuranta voi perustua ajoittain julkaistaviin operatiivisiin tapahtumiin jatkuvan sijaintitelemetrian sijaan. Selvitä, mikä käynnistää päivitykset, mitkä aikaleimat ovat saatavilla ja tuleeko sijaintitieto erillisestä anturilähteestä.
Ovatko webhookit parempia kuin kyselyt?
Webhookit ovat hyödyllisiä tapahtumailmoitusten vastaanottamiseen ilman toistuvia tilapyyntöjä. Kysely tai muu hakumekanismi voi silti tukea täsmäytystä ja palautumista. Valitse ratkaisu palveluntarjoajan dokumentoidun toiminnan, rajojen ja väliin jääneiden tai viivästyneiden päivitysten sietokykysi perusteella.
Todistaako toimitustapahtuma, että ostaja vastaanotti lähetyksen?
Ei kaikissa tilanteissa. Rahdin valmistuminen voi tarkoittaa luovutusta logistiikkaosapuolelle, kun taas pakettien toimitustapahtumat riippuvat kuljetusliikkeen toimitusprosessista. Varmista tapahtuman määritelmä ja hanki erillinen toimitustodiste, kun työnkulkusi sitä edellyttää.
Lähteet
- IATA — ONE Record: alan viite standardoidulle rahtitietojen jakamiselle; ei takaa tietyn APIn kattavuutta.
- 17TRACK — Tracking API: virallinen tuoteviite pakettiseurannan integraation arviointiin.
- 17TRACK — API-dokumentaatio: tekninen viite toteutusvaatimusten validointiin.


