Skip to main content
HjemBloggVeiledningerFlyfrakt vs. sporing av grensekryssende pakker: Hvilke API-funksjoner trenger du?

Flyfrakt vs. sporing av grensekryssende pakker: Hvilke API-funksjoner trenger du?

17TRACK

Velg et API for sporing av flyfrakt når applikasjonen din må følge flyfraktbrev, flystrekninger, milepæler for lasthåndtering og forsendelsesmengder. Velg et API for sporing av grensekryssende pakker når du trenger oppdateringer på pakkenivå på tvers av transportører, leveringsavvik og status for siste leveringsetappe. Hvis forsendelsene dine kombinerer konsolidert flyfrakt med individuell pakkelevering, trenger du begge synlighetslagene og en pålitelig måte å koble identifikatorene deres på.

Flyfrakt kontra sporing av grensekryssende pakker – hvilke API-funksjoner

For utviklingsteam, logistikkoperatører og netthandelsbedrifter handler kjøpsbeslutningen mindre om hvilket API som returnerer flest hendelser, og mer om hvorvidt disse hendelsene beskriver den forsendelsesenheten dere faktisk håndterer. En ankomsthendelse fra et flyselskap kan ikke alene fortelle en kunde hvor pakken er, eller når den vil nå frem til døren.

Start med forsendelsesenheten, ikke transportmåten

Flyfrakt og grensekryssende pakker er ikke gjensidig utelukkende fraktkategorier. En pakke kan transporteres internasjonalt med fly, mens flyselskapet håndterer den som del av en større konsolidert forsendelse. Forskjellen ved valg av API ligger i hvilket operasjonelt objekt som spores.

Synlighet for flyfrakt er vanligvis sentrert rundt et flyfraktbrev og den tilknyttede transportbevegelsen. Avhengig av kilden kan dataene beskrive mottak, avgang, ankomst, tilgjengelighet for lasten og overlevering. Pakkevisibilitet er sentrert rundt individuelle pakker og fremdriften deres gjennom innsamling, internasjonal transport, behandling på bestemmelsesstedet og levering.

Et hovedflyfraktbrev kan representere en konsolidert transport som inneholder flere underliggende forsendelser. Husflyfraktbrev, pakkeetiketter og sporingsnumre fra transportører på bestemmelsesstedet kan identifisere ulike nivåer i denne transporten. Ikke anta at en sporingsleverandør automatisk kan oppdage eller koble sammen alle disse relasjonene.

BeslutningsområdeSporing av flyfraktSporing av grensekryssende pakker
PrimærobjektFlyfraktbrev, forsendelse eller transportstrekningIndividuell pakke og transportørens identifikatorer
Operasjonelle spørsmålBle lasten mottatt, fraktet med fly, ankommet eller overlevert?Hvor er pakken, hva hindrer den, og ble den levert?
Relasjoner som må bevaresHoved- og husreferanser, strekninger, kolli og oppdelte transporterKoblinger mellom ordre og pakke, overleveringer mellom transportører, erstatningsidentifikatorer og returer
Typisk ansvarlig teamSpedisjons-, transport- eller fraktoperasjonsteamNetthandelsdrift, kundeservice eller leveringsstyring
Viktigste tolkningsrisikoÅ behandle én strekning eller delvis ankomst som fullføring av hele forsendelsenÅ behandle en overlevering eller en tvetydig leveringshendelse som mottak av kjøperen

Hva et API for sporing av flyfrakt må støtte

Identitet for flyfraktbrev og forsendelsesrelasjoner

Spør hvilke identifikatorer API-et godtar, og hva hvert oppslag returnerer. Støtte for et hovedflyfraktbrev innebærer ikke automatisk støtte for synlighet på husnivå. Hvis driften din er avhengig av husforsendelser, bør du kreve en demonstrasjon med egne referanser og autoriserte datakilder.

Datamodellen bør bevare relasjonene mellom forsendelsen, transportstrekningene og eventuelle deler som beveger seg separat. For arbeidsflyter som er avhengige av mengder, bør du spørre om antall kolli og vekter er tilgjengelige på forsendelsesnivå, hendelsesnivå eller begge deler. En total på forsendelsesnivå er ikke en erstatning for å vite hvor mye last som nådde en bestemt flyplass.

Synlighet for transportstrekninger og lasthåndtering

Krev tilstrekkelig kontekst til å skille en avgang fra opprinnelsesstedet fra en avgang etter mellomlanding, og en planlagt transport fra en faktisk transport. Nyttige felt kan omfatte avgangs- og ankomstflyplasser, flyreferanser, hendelsessteder og planlagte kontra faktiske tidsstempler. Tilgjengeligheten avhenger av kilden og bør verifiseres i stedet for å antas.

Skill også mellom flybevegelse og lastbevegelse. At et fly ankommer, beviser ikke alene at alle tilknyttede forsendelser ble lastet, losset, behandlet eller gjort tilgjengelige. Spør om en hendelse gjelder en bestemt forsendelse, eller om den er avledet fra en flyfeed.

Delvise transporter og betydningen av milepæler

En fraktforsendelse kan bevege seg i deler. Systemet ditt bør ikke merke hele forsendelsen som ankommet bare fordi det finnes en ankomsthendelse for en del av den. Test hvordan API-et representerer flere flygninger, delvise mengder, endrede ruter og korrigeringer.

Milepæl-definisjoner krever tilsvarende gransking. En overlevering til en speditør eller en annen logistikkpart er ikke nødvendigvis levering til den endelige mottakeren. Be leverandøren forklare den operasjonelle betydningen av fullføringshendelser, og behold denne betydningen i den interne statusmodellen.

IATAs ONE Record-initiativ er en relevant bransjereferanse for deling av fraktdata og standardiserte datastrukturer. En påstand om standardstøtte er imidlertid ikke et bevis på tilgang til alle flyselskaper, lasthåndterere, forsendelser eller milepæler. Spør hvilken implementering, hvilke datarelasjoner, tillatelser og operasjonelle kilder som faktisk er tilgjengelige.

Hva et API for sporing av grensekryssende pakker må støtte

Transportøridentifikasjon og kontinuitet ved overlevering

Internasjonale pakkereiser kan involvere en operatør på opprinnelsesstedet, en grensekryssende logistikkleverandør og en leveringstransportør på bestemmelsesstedet. En integrasjon bør hjelpe deg med å opprettholde kontinuitet når identifikatoren eller den ansvarlige transportøren endres.

Kontroller om API-et returnerer påfølgende sporingsnumre, transportørrelasjoner eller bare hendelser for identifikatoren du sendte inn. Hvis disse relasjonene ikke er tilgjengelige, bør du finne ut om fraktplattformen, lageret eller logistikkpartneren din kan levere dem. Ikke lov automatisk kobling fra ende til ende uten å teste det.

Transportørgjenkjenning trenger også en reserveløsning. Lignende mønstre i sporingsnumre kan skape tvetydighet, så integrasjonen bør tillate et eksplisitt valg av transportør eller en annen dokumentert metode for å skille dem der dette støttes.

Normaliserte statuser med opprinnelig dokumentasjon

En felles statusmodell gjør det enklere å automatisere varsler på tvers av transportører. Normalisering bør imidlertid ikke slette den opprinnelige hendelsesbeskrivelsen, plasseringen, tidsstempelet eller kildetransportøren.

En bred avviksstatus kan for eksempel representere et adresseproblem, en tollrelatert forsinkelse eller et mislykket leveringsforsøk. Disse krever ulike tiltak. Bevar den opprinnelige meldingen, og bruk spesifikke avvikskategorier bare når kilden støtter dem.

Leveringsresultater og handlingsrettede avvik

Pakkeavdelinger trenger vanligvis å skille mellom ute til levering, forsøkt levering, tilgjengelig for henting, levert og returbegivenheter. Spør hvilke forskjeller API-et viser, og om de er konsistente på tvers av transportørene du bruker.

Behandle leveringsbevis som et separat krav. En levert-status garanterer ikke tilgang til signatur, fotografi, mottakernavn eller dokument. Bekreft tilgjengelighet, tilgangstillatelser, lagring og personvernbegrensninger for de aktuelle tjenestene.

Tollinformasjon har også begrensninger. En sporingshendelse som nevner toll, gir ikke nødvendigvis en tolldeklarasjon, en forklaring på avgifter eller en pålitelig prognose for frigivelse. Bygg eskaleringsregler rundt det hendelsen faktisk sier, ikke et antatt juridisk eller tollmessig resultat.

Funksjoner begge API-typene trenger

Pålitelig mottak og gjenoppretting av hendelser

For hendelsesstyrte arbeidsflyter bør du evaluere webhook-levering, autentisering, forsøk på nytt, håndtering av duplikater og gjenoppretting etter driftsstans. Dette er innkjøpskrav som må verifiseres, ikke funksjoner du bør anta at alle leverandører tilbyr.

Utform konsumenten slik at den håndterer dupliserte meldinger og meldinger som kommer i feil rekkefølge. Lagre hendelsestidspunktet separat fra tidspunktet systemet ditt mottok oppdateringen. Hvis en stabil hendelsesidentifikator ikke er tilgjengelig, bør du definere en dokumentert metode for deduplisering ved hjelp av de tilgjengelige feltene.

Spør om du kan hente en forsendelses hendelseshistorikk etter at varsler er gått tapt. Webhooks er nyttige for å utløse arbeid; en støttet hente- eller avstemmingsprosess er det som hjelper deg med å gjenopprette når utløseren ikke ble mottatt.

Aktualitet, opphav og håndtering av tidsstempler

Skill mellom tre klokker: når den fysiske hendelsen fant sted, når kilden publiserte den, og når applikasjonen din mottok den. Ikke alle kilder viser alle tre, men ved å holde tilgjengelige tidsstempler adskilt blir forsinkelser enklere å diagnostisere.

Skill på samme måte mellom ingen ny hendelse og et mislykket oppslag. En uendret forsendelseshistorikk kan skyldes et legitimt opphold mellom skanninger, et kildeutfall, en ukjent identifikator eller et integrasjonsproblem. Driftsteamet trenger nok diagnostisk informasjon til å velge riktig respons.

Bevar tidssoneinformasjon når den oppgis. Hvis et tidsstempel fra kilden mangler tidssone, bør du registrere denne begrensningen i stedet for å konvertere det stilltiende til en tilsynelatende presis global tid.

Tilgang, kostnader og operasjonelle kontroller

Bekreft autentisering, kontoseparasjon, datalagring, slettingsprosedyrer, hastighetsgrenser og ordninger for produksjonsstøtte. Sporingsdata kan inneholde personopplysninger, så samle inn og vis bare det arbeidsflyten din trenger.

Sammenlign kommersielle vilkår med den faktiske arbeidsmengden din. Spør hva som er fakturerbart: en registrert forsendelse, en forespørsel, en oppdatering eller en annen enhet. Avklar hvordan ugyldige numre, duplikatregistreringer, ny sporing, historiske oppslag og overskridelser behandles. Uten disse definisjonene er en oppgitt pris ikke et pålitelig kostnadssammenligningsgrunnlag.

Når du bør bruke ett API, og når du bør kombinere datakilder

Velg fraktfokusert synlighet når teamet ditt handler på milepæler for flyfraktbrev, flyplasshåndtering, svikt ved mellomlandinger eller delvise lastankomster. Pakkevisibilitet alene er ikke en tilstrekkelig erstatning for disse arbeidsflytene med mindre de nødvendige detaljene på fraktnivå uttrykkelig er demonstrert.

Velg pakkefokusert synlighet når teamet ditt trenger leveringsoppdateringer på pakkenivå, kundemeldinger, hendelser fra transportøren på bestemmelsesstedet og håndtering av leveringsavvik. En feed for flyfraktbrev alene er ikke tilstrekkelig for leveringssporing mot kjøperen.

Kombiner de to når du håndterer internasjonal hovedtransport og individuell pakkelevering. Oppbevar separate poster for konsolideringen og pakkene, og koble dem deretter sammen gjennom referanser fra din egen logistikkprosess eller en verifisert partnerfeed.

En forhandler kan for eksempel sende en konsolidert batch med fly før den injiseres i et pakkenettverk på bestemmelsesstedet. Registrer lastens ankomst mot konsolideringen. Oppdater hver pakke bare når det finnes dokumentasjon som gjelder den aktuelle pakken; ikke gjør batchens ankomst på flyplassen om til en levert-hendelse for hver ordre.

Hvor 17TRACK passer inn

På pakkesiden av denne arkitekturen er 17TRACKs Tracking API relevant ved evaluering av integrasjon for sporing på tvers av flere transportører. Bruk den offisielle API-dokumentasjonen til å kontrollere integrasjonen mot de nødvendige identifikatorene, responsfeltene, arbeidsflyten for varsler og operasjonelle begrensningene.

Ikke betrakt en evaluering av et pakke-API som en bekreftelse på funksjonalitet for flyfrakt. Hvis du også trenger relasjoner mellom hoved- og husnivå, detaljer om flystrekninger eller delvise kollibevegelser, bør du be om uttrykkelig bekreftelse og eksempelsvar for disse kravene. Produktets riktige rolle avgjøres av arbeidsflytene det kan dokumentere, ikke av bredden i ordet «sporing».

Gjennomfør en konseptvalidering før du forplikter deg

Bruk representative forsendelser fra de faktiske transportørene, rutene og tjenestetypene dine. Ta med fullførte forsendelser med kjente resultater samt aktive forsendelser. Et vellykket oppslag for én enkel forsendelse er ikke nok til å validere integrasjonen.

  1. Definer hvilken beslutning hver hendelse skal støtte. Eksempler er å undersøke en tapt forbindelse for last, kontakte en kjøper om et adresseproblem eller sende ut et leveringsvarsel.
  2. Bygg et representativt testsett. Ta med overleveringer mellom transportører, stille perioder, leveringsforsøk, returer og oppdelte lasttransporter der det er relevant.
  3. Kontroller nøyaktighet på objektnivå. Bekreft om hver hendelse gjelder en flygning, forsendelse, del eller individuell pakke.
  4. Sammenlign med den operasjonelle kilden. Kontroller manglende milepæler, tidsstempler, steder, opprinnelige meldinger og håndtering av korrigeringer mot transportør- eller partnerposter du har autorisert tilgang til.
  5. Test gjenoppretting etter feil. Test dupliserte hendelser, forsinkede hendelser, ugyldige identifikatorer, tvetydige transportører, webhook-utfall og avstemming.
  6. Valider økonomi og ansvar. Beregn kostnaden ut fra arbeidsmengden din, og fordel ansvaret for problemer med kildedata, integrasjonsfeil og kundekommunikasjon.

Fastsett akseptansekriterier før du vurderer resultatene. De bør dekke de nødvendige feltene, betydningen av hendelser, gjenopprettingsatferd og akseptable oppdateringsforsinkelser for hver arbeidsflyt. Et kundesvarsel og et inngrep i frakten kan kreve ulike terskler.

Vanlige spørsmål

Kan ett sporings-API dekke flyfrakt og pakker?

Potensielt, men bekreft datamodellen og kildetilgangen for begge deler. Et felles endepunkt beviser ikke støtte for fraktmengder, flystrekninger, husrelasjoner eller pakkeoverleveringer. Be om separate demonstrasjoner for de to arbeidsflytene.

Kan jeg bruke et flyfraktbrevnummer til å spore en individuell pakke?

Ikke nødvendigvis. Et flyfraktbrev kan identifisere en større forsendelse i stedet for en individuell pakke. Du trenger en verifisert relasjon mellom forsendelsen og pakkeidentifikatoren for å koble historikkene deres.

Betyr «sporing i sanntid» kontinuerlig fysisk posisjon?

Ikke anta det. Sporing kan være basert på operasjonelle hendelser som publiseres med mellomrom, i stedet for kontinuerlig posisjonstelemetri. Spør hva som utløser oppdateringer, hvilke tidsstempler som vises, og om posisjonsdata kommer fra en separat sensorkilde.

Er webhooks bedre enn polling?

Webhooks er nyttige for å motta hendelsesvarsler uten gjentatte statusforespørsler. Polling eller en annen hentemekanisme kan fortsatt støtte avstemming og gjenoppretting. Velg en utforming basert på leverandørens dokumenterte atferd, begrensninger og hvor godt du tåler manglende eller forsinkede oppdateringer.

Beviser en levert-hendelse at kjøperen mottok forsendelsen?

Ikke i alle sammenhenger. Fullføring av frakt kan beskrive overlevering til en logistikkpart, mens pakkeleveringshendelser avhenger av transportørens leveringsprosess. Bekreft hendelsesdefinisjonen, og skaff separat leveringsdokumentasjon når arbeidsflyten krever det.

Kilder