Skip to main content
HjemBlogVejledningerHvordan returplatforme bruger Shipment Tracking API til at spore retur forsendelser

Hvordan returplatforme bruger Shipment Tracking API til at spore retur forsendelser

17TRACK

Returplatforme bruger en API til forsendelsessporing til at forbinde en godkendt retur med den fysiske forsendelse. Platformen registrerer transportøren og sporings-ID'et for returforsendelsen, henter sporingshændelser og bruger disse hændelser til at vise fremskridt eller anmode om en operationel gennemgang. API'en giver synlighed over forsendelsen; returplatformen ejer stadig returforespørgslen, politikbeslutningerne, lagerinspektionen og refusionsprocessen.

Sådan bruger returplatforme en API til forsendelsessporing

For et team, der arbejder med returdrift eller produktudvikling, er det nyttige spørgsmål ikke blot, om en API kan vise en sporingsstatus. Spørgsmålet er, om integrationen pålideligt kan identificere den rigtige returforsendelse, fortolke de hændelser, den modtager, og forhindre, at en sporingsopdatering udløser den forkerte kundemeddelelse eller refusionshandling.

Hvor passer sporing ind i en retur?

En retur begynder som en forretningspost: En kunde beder om at sende en vare tilbage, og forhandleren beslutter, hvad der skal godkendes. En sporingspost beskriver noget andet: en pakkes bevægelse. Ved at forbinde de to poster kan en returplatform besvare spørgsmål som, om kunden ser ud til at have afleveret pakken, om den bevæger sig mod returadressen, og om der er rapporteret en leveringshændelse.

Denne forbindelse skal være eksplicit. En ordre kan indeholde flere varer, en kunde kan foretage mere end én retur i forbindelse med den samme ordre, og én retur kan omfatte flere pakker. Det oprindelige sporingsnummer for udgående forsendelse må ikke forveksles med returens sporingsnummer. En praktisk datamodel har separate identifikatorer for ordren, returgodkendelsen, returpakken, transportøren og sporingsposten og gemmer derefter relationerne mellem dem.

Sporing har også en klar grænse. En leveringshændelse fra transportøren kan indikere, at en pakke er nået frem til en adresse eller facilitet. Den fastslår ikke, at lageret har modtaget den forventede vare, at varen har bestået inspektionen, eller at en refusion er berettiget. Disse beslutninger kræver deres egne beviser og regler.

Integrationsforløbet fra godkendelse til modtagelse

1. Opret returposten, før pakken følges

Returplatformen registrerer først forespørgslen, de involverede varer, den godkendte destination og den tilladte løsning. Hvis returen bruger en etiket udstedt af forhandleren, kan platformen knytte etikettens sporings-ID til returpakken. Hvis kunden selv arrangerer forsendelsen, kan platformen have brug for en metode til at indsamle og validere transportøren og sporingsnummeret, før overvågningen begynder.

Dette er det første punkt, hvor datakvaliteten påvirker synligheden. Et sporingsnummer uden en pålidelig forbindelse mellem pakke og retur kan producere en helt nøjagtig transportøropdatering for den forkerte retur. Teams bør også beslutte, hvordan de håndterer korrigerede sporingsnumre, erstatningsetiketter og kunder, der indsender den samme identifikator to gange.

2. Registrer eller slå forsendelsen op

Platformen sender de oplysninger, der kræves af den valgte sporingsudbyder, for at oprette eller hente en forsendelsespost. De præcise anmodningsfelter og rækkefølgen afhænger af udbyderens dokumentation. Som minimum kræver en implementering en pålidelig måde at knytte udbyderens forsendelsesreference til sin egen returpost. Når transportøridentifikation er nødvendig, bør platformen bekræfte, hvordan tvetydige eller ikke-understøttede transportøroplysninger håndteres, i stedet for at antage, at et sporingsnummer alene er tilstrækkeligt.

Gem udbyderens svar, integrationsfejlene og den dato, hvor platformen begyndte at overvåge. En accepteret anmodning er ikke nødvendigvis et bevis på, at en transportør har scannet pakken. Før den første scanning kan den kundevendte status være nødt til at angive, at sporing afventer, i stedet for at returen er undervejs.

3. Indlæs opdateringer uden at miste den oprindelige hændelse

Afhængigt af API'en kan opdateringer ankomme via en webhook, hentes ved polling eller bruge en anden dokumenteret metode. Integrationen bør bevare udbyderens rå hændelsesoplysninger sammen med enhver forenklet status, der vises i returplatformen. Nyttige felter kan omfatte hændelsesbeskrivelsen, hændelsestidspunktet, stedet når det oplyses, transportørens reference og tidspunktet, hvor platformen modtog opdateringen.

De to tidspunkter besvarer forskellige spørgsmål. Et hændelsestidsstempel beskriver, hvornår en aktivitet angiveligt fandt sted; et modtagelsestidsstempel viser, hvornår returplatformen fik kendskab til den. Forsinkelser, gentagne leveringer og meddelelser, der ankommer ude af rækkefølge, kan ellers få en retur til at se ud til at bevæge sig baglæns. Hvis udbyderen tilbyder hændelses-ID'er, skal de bruges til deduplikering. Hvis ikke, skal der defineres en forsigtig deduplikeringsmetode, som testes med reelle integrationseksempler.

4. Oversæt sporingshændelser til returstatusser

Transportørens hændelsesbeskrivelser er ikke en returpolitik. Returplatformen omsætter dem typisk til et mindre sæt operationelle statusser, såsom afventer aflevering, under transport, levering rapporteret eller kræver gennemgang. Omsætningen bør tage højde for ukendte hændelser i stedet for stiltiende at behandle enhver ukendt opdatering som fremskridt.

En første scanning hos transportøren kan for eksempel være tilstrækkelig til at fortælle en kunde, at pakken ser ud til at være på vej. Den er måske ikke tilstrækkelig til at love en refusionsdato. En leveringshændelse kan hjælpe lageret med at prioritere en matchende pakke, men en refusionsregel kan stadig kræve fysisk modtagelse og inspektion. Teams bør skrive disse skel ind i arbejdsgangen, før statusser forbindes med automatiserede handlinger.

5. Luk kredsløbet med dokumentation fra lageret

Når en pakke ankommer, kan lageret eller returfabrikken scanne en intern stregkode, matche pakken med en returgodkendelse, inspicere indholdet og registrere resultatet. Dette er hændelser i returhåndteringen, ikke hændelser i transportørens sporing. Når begge systemer er forbundet, kan platformen vise en mere nyttig rækkefølge: forsendelsens bevægelse, levering rapporteret af transportøren, pakken modtaget af faciliteten og afsluttet behandling.

Denne rækkefølge hjælper også med at løse undtagelser. Hvis sporingen rapporterer levering, men der ikke vises nogen lagerkvittering, kan en medarbejder undersøge destinationen, transportørens hændelse, facilitetens modtagelseskø og pakkeidentifikatoren, før der fremsættes en kundevendt påstand. Hvis lageret modtager en pakke uden en brugbar sporingshistorik, kan den fysiske modtagelse stadig registreres; manglende sporingsdata bør ikke slette uafhængig dokumentation fra lageret.

Hvad en API til forsendelsessporing kan og ikke kan fortælle platformen

En API til forsendelsessporing kan gøre transportørrapporterede bevægelser tilgængelige for en anden applikation, afhængigt af udbyderens dokumenterede dækning, tilgængelige hændelser og integrationsadfærd. Den kan ikke i sig selv verificere en returs indhold eller afgøre, om en forhandlers politik er opfyldt. Den har muligvis heller ingen opdatering at rapportere før den første scanning hos transportøren.

Skellet er vigtigt ved udformning af automatisering. Statusser bør behandles som signaler med definerede anvendelser, ikke som udskiftelige beviser. En hændelse om aflevering til transportøren kan udløse en fremskridtsmeddelelse. En leveringshændelse kan oprette en opfølgningsopgave for lageret. En bekræftet lagerkvittering kan flytte returen videre mod inspektion. Beslutningen om refusion eller ombytning bør følge forhandlerens faktiske regler og det bevis, som disse regler kræver.

Det kundevendte sprog bør afspejle den samme grænse. »Transportøren rapporterer, at din retur er leveret« er mere præcist end »Vi har godkendt din refusion«, når der ikke er foretaget nogen inspektion. På samme måde er »Vi venter på den første opdatering fra transportøren« mere informativt end en uforklaret tom sporingsside.

Designkontroller, der forebygger undgåelige fejl i returlogistikken

  • Match på pakkeniveau. Test delte returneringer, flere pakker under én godkendelse, erstatningsetiketter og gentagne returneringer i forbindelse med én ordre. Hver pakke skal have en entydig forbindelse til sin egen sporingspost.
  • Definer statusprioritet. Beslut, hvad der sker, hvis en ældre hændelse om transport ankommer efter en leveringshændelse. Bevar hændelseshistorikken uden automatisk at nedgradere den viste returstatus.
  • Adskil udbyderfejl fra transportørens tavshed. En godkendelsesfejl, en afvist anmodning eller mislykket webhook-behandling er et integrationsproblem. Ingen scanning endnu er en anden tilstand og bør kommunikeres anderledes.
  • Planlæg for dubletter og gentagelser. En leveringsopdatering kan blive gentaget. Gør hændelsesindlæsningen sikker at gentage, og undgå at sende den samme kundemeddelelse eller oprette den samme opgave to gange.
  • Beskyt kunde- og forsendelsesdata. Begræns adgangen til sporingsoplysninger, opbevar kun de data, som arbejdsgangen kræver, og gennemgå udbyderens dokumenterede krav til godkendelse og sikkerhed før lancering.
  • Bevar en manuel proces. Nogle returneringer vil have ufuldstændige, forsinkede eller uoverensstemmende sporingsoplysninger. Medarbejdere skal kunne undersøge og korrigere returposten uden at opfinde transportørhændelser.

Disse kontroller er mest nyttige, når de testes mod konkrete scenarier i stedet for én vellykket forsendelse. Et lille testsæt bør omfatte manglende første scanning, et forkert sporingsnummer, en duplikeret hændelse, en hændelse ude af rækkefølge, en leveringsrapport uden lagerkvittering og en lagerkvittering uden en matchende leveringsrapport. Den forventede kundemeddelelse og medarbejderens handling bør angives for hvert tilfælde.

Valg af API og fastlæggelse af arbejdsfordelingen

Begynd med de returruter og transportører, som virksomheden faktisk bruger. Kontrollér derefter i udbyderens aktuelle dokumentation, hvordan forsendelsesregistrering fungerer, hvilke identifikatorer der kræves, hvordan opdateringer leveres, hvilke hændelsesdata der eksponeres, og hvordan fejl og gentagelser håndteres. Bekræft de relevante transportører og returruter direkte i stedet for at udlede dem af en generel erklæring om transportørdækning. Test med repræsentative forsendelser, før du stoler på omsatte statusser til kundekommunikation eller automatisering.

17TRACK udgiver en oversigt over Tracking API og API-dokumentation; dens 17RETURNS-produktside omhandler returhåndteringssiden af arbejdsgangen. De er relevante udgangspunkter for et team, der vurderer sporingssynlighed sammen med en returproces. Tilstedeværelsen af begge produktområder bør ikke tages som bevis på, at en bestemt integration, transportør, hændelse eller automatiseret refusionsregel er tilgængelig. Verificér den præcise arbejdsgang i den aktuelle dokumentation og om nødvendigt hos udbyderen.

Ved indkøb eller et proof of concept bør teamet, der ejer returpolitikken og lagerdriften, gennemgå statusmappingen sammen med udviklingsafdelingen. Udviklingsafdelingen kan bekræfte, om API'en leverer brugbare hændelser; driften kan bekræfte, om disse hændelser berettiger den foreslåede handling. En vellykket integration er en, der hjælper medarbejdere og kunder med at følge pakken, samtidig med at godkendelse, modtagelse, inspektion og løsning forbliver separate trin.

Ofte stillede spørgsmål

Har en retur brug for et andet sporingsnummer end den oprindelige ordre?

Platformen bør vedligeholde separate poster for udgående forsendelser og returforsendelser. En retur transporteres normalt som en separat forsendelse, så dens sporings-ID skal forbindes med returpakken i stedet for at blive antaget at være den oprindelige ordres udgående identifikator. De præcise tilgængelige identifikatorer afhænger af, hvordan returen sendes.

Kan en API til sporing bekræfte, at en refusion skal udstedes?

Nej. Ingen enkelt sporingshændelse bekræfter, at den returnerede vare opfylder forhandlerens refusionsbetingelser. Platformen kan bruge transportørhændelser som input til en arbejdsgang, men retten til refusion kan også afhænge af godkendelse, fysisk modtagelse, inspektion og forhandlerens politik.

Hvad hvis sporingen viser levering, men lageret ikke kan finde pakken?

Hold den af transportøren rapporterede leveringshændelse og lagerets modtagelsespost adskilt. Kontrollér den rapporterede destination og hændelsesdetaljerne, og undersøg derefter facilitetens modtagelses- og matchningsproces. Konvertér ikke stiltiende transportørens levering til en bekræftet lagerkvittering.

Er webhooks nødvendige for at spore returforsendelser?

Ikke nødvendigvis. Opdateringsmetoden afhænger af den valgte udbyder og dennes dokumenterede muligheder. Hvis webhooks er tilgængelige, skal der planlægges for godkendelse, gentagelser, duplikerede leveringer og behandlingsfejl. Hvis polling anvendes, skal der vælges et interval og en stopregel, der passer til returarbejdsgangen og udbyderens krav.

Hvornår bør en kunde se den første sporingsopdatering?

Det afhænger af, hvornår transportøren rapporterer en hændelse, og hvornår integrationen modtager den. Oprettelse af en etiket eller registrering af en forsendelse kan ske før en scanning hos transportøren. Vis denne forskel tydeligt, så kunderne ikke fortolker en afventende første opdatering som bekræftet bevægelse.

Kilder