Skip to main content
HjemBloggVeiledningerHvordan abonnementsbaserte e-handelsmerker kan spore gjentakende forsendelser med et sporings-API

Hvordan abonnementsbaserte e-handelsmerker kan spore gjentakende forsendelser med et sporings-API

17TRACK

For å spore gjentakende forsendelser med et sporings-API oppretter du en forsendelsespost for hver fysiske pakke, knytter den til oppfyllingsordren for den aktuelle abonnementssyklusen og registrerer sporingsnummeret når lageret eller oppfyllingspartneren din oppgir det. Bruk API-ets sporingsoppdateringer til å vise kundene hvor pakken befinner seg, og flagg leveringsavvik for teamet ditt. Behold abonnements-ID-en som en kobling mellom syklusene, ikke som identifikator for en pakke.

Slik kan merkevarer innen abonnementshandel spore gjentakende forsendelser med et

Spor pakken, ikke abonnementet

Et abonnement forteller deg hva en kunde etter planen skal motta over tid. En oppfyllingsordre forteller deg hva som skal sendes ut i én syklus. Et sporingsnummer forteller deg om en bestemt pakke. Ved å holde disse postene atskilt unngår du at en forsinket forsendelse fra én syklus vises på sporingssiden for den neste.

La oss for eksempel si at en abonnementseske for mai deles i to pakker, mens juniesken sendes ut og den ene mai-pakken fortsatt er underveis. Kunden bør se to pakker under maiordren og en separat pakke under juniordren. Den sene maioppdateringen skal bare endre mai-pakken. Hvis du sender en erstatning, oppretter du en ny forsendelsespost og knytter den til den opprinnelige, slik at kundestøtten kan se hvorfor begge finnes.

  • Abonnement: Lagre abonnements-ID-en slik at kundestøtten kan finne kundens forsendelseshistorikk.
  • Syklus og ordre: Registrer syklusidentifikatoren eller planlagt oppfyllingsdato, ordre-ID-en og eventuelle oppfyllings-ID-er som trengs for å knytte pakker til riktig ordre. Ikke utled syklusen fra datoen en sporingshendelse mottas.
  • Forsendelse: Gi hver pakke en intern forsendelses-ID. Lagre transportøren og sporingsnummeret, den relevante oppfyllingsreferansen og eventuell sporingsregistrerings-ID som leverandøren returnerer. Hold kansellerte etiketter og erstattede sporingsnumre borte fra den aktive kundevisningen, men behold historikken for kundestøtten.

På en ordreside viser du fremdrift på pakkenivå sammen med eventuelt ordresammendrag. Hvis én pakke er levert og en annen er underveis, skal det stå tydelig. Vis først hele ordren som levert når alle pakkene som kreves for å fullføre den, har ankommet, med hensyn til kansellerte forsendelser og erstatninger.

Koble oppfylling til sporings-API-et

  1. Registrer fra en oppfyllingshendelse. Utløs registrering når et oppfyllingssystem, et lager eller en tredjepartslogistikkpartner sender transportør og sporingsnummer. En fornyelsesbetaling skjer for tidlig: Ordren kan fortsatt vente på utsendelse, og det finnes kanskje ikke noe sporingsnummer ennå.
  2. Lagre forsendelsen før du kaller API-et. Lagre den interne forsendelsesposten og legg registreringsforespørselen i kø. Hvis den samme oppfyllingsmeldingen kommer to ganger, bruker du den eksisterende posten i stedet for å opprette en ny pakke. Hvis API-kallet får tidsavbrudd, må du kontrollere om den opprinnelige forespørselen ble gjennomført før du prøver på nytt, når leverandøren tilbyr en måte å gjøre dette på.
  3. Knytt oppdateringer til den registrerte pakken. Bruk leverandørens registreringsidentifikator hvis den returneres i oppdateringene. Ellers matcher du på identifikatorene som er angitt i dokumentasjonen, og validerer resultatet mot forsendelsespostene dine. Hvis en oppdatering kan tilhøre mer enn én post, sender du den til gjennomgang i stedet for å bruke den på den nyeste ordren.
  4. Skill mellom oppretting av etikett og transportørens håndtering. Et sporingsnummer kan eksistere før transportøren har registrert at den har mottatt pakken. Bruk en melding som «Klargjøres for henting av transportør» når du bare har en etikett. Bruk «Underveis» først når transportørinformasjonen støtter dette.

17TRACK Tracking API er ett alternativ for dette oppsettet. Utviklerdokumentasjonen er referansen for registrering av sporingsnumre og mottak av sporingsoppdateringer. Bruk disse oppdateringene til å vedlikeholde pakkeposten i systemet ditt. Behold regler for syklustilordning, ordrestatus og kundemeldinger i netthandelsapplikasjonen din. Før lansering bør du teste med pakker fra de faktiske transportørrutene og oppfyllingspartnerne dine, i stedet for å stole på en transportørliste alene.

Gjør oppdateringer trygge å behandle to ganger

Der leverandøren tilbyr webhooks, bruker du dem til å motta oppdateringer uten å spørre etter status for hver pakke kontinuerlig. En webhook er en HTTP-forespørsel leverandøren sender til applikasjonen din. Følg leverandørens krav til verifisering, lagre godkjente nyttelaster varig og bekreft forespørsler i tråd med de dokumenterte reglene for svar. Kjør langsommere arbeid, som oppdatering av ordrevisninger eller sending av e-post, utenfor forespørselsbehandleren.

Bygg behandlingsflyten slik at en gjentatt oppdatering ikke får noen ekstra effekt. Hvis leverandøren oppgir stabile hendelses-ID-er, bruker du dem til å gjenkjenne gjentakelser. Hvis leverandøren sender øyeblikksbilder av sporingen i stedet for enkeltstående hendelser, sammenligner du den innkommende tilstanden og skannehistorikken med det du allerede har før du utfører handlinger. Dedupliser kundemeldinger separat: Et leveringsvarsel som allerede er sendt, skal ikke sendes på nytt bare fordi de samme forsendelsesdataene ble behandlet to ganger.

Hold tidspunktet da en skanning fant sted, atskilt fra tidspunktet applikasjonen din mottok den. En sent innkommende skanning av en pakke underveis kan høre hjemme i pakkeh historikken uten å erstatte en nyere levert-status. Ikke anta at enhver legitim endring flytter pakken fremover. En korrigering fra transportøren eller en oppdatering om retur til avsender kan kreve at det som vises, endres. Hvis de nye dataene er i konflikt med den lagrede tilstanden og du ikke kan avgjøre hva som er riktig, legger du forsendelsen i en kø for gjennomgang.

Kjør en periodisk kontroll av åpne forsendelser som kan trenge oppfølging: registreringer som fortsatt venter, pakker uten første skanning etter forventet overlevering og forsendelser der sporingen har blitt stille. Når API-et støtter oppslag eller oppdatering, bruker du dette selektivt innenfor leverandørens grenser. Se på mønsteret på tvers av transportører og lagre før du eskalerer. Hvis oppdateringer stopper for mange urelaterte forsendelser samtidig, undersøker du integrasjonen før du åpner individuelle leveringssaker.

Gjør sporingsdata om til nyttige kundemeldinger

Kunder trenger sjelden en e-post for hver skanning. Start med meldinger knyttet til noe de trenger å vite eller gjøre: pakken har kommet inn i transportørens nettverk, et leveringsforsøk krever handling, eller transportøren melder at pakken er levert. Vis ordre-referansen og den aktuelle esken eller syklusen, slik at abonnenter kan se hvilken forsendelse meldingen gjelder. For en delt ordre identifiserer du pakken og gjør det tydelig om resten av ordren fortsatt er på vei.

  • Etikett opprettet, ingen skanning: Kontroller forventet overlevering mot lageroppføringene. Hvis tidsvinduet for overlevering er utløpt, ber du oppfyllingsteamet bekrefte om pakken forlot anlegget før du forteller kunden at den er forsinket underveis.
  • Sporingen har sluttet å bevege seg: Bruk terskler som gjenspeiler ruten og tjenesten, i stedet for én tidsgrense for alle pakker. For grensekryssende forsendelser bør du gå gjennom den siste transportørhendelsen før du bestemmer deg for å kontakte kunden eller eskalere.
  • Mislykket forsøk eller henting kreves: Fortell kunden hvilken handling som kreves hvis transportøren oppgir tydelige instruksjoner. Hvis hendelsen er uklar, sender du saken til kundestøtten i stedet for å gjette en dato for nytt leveringsforsøk eller et hentested.
  • Markert som levert, men ikke mottatt: Behold transportørens rapporterte status og opprett en separat kundestøttesak. Arbeidsflyten for kundestøtte bør skille mellom en kundemelding og en korrigering fra transportøren.

Gi kundestøttepersonalet én samlet visning av syklusen, ordren, pakkeh istorikken og meldingene som allerede er sendt. For hvert avvik tildeler du en ansvarlig og et neste steg. Oppfyllingsteamet kan undersøke manglende overlevering, logistikkteamet kan følge opp et transportøravvik, og kundestøtten kan håndtere kommunikasjonen med kunden. En sporingsstatus beskriver pakken; den avgjør ikke om en erstatning eller refusjon skal gis.

Test overlapp før lansering

Start med én oppfyllingspartner og et sett med forsendelser som gjenspeiler hvordan partneren faktisk sender ut ordre. Inkluder en syklus med flere pakker, en ugyldiggjort etikett, en erstatning og en eldre forsendelse som fortsatt er åpen når neste syklus sendes. Spill deretter bevisst av en duplisert webhook, og lever en eldre hendelse etter en nyere. Kontroller pakkeposten, kundens ordreside, kundestøttevisningen og varslingsloggen. En test som bare bekrefter et vellykket API-svar, kan overse den mest kostbare feilen: å oppdatere feil ordre eller sende melding til feil kunde.

Overvåk registreringsfeil, andelen kvalifiserte pakker som registreres, første skanninger som skjer senere enn forventet, og oppdateringer som ikke kan matches. Hvis du sporer oppdateringsforsinkelse, skiller du mellom tiden fra en transportørhendelse til mottak og tiden systemet ditt bruker på å behandle den. Dette hjelper deg med å avgjøre om du bør undersøke en transportørfeed, webhook-endepunktet ditt eller en kø i applikasjonen.

Utvide til flere ruter når du kan svare på tre spørsmål for enhver pakke: Hvilken syklus tilhører den? Hva rapporterte transportøren sist? Hvem handler hvis oppdateringen mangler eller er feil? Hvis et svar er uklart, må du rette posttilordningen eller arbeidsflyten for avvik før du legger til flere varslingsregler.

Vanlige spørsmål

Kan et sporings-API fortelle kundene når den neste abonnementsesken sendes?

Bruk abonnementsplanen og oppfyllingssystemet for neste planlagte utsendelsesdato. Et sporings-API gjelder en bestemt pakke når sporingsinformasjon finnes. En planlagt utsendelsesdato, et estimert leveringstidspunkt fra transportøren og en bekreftet levering er ulike fakta og bør merkes separat.

Hva om lageret erstatter et sporingsnummer etter at en e-post er sendt?

Merk den gamle etiketten som erstattet, og knytt det nye sporingsnummeret til samme ordre. Hvis e-posten din peker til en sporingsside på ordrenivå, oppdaterer du siden slik at kunden kan finne den aktive pakken uten å trenge den opprinnelige transportørkoblingen. Send en korrigering når endringen påvirker informasjon kunden må handle på grunnlag av.

Hva om en oppfyllingspartner sender sporingsnumre uten transportørkoder?

Be partneren om et konsekvent transportørfelt eller en tilordning fra partnerens frakttjenestekoder. Hvis API-et tilbyr transportørgjenkjenning, må du kontrollere hvordan det fungerer med partnerens etiketter før du stoler på det. Send tvetydige treff til gjennomgang i stedet for å velge transportør basert på sporingsnummeret alene.

Trenger satte på pause eller hoppede over abonnementer sporingsposter?

Det trengs ingen pakkepost for en syklus som aldri sendes. Hvis en tidligere forsendelse fortsatt er åpen, fortsetter du å spore den selv om abonnementet er satt på pause, hoppet over eller kansellert. Abonnementsstatusen styrer fremtidig oppfylling; den forteller ikke hva som skjedde med en pakke som allerede forlot lageret.

Kilder

  • 17TRACK Tracking API — produktoversikt for integrering av pakkesporing i forretningssystemer.
  • 17TRACK Tracking API documentation — implementasjonsreferanse for registrering av sporingsnumre og mottak av sporingsdata.
  • Stripe webhook documentation — referanse for generell webhook-praksis, som håndtering av dupliserte hendelser og unngåelse av antakelser om leveringsrekkefølge. Følg sporingsleverandørens egne regler for verifisering og bekreftelser.