Een open, leverancieronafhankelijk gebeurtenisprotocol voor tracking, bezorging, fulfilment en logistieke operaties. Van vervoerders en koeriers tot magazijnen, lockers, routes en toekomstige mobiliteitsnetwerken biedt OTEP een gemeenschappelijke taal voor elke operationele gebeurtenis.
OTEP (Open Tracking Event Protocol) is een open, leverancieronafhankelijk protocol voor de levenscyclus van elk traceerbaar onderwerp. Het is geïnitieerd en wordt beheerd door Superroute, en is voor iedereen vrij te implementeren. Het verenigt eigen bezorging, bezorging door derden, vervoerder-tracking, bezorgbewijs, uitzonderingen, knooppuntscans en chauffeurstrajecten in één gebeurtenisstroom met één statusvocabulaire — en is ontworpen om uit te breiden naar verhuizingen, maaltijdbezorging, opslag en meer.
Tracking is gefragmenteerd. Elke vervoerder benoemt velden anders, elk bezorgkanaal leeft in zijn eigen silo, en aansluiten op wereldwijde standaarden betekent telkens opnieuw integreren.
Elke vervoerder gebruikt zijn eigen statuscodes en veldnamen. Consumenten schrijven voor elke integratie een mapping op maat.
Je eigen chauffeurs, externe vloten en labelvervoerders rapporteren tracking elk in een andere vorm, waardoor er geen enkele tijdlijn bestaat.
Tracking delen met partners op GS1 EPCIS, IATA ONE Record of UN/CEFACT betekent voor elk een aparte export bouwen en onderhouden.
OTEP is event-sourced: de gebeurtenistijdlijn is de bron van waarheid en de huidige status is slechts de meest recente gebeurtenis. Elke gebeurtenis is opgebouwd rond vier dimensies — Wat, Wanneer, Waar en Waarom — dezelfde dimensies die EPCIS, ONE Record en UN/CEFACT delen, zodat die standaarden eenvoudige projecties worden in plaats van parallelle modellen. Bronnen die alleen een huidige status blootgeven (geen historie) worden afgehandeld door één gebeurtenis per wijziging te synthetiseren, zodat een ontbrekende gebeurtenislijst nooit een blokkade is.
Eigen bezorging, bezorging door derden en zendingen van vervoerders versmelten tot één geordende gebeurtenistijdlijn per trackingnummer.
Een genormaliseerde levenscyclus van canonieke statuscodes en fasen, gemapt vanuit elke bron — geen giswerk meer per vervoerder.
Projecteer elke tijdlijn naar GS1 EPCIS 2.0, IATA ONE Record of UN/CEFACT met één enkele aanvraagparameter.
Een algemeen protocol met domeinprofielen — vandaag pakketten; daarna verhuizingen, maaltijdbezorging en opslag — over één gedeelde gebeurtenisruggengraat.
Een openbare, geversioneerde specificatie die iedereen kan implementeren. Stabiele identifiers, een gepubliceerde statustaxonomie en een toestandsmachine.
Beschikbaar gesteld via een nieuwe openbare API naast de bestaande. Niets waarmee je al integreert verandert.
Openbaar, alleen-lezen, onder de bestaande /api/v1-prefix. Voeg ?format= toe voor een projectie naar een externe standaard.
Eén tijdlijn erin, vier representaties eruit — gekozen via ?format= of een Accept-profiel.
Native OTEP-tijdlijn (standaard).
GS1 EPCIS 2.0 ObjectEvents ( JSON-LD ).
IATA ONE Logistieke gebeurtenissen vastleggen ( JSON-LD ).
UN/CEFACT transportstatusgebeurtenissen.
OpenTelemetry OTLP-traces — de reis als een trace, elke gebeurtenis een span.
AfterShip-compatibel trackingobject met checkpoints.
Shopify FulfillmentEvent-lijst.
Amazon Shipping (SP-API) trackinggebeurtenisgeschiedenis.
Walmart Marketplace orderregelstatus en tracking (grofkorrelig).
BigCommerce orderstatus en tracking (grofkorrelig).
Magento orderstatus en tracking (grofkorrelig).
WooCommerce orderstatus en tracking (grofkorrelig).
Etsy ontvangststatus en tracking (grofkorrelig).
OGC SensorThings-waarnemingen (IoT).
Elke gebeurtenis wordt gemapt naar een canonieke status, gegroepeerd in fasen — van pre-verzending via ophaling, transit en onderweg-voor-bezorging tot een terminale toestand (bezorgd, geretourneerd, geweigerd of geannuleerd).
OTEP wordt gepubliceerd als een open specificatie — geïnitieerd en beheerd door Superroute, voor iedereen vrij te implementeren. Het is geen privéformaat: de gebeurtenisenvelop, de faseruggengraat, het statusvocabulaire en de toestandsmachine vormen het openbare, normatieve protocol.
Het protocol (envelop, vocabulaire, toestandsmachine, standaardmappings) is normatief. De koppelingen van een implementator naar zijn eigen interne systemen zijn informatief en mogen verschillen.
Semantische versionering. Codes of profielen toevoegen is achterwaarts compatibel; de betekenis van een gepubliceerde identifier verandert nooit. De protocolversie reist met elke gebeurtenis mee.
Codes worden geadresseerd als otep:<profile>:<code> en fasen als otep:phase:<name>, zodat het vocabulaire wereldwijd ondubbelzinnig blijft tussen implementatoren.
Een openbare specificatie die elke partij kan overnemen, met een open licentie en een openbaar uitbreidingsproces — stel nieuwe profielen en codes voor in plaats van te forken.
Producenten en consumenten integreren één keer tegen het protocol, niet één keer per vervoerder. Vier stappen naar een conforme implementatie.
Stuur elke gebeurtenis met zijn onderwerp (Wat), het tijdstip van optreden en registratie (Wanneer), de locatie (Waar) en een canonieke status plus optionele reden (Waarom). Elk veld behalve onderwerp, tijd en status is optioneel — vul in wat je hebt.
Vertaal je ruwe statuscodes naar OTEP-statuscodes en -fasen. Bronnen die alleen een huidige status blootgeven, synthetiseren één gebeurtenis per wijziging.
Orden gebeurtenissen op tijdstip van optreden, tolereer aankomst in willekeurige volgorde, en behandel delivered / returned / rejected / cancelled als terminaal. Markeer experimentele codes met een x--prefix totdat ze geregistreerd zijn.
Lees native OTEP, of vraag een EPCIS- / ONE Record- / UN-CEFACT-projectie aan — dezelfde gebeurtenis, één parameter. Een nieuwe uitvoerstandaard is gewoon een nieuwe serializer.
Niveau 1 — geef de universele codes, fasen en geldige toestandsovergangen uit.
Niveau 2 — geef daarnaast profielspecifieke codes en ten minste één projectie naar een externe standaard uit.
De vier dimensies van OTEP sluiten veld-voor-veld aan op de grote wereldwijde standaarden, zodat elk een uitvoerprojectie wordt in plaats van een parallelle integratie.
Elke OTEP-gebeurtenis wordt een ObjectEvent; status mapt naar CBV bizStep + disposition; locatie naar readPoint. Stabiele standaard-URN's.
Elke gebeurtenis wordt een LogisticsEvent met een eventCode en eventTimeType; de tijdlijn koppelt aan een Shipment / Piece.
Elke gebeurtenis wordt een TransportEvent met een transportstatuscode onder een Consignment.
| OTEP | GS1 EPCIS 2.0 | IATA ONE Record | UN/CEFACT |
|---|---|---|---|
| occurred_at | eventTime | eventDate | Occurrence Date/Time |
| status_code | bizStep + disposition | eventCode | Transport status code |
| location | readPoint / bizLocation | recordedAtLocation | Location |
| subject | epcList | linkedObject | Consignment |
| incident_reason | disposition | event remark | Status reason code |
EPCIS CBV-waarden zijn stabiele standaard-URN's. ONE Record- en UN/CEFACT-codewaarden zijn een best-fit voor last-mile en moeten vóór extern gebruik gevalideerd worden tegen de officiële codelijsten.
OTEP is gebouwd om standaarden te blijven opnemen. Deze staan op de interoperabiliteitsroadmap.
In evaluatie: Andere marktplaatsen (TikTok Shop, Temu, Shein en meer) worden geëvalueerd en worden toegevoegd zodra hun openbare fulfilment-API's stabiliseren.
Zelfs als je de OTEP-standaard om welke reden dan ook niet rechtstreeks kunt gebruiken, heten we je van harte welkom om ons halverwege tegemoet te komen — en werken we graag samen op het interoperabiliteitsniveau.
otep_status-veld toe aan je API-responses en retourwaarden — één genormaliseerde, vervoerderonafhankelijke status naast je eigen bestaande velden. Het is puur additief en heeft geen invloed op je huidige consumenten.Alles wat je nodig hebt om een OTEP-conforme integratie te bouwen en te verifiëren — offline specificatie, machineleesbaar schema en codeboek, een live conformiteitsvalidator, een MCP-config en een ontwikkelvaardigheid.
Lees de volledige normatieve protocolspecificatie in je browser.
Online bekijkenBlader online door elke statuscode, fase en mapping.
Online bekijkenKant-en-klare, kopieerbare integratievoorbeelden.
Online bekijkenPOST een tijdlijn om te controleren of die conform is; je krijgt de exacte fouten en waarschuwingen terug.
POSThttps://api.superlabel.ca/api/v1/otep/validate
De volledige normatieve protocolspecificatie, offline.
Downloaden .mdPrintklare PDF van de protocolspecificatie.
Downloaden .pdfValideer je payloads tegen het OTEP-tijdlijnschema.
Downloaden .jsonDe volledige, accurate statuscodes, fasen, bruggen en externe mappings — gegenereerd uit de implementatie.
Downloaden .jsonVerbind een AI-assistent met de OTEP-tools voor begeleide ontwikkeling.
Downloaden .jsonEen kant-en-klare vaardigheid die begeleidt bij het bouwen van OTEP-conforme code.
Downloaden .mdOTEP-endpoints zijn live onder /api/v1/otep. Verken ze in de REST API-referentie.
Open API-referentie