Skip to main content
HjemBloggVeiledningerHvordan returplattformer kan bruke API-er for forsendelsessporing til returer og bytter

Hvordan returplattformer kan bruke API-er for forsendelsessporing til returer og bytter

17TRACK

Returplattformer kan bruke API-er for forsendelsessporing til å koble arbeidsflyter for returer og bytter sammen med sanntidshendelser for pakker. API-et kan hjelpe en plattform med å identifisere når en returetikett opprettes, overvåke bevegelsen gjennom transportørens nettverk, oppdage leverings- eller avvikshendelser og utløse neste operasjonelle trinn. Resultatet er en returprosess som er enklere for kundene å forstå og enklere for forhandlere å administrere.

How Returns Platforms Can Use Shipment Tracking APIs for Returns

Sporing erstatter ikke returregler, lagerinspeksjon, refusjoner eller lagerstyring. Den leverer forsendelsesdata som gjør at disse prosessene kan fungere med bedre timing og færre manuelle kontroller.

Hvorfor synlighet i forsendelser er viktig ved returer

En utgående forsendelse har vanligvis ett hovedmål: å levere en ordre til kjøperen. En retur eller et bytte kan ha flere mulige utfall. Pakken kan leveres til et lager, mottas av et tredjepartsbehandlingssted, omdirigeres, bli forsinket eller markeres som levert før forhandleren har fullført en inspeksjon. Kundene trenger også å vite om den returnerte varen er underveis, mens supportteamene må kunne svare på spørsmål uten å være avhengige av transportørens nettsteder eller manuelle sporingssøk.

Et sporings-API gir en returplattform en strukturert måte å hente og normalisere forsendelsesinformasjon fra transportører på. Avhengig av API-et og tilgjengelige transportørdata kan dette omfatte et sporingsnummer, forsendelsesstatus, tidsstempler for hendelser, posisjonsdetaljer, beregnet leveringsinformasjon og avviksmeldinger. De nøyaktige feltene og oppdateringsfrekvensen bør bekreftes i dokumentasjonen til den valgte leverandøren, ikke antas.

For en arbeidsflyt for returer i netthandel ligger den praktiske verdien ikke bare i å vise et sporingsnummer. Det handler om å bruke forsendelseshendelser som grunnlag for beslutninger, kundemeldinger, saksbehandling og koordinering med lageret.

De viktigste sporingshendelsene i en arbeidsflyt for retur eller bytte

En returplattform bør koble transportørhendelser til sine egne operasjonelle statuser. Transportørterminologien er ikke alltid konsekvent, så en integrasjon bør bruke en normalisert statusmodell samtidig som den opprinnelige transportørhendelsen beholdes for revisjon og support.

ForsendelseshendelseMulig plattformhandlingVerdi for kunden
Etikett opprettetÅpne sporingsposten og knytt den til returgodkjenningen.Viser at returinstruksjoner er utstedt, uten å antyde at pakken allerede er underveis.
Transportør har mottatt eller første skanningStart klokken for transporttiden og reduser usikkerheten rundt hvorvidt pakken er kommet inn i nettverket.Bekrefter at transportøren har mottatt pakken.
Under transportOppdater returtidslinjen og identifiser forsendelser som har stoppet opp.Gir fremdrift uten at kunden må kontakte support.
Avvik eller forsinkelseOpprett et varsel, juster forventningene eller send saken til support.Forklarer hvorfor returen kanskje ikke kommer frem som opprinnelig forventet.
LevertVarsle mottaksteamet og start inspeksjons- eller bytteprosessen.Bekrefter ankomst til det angitte bestemmelsesstedet, samtidig som det tydeliggjøres at inspeksjon fortsatt kan gjenstå.

Disse koblingene bør holdes atskilt fra forhandlerens endelige beslutning om refusjon. En levert-hendelse betyr at transportøren har rapportert levering; den beviser ikke i seg selv at riktig vare ble returnert, at varen er uskadd eller at returen oppfyller forhandlerens retningslinjer.

Slik kobler du et Tracking API til returdriften

1. Opprett en post for returforsendelsen

Når en retur er godkjent, bør returplattformen opprette en post som knytter returgodkjenningen til den opprinnelige ordren, kunden, varen, bestemmelsesstedet og forsendelsesidentifikatoren. Hvis et bytte er involvert, bør posten også identifisere erstatningsordren eller leveringshandlingen. Denne sammenhengen hindrer at en sporingshendelse behandles som en isolert oppdatering av en pakke.

Plattformen bør skille mellom den opprinnelige utgående forsendelsen og returforsendelsen. De kan bruke ulike transportører, servicenivåer, sporingsnumre og leveringsdestinasjoner. En enkel datamodell kan inneholde ordre-ID, retur-ID, bytte-ID når det er aktuelt, transportør, sporingsnummer, retning, gjeldende normaliserte status, tidspunkt for siste hendelse og rå transportørhendelse.

2. Send sporingsnummeret til API-et

Integrasjonen sender transportøren og sporingsnummeret til sporingstjenesten, underlagt leverandørens krav til autentisering, forespørsler og transportøridentifikasjon. Hvis systemet ikke kan identifisere transportøren på en pålitelig måte, bør det bruke en godkjent deteksjonsmetode eller be brukeren eller forhandleren om transportøren. Feil transportørkobling kan føre til forsinkede eller unøyaktige resultater.

På dette stadiet bør plattformen registrere når sporingsforespørselen ble opprettet, og om API-et godtok, avviste eller ennå ikke kunne identifisere forsendelsen. At en forespørsel godtas av et API, er ikke det samme som en skanning hos transportøren. Disse statusene bør ikke slås sammen i brukergrensesnittet.

3. Motta oppdateringer gjennom polling eller webhooks

Leverandører av sporing støtter vanligvis én eller flere metoder for å hente senere hendelser. En plattform kan hente oppdateringer gjennom polling, motta push-varsler eller bruke en kombinasjon av begge, avhengig av leverandørens dokumentasjon og nødvendig latenstid. Dokumentasjonen for 17TRACK API er riktig sted for å bekrefte den gjeldende integrasjonsmodellen, støttede forespørselsmønstre og implementeringskrav.

Uansett hvilken metode som brukes, bør plattformen gjøre oppdateringene idempotente. Den samme hendelsen kan leveres mer enn én gang, komme i feil rekkefølge eller bli revidert av en transportør. Lagre hendelsesidentifikatoren når den er tilgjengelig, sammenlign tidsstempler for hendelser og behold en historikk i stedet for å overskrive alle tidligere statuser.

4. Normaliser hendelser til forretningsstatuser

Transportørstatuser er utformet for transportoperasjoner, ikke nødvendigvis for returbeslutninger. En returplattform kan koble dem til statuser som etikett utstedt, venter på innlevering, under transport, forsinket, levert, leveringsavvik og undersøkes. Koblingen bør bevare usikkerhet. For eksempel kan «levert» flytte en sak til «venter på inspeksjon», ikke direkte til «refusjon godkjent».

Forretningsreglene bør også ta hensyn til manglende eller motstridende hendelser. En pakke uten ny skanning på flere dager kan utløse et internt varsel, men bør ikke automatisk behandles som tapt med mindre forhandlerens retningslinjer og transportørens prosess støtter den konklusjonen.

5. Utløs operasjonelle handlinger og kundehendelser

Når normaliserte hendelser er tilgjengelige, kan plattformen bruke regler. En første skanning hos transportøren kan sende en bekreftelse til kunden. Et leveringsavvik kan opprette en supportoppgave. En levert-hendelse kan varsle et returlager om å se etter pakken. Ved bytter kan virksomheten bestemme om erstatningsvaren skal sendes etter første skanning, etter levering eller etter inspeksjon. Denne beslutningen avhenger av risiko, lagerbeholdning og retningslinjer; sporingsdata kan informere den, men kan ikke avgjøre den universelt.

Varsler bør bruke et enkelt språk og angi neste forventede trinn. Kunden bør kunne skille mellom «transportøren har mottatt returen», «forhandleren har inspisert returen» og «refusjonen er utstedt». Dette er ulike hendelser som eies av ulike deler av prosessen.

Bruk av sporingsdata ved bytter

Arbeidsflyter for bytter har en ekstra avhengighet: Erstatningsvaren kan måtte sendes før den returnerte varen har fullført reisen. En returplattform med sporing kan opprettholde to relaterte forsendelsesposter: den innkommende returen og den utgående erstatningsvaren. Ved å koble dem får supportmedarbeiderne et mer fullstendig bilde av byttet.

Nyttige bytteregler kan omfatte:

  • Ikke beskriv erstatningsvaren som sendt før leveringssystemet bekrefter denne statusen.
  • Vis tidslinjene for retur og erstatningsvare separat, selv når de inngår i samme byttesak.
  • Varsle support når returen er forsinket, men erstatningsvaren allerede er levert.
  • Hold kundens kvalifikasjonsbeslutning atskilt fra transportørens leveringsstatus.
  • Registrer hvilken hendelse som utløste en automatisert handling, slik at teamet kan kontrollere eller reversere den.

Denne tilnærmingen reduserer en vanlig kilde til forvirring: å behandle leveringen av en erstatningsvare som bevis på at den opprinnelige returen er fullført. De to forsendelsene kan bevege seg uavhengig av hverandre og kan kreve ulike løsninger.

Hvor 17TRACK passer inn

17TRACK tilbyr et eget Tracking API for utviklerintegrasjoner og tilbyr også 17RETURNS som et returfokusert produkt. Disse produktene bør vurderes ut fra hvilken rolle forhandleren trenger å fylle. Et sporings-API er relevant når en returplattform trenger forsendelsesdata i sin egen arbeidsflyt eller applikasjon. Et produkt for returadministrasjon er relevant når virksomheten trenger en bredere prosess for å starte, organisere og administrere returer.

Det offisielle materialet fra 17TRACK bør brukes til å bekrefte gjeldende API-atferd, støttede transportører og integrasjonsdetaljer, autentiseringskrav og eventuelle produktspesifikke begrensninger før implementering. Produktsiden for 17RETURNS og 17RETURNS-oppføringen i Shopify gir produktkontekst, mens API-dokumentasjonen er den mest passende kilden for tekniske integrasjonsbeslutninger. En forhandler som allerede driver en tilpasset returplattform, kan bruke API-et som et datalag; en forhandler som ønsker en administrert arbeidsflyt for returer, bør vurdere selve returproduktet i stedet for å anta at et API alene leverer disse funksjonene.

Implementeringskontroller før lansering

Et konseptbevis bør bruke reelle returscenarioer, ikke bare et vellykket eksempel på en forsendelse under transport. Test minst én innenlands retur, én grensekryssende retur hvis det er relevant for virksomheten, en forsinket forsendelse, et leveringsavvik, en levert pakke, en duplisert oppdatering og et sporingsnummer som ikke kan identifiseres umiddelbart.

Implementeringsteamet bør bekrefte følgende:

  • Hvilke transportører og tjenester som kreves for forhandlerens returruter, og hvordan disse transportørene identifiseres.
  • Hvilke hendelser som er tilgjengelige for hver relevante transportør, og om hendelsesdetaljene varierer etter bestemmelsessted.
  • Hvor ofte oppdateringer fornyes, og hvordan plattformen håndterer API-feil, hastighetsbegrensninger og midlertidige driftsavbrudd.
  • Hvordan dupliserte, sene, manglende eller feilordnede hendelser lagres og avstemmes.
  • Hvilke handlinger som er automatiske, og hvilke som krever manuell gjennomgang.
  • Hvordan kundemeldinger oversettes, profileres, settes på pause og revideres.
  • Hvordan personopplysninger og forsendelsesdata beskyttes, oppbevares og fjernes i henhold til forhandlerens krav.
  • Hvordan systemet skiller mellom levering hos transportøren og mottak på lageret, inspeksjon, godkjenning, refusjon og oppfyllelse av bytte.

Operasjonelt ansvar er like viktig som teknisk tilkobling. Logistikkteamene bør definere betydningen av hendelsene, supportteamene bør definere kundemeldinger, økonomiteamene bør definere refusjonskontroller, og lagerteamene bør definere hva som skjer etter levering. Uten disse beslutningene kan en teknisk vellykket API-tilkobling fortsatt skape misvisende automatisering.

Et praktisk beslutningsrammeverk

Bruk et API for forsendelsessporing når returprosessen er avhengig av tidsriktige transportørhendelser, virksomheten trenger å koble sammen flere systemer, eller kunder og supportmedarbeidere trenger en felles oversikt over pakkens fremdrift. Vurder en plattform for returadministrasjon når det større problemet omfatter konfigurasjon av retningslinjer, returgodkjenning, arbeidsflyter for etiketter, kundekommunikasjon, lagerdisponering og rapportering. I noen virksomheter fungerer de to lagene sammen: retursystemet administrerer saken, mens sporingstjenesten leverer normaliserte forsendelseshendelser.

Det beste designet behandler sporing som bevis i en større tilstandsmaskin. Den forteller plattformen hva transportøren har rapportert, når det ble rapportert, og hvilken forsendelse det tilhører. Forretningsreglene avgjør deretter hva som skal skje. Dette skillet gjør returer og bytter mer transparente uten å love en grad av sikkerhet som transportørdata ikke kan gi.

Vanlige spørsmål

Kan et sporings-API bekrefte at en refusjon skal gis?

Nei. Det kan rapportere forsendelseshendelser som mottak, bevegelse, avvik eller levering når disse hendelsene er tilgjengelige. Refusjonsberettigelse avhenger vanligvis også av returreglene, varens tilstand, inspeksjon, svindelkontroller og forhandlerens godkjenning.

Bør en levert retur automatisk utløse en refusjon?

Ikke nødvendigvis. Levering betyr at transportøren har rapportert at pakken nådde bestemmelsesstedet. Forhandleren kan fortsatt måtte kontrollere varen, antallet, tilstanden og returgodkjenningen før en refusjon godkjennes.

Er polling eller webhook-levering best for retursoring?

Ingen av metodene er universelt bedre. Valget avhenger av leverandørens støttede metoder, ønsket oppdateringshastighet, implementeringsinnsats og toleranse for forsinkede varsler. Noen plattformer bruker push-oppdateringer med periodisk avstemming for å fange opp tapte hendelser.

Hvordan bør en bytteplattform spore to forsendelser?

Lagre den innkommende returen og den utgående erstatningsvaren som separate forsendelsesposter knyttet til samme byttesak. Vis statusene deres uavhengig av hverandre, og definer regler som hindrer at statusen til én forsendelse forveksles med at den andre er fullført.

Hva bør testes før et sporings-API kobles til?

Test vellykket sporing, forsinkede skanninger, avvik, dupliserte hendelser, feil eller ukjent transportørinformasjon, grensekryssende saker når det er relevant, og API-driftsavbrudd. Test også kundemeldingene og banene for manuell gjennomgang som følger hver hendelse.

Kilder