TracePass
Loslegen
EPCIS 2.0

EPCIS-Ereignisse abfragen

Die GS1-EPCIS-2.0-Query-Schnittstelle. Durchsuchen Sie erfasste Lieferketten-Ereignisse mit der Standard-EPCIS-Query-Parameter-Grammatik — `EQ_bizStep`, `GE_eventTime`, `LT_eventTime`, `MATCH_epc`, `EQ_bizLocation` und dem Rest der `EQ_*`- / `GE_*`- / `LT_*`- / `MATCH_*`-Familie. Parameter werden wortgetreu an die EPCIS-Query-Schnittstelle durchgereicht, sodass jede von der GS1-Grammatik erlaubte Abfrage hier unverändert funktioniert.

GET/api/v1/epcis/events
OpenAPI 3.1 herunterladen
GET/api/v1/epcis/events

EPCIS-Ereignisse abfragen

Die GS1-EPCIS-2.0-Query-Schnittstelle. Durchsuchen Sie erfasste Lieferketten-Ereignisse mit der Standard-EPCIS-Query-Parameter-Grammatik — `EQ_bizStep`, `GE_eventTime`, `LT_eventTime`, `MATCH_epc`, `EQ_bizLocation` und dem Rest der `EQ_*`- / `GE_*`- / `LT_*`- / `MATCH_*`-Familie. Parameter werden wortgetreu an die EPCIS-Query-Schnittstelle durchgereicht, sodass jede von der GS1-Grammatik erlaubte Abfrage hier unverändert funktioniert.

TracePass leitet die Abfrage an einen OpenEPCIS-Query-Knoten weiter und liefert das Ergebnis als standardkonformes `EPCISQueryDocument` (`Content-Type: application/ld+json`). Zählt als ein Lesevorgang.

Tarif-Gate: EPCIS-Abfragen sind in jedem kostenpflichtigen Tarif enthalten (und auf Free gegen einen leeren Index — nützlich für die Integrationsvalidierung). Der 403-`epcis_query_not_available`-Pfad ist nur auf Workspaces erreichbar, deren `epcisCaptureEnabled`-Flag per Tenant-Override deaktiviert wurde. Ein abgelaufenes Abonnement liefert `402`. Der Query-Knoten wird auf Anfrage statt standardmäßig bereitgestellt — bis er für Ihren Workspace ausgerollt ist, liefert der Endpoint `503 {"error":"epcis_query_node_unavailable"}`; wenden Sie sich an den Support, damit er eingerichtet wird.

Query-Parameter

  • EQ_bizStep

    string

    Standard-EPCIS-Query-Parameter — matcht Events, deren `bizStep` dem angegebenen CBV-Wert entspricht (z. B. `shipping`, `receiving`). Wird wortgetreu an die EPCIS-Query-Schnittstelle durchgereicht.

  • GE_eventTime

    string (ISO 8601)

    Standard-EPCIS-Query-Parameter — matcht Events, deren `eventTime` größer oder gleich dem angegebenen Zeitstempel ist. Mit `LT_eventTime` für ein Zeitfenster kombinieren. Wird wortgetreu durchgereicht.

  • MATCH_epc

    string

    Standard-EPCIS-Query-Parameter — matcht Events, deren `epcList` den angegebenen EPC enthält (eine TracePass-Pass-Digital-Link-URI). Wird wortgetreu durchgereicht.

Header

  • Authorizationerforderlich

    string

    `Bearer <api-key>`.

Anfrage

# All shipping events for one passport in a time window
curl -sS -G https://app.tracepass.eu/api/v1/epcis/events \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  --data-urlencode "EQ_bizStep=shipping" \
  --data-urlencode "GE_eventTime=2026-01-01T00:00:00.000Z" \
  --data-urlencode "LT_eventTime=2026-06-01T00:00:00.000Z" \
  --data-urlencode "MATCH_epc=https://id.tracepass.eu/p/01/04012345000015/21/BP-48V-100-000001"

Antwort

{
  "@context": "https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld",
  "type": "EPCISQueryDocument",
  "schemaVersion": "2.0",
  "creationDate": "2026-05-09T12:00:00.000Z",
  "epcisBody": {
    "queryResults": {
      "resultsBody": {
        "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"
          }
        ]
      }
    }
  }
}

Verwandte Endpoints