Otevřený, na dodavateli nezávislý protokol událostí pro sledování, doručování, fulfillment a logistické operace. Od dopravců a kurýrů přes sklady, schránky, trasy až po budoucí mobilitní sítě poskytuje OTEP společný jazyk pro každou provozní událost.
OTEP (Open Tracking Event Protocol) je otevřený, na dodavateli nezávislý protokol pro životní cyklus jakéhokoli sledovatelného předmětu. Iniciovaný a spravovaný společností Superroute, je zdarma k implementaci pro kohokoli. Sjednocuje vlastní doručování, doručování třetích stran, sledování dopravců, potvrzení o doručení, výjimky, skenování uzlů a trajektorii řidiče do jednoho proudu událostí s jedním slovníkem stavů — a je navržen tak, aby se rozšířil na stěhování, rozvoz jídla, skladování a dále.
Sledování je roztříštěné. Každý dopravce pojmenovává pole jinak, každý doručovací kanál žije ve vlastním silu a propojení s globálními standardy znamená opakovanou integraci znovu a znovu.
Každý dopravce používá vlastní stavové kódy a názvy polí. Spotřebitelé píší vlastní mapování pro každou integraci.
Vaši vlastní řidiči, flotily třetích stran a štítkoví dopravci hlásí sledování každý v jiné podobě, takže neexistuje jediná časová osa.
Sdílení sledování s partnery na GS1 EPCIS, IATA ONE Record nebo UN/CEFACT znamená vytvářet a udržovat samostatný export pro každý z nich.
OTEP je založen na událostech: časová osa událostí je zdrojem pravdy a aktuální stav je jen nejnovější událostí. Každá událost je formována kolem čtyř dimenzí — Co, Kdy, Kde a Proč — stejných dimenzí sdílených EPCIS, ONE Record a UN/CEFACT, takže se tyto standardy stávají jednoduchými projekcemi spíše než paralelními modely. Zdroje, které vystavují pouze aktuální stav (bez historie), jsou zpracovány syntetizováním jedné události na každou změnu, takže chybějící seznam událostí nikdy není překážkou.
Vlastní doručování, doručování třetích stran a zásilky dopravců se slučují do jedné seřazené časové osy událostí pro každé sledovací číslo.
Normalizovaný životní cyklus kanonických stavových kódů a fází, mapovaný z každého zdroje — žádné dohadování pro jednotlivé dopravce.
Projektujte jakoukoli časovou osu do GS1 EPCIS 2.0, IATA ONE Record nebo UN/CEFACT pomocí jediného parametru požadavku.
Obecný protokol s doménovými profily — dnes balíky; dále stěhování, rozvoz jídla a skladování — nad jednou sdílenou páteří událostí.
Veřejná, verzovaná specifikace, kterou může implementovat kdokoli. Stabilní identifikátory, zveřejněná taxonomie stavů a stavový automat.
Vystaven prostřednictvím nového veřejného API vedle stávajícího. Nic, s čím už integrujete, se nemění.
Veřejné, jen pro čtení, pod stávajícím prefixem /api/v1. Přidejte ?format= pro projekci do externího standardu.
Jedna časová osa dovnitř, čtyři reprezentace ven — vybrané pomocí ?format= nebo Accept profilu.
Nativní časová osa OTEP (výchozí).
GS1 EPCIS 2.0 ObjectEvents ( JSON-LD ).
IATA ONE Záznam LogisticsEvents ( JSON-LD ).
UN/CEFACT události stavu přepravy.
OpenTelemetry OTLP trasy — cesta jako trasa, každá událost jako span.
Objekt sledování kompatibilní s AfterShip s kontrolními body.
Seznam Shopify FulfillmentEvent.
Amazon Shipping (SP-API) historie sledovacích událostí.
Walmart Marketplace stav řádku objednávky a sledování (hrubé).
BigCommerce stav objednávky a sledování (hrubé).
Magento stav objednávky a sledování (hrubé).
WooCommerce stav objednávky a sledování (hrubé).
Etsy stav účtenky a sledování (hrubé).
OGC SensorThings pozorování (IoT).
Každá událost se mapuje na kanonický stav seskupený do fází — od přípravy před odesláním přes vyzvednutí, přepravu a vyjetí k doručení až po koncový stav (doručeno, vráceno, odmítnuto nebo zrušeno).
OTEP je publikován jako otevřená specifikace — iniciovaná a spravovaná společností Superroute, zdarma k implementaci pro kohokoli. Není to soukromý formát: obálka události, páteř fází, slovník stavů a stavový automat jsou veřejný, normativní protokol.
Protokol (obálka, slovník, stavový automat, standardní mapování) je normativní. Vazby implementátora na jeho vlastní interní systémy jsou informativní a mohou se lišit.
Sémantické verzování. Přidávání kódů nebo profilů je zpětně kompatibilní; význam zveřejněného identifikátoru se nikdy nemění. Verze protokolu cestuje s každou událostí.
Kódy jsou adresovány jako otep:<profile>:<code> a fáze jako otep:phase:<name>, takže slovník zůstává globálně jednoznačný napříč implementátory.
Veřejná specifikace, kterou může přijmout kdokoli, s otevřenou licencí a veřejným procesem rozšíření — navrhujte nové profily a kódy místo forkování.
Producenti a spotřebitelé se integrují jednou proti protokolu, ne jednou za každého dopravce. Čtyři kroky ke konformní implementaci.
Vyzařujte každou událost s jejím předmětem (Co), časem výskytu a záznamu (Kdy), umístěním (Kde) a kanonickým stavem plus volitelným důvodem (Proč). Každé pole kromě předmětu, času a stavu je volitelné — vyplňte to, co máte.
Přeložte své surové stavové kódy na stavové kódy a fáze OTEP. Zdroje, které vystavují pouze aktuální stav, syntetizují jednu událost na každou změnu.
Seřaďte události podle času výskytu, tolerujte příchod mimo pořadí a považujte delivered / returned / rejected / cancelled za koncové. Označte experimentální kódy prefixem x- dokud nejsou registrovány.
Čtěte nativní OTEP nebo požádejte o projekci EPCIS / ONE Record / UN-CEFACT — stejná událost, jeden parametr. Nový výstupní standard je jen nový serializér.
Úroveň 1 — vyzařujte univerzální kódy, fáze a platné stavové přechody.
Úroveň 2 — navíc vyzařujte kódy specifické pro profil a alespoň jednu projekci do externího standardu.
Čtyři dimenze OTEP se shodují pole po poli s hlavními globálními standardy, takže každý se stává výstupní projekcí spíše než paralelní integrací.
Každá událost OTEP se stává ObjectEvent; stav se mapuje na CBV bizStep + disposition; umístění na readPoint. Stabilní standardní URN.
Každá událost se stává LogisticsEvent s eventCode a eventTimeType; časová osa se připojuje k Shipment / Piece.
Každá událost se stává TransportEvent s kódem stavu přepravy pod 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 |
Hodnoty EPCIS CBV jsou stabilní standardní URN. Kódové hodnoty ONE Record a UN/CEFACT jsou nejvhodnější shodou pro poslední míli a měly by být ověřeny proti oficiálním seznamům kódů před externím použitím.
OTEP je navržen tak, aby neustále vstřebával standardy. Tyto jsou na cestovní mapě interoperability.
V hodnocení: Další tržiště (TikTok Shop, Temu, Shein a další) jsou hodnocena a budou přidána, jakmile se jejich veřejná fulfillment API stabilizují.
I když z jakéhokoli důvodu nemůžete použít standard OTEP přímo, srdečně vás vítáme, abyste nám vyšli vstříc na půl cesty — a rádi budeme spolupracovat na úrovni interoperability.
otep_status do svých API odpovědí a návratových hodnot — jeden normalizovaný stav nezávislý na dopravci vedle svých vlastních stávajících polí. Je čistě aditivní a neovlivní vaše současné spotřebitele.Vše, co potřebujete k vytvoření a ověření integrace konformní s OTEP — offline specifikace, strojově čitelné schéma a kódovník, živý validátor konformity, MCP konfigurace a vývojová dovednost.
Přečtěte si úplnou normativní specifikaci protokolu v prohlížeči.
Zobrazit onlineProcházejte online každý stavový kód, fázi a mapování.
Zobrazit onlineHotové příklady integrace ke zkopírování.
Zobrazit onlinePOSTněte časovou osu pro kontrolu konformity; dostanete zpět přesné chyby a varování.
POSThttps://api.superlabel.ca/api/v1/otep/validate
Úplná normativní specifikace protokolu, offline.
Stáhnout .mdPDF specifikace protokolu připravené k tisku.
Stáhnout .pdfValidujte své payloady proti schématu časové osy OTEP.
Stáhnout .jsonÚplné, přesné stavové kódy, fáze, mosty a externí mapování — generované z implementace.
Stáhnout .jsonPřipojte AI asistenta k nástrojům OTEP pro asistovaný vývoj.
Stáhnout .jsonPřipravená dovednost, která vede k vytváření kódu konformního s OTEP.
Stáhnout .mdKoncové body OTEP jsou aktivní pod /api/v1/otep. Prozkoumejte je v referenci REST API.
Otevřít referenci API