Un protocollo di eventi aperto e indipendente dai fornitori per le operazioni di tracciamento, consegna, evasione e logistica. Dai corrieri e dai trasportatori fino a magazzini, locker, rotte e future reti di mobilità, OTEP offre un linguaggio comune per ogni evento operativo.
OTEP (Open Tracking Event Protocol) è un protocollo aperto e indipendente dai fornitori per il ciclo di vita di qualsiasi soggetto tracciabile. Avviato e gestito da Superroute, è libero da implementare per chiunque. Unifica la consegna in proprio, la consegna di terze parti, il tracciamento dei corrieri, la prova di consegna, le eccezioni, le scansioni nei nodi e la traiettoria dell'autista in un unico flusso di eventi con un unico vocabolario di stati — ed è progettato per estendersi a traslochi, consegna di cibo, stoccaggio e oltre.
Il tracciamento è frammentato. Ogni corriere nomina i campi in modo diverso, ogni canale di consegna vive nel proprio silo e collegarsi agli standard globali significa reintegrare ancora e ancora.
Ogni corriere usa i propri codici di stato e nomi di campo. I consumatori scrivono mappature su misura per ogni integrazione.
I tuoi autisti, le flotte di terze parti e i corrieri con etichetta riportano il tracciamento in una forma diversa ciascuno, quindi non esiste un'unica cronologia.
Condividere il tracciamento con i partner su GS1 EPCIS, IATA ONE Record o UN/CEFACT significa costruire e mantenere un export separato per ciascuno.
OTEP è event-sourced: la cronologia degli eventi è la fonte di verità e lo stato corrente è semplicemente l'evento più recente. Ogni evento è modellato attorno a quattro dimensioni — Cosa, Quando, Dove e Perché — le stesse dimensioni condivise da EPCIS, ONE Record e UN/CEFACT, così che quegli standard diventano semplici proiezioni anziché modelli paralleli. Le fonti che espongono solo uno stato corrente (senza cronologia) sono gestite sintetizzando un evento per ogni cambiamento, così che una lista di eventi mancante non è mai un ostacolo.
Consegna in proprio, consegna di terze parti e spedizioni con corriere si uniscono in un'unica cronologia ordinata di eventi per numero di tracciamento.
Un ciclo di vita normalizzato di codici di stato e fasi canoniche, mappati da ogni fonte — niente più congetture per ogni corriere.
Proietta qualsiasi cronologia su GS1 EPCIS 2.0, IATA ONE Record o UN/CEFACT con un solo parametro di richiesta.
Un protocollo generale con profili di dominio — pacchi oggi; traslochi, consegna di cibo e stoccaggio in seguito — su un'unica spina dorsale condivisa di eventi.
Una specifica pubblica e versionata che chiunque può implementare. Identificatori stabili, una tassonomia di stati pubblicata e una macchina a stati.
Esposto tramite una nuova API pubblica accanto a quella esistente. Niente di ciò con cui sei già integrato cambia.
Pubblici, in sola lettura, sotto il prefisso esistente /api/v1. Aggiungi ?format= per una proiezione su standard esterno.
Una cronologia in ingresso, quattro rappresentazioni in uscita — scelte tramite ?format= o un profilo Accept.
Cronologia OTEP nativa (predefinita).
GS1 EPCIS 2.0 ObjectEvents ( JSON-LD ).
IATA ONE Registra eventi logistici ( JSON-LD ).
Eventi di stato del trasporto UN/CEFACT.
Tracce OpenTelemetry OTLP — il percorso come traccia, ogni evento uno span.
Oggetto di tracciamento compatibile con AfterShip con checkpoint.
Lista Shopify FulfillmentEvent.
Cronologia degli eventi di tracciamento Amazon Shipping (SP-API).
Stato della riga d'ordine e tracciamento di Walmart Marketplace (approssimativo).
Stato dell'ordine e tracciamento di BigCommerce (approssimativo).
Stato dell'ordine e tracciamento di Magento (approssimativo).
Stato dell'ordine e tracciamento di WooCommerce (approssimativo).
Stato della ricevuta e tracciamento di Etsy (approssimativo).
Osservazioni OGC SensorThings (IoT).
Ogni evento è mappato su uno stato canonico raggruppato in fasi — dalla pre-spedizione passando per ritiro, transito e in consegna fino a uno stato terminale (consegnato, restituito, rifiutato o annullato).
OTEP è pubblicato come specifica aperta — avviato e gestito da Superroute, libero da implementare per chiunque. Non è un formato privato: l'envelope dell'evento, la spina dorsale delle fasi, il vocabolario degli stati e la macchina a stati sono il protocollo pubblico e normativo.
Il protocollo (envelope, vocabolario, macchina a stati, mappature standard) è normativo. Le associazioni di un implementatore ai propri sistemi interni sono informative e possono differire.
Versionamento semantico. Aggiungere codici o profili è retrocompatibile; il significato di un identificatore pubblicato non cambia mai. La versione del protocollo viaggia con ogni evento.
I codici sono indirizzati come otep:<profile>:<code> e le fasi come otep:phase:<name>, così che il vocabolario resti globalmente inequivocabile tra gli implementatori.
Una specifica pubblica che chiunque può adottare, con una licenza aperta e un processo di estensione pubblico — proponi nuovi profili e codici invece di creare un fork.
Produttori e consumatori si integrano una sola volta con il protocollo, non una volta per corriere. Quattro passaggi verso un'implementazione conforme.
Emetti ogni evento con il suo soggetto (Cosa), l'orario di accadimento e di registrazione (Quando), la posizione (Dove) e uno stato canonico più un motivo opzionale (Perché). Ogni campo eccetto soggetto, orario e stato è opzionale — compila ciò che hai.
Traduci i tuoi codici di stato grezzi in codici di stato e fasi OTEP. Le fonti che espongono solo uno stato corrente sintetizzano un evento per ogni cambiamento.
Ordina gli eventi per orario di accadimento, tollera l'arrivo fuori ordine e tratta delivered / returned / rejected / cancelled come terminali. Contrassegna i codici sperimentali con un prefisso x- finché non vengono registrati.
Leggi OTEP nativo, oppure richiedi una proiezione EPCIS / ONE Record / UN-CEFACT — stesso evento, un solo parametro. Un nuovo standard di output è semplicemente un nuovo serializzatore.
Livello 1 — emetti i codici universali, le fasi e le transizioni di stato valide.
Livello 2 — emetti inoltre codici specifici del profilo e almeno una proiezione su standard esterno.
Le quattro dimensioni di OTEP si allineano campo per campo con i principali standard globali, così che ciascuno diventa una proiezione di output anziché un'integrazione parallela.
Ogni evento OTEP diventa un ObjectEvent; lo stato è mappato su bizStep + disposition del CBV; la posizione su readPoint. URN standard stabili.
Ogni evento diventa un LogisticsEvent con un eventCode e un eventTimeType; la cronologia si collega a un Shipment / Piece.
Ogni evento diventa un TransportEvent con un codice di stato del trasporto sotto un 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 |
I valori CBV di EPCIS sono URN standard stabili. I valori dei codici ONE Record e UN/CEFACT sono i più adatti per l'ultimo miglio e dovrebbero essere validati rispetto alle liste di codici ufficiali prima dell'uso esterno.
OTEP è costruito per continuare ad assorbire standard. Questi sono nella roadmap dell'interoperabilità.
In valutazione: Altri marketplace (TikTok Shop, Temu, Shein e altri) sono in fase di valutazione e verranno aggiunti man mano che le loro API pubbliche di evasione si stabilizzano.
Anche se non puoi usare lo standard OTEP direttamente, per qualsiasi ragione, ti diamo il benvenuto a venirci incontro a metà strada — e siamo lieti di collaborare a livello di interoperabilità.
otep_status alle risposte della tua API e ai valori di ritorno — un unico stato normalizzato e indipendente dal corriere accanto ai tuoi campi esistenti. È puramente additivo e non influirà sui tuoi consumatori attuali.Tutto ciò di cui hai bisogno per costruire e verificare un'integrazione conforme a OTEP — specifica offline, schema e codebook leggibili dalla macchina, un validatore di conformità live, una configurazione MCP e una skill di sviluppo.
Leggi la specifica normativa completa del protocollo nel browser.
Vedi onlineSfoglia online ogni codice di stato, fase e mappatura.
Vedi onlineEsempi di integrazione pronti da copiare e incollare.
Vedi onlineInvia una cronologia in POST per verificarne la conformità; ricevi gli errori e gli avvisi esatti.
POSThttps://api.superlabel.ca/api/v1/otep/validate
La specifica normativa completa del protocollo, offline.
Scarica .mdPDF pronto per la stampa della specifica del protocollo.
Scarica .pdfValida i tuoi payload rispetto allo schema della cronologia OTEP.
Scarica .jsonI codici di stato completi e accurati, le fasi, i bridge e le mappature esterne — generati dall'implementazione.
Scarica .jsonCollega un assistente IA agli strumenti OTEP per lo sviluppo assistito.
Scarica .jsonUna skill pronta all'uso che guida la creazione di codice conforme a OTEP.
Scarica .mdGli endpoint OTEP sono attivi sotto /api/v1/otep. Esplorali nel riferimento dell'API REST.
Apri il riferimento API