EPCIS 2.0
Eventi GS1 EPCIS 2.0 — esportate la cronologia di un passaporto, acquisite eventi da partner e ERP, interrogate l'archivio eventi.
/api/v1/passports/{id}/epcisEsportare gli eventi EPCIS di un passaporto
Esporta la cronologia completa degli eventi di un passaporto — eventi della catena di approvvigionamento, di servizio, di proprietà e acquisiti — come un unico `EPCISDocument` GS1 EPCIS 2.0 valido secondo lo standard in JSON-LD. Il documento porta il `@context` GS1, `type: "EPCISDocument"`, `schemaVersion: "2.0"` e una `epcisBody.eventList` con ogni evento che TracePass conserva per il passaporto. L'URI Digital Link del passaporto è l'EPC di ogni evento, così l'esportazione si inserisce direttamente in qualsiasi repository compatibile con EPCIS o toolchain di revisione.
/api/v1/epcis/captureAcquisire eventi EPCIS
L'interfaccia di acquisizione GS1 EPCIS 2.0. Inviate eventi della catena di approvvigionamento da partner, sistemi ERP o scanner di reparto e TracePass li allega ai passaporti corrispondenti. Il corpo della richiesta accetta quattro forme: un `EPCISDocument` completo, un `EPCISQueryDocument`, un singolo evento nudo o un array JSON-LD nudo di eventi. Inviate `Content-Type: application/ld+json`.
/api/v1/epcis/capture/{id}Interrogare un job di acquisizione
Legge lo stato di un job di acquisizione EPCIS asincrono — il lato di lettura del modello di acquisizione EPCIS 2.0. `POST /api/v1/epcis/capture` restituisce `202 Accepted` con un `captureJobId`; passate quell'id qui per seguire il job fino a uno stato terminale.
/api/v1/epcis/eventsInterrogare eventi EPCIS
Cercate gli eventi della catena di approvvigionamento che avete acquisito usando i parametri di query EPCIS 2.0. Ne sono supportati otto: `EQ_bizStep`, `EQ_disposition`, `EQ_eventType`, `MATCH_epc`, `EQ_bizLocation`, `EQ_readPoint`, `GE_eventTime` e `LT_eventTime`. I valori possono essere separati da `|` per corrispondere a una fra più alternative (`EQ_bizStep=shipping|receiving`). Qualsiasi altro parametro restituisce `400` invece di essere ignorato in silenzio: un errore di battitura fallisce in modo visibile anziché allargare i vostri risultati.