Skip to main content
HomeBlogGidsenKan een tracking-API werken zonder verzendlabels? 3Pl- en marktplaatsbestellingen volgen?

Kan een tracking-API werken zonder verzendlabels? 3Pl- en marktplaatsbestellingen volgen?

17TRACK

Ja. Een tracking-API kan werken zonder dat je bedrijf verzendlabels aanmaakt, zolang een vervoerder of verzendpartner een traceerbare zending heeft aangemaakt en je een bruikbaar trackingnummer of een andere identifier kunt verkrijgen die de API ondersteunt. Dit komt vaak voor wanneer een externe logistieke dienstverlener (3PL) of marketplace de fulfilment afhandelt. Het verschil zit tussen het label niet zelf kopen en helemaal geen zendingidentifier hebben: het eerste is doorgaans werkbaar; het tweede kan ertoe leiden dat de API niets heeft om te volgen.

Kan een tracking-API werken zonder verzendlabels Tracking 3PL

Voor een verkoper, marketplace-exploitant of integratieteam bestaat de praktische taak erin elke bestelling te koppelen aan de zending die is aangemaakt door de partij die deze daadwerkelijk verzendt. Daarvoor is toegang tot de juiste gegevens nodig, niet noodzakelijk controle over het aanmaken van labels.

Wat een tracking-API nodig heeft wanneer je het label niet zelf aanmaakt

Een verzendlabel is één manier om een zendingidentifier te genereren, maar normaal gesproken is dit niet de invoer die een tracking-API leest. Trackingintegraties werken doorgaans met zendingsgegevens die worden aangeleverd nadat elders een label is aangemaakt. Maak voordat je de koppeling ontwerpt onderscheid tussen drie gegevensrecords die vaak als uitwisselbaar worden beschouwd:

  • Bestel-ID: identificeert een aankoop in je winkel, marketplace-account of orderbeheersysteem. Deze kan meerdere artikelen en meerdere zendingen omvatten.
  • Fulfilment- of pakket-ID: identificeert een fulfilmentactie of pakket in een 3PL- of marketplacesysteem. De indeling en betekenis ervan zijn afhankelijk van dat systeem.
  • Trackingnummer van de vervoerder: identificeert een zending voor trackingdoeleinden, voor zover de vervoerder en trackingdienst dit accepteren.

Met je interne bestel-ID kun je de juiste klantbestelling vinden. Deze werkt niet automatisch als trackingnummer van een vervoerder. Het gebruikelijke integratiepatroon is dat je het trackingnummer bij de 3PL of marketplace verkrijgt, dat nummer via de tracking-API registreert of opvraagt en de geretourneerde zendingsinformatie bij de relevante bestelling of het relevante pakket opslaat.

Een naam of code van de vervoerder kan ook nodig zijn. Sommige diensten kunnen proberen de vervoerder automatisch te detecteren, maar dit moet worden getest en niet als vanzelfsprekend worden beschouwd, vooral wanneer identifiers bij meerdere vervoerders overlappen of een bestelling door meerdere bezorgnetwerken gaat. Controleer de documentatie van de API op geaccepteerde identifiers, regels voor vervoerdersselectie, registratievereisten en statusvelden voordat je een implementatie vastlegt.

Zendingen volgen die door een 3PL zijn verzonden

Wanneer een 3PL een bestelling inpakt, het label koopt en het pakket aan een vervoerder overhandigt, krijgt je bedrijf het label zelf mogelijk nooit te zien. Je hebt nog steeds de zendingsgegevens nodig die uit dat proces voortkomen. Vraag de 3PL welk systeem of welke gegevensfeed trackingnummers, vervoerdersinformatie, pakketidentifiers en de bestelreferentie toont die je bij het aanvragen van fulfilment hebt opgegeven.

Een werkbare 3PL-stroom ziet er meestal als volgt uit:

  1. Stuur de bestelling en een stabiele referentie via je bestaande fulfilmentproces naar de 3PL.
  2. Ontvang een fulfilmentbevestiging met het trackingnummer op pakketniveau en, indien beschikbaar, de vervoerder.
  3. Koppel het pakket aan de juiste klantbestelling en artikelen.
  4. Dien de ondersteunde zendingidentifier in bij je tracking-API of gebruik het voorgeschreven opvraagproces van de API.
  5. Registreer trackingupdates bij het pakket en toon vervolgens een overzicht op bestelniveau aan je operationele team of klant.

Besteed bijzondere aandacht aan de koppelingsstap. Eén bestelling kan het magazijn in twee dozen verlaten, of één artikel kan later dan de andere worden verzonden. In beide gevallen is er geen afzonderlijke pakketstatus die de volledige bestelling nauwkeurig beschrijft. Houd records op pakketniveau bij en leid daaruit eventuele berichten op bestelniveau af. Markeer een bestelling bijvoorbeeld niet als geleverd alleen omdat het eerste pakket is geleverd.

Maak met de 3PL afspraken over de manier waarop correcties worden aangeleverd. Labels kunnen ongeldig worden gemaakt, pakketten kunnen opnieuw worden verpakt en een aanvankelijk trackingnummer kan worden vervangen. Je integratie moet de vervanging aan dezelfde bestelling kunnen koppelen zonder beide nummers onbeperkt als actieve zendingen weer te geven.

Marketplace-bestellingen volgen wanneer de marketplace de verzending beheert

Fulfilment via een marketplace brengt een vergelijkbare technische vraag met zich mee, maar een andere toegangs­vraag. De marketplace of diens fulfilmentpartner kan het label aanmaken, terwijl de verkoper mogelijk alleen de verzendgegevens ontvangt die via zijn account, bestelworkflow of geautoriseerde integratie beschikbaar worden gesteld. Een tracking-API kan een trackingnummer dat de marketplace niet aan jou beschikbaar heeft gesteld, niet compenseren.

Begin met het vaststellen van het fulfilmentmodel voor elke bestelling. Bij door de verkoper uitgevoerde bestellingen kan je eigen verzendworkflow of 3PL de bron van de pakketgegevens zijn. Bij door de marketplace uitgevoerde bestellingen kan de marketplace de bron van de zendingsinformatie zijn en kunnen de voor een verkoper beschikbare velden verschillen. Ga er niet van uit dat een bestelpagina met een bezorgstatus ook een trackingnummer van een vervoerder bevat dat geschikt is voor registratie bij een afzonderlijke API.

Als de marketplace een traceerbaar nummer verstrekt, controleer dan of je dit in het beoogde systeem mag ophalen en gebruiken. Test vervolgens of de tracking-API die identifier accepteert en of de resulterende gebeurtenissen nuttige informatie toevoegen bovenop de marketplace-status. Als de marketplace alleen een eigen bestel- of bezorgreferentie beschikbaar stelt, controleer dan of er een expliciet ondersteunde opvraagmethode bestaat. Dien geen interne marketplace-bestel-ID in alsof het een nummer van een vervoerder is en verwacht geen betrouwbare resultaten.

Houd de bestelstatus van de marketplace en de zendingsstatus van de tracking-API gescheiden. Een marketplace kan een bestelling als verzonden beschrijven zodra fulfilment is bevestigd, terwijl de tracking van de vervoerder nog geen acceptatiescan toont. Deze records beantwoorden verschillende vragen en kunnen op verschillende momenten worden bijgewerkt.

Wanneer tracking zonder label het probleem niet oplost

“Geen label dat door ons is aangemaakt” vormt geen blokkade. De volgende situaties kunnen dat wel zijn:

  • Er is geen zending aangemaakt: voordat fulfilment een bruikbare identifier genereert, bestaat er mogelijk geen zending van een vervoerder die kan worden opgevraagd. Alleen een orderbevestiging is geen bewijs dat er een pakket onderweg is.
  • De identifier is niet voor jou beschikbaar: een 3PL of marketplace kan het nummer bewaren zonder dit via je geautoriseerde workflow beschikbaar te stellen. Los dit probleem met gegevenstoegang bij de bron op.
  • De identifier wordt niet ondersteund: een referentienummer, een code die alleen door de marketplace wordt gebruikt of een niet-ondersteund formaat van een vervoerder werkt mogelijk niet met de gekozen API. Controleer in de documentatie en met een testzending welke invoer wordt geaccepteerd.
  • Het pakket heeft nog geen nieuwe scan: een nummer kan bestaan voordat een vervoerder een acceptatiegebeurtenis registreert. Behandel een leeg of onveranderd resultaat als een toestand die moet worden onderzocht, niet als automatisch bewijs dat het nummer ongeldig is.
  • Tracking is beperkt of onvolledig: de vervoerder, dienst of verzendworkflow levert mogelijk niet de gebeurtenissen die je klantgerichte toepassing vereist. Controleer de daadwerkelijke kwaliteit van de gebeurtenissen met representatieve zendingen.

Deze beperkingen zijn belangrijk omdat een API geen ontbrekende fysieke gebeurtenissen kan creëren en geen toegang kan verlenen tot bestelgegevens van een andere partij. De waarde ervan ligt in het ophalen en ordenen van ondersteunde trackinginformatie zodra de noodzakelijke identifier en rechten beschikbaar zijn.

Een API voor deze workflow beoordelen

De Tracking API van 17TRACK is een relevante optie om te onderzoeken wanneer je team trackinggegevens van zendingen in de eigen systemen nodig heeft, in plaats van een tool voor het kopen van labels. De ontwikkelaarsdocumentatie is de plek om te controleren welke registratievelden worden geaccepteerd, welke vervoerders worden ondersteund, hoe de respons is opgebouwd, welke authenticatie wordt gebruikt en welke methoden voor het leveren van updates beschikbaar zijn voor jouw toepassing. Leid uit het bestaan van een algemene tracking-API niet af dat een specifieke 3PL, marketplace of eigen identifier wordt ondersteund.

Stel een kleine testset samen voordat je een provider selecteert of implementeert. Neem een 3PL-bestelling met een vervoerdersnummer op, een marketplace-bestelling waarvoor je account een nummer beschikbaar stelt, een bestelling met meerdere pakketten, een nummer dat vóór de eerste scan is aangemaakt en een zending met een latere bezorggebeurtenis. Als vervangingen of internationale overdrachten gebruikelijk zijn, neem die dan ook op. De test moet operationele vragen beantwoorden en niet alleen nagaan of een verzoek een geslaagde HTTP-respons oplevert:

  • Kun je de identifiers die je daadwerkelijk ontvangt doorgeven zonder ze handmatig opnieuw in te voeren?
  • Kun je elke trackingrecord betrouwbaar aan de juiste bestelling en het juiste pakket koppelen?
  • Zijn de gebeurtenisbeschrijvingen, tijdstempels en vervoerdersinformatie voldoende voor je klantberichten en supportworkflows?
  • Hoe gaat je systeem om met dubbele updates, ontbrekende gebeurtenissen, gewijzigde nummers en mislukte verzoeken?
  • Voldoet het beoogde gebruik van marketplace- en klantgegevens aan de toegangsvoorwaarden die op die gegevens van toepassing zijn?

Bewaar voor de integratie zelf zowel het oorspronkelijke bronrecord als het record van de tracking-API. Sla de bestelreferentie, pakketreferentie, ingediende trackingnummer, vervoerdersinformatie indien beschikbaar en het tijdstip waarop elke update is ontvangen op. Hierdoor wordt het eenvoudiger een afwijking te onderzoeken zonder een API-gebeurtenis te presenteren alsof deze de volledige fulfilmentgeschiedenis vormt. Als de API de keuze biedt tussen periodiek controleren en updates ontvangen via een ondersteund leveringsmechanisme, maak je keuze dan op basis van het gedocumenteerde gedrag en je behoefte aan tijdige updates; geen van beide methoden maakt foutafhandeling overbodig.

De praktische beslissing

Gebruik een tracking-API zonder labels aan te maken wanneer een andere partij het pakket verzendt en je een ondersteunde zendingidentifier geeft die je mag gebruiken. Zorg eerst voor een betrouwbare gegevensfeed op pakketniveau van de 3PL of marketplace. Test vervolgens de identifiers en trackinggebeurtenissen tegen de API en je logica voor het koppelen van bestellingen. Als je alleen een bestel-ID of een marketplace-status hebt, los dan het ontbrekende brongegeven op voordat je investeert in een trackingintegratie voor vervoerders.

Veelgestelde vragen

Kan ik een bestelling alleen met het bestelnummer van mijn winkel volgen?

Meestal niet via een tracking-API van een vervoerder. Het bestelnummer van je winkel identificeert de aankoop in jouw systeem. Over het algemeen heb je de bijbehorende zendingidentifier nodig, tenzij de specifieke dienst expliciet opzoeking op basis van jouw type bestelreferentie ondersteunt.

Heb ik toestemming van de 3PL nodig om diens trackingnummers te gebruiken?

Bevestig je contractuele en technische toegang tot de zendingsgegevens. Een 3PL kan trackingnummers al als onderdeel van zijn fulfilmentfeed retourneren, maar de integratie moet een geautoriseerd kanaal gebruiken en klantgegevens correct verwerken.

Waarom toont de API geen beweging nadat de 3PL een nummer heeft verzonden?

Het nummer kan zijn aangemaakt voordat de vervoerder de eerste scan heeft geregistreerd. Controleer of de identifier en vervoerder correct zijn, of het oorspronkelijke label is vervangen en of een latere opvraging gebeurtenissen oplevert. Stel “nog geen scan” niet gelijk aan “niet verzonden” zonder het fulfilmentrecord te controleren.

Wat als één marketplace-bestelling in meerdere pakketten wordt verzonden?

Volg elke beschikbare pakketidentifier afzonderlijk en koppel alle pakketten aan dezelfde bestelling. Houd de klantgerichte bestelstatus gescheiden van de status van afzonderlijke pakketten, zodat één geleverd pakket niet de indruk wekt dat de volledige bestelling is afgerond.

Bronnen

  • 17TRACK Tracking API — productinformatie voor het beoordelen van een trackingintegratie voor zendingen.
  • 17TRACK API-documentatie — technische referentie voor het controleren van geaccepteerde invoer en integratiegedrag.