Otvoren, neutralan protokol događaja za praćenje, isporuku, ispunjenje porudžbina i logističke operacije, nezavisan od dobavljača. Od prevoznika i kurira do magacina, ormarića, ruta i budućih mreža mobilnosti, OTEP pruža zajednički jezik za svaki operativni događaj.
OTEP (Open Tracking Event Protocol) je otvoren protokol nezavisan od dobavljača za životni ciklus bilo kog subjekta koji se može pratiti. Pokrenut i vođen od strane Superroute-a, slobodan je za primenu od strane bilo koga. Objedinjuje sopstvenu isporuku, isporuku trećih strana, praćenje prevoznika, dokaz o isporuci, izuzetke, skeniranja na čvorovima i putanju vozača u jedan tok događaja sa jednim rečnikom statusa — i osmišljen je da se proširi na selidbe, dostavu hrane, skladištenje i dalje.
Praćenje je fragmentisano. Svaki prevoznik imenuje polja drugačije, svaki kanal isporuke živi u sopstvenom silosu, a povezivanje sa globalnim standardima znači ponovnu integraciju iznova i iznova.
Svaki prevoznik koristi sopstvene statusne kodove i nazive polja. Korisnici pišu prilagođeno mapiranje za svaku integraciju.
Vaši sopstveni vozači, flote trećih strana i prevoznici sa nalepnicama svaki prijavljuju praćenje u drugačijem obliku, pa ne postoji jedinstvena vremenska linija.
Deljenje praćenja sa partnerima na GS1 EPCIS, IATA ONE Record ili UN/CEFACT znači izgradnju i održavanje odvojenog izvoza za svaki od njih.
OTEP je zasnovan na događajima: vremenska linija događaja je izvor istine, a trenutni status je samo poslednji događaj. Svaki događaj je oblikovan oko četiri dimenzije — Šta, Kada, Gde i Zašto — istih dimenzija koje dele EPCIS, ONE Record i UN/CEFACT, tako da ti standardi postaju jednostavne projekcije umesto paralelnih modela. Izvori koji izlažu samo trenutni status (bez istorije) obrađuju se sintetizovanjem jednog događaja po promeni, tako da nedostatak liste događaja nikada nije prepreka.
Sopstvena isporuka, isporuka trećih strana i pošiljke prevoznika spajaju se u jednu uređenu vremensku liniju događaja po broju za praćenje.
Normalizovan životni ciklus kanonskih statusnih kodova i faza, mapiran iz svakog izvora — bez nagađanja po prevozniku.
Projektujte bilo koju vremensku liniju u GS1 EPCIS 2.0, IATA ONE Record ili UN/CEFACT jednim parametrom zahteva.
Opšti protokol sa domenskim profilima — paket danas; selidbe, dostava hrane i skladištenje sledeći — preko jedne zajedničke kičme događaja.
Javna, verzionirana specifikacija koju bilo ko može primeniti. Stabilni identifikatori, objavljena taksonomija statusa i automat stanja.
Izložen kroz novi javni API uporedo sa postojećim. Ništa sa čime se već integrišete se ne menja.
Javne, samo za čitanje, pod postojećim /api/v1 prefiksom. Dodajte ?format= za projekciju eksternog standarda.
Jedna vremenska linija unutra, četiri reprezentacije napolju — odabrane preko ?format= ili Accept profila.
Izvorna OTEP vremenska linija (podrazumevano).
GS1 EPCIS 2.0 ОбјецтЕвентс ( JSON-LD ).
IATA ONE Запиши логистичке догађаје ( JSON-LD ).
UN/CEFACT događaji statusa transporta.
OpenTelemetry OTLP tragovi — putovanje kao trag, svaki događaj kao raspon.
Objekat za praćenje kompatibilan sa AfterShip-om sa kontrolnim tačkama.
Shopify FulfillmentEvent lista.
Amazon Shipping (SP-API) istorija događaja praćenja.
Walmart Marketplace status stavke porudžbine i praćenje (grubo).
BigCommerce status porudžbine i praćenje (grubo).
Magento stanje porudžbine i praćenje (grubo).
WooCommerce status porudžbine i praćenje (grubo).
Etsy status priznanice i praćenje (grubo).
OGC SensorThings opservacije (IoT).
Svaki događaj se mapira na kanonski status grupisan u faze — od pred-otpreme kroz preuzimanje, tranzit i izlazak na isporuku do terminalnog stanja (isporučeno, vraćeno, odbijeno ili otkazano).
OTEP je objavljen kao otvorena specifikacija — pokrenut i vođen od strane Superroute-a, slobodan za primenu od strane bilo koga. Nije privatni format: omotač događaja, kičma faza, rečnik statusa i automat stanja su javni, normativni protokol.
Protokol (omotač, rečnik, automat stanja, standardna mapiranja) je normativan. Povezivanja implementatora sa sopstvenim internim sistemima su informativna i mogu se razlikovati.
Semantičko verzionisanje. Dodavanje kodova ili profila je unazad kompatibilno; značenje objavljenog identifikatora se nikada ne menja. Verzija protokola putuje sa svakim događajem.
Kodovi se adresiraju kao otep:<profile>:<code>, a faze kao otep:phase:<name>, tako da rečnik ostaje globalno nedvosmislen kroz implementatore.
Javna specifikacija koju bilo koja strana može usvojiti, sa otvorenom licencom i javnim procesom proširenja — predložite nove profile i kodove umesto grananja.
Proizvođači i potrošači se integrišu jednom prema protokolu, a ne jednom po prevozniku. Četiri koraka do usaglašene implementacije.
Emitujte svaki događaj sa njegovim subjektom (Šta), vremenom pojave i zapisa (Kada), lokacijom (Gde) i kanonskim statusom plus opcionim razlogom (Zašto). Svako polje osim subjekta, vremena i statusa je opciono — popunite ono što imate.
Prevedite svoje sirove statusne kodove u OTEP statusne kodove i faze. Izvori koji izlažu samo trenutni status sintetizuju jedan događaj po promeni.
Uredite događaje po vremenu pojave, tolerišite dolazak van redosleda i tretirajte isporučeno / vraćeno / odbijeno / otkazano kao terminalno. Označite eksperimentalne kodove sa x- prefiksom dok se ne registruju.
Čitajte izvorni OTEP, ili zatražite EPCIS / ONE Record / UN-CEFACT projekciju — isti događaj, jedan parametar. Novi izlazni standard je samo novi serijalizator.
Nivo 1 — emituje univerzalne kodove, faze i validne prelaze stanja.
Nivo 2 — dodatno emituje kodove specifične za profil i najmanje jednu projekciju eksternog standarda.
Četiri dimenzije OTEP-a se poklapaju polje-za-polje sa glavnim globalnim standardima, tako da svaki postaje izlazna projekcija umesto paralelne integracije.
Svaki OTEP događaj postaje ObjectEvent; status se mapira na CBV bizStep + disposition; lokacija na readPoint. Stabilni standardni URN-ovi.
Svaki događaj postaje LogisticsEvent sa eventCode i eventTimeType; vremenska linija se prikačinje na Shipment / Piece.
Svaki događaj postaje TransportEvent sa kodom statusa transporta 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 |
EPCIS CBV vrednosti su stabilni standardni URN-ovi. ONE Record i UN/CEFACT vrednosti kodova su najbolje uklapanje za poslednju milju i treba ih validirati u odnosu na zvanične liste kodova pre eksterne upotrebe.
OTEP je izgrađen da nastavi da apsorbuje standarde. Ovi su na mapi puta interoperabilnosti.
U razmatranju: Druga tržišta (TikTok Shop, Temu, Shein i druga) se procenjuju i biće dodata kako se njihovi javni API-ji za ispunjenje stabilizuju.
Čak i ako ne možete direktno da koristite OTEP standard, iz bilo kog razloga, toplo vas pozivamo da nam izađete u susret na pola puta — i rado ćemo sarađivati na nivou interoperabilnosti.
otep_status polje svojim API odgovorima i povratnim vrednostima — jedan normalizovan status nezavisan od prevoznika uz vaša postojeća polja. To je čisto aditivno i neće uticati na vaše trenutne korisnike.Sve što vam je potrebno da izgradite i verifikujete OTEP-usaglašenu integraciju — oflajn specifikacija, mašinski čitljiva šema i kodeks, validator usaglašenosti uživo, MCP konfiguracija i razvojna veština.
Pročitajte kompletnu normativnu specifikaciju protokola u pregledaču.
Pogledaj onlajnPregledajte onlajn svaki statusni kod, fazu i mapiranje.
Pogledaj onlajnGotovi primeri integracije spremni za kopiranje.
Pogledaj onlajnPOST vremenske linije da proverite da li je usaglašena; dobijate tačne greške i upozorenja.
POSThttps://api.superlabel.ca/api/v1/otep/validate
Puna normativna specifikacija protokola, oflajn.
Preuzmi .mdPDF specifikacije protokola spreman za štampu.
Preuzmi .pdfValidirajte svoje payload-ove u odnosu na OTEP šemu vremenske linije.
Preuzmi .jsonKompletni, tačni statusni kodovi, faze, mostovi i eksterna mapiranja — generisani iz implementacije.
Preuzmi .jsonPovežite AI asistenta sa OTEP alatima za potpomognut razvoj.
Preuzmi .jsonVeština spremna za upotrebu koja vodi izgradnju OTEP-usaglašenog koda.
Preuzmi .mdOTEP krajnje tačke su uživo pod /api/v1/otep. Istražite ih u REST API referenci.
Otvori API referencu