Skip to main content
HomeBlogGidsenHoe e-commercemerken met abonnementen terugkerende zendingen kunnen volgen met een tracking-API

Hoe e-commercemerken met abonnementen terugkerende zendingen kunnen volgen met een tracking-API

17TRACK

Om terugkerende zendingen met een tracking-API te volgen, maakt u voor elk fysiek pakket een verzendrecord aan, koppelt u dit aan de fulfilmentorder voor die abonnementsperiode en registreert u het trackingnummer zodra uw magazijn of fulfilmentpartner dit aanlevert. Gebruik de trackingupdates van de API om klanten te tonen waar dat pakket zich bevindt en markeer leveringsuitzonderingen voor uw team. Houd de abonnements-ID als koppeling tussen de verschillende periodes, niet als identificatie voor een pakket.

Hoe ecommerce-merken met abonnementen terugkerende zendingen kunnen volgen met een

Volg het pakket, niet het abonnement

Een abonnement vertelt u wat een klant in de loop van de tijd zal ontvangen. Een fulfilmentorder vertelt u wat er voor één periode moet worden verzonden. Een trackingnummer geeft informatie over een specifiek pakket. Door deze gegevens gescheiden te houden, voorkomt u dat een vertraagde zending uit de ene periode op de trackingpagina voor de volgende periode verschijnt.

Stel bijvoorbeeld dat een abonnementsdoos van mei over twee pakketten wordt verdeeld en de doos van juni wordt verzonden terwijl één pakket van mei nog onderweg is. De klant moet twee pakketten onder de bestelling van mei zien en een afzonderlijk pakket onder de bestelling van juni. De late update van mei mag alleen het pakket van mei wijzigen. Als u een vervangend pakket verstuurt, maakt u een nieuw verzendrecord aan en koppelt u dit aan het oorspronkelijke record, zodat support kan zien waarom beide bestaan.

  • Abonnement: Sla de abonnements-ID op, zodat support de verzendgeschiedenis van de klant kan vinden.
  • Periode en bestelling: Leg de periode-ID of geplande fulfilmentdatum, de order-ID en alle fulfilment-ID's vast die nodig zijn om pakketten aan de juiste bestelling te koppelen. Leid de periode niet af uit de datum waarop een trackinggebeurtenis binnenkomt.
  • Zending: Geef elk pakket een interne verzend-ID. Sla de vervoerder en het trackingnummer op, evenals de relevante fulfilmentreferentie en eventuele trackingregistratie-ID die de provider terugstuurt. Houd geannuleerde labels en vervangen trackingnummers uit de actieve klantweergave, maar bewaar de geschiedenis voor support.

Toon op een bestelpagina de voortgang per pakket naast een eventuele samenvatting van de bestelling. Als één pakket is bezorgd en een ander onderweg is, vermeld dit dan. Toon de volledige bestelling pas als bezorgd wanneer alle pakketten die nodig zijn om de bestelling te voltooien zijn aangekomen, rekening houdend met geannuleerde zendingen en vervangende pakketten.

Verbind fulfilment met de tracking-API

  1. Registreer vanuit een fulfilmentgebeurtenis. Start de registratie wanneer een fulfilmentsysteem, magazijn of externe logistieke partner de vervoerder en het trackingnummer doorstuurt. Een verlengingsbetaling is te vroeg: de bestelling wacht mogelijk nog op verzending en er bestaat misschien nog geen trackingnummer.
  2. Sla de zending op voordat u de API aanroept. Sla het interne verzendrecord op en plaats het registratieverzoek in de wachtrij. Als hetzelfde fulfilmentbericht twee keer binnenkomt, gebruikt u dat record opnieuw in plaats van een extra pakket aan te maken. Als de API-aanroep een time-out geeft, controleert u of het oorspronkelijke verzoek is geslaagd voordat u opnieuw probeert, wanneer de provider hiervoor een mogelijkheid biedt.
  3. Koppel updates aan het geregistreerde pakket. Gebruik de registratie-ID van de provider als deze in updates wordt teruggestuurd. Koppel anders op basis van de identificatiemiddelen die in de documentatie worden vermeld en valideer het resultaat aan de hand van uw verzendrecords. Als een update bij meer dan één record kan horen, stuurt u deze ter beoordeling door in plaats van de update op de meest recente bestelling toe te passen.
  4. Scheid het aanmaken van het label van de vervoersbeweging. Een trackingnummer kan bestaan voordat de vervoerder het pakket in bezit heeft. Gebruik een bericht zoals “Wordt voorbereid op afhaling door de vervoerder” wanneer u alleen een label hebt. Gebruik “Onderweg” uitsluitend wanneer de informatie van de vervoerder dit ondersteunt.

De 17TRACK Tracking API is één optie voor deze configuratie. De documentatie voor ontwikkelaars is de referentie voor het registreren van trackingnummers en het ontvangen van trackingupdates. Gebruik deze updates om het pakketrecord in uw systeem bij te houden; houd toewijzing aan periodes, voltooiing van bestellingen en regels voor klantmeldingen in uw ecommerce-applicatie. Test vóór de uitrol met pakketten uit uw daadwerkelijke vervoersroutes en van uw fulfilmentpartners, in plaats van uitsluitend op een lijst met vervoerders te vertrouwen.

Maak updates veilig om twee keer te verwerken

Wanneer uw provider webhooks aanbiedt, gebruikt u deze om updates te ontvangen zonder elk pakket voortdurend te pollen. Een webhook is een HTTP-verzoek dat de provider naar uw applicatie stuurt. Volg de verificatievereisten van de provider, sla geaccepteerde payloads duurzaam op en bevestig verzoeken volgens de gedocumenteerde responsregels. Voer trager werk, zoals het bijwerken van bestelweergaven of het verzenden van e-mails, buiten de requesthandler uit.

Bouw het verwerkingspad zo dat een herhaalde update geen extra effect heeft. Als de provider stabiele gebeurtenis-ID's levert, gebruikt u deze om herhalingen te herkennen. Als de provider trackingmomentopnamen in plaats van afzonderlijke gebeurtenissen verstuurt, vergelijkt u de binnenkomende status en scangeschiedenis met wat u al hebt voordat u actie onderneemt. Dedupliceer klantberichten afzonderlijk: een bezorgingsmelding die al is verzonden, mag niet opnieuw worden verstuurd alleen omdat dezelfde verzendgegevens twee keer zijn verwerkt.

Houd het tijdstip waarop een scan plaatsvond gescheiden van het tijdstip waarop uw applicatie deze ontving. Een laat binnengekomen scan met de status onderweg kan in de pakketgeschiedenis thuishoren zonder een nieuwere status bezorgd te vervangen. Ga er echter niet van uit dat elke legitieme wijziging een pakket vooruit laat gaan. Een correctie van de vervoerder of een update voor retour naar afzender kan vereisen dat u de weergave aanpast. Als de nieuwe gegevens conflicteren met de opgeslagen status en u niet kunt bepalen welke correct is, plaatst u de zending in een beoordelingswachtrij.

Voer periodiek een controle uit op openstaande zendingen die aandacht nodig kunnen hebben: registraties die nog in behandeling zijn, pakketten zonder eerste scan na een verwachte overdracht en zendingen waarvan de tracking stil is gevallen. Wanneer de API een lookup of vernieuwing ondersteunt, gebruikt u deze selectief binnen de limieten van de provider. Controleer het patroon bij verschillende vervoerders en magazijnen voordat u escaleert. Als updates voor veel niet-gerelateerde zendingen tegelijk stoppen, onderzoekt u de integratie voordat u afzonderlijke leveringsgevallen opent.

Maak van trackinggegevens nuttige klantberichten

Klanten hebben zelden voor elke scan een e-mail nodig. Begin met berichten die verband houden met iets wat ze moeten weten of doen: het pakket is het netwerk van de vervoerder binnengekomen, voor een bezorgpoging is actie nodig of de vervoerder meldt dat het pakket is bezorgd. Toon de orderreferentie en de relevante doos of periode, zodat abonnees kunnen zien over welke zending het bericht gaat. Identificeer bij een gesplitste bestelling het pakket en maak duidelijk of de rest van de bestelling nog onderweg is.

  • Label aangemaakt, geen scan: Controleer de verwachte overdracht aan de hand van magazijngegevens. Als het overdrachtsvenster is verstreken, vraagt u fulfilment te bevestigen of het pakket de locatie heeft verlaten voordat u de klant vertelt dat het onderweg vertraagd is.
  • Tracking beweegt niet meer: Gebruik drempelwaarden die rekening houden met de route en service, in plaats van één timer voor elk pakket. Controleer bij grensoverschrijdende zendingen de laatste vervoerdersgebeurtenis voordat u besluit contact op te nemen met de klant of te escaleren.
  • Mislukte poging of afhaling vereist: Vertel de klant welke actie nodig is als de vervoerder duidelijke instructies geeft. Als de gebeurtenis vaag is, stuurt u de zaak naar support in plaats van een herbezorgingsdatum of afhaallocatie te raden.
  • Als bezorgd gemarkeerd maar niet ontvangen: Behoud de door de vervoerder gemelde status en open een afzonderlijke supportzaak. Uw supportworkflow moet onderscheid maken tussen een melding van de klant en een correctie van de vervoerder.

Geef supportmedewerkers één overzicht van de periode, bestelling, pakketgeschiedenis en al verzonden berichten. Wijs voor elke uitzondering een verantwoordelijke en een volgende stap toe. Fulfilment kan een ontbrekende overdracht onderzoeken, logistiek kan een uitzondering bij de vervoerder opvolgen en support kan de communicatie met de klant verzorgen. Een trackingstatus beschrijft het pakket; deze bepaalt niet of een vervanging of terugbetaling verschuldigd is.

Test de overlap vóór de uitrol

Begin met één fulfilmentpartner en een reeks zendingen die weerspiegelt hoe deze partner bestellingen daadwerkelijk verzendt. Neem een periode op met meerdere pakketten, een ongeldig gemaakt label, een vervanging en een oudere zending die nog openstaat wanneer de volgende periode wordt verzonden. Speel vervolgens bewust een dubbele webhook af en lever een oudere gebeurtenis na een nieuwere aan. Controleer het pakketrecord, de bestelpagina van de klant, de supportweergave en het meldingenlogboek. Een test die alleen een geslaagd API-antwoord controleert, kan de duurste fout missen: de verkeerde bestelling bijwerken of de verkeerde klant benaderen.

Monitor registratiefouten, het aandeel in aanmerking komende pakketten dat succesvol wordt geregistreerd, eerste scans die later dan verwacht plaatsvinden en niet-gematchte updates. Als u de updatevertraging volgt, maakt u onderscheid tussen de tijd tussen een vervoerdersgebeurtenis en ontvangst ervan en de tijd die uw eigen systeem nodig heeft om deze te verwerken. Zo kunt u bepalen of u een toevoer van de vervoerder, uw webhookendpoint of een wachtrij binnen uw applicatie moet onderzoeken.

Veelgestelde vragen

Kan een tracking-API klanten vertellen wanneer hun volgende abonnementsdoos wordt verzonden?

Gebruik uw abonnementsplanning en fulfilmentsysteem voor de volgende geplande verzenddatum. Een tracking-API is bedoeld voor een specifiek pakket zodra trackinginformatie beschikbaar is. Een geplande verzenddatum, een geschatte bezorgdatum van de vervoerder en een bevestigde bezorging zijn verschillende feiten en moeten afzonderlijk worden gelabeld.

Wat als het magazijn een trackingnummer vervangt nadat er een e-mail is verzonden?

Markeer het oude label als vervangen en koppel het nieuwe trackingnummer aan dezelfde bestelling. Als uw e-mail verwijst naar een trackingpagina op bestelniveau, werkt u die pagina bij zodat de klant het actieve pakket kan vinden zonder de oorspronkelijke link van de vervoerder nodig te hebben. Stuur een correctie wanneer de wijziging gevolgen heeft voor informatie waar de klant naar moet handelen.

Wat als een fulfilmentpartner trackingnummers zonder vervoerderscodes verstuurt?

Vraag de partner om een consistent vervoerdersveld of een koppeling vanuit de codes van zijn verzendservices. Als uw API vervoerdersdetectie aanbiedt, controleert u hoe deze presteert met de labels van de partner voordat u erop vertrouwt. Stuur onduidelijke matches ter beoordeling door in plaats van een vervoerder uitsluitend op basis van het trackingnummer te kiezen.

Hebben gepauzeerde of overgeslagen abonnementen trackingrecords nodig?

Voor een periode die nooit wordt verzonden, is geen pakketrecord nodig. Als een eerdere zending nog openstaat, blijft u deze volgen, ook wanneer het abonnement is gepauzeerd, overgeslagen of geannuleerd. De abonnementsstatus bepaalt toekomstige fulfilment; deze vertelt u niet wat er is gebeurd met een pakket dat het magazijn al heeft verlaten.

Bronnen

  • 17TRACK Tracking API — productoverzicht voor het integreren van pakkettracking in bedrijfssystemen.
  • Documentatie van de 17TRACK Tracking API — implementatiereferentie voor het registreren van trackingnummers en het ontvangen van trackinggegevens.
  • Stripe-webhookdocumentatie — referentie voor algemene webhookpraktijken, zoals het verwerken van dubbele gebeurtenissen en het vermijden van aannames over de volgorde van bezorgingen. Volg de eigen regels van uw trackingprovider voor verificatie en bevestigingen.