TracePass
Loslegen
EPCIS 2.0

EPCIS-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.

GET/api/v1/passports/{id}/epcis
OpenAPI 3.1 herunterladen
GET/api/v1/passports/{id}/epcis

EPCIS-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.

Alternative Adressierung: `GET /api/v1/passports/by-serial/{serial}/epcis` liefert dasselbe EPCISDocument für einen über seine Seriennummer statt seine ID adressierten Pass — praktisch, wenn Ihre Systeme auf die GS1-Seriennummer statt auf die TracePass-ObjectId schlüsseln. Zählt als ein Pass-Lesevorgang.

Der EPCIS-Export ist ab den Starter-Plänen verfügbar: auf einem Plan ohne ihn liefert der Endpoint `403 {"error":"epcis_export_not_available"}`. Eine unbekannte Pass-id liefert `404`.

Pfad-Parameter

  • iderforderlich

    ObjectId

    Pass-ID. Verwenden Sie `GET /api/v1/passports/by-serial/{serial}/epcis`, um den Pass stattdessen über seine GS1-Seriennummer zu adressieren.

Header

  • Authorizationerforderlich

    string

    `Bearer <api-key>`.

Anfrage

# By passport ID
curl -sS https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/epcis \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

# By GS1 serial number
curl -sS https://app.tracepass.eu/api/v1/passports/by-serial/BP-48V-100-000001/epcis \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "@context": "https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld",
  "type": "EPCISDocument",
  "schemaVersion": "2.0",
  "creationDate": "2026-05-09T12:00:00.000Z",
  "epcisBody": {
    "eventList": [
      {
        "type": "ObjectEvent",
        "eventID": "ni:///sha-256;9f86d0...?ver=CBV2.0",
        "eventTime": "2026-05-09T11:58:00.000Z",
        "eventTimeZoneOffset": "+02:00",
        "epcList": ["https://id.tracepass.eu/p/01/04012345000015/21/BP-48V-100-000001"],
        "action": "OBSERVE",
        "bizStep": "shipping",
        "bizLocation": { "id": "https://id.tracepass.eu/loc/acme-batteries-de" }
      }
    ]
  }
}

Verwandte Endpoints