Otvorený, na dodávateľovi nezávislý protokol udalostí pre sledovanie, doručovanie, fulfillment a logistické operácie. Od dopravcov a kuriérov až po sklady, schránky, trasy a budúce mobilné siete poskytuje OTEP spoločný jazyk pre každú prevádzkovú udalosť.
OTEP (Open Tracking Event Protocol) je otvorený, na dodávateľovi nezávislý protokol pre životný cyklus akéhokoľvek sledovateľného subjektu. Iniciovaný a spravovaný spoločnosťou Superroute, je voľne implementovateľný pre kohokoľvek. Zjednocuje vlastné doručovanie, doručovanie treťou stranou, sledovanie dopravcov, potvrdenie o doručení, výnimky, skenovania uzlov a trajektóriu vodiča do jedného toku udalostí s jedným slovníkom stavov — a je navrhnutý tak, aby sa rozšíril na sťahovanie, rozvoz jedla, skladovanie a ďalej.
Sledovanie je roztrieštené. Každý dopravca pomenúva polia inak, každý doručovací kanál žije vo vlastnom silu a pripojenie ku globálnym štandardom znamená opakovanú integráciu znova a znova.
Každý dopravca používa vlastné stavové kódy a názvy polí. Spotrebitelia píšu mapovanie na mieru pre každú integráciu.
Vaši vlastní vodiči, flotily tretích strán a dopravcovia so štítkami každý hlásia sledovanie v inej podobe, takže neexistuje žiadna jednotná časová os.
Zdieľanie sledovania s partnermi cez GS1 EPCIS, IATA ONE Record alebo UN/CEFACT znamená vytvárať a udržiavať samostatný export pre každý z nich.
OTEP je založený na udalostiach: časová os udalostí je zdrojom pravdy a aktuálny stav je len posledná udalosť. Každá udalosť je tvarovaná okolo štyroch rozmerov — Čo, Kedy, Kde a Prečo — tých istých rozmerov zdieľaných štandardmi EPCIS, ONE Record a UN/CEFACT, takže tieto štandardy sa stávajú jednoduchými projekciami namiesto paralelných modelov. Zdroje, ktoré vystavujú len aktuálny stav (bez histórie), sa spracúvajú syntetizovaním jednej udalosti na každú zmenu, takže chýbajúci zoznam udalostí nikdy nie je prekážkou.
Vlastné doručovanie, doručovanie treťou stranou a zásielky dopravcov sa zlučujú do jednej usporiadanej časovej osi udalostí pre každé sledovacie číslo.
Normalizovaný životný cyklus kanonických stavových kódov a fáz, namapovaný z každého zdroja — žiadne ďalšie hádanie pre jednotlivých dopravcov.
Premietnite akúkoľvek časovú os do GS1 EPCIS 2.0, IATA ONE Record alebo UN/CEFACT jediným parametrom požiadavky.
Všeobecný protokol s doménovými profilmi — dnes balíky; nabudúce sťahovanie, rozvoz jedla a skladovanie — nad jednou zdieľanou chrbticou udalostí.
Verejná, verzionovaná špecifikácia, ktorú môže implementovať ktokoľvek. Stabilné identifikátory, publikovaná taxonómia stavov a stavový automat.
Vystavený cez nové verejné API popri existujúcom. Nič, s čím už máte integráciu, sa nemení.
Verejné, len na čítanie, pod existujúcou predponou /api/v1. Pridajte ?format= pre projekciu do externého štandardu.
Jedna časová os dnu, štyri reprezentácie von — zvolené cez ?format= alebo profil Accept.
Natívna časová os OTEP (predvolené).
GS1 EPCIS 2.0 ObjectEvents ( JSON-LD ).
IATA ONE Záznam logistických udalostí ( JSON-LD ).
UN/CEFACT udalosti stavu prepravy.
OpenTelemetry OTLP trasy — cesta ako trasa, každá udalosť ako span.
Sledovací objekt kompatibilný s AfterShip s kontrolnými bodmi.
Zoznam Shopify FulfillmentEvent.
História sledovacích udalostí Amazon Shipping (SP-API).
Stav riadku objednávky a sledovanie Walmart Marketplace (hrubé).
Stav objednávky a sledovanie BigCommerce (hrubé).
Stav objednávky a sledovanie Magento (hrubé).
Stav objednávky a sledovanie WooCommerce (hrubé).
Stav potvrdenia a sledovanie Etsy (hrubé).
Pozorovania OGC SensorThings (IoT).
Každá udalosť sa mapuje na kanonický stav zoskupený do fáz — od pred-odoslaním cez vyzdvihnutie, prepravu a doručovanie až po koncový stav (doručené, vrátené, odmietnuté alebo zrušené).
OTEP je publikovaný ako otvorená špecifikácia — iniciovaná a spravovaná spoločnosťou Superroute, voľne implementovateľná pre kohokoľvek. Nie je to súkromný formát: obálka udalosti, chrbtica fáz, slovník stavov a stavový automat sú verejný, normatívny protokol.
Protokol (obálka, slovník, stavový automat, štandardné mapovania) je normatívny. Väzby implementátora na jeho vlastné interné systémy sú informatívne a môžu sa líšiť.
Sémantické verzionovanie. Pridávanie kódov alebo profilov je spätne kompatibilné; význam publikovaného identifikátora sa nikdy nemení. Verzia protokolu cestuje s každou udalosťou.
Kódy sú adresované ako otep:<profile>:<code> a fázy ako otep:phase:<name>, takže slovník zostáva globálne jednoznačný naprieč implementátormi.
Verejná špecifikácia, ktorú môže prijať ktorákoľvek strana, s otvorenou licenciou a verejným procesom rozšírenia — namiesto vetvenia navrhnite nové profily a kódy.
Producenti a konzumenti sa integrujú raz proti protokolu, nie raz na každého dopravcu. Štyri kroky ku konformnej implementácii.
Vyšlite každú udalosť s jej subjektom (Čo), časom výskytu a záznamu (Kedy), polohou (Kde) a kanonickým stavom plus voliteľným dôvodom (Prečo). Každé pole okrem subjektu, času a stavu je voliteľné — vyplňte, čo máte.
Preložte svoje surové stavové kódy na stavové kódy a fázy OTEP. Zdroje, ktoré vystavujú len aktuálny stav, syntetizujú jednu udalosť na každú zmenu.
Usporiadajte udalosti podľa času výskytu, tolerujte príchod mimo poradia a považujte delivered / returned / rejected / cancelled za koncové. Experimentálne kódy označte predponou x- až do registrácie.
Čítajte natívny OTEP alebo požiadajte o projekciu EPCIS / ONE Record / UN-CEFACT — tá istá udalosť, jeden parameter. Nový výstupný štandard je len nový serializér.
Úroveň 1 — vyšlite univerzálne kódy, fázy a platné prechody stavov.
Úroveň 2 — navyše vyšlite kódy špecifické pre profil a aspoň jednu projekciu do externého štandardu.
Štyri rozmery OTEP sa pole po poli zhodujú s hlavnými globálnymi štandardmi, takže každý sa stáva výstupnou projekciou namiesto paralelnej integrácie.
Každá udalosť OTEP sa stáva ObjectEvent; stav sa mapuje na CBV bizStep + disposition; poloha na readPoint. Stabilné štandardné URN.
Každá udalosť sa stáva LogisticsEvent s eventCode a eventTimeType; časová os sa pripája k Shipment / Piece.
Každá udalosť sa stáva TransportEvent s kódom stavu prepravy 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 sú stabilné štandardné URN. Hodnoty kódov ONE Record a UN/CEFACT sú najlepším priblížením pre poslednú míľu a pred externým použitím by mali byť overené oproti oficiálnym zoznamom kódov.
OTEP je vytvorený tak, aby neustále absorboval štandardy. Tieto sú na pláne interoperability.
V hodnotení: Ďalšie trhoviská (TikTok Shop, Temu, Shein a ďalšie) sa hodnotia a budú pridané, keď sa ich verejné fulfillment API ustália.
Aj keď nemôžete použiť štandard OTEP priamo, z akéhokoľvek dôvodu, srdečne vás vítame, aby ste nám vyšli v ústrety — a radi spolupracujeme na úrovni interoperability.
otep_status do svojich odpovedí API a návratových hodnôt — jeden normalizovaný, na dopravcovi nezávislý stav popri vašich vlastných existujúcich poliach. Je čisto aditívny a neovplyvní vašich súčasných konzumentov.Všetko, čo potrebujete na vytvorenie a overenie integrácie konformnej s OTEP — offline špecifikácia, strojovo čitateľná schéma a kódovník, živý validátor konformity, konfigurácia MCP a vývojárska zručnosť.
Prečítajte si úplnú normatívnu špecifikáciu protokolu v prehliadači.
Zobraziť onlinePrehliadajte online každý stavový kód, fázu a mapovanie.
Zobraziť onlineHotové príklady integrácie na skopírovanie.
Zobraziť onlinePošlite časovú os cez POST na kontrolu konformity; získate späť presné chyby a varovania.
POSThttps://api.superlabel.ca/api/v1/otep/validate
Úplná normatívna špecifikácia protokolu, offline.
Stiahnuť .mdPDF špecifikácie protokolu pripravené na tlač.
Stiahnuť .pdfOverte svoje payloady oproti schéme časovej osi OTEP.
Stiahnuť .jsonKompletné, presné stavové kódy, fázy, premostenia a externé mapovania — generované z implementácie.
Stiahnuť .jsonPripojte asistenta AI k nástrojom OTEP pre asistovaný vývoj.
Stiahnuť .jsonPripravená zručnosť, ktorá vedie tvorbu kódu konformného s OTEP.
Stiahnuť .mdKoncové body OTEP sú aktívne pod /api/v1/otep. Preskúmajte ich v referencii REST API.
Otvoriť referenciu API