Nyílt, gyártósemleges eseményprotokoll a követéshez, kézbesítéshez, teljesítéshez és logisztikai műveletekhez. A fuvarozóktól és futároktól a raktárakig, csomagautomatákig, útvonalakig és a jövőbeli mobilitási hálózatokig az OTEP közös nyelvet biztosít minden operatív eseményhez.
Az OTEP (Open Tracking Event Protocol) egy nyílt, gyártósemleges protokoll bármely követhető alany életciklusához. A Superroute kezdeményezte és gondozza, és bárki szabadon megvalósíthatja. Egyetlen eseményfolyamba és egyetlen állapotszótárba egyesíti a saját kézbesítést, a harmadik féltől származó kézbesítést, a fuvarozói követést, a kézbesítési igazolást, a kivételeket, a csomópont-szkenneléseket és a sofőr útvonalát — és úgy tervezték, hogy kiterjeszthető legyen a költöztetésre, ételkiszállításra, tárolásra és azon túl is.
A követés széttöredezett. Minden fuvarozó másképp nevezi el a mezőket, minden kézbesítési csatorna a saját elszigetelt rendszerében él, a globális szabványokhoz való csatlakozás pedig azt jelenti, hogy újra és újra integrálni kell.
Minden fuvarozó saját állapotkódokat és mezőneveket használ. A felhasználók minden integrációhoz egyedi leképezést írnak.
A saját sofőrei, a harmadik féltől származó flották és a címkés fuvarozók mind eltérő formában jelentik a követést, így nem létezik egységes idővonal.
A követés megosztása a GS1 EPCIS, IATA ONE Record vagy UN/CEFACT szabványt használó partnerekkel azt jelenti, hogy mindegyikhez külön exportot kell felépíteni és karbantartani.
Az OTEP eseményalapú: az eseményidővonal az igazság forrása, az aktuális állapot pedig csupán a legutóbbi esemény. Minden esemény négy dimenzió köré épül — Mi, Mikor, Hol és Miért —, ugyanazon dimenziók köré, amelyeket az EPCIS, a ONE Record és az UN/CEFACT is használ, így ezek a szabványok egyszerű vetületekké válnak, nem pedig párhuzamos modellekké. Azokat a forrásokat, amelyek csak aktuális állapotot tesznek elérhetővé (előzmény nélkül), úgy kezeli, hogy minden változáshoz egy eseményt szintetizál, így a hiányzó eseménylista soha nem akadály.
A saját kézbesítés, a harmadik féltől származó kézbesítés és a fuvarozói küldemények követési számonként egyetlen rendezett eseményidővonalba olvadnak össze.
A kanonikus állapotkódok és fázisok normalizált életciklusa, amely minden forrásból leképezhető — nincs többé fuvarozónkénti találgatás.
Bármely idővonalat egyetlen kérési paraméterrel vetíthet GS1 EPCIS 2.0, IATA ONE Record vagy UN/CEFACT formátumra.
Általános protokoll domain-profilokkal — ma csomag; legközelebb költöztetés, ételkiszállítás és tárolás — egyetlen közös eseménygerincen.
Nyilvános, verziózott specifikáció, amelyet bárki megvalósíthat. Stabil azonosítók, közzétett állapot-taxonómia és állapotgép.
Egy új nyilvános API-n keresztül érhető el a meglévő mellett. Semmi sem változik abból, amivel már integrálva van.
Nyilvános, csak olvasható, a meglévő /api/v1 előtag alatt. Adja hozzá a ?format= paramétert egy külső szabványra való vetítéshez.
Egy idővonal be, négy reprezentáció ki — a ?format= vagy egy Accept profil választja ki.
Natív OTEP idővonal (alapértelmezett).
GS1 EPCIS 2.0 ObjectEvents ( JSON-LD ).
IATA ONE LogisticsEvents rögzítése ( JSON-LD ).
UN/CEFACT szállítási állapotesemények.
OpenTelemetry OTLP nyomkövetések — az út mint egy nyomkövetés, minden esemény egy szakasz.
AfterShip-kompatibilis követési objektum ellenőrzőpontokkal.
Shopify FulfillmentEvent lista.
Amazon Shipping (SP-API) követési eseményelőzmények.
Walmart Marketplace rendeléssor-állapot és követés (durva felbontású).
BigCommerce rendelési állapot és követés (durva felbontású).
Magento rendelési állapot és követés (durva felbontású).
WooCommerce rendelési állapot és követés (durva felbontású).
Etsy nyugtaállapot és követés (durva felbontású).
OGC SensorThings megfigyelések (IoT).
Minden esemény egy fázisokba csoportosított kanonikus állapotra képeződik le — a szállítás előtti szakasztól a felvételen, a tranziton és a kézbesítés alatt állapoton át egy végállapotig (kézbesítve, visszaküldve, elutasítva vagy törölve).
Az OTEP nyílt specifikációként jelenik meg — a Superroute kezdeményezte és gondozza, és bárki szabadon megvalósíthatja. Nem zárt formátum: az eseményburok, a fázisgerinc, az állapotszótár és az állapotgép a nyilvános, normatív protokoll.
A protokoll (burok, szótár, állapotgép, szabványos leképezések) normatív. A megvalósító saját belső rendszereihez való kötései informatívak és eltérhetnek.
Szemantikus verziózás. Kódok vagy profilok hozzáadása visszafelé kompatibilis; egy közzétett azonosító jelentése soha nem változik. A protokoll verziója minden eseménnyel együtt utazik.
A kódok otep:<profile>:<code>, a fázisok pedig otep:phase:<name> formában címezhetők, így a szótár globálisan egyértelmű marad a megvalósítók között.
Nyilvános specifikáció, amelyet bármely fél átvehet, nyílt licenccel és nyilvános bővítési folyamattal — javasoljon új profilokat és kódokat ahelyett, hogy elágaztatná.
A gyártók és a fogyasztók egyszer integrálnak a protokoll ellen, nem fuvarozónként egyszer. Négy lépés egy megfelelő megvalósításhoz.
Minden eseményt az alanyával (Mi), a bekövetkezés és a rögzítés idejével (Mikor), a helyével (Hol), valamint egy kanonikus állapottal és opcionális okkal (Miért) bocsásson ki. Az alany, az idő és az állapot kivételével minden mező opcionális — töltse ki, amije van.
Fordítsa le a nyers állapotkódjait OTEP állapotkódokra és fázisokra. Azok a források, amelyek csak aktuális állapotot tesznek elérhetővé, minden változáshoz egy eseményt szintetizálnak.
Rendezze az eseményeket bekövetkezési idő szerint, tűrje a sorrenden kívüli érkezést, és kezelje a kézbesítve / visszaküldve / elutasítva / törölve állapotokat végállapotként. A kísérleti kódokat x- előtaggal jelölje, amíg regisztrálva nem lesznek.
Olvassa a natív OTEP-et, vagy kérjen EPCIS / ONE Record / UN-CEFACT vetületet — ugyanaz az esemény, egy paraméter. Egy új kimeneti szabvány csupán egy új szerializáló.
1. szint — bocsássa ki az univerzális kódokat, fázisokat és érvényes állapotátmeneteket.
2. szint — ezen felül bocsásson ki profilspecifikus kódokat és legalább egy külső szabványra való vetítést.
Az OTEP négy dimenziója mezőről mezőre illeszkedik a nagy globális szabványokhoz, így mindegyik kimeneti vetületté válik, nem pedig párhuzamos integrációvá.
Minden OTEP esemény ObjectEvent lesz; az állapot CBV bizStep + disposition értékre képeződik; a hely readPoint értékre. Stabil szabványos URN-ek.
Minden esemény LogisticsEvent lesz egy eventCode és eventTimeType értékkel; az idővonal egy Shipment / Piece elemhez kapcsolódik.
Minden esemény TransportEvent lesz egy szállítási állapotkóddal egy Consignment alatt.
| 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 |
Az EPCIS CBV értékek stabil szabványos URN-ek. A ONE Record és az UN/CEFACT kódértékek a legjobb illeszkedést jelentik az utolsó kilométerhez, és külső használat előtt a hivatalos kódlistákkal kell érvényesíteni őket.
Az OTEP úgy épült, hogy folyamatosan beépítse a szabványokat. Ezek szerepelnek az együttműködési ütemtervben.
Értékelés alatt: Más piacterek (TikTok Shop, Temu, Shein és továbbiak) értékelés alatt állnak, és akkor kerülnek hozzáadásra, amikor nyilvános teljesítési API-juk stabilizálódik.
Még ha bármilyen okból nem is tudja közvetlenül használni az OTEP szabványt, szívesen látjuk, ha félúton találkozunk velünk — és örömmel működünk együtt az együttműködés szintjén.
otep_status mezőt az API-válaszaihoz és visszatérési értékeihez — egyetlen normalizált, fuvarozófüggetlen állapotot a saját meglévő mezői mellett. Ez tisztán bővítő jellegű, és nem érinti a jelenlegi felhasználóit.Minden, amire szüksége van egy OTEP-megfelelő integráció felépítéséhez és ellenőrzéséhez — offline specifikáció, géppel olvasható séma és kódkönyv, élő megfelelőség-ellenőrző, egy MCP konfiguráció és egy fejlesztői skill.
Olvasd el a teljes normatív protokoll-specifikációt a böngésződben.
Megtekintés onlineBöngészd online az összes állapotkódot, fázist és leképezést.
Megtekintés onlineKész, másolható integrációs példák.
Megtekintés onlineKüldjön be (POST) egy idővonalat a megfelelőség ellenőrzéséhez; visszakapja a pontos hibákat és figyelmeztetéseket.
POSThttps://api.superlabel.ca/api/v1/otep/validate
A teljes normatív protokoll-specifikáció, offline.
Letöltés .mdNyomtatásra kész PDF a protokoll-specifikációról.
Letöltés .pdfÉrvényesítse a payloadjait az OTEP idővonal-séma ellen.
Letöltés .jsonA teljes, pontos állapotkódok, fázisok, hidak és külső leképezések — a megvalósításból generálva.
Letöltés .jsonCsatlakoztasson egy MI-asszisztenst az OTEP eszközökhöz a segített fejlesztéshez.
Letöltés .jsonEgy használatra kész skill, amely az OTEP-megfelelő kód építését vezeti.
Letöltés .mdAz OTEP végpontok élnek az /api/v1/otep alatt. Fedezze fel őket a REST API referenciában.
API-referencia megnyitása