Skip to main content
EtusivuBlogiOppaatLentorahti vs. rajat ylittävien pakettien seuranta: mitä API-ominaisuuksia tarvitset?

Lentorahti vs. rajat ylittävien pakettien seuranta: mitä API-ominaisuuksia tarvitset?

17TRACK

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.

Lentorahti vs. rajat ylittävien pakettien seuranta: mitä API-ominaisuuksia tarvitaan

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ösalueLentorahdin seurantaRajat ylittävien pakettien seuranta
Ensisijainen kohdeLentorahtikirja, lähetys tai kuljetusosuusYksittäinen paketti ja sen kuljetusliikkeen tunnisteet
Operatiiviset kysymyksetVastaanotettiinko rahti, lennätettiinkö se, saapuiko se tai luovutettiinko se?Missä paketti on, mikä estää sen etenemisen ja toimitettiinko se?
Säilytettävät suhteetMaster- ja house-viitteet, osuudet, kappaleet ja jaetut kuljetuksetTilauksen ja paketin väliset linkit, kuljetusliikkeiden vaihdot, korvaavat tunnisteet ja palautukset
Tyypillinen vastuutiimiHuolinta-, kuljetus- tai rahtitoimintojen tiimiVerkkokaupan toimintojen, asiakaspalvelun tai toimitusten hallinnan tiimi
Suurin tulkintariskiYhden osuuden tai osittaisen saapumisen käsittäminen koko lähetyksen valmistumiseksiLuovutuksen 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.

  1. 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.
  2. Rakenna edustava testijoukko. Sisällytä kuljetusliikkeiden vaihdot, hiljaiset jaksot, toimitusyritykset, palautukset ja tarvittaessa rahdin jakautuneet kuljetukset.
  3. Tarkista kohdetason tarkkuus. Varmista, koskeeko kukin tapahtuma lentoa, lähetystä, osaa vai yksittäistä pakettia.
  4. 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.
  5. Testaa virheistä palautuminen. Testaa päällekkäiset tapahtumat, viivästyneet tapahtumat, virheelliset tunnisteet, epäselvät kuljetusliikkeet, webhook-katkot ja täsmäytys.
  6. 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