EPCIS 2.0
GS1-EPCIS-2.0-Ereignisse — Ereignishistorie eines Passes exportieren, Events von Partnern und ERP erfassen, Event-Speicher abfragen.
/api/v1/passports/{id}/epcisEPCIS-Ereignisse eines Passes exportieren
Exportiert die vollständige Ereignishistorie eines Passes — Lieferketten-, Service-, Eigentums- und erfasste Ereignisse — als ein einziges standardkonformes GS1-EPCIS-2.0-`EPCISDocument` in JSON-LD. Das Dokument trägt den GS1-`@context`, `type: "EPCISDocument"`, `schemaVersion: "2.0"` und eine `epcisBody.eventList` mit jedem Ereignis, das TracePass für den Pass hält. Die Digital-Link-URI des Passes ist der EPC jedes Ereignisses, sodass sich der Export direkt in jedes EPCIS-fähige Repository oder Auditor-Toolchain einfügt.
/api/v1/epcis/captureEPCIS-Ereignisse erfassen
Die GS1-EPCIS-2.0-Capture-Schnittstelle. Übermitteln Sie Lieferketten-Ereignisse von Partnern, ERP-Systemen oder Werkstatt-Scannern, und TracePass hängt sie an die passenden Pässe an. Der Request-Body akzeptiert vier Formen: ein vollständiges `EPCISDocument`, ein `EPCISQueryDocument`, ein einzelnes nacktes Event oder ein nacktes JSON-LD-Array von Events. Senden Sie `Content-Type: application/ld+json`.
/api/v1/epcis/capture/{id}Erfassungs-Job abfragen
Liest den Status eines asynchronen EPCIS-Erfassungs-Jobs — die Leseseite des EPCIS-2.0-Capture-Modells. `POST /api/v1/epcis/capture` liefert `202 Accepted` mit einer `captureJobId`; übergeben Sie diese id hier, um den Job bis zu einem Endzustand zu verfolgen.
/api/v1/epcis/eventsEPCIS-Ereignisse abfragen
Durchsuchen Sie Ihre erfassten Lieferketten-Ereignisse mit EPCIS-2.0-Query-Parametern. Acht werden unterstützt: `EQ_bizStep`, `EQ_disposition`, `EQ_eventType`, `MATCH_epc`, `EQ_bizLocation`, `EQ_readPoint`, `GE_eventTime` und `LT_eventTime`. Werte lassen sich mit `|` trennen, um mehrere Alternativen zu treffen (`EQ_bizStep=shipping|receiving`). Jeder andere Parameter liefert `400`, statt stillschweigend ignoriert zu werden — ein Tippfehler scheitert also sichtbar, statt Ihre Ergebnismenge zu erweitern.