Zum Hauptinhalt springen

Integrationen & API · Anleitung

Das System eines Käufers Ihre Rückverfolgbarkeitsereignisse lesen lassen

Die Systeme Ihrer Käufer und Ihre eigenen lesen die Ereignisse Ihrer Partien über die GS1-EPCIS-2.0-Abfrageschnittstelle, statt auf Dateien zu warten. Sie wählen, welche verbundenen Unternehmen sie lesen dürfen.

Viele Käufer nutzen ein Rückverfolgbarkeitssystem, das GS1 EPCIS 2.0 spricht, den weltweiten Standard für „was geschah mit welcher Partie, wann und wo“. A-REX beantwortet diesen Standard direkt: Ihr System fragt, A-REX antwortet mit den Ereignissen der Partien, live und so gefiltert, wie GS1 es festlegt. Keine Dateien zu versenden.

Was das andere System liest

Jedes Ereignis sagt, was mit einer Partie geschah: Sie wurde angelegt, versandt, empfangen, verarbeitet, geprüft oder erhielt ein Zertifikat. Jedes Ereignis trägt einen GS1-Geschäftsschritt (zum Beispiel shipping, Versand) und daneben Ihre eigenen Worte für den Schritt. Jedes Ereignis sagt, dass Ihr Unternehmen es erklärt hat: Geteilte Ereignisse werden dadurch nicht geprüft.

  • Ihr eigenes System liest alle Ereignisse Ihres Unternehmens.
  • Ein verbundenes Unternehmen liest die Ereignisse der Partien, die Sie ihm geliefert haben, und nur solange Sie mit ihm Rückverfolgbarkeitsereignisse teilen (siehe Was jedes Unternehmen teilt). Es sieht Ihre Lieferungen an es, nie Ihre Lieferungen an andere, und die Verarbeitung bis zur Lieferung.

Einem System Zugang geben

  1. Legen Sie unter Integrationen einen API-Schlüssel oder einen Maschinen-Client mit dem Bereich read an. Ein Käufer legt ihn in seinem eigenen Unternehmen an: Er liest, was Sie mit ihm teilen.
  2. Geben Sie den Betreibern dieses Systems die Adresse https://{API-Adresse}/v1/epcis und den Schlüssel.
  3. Ihr System fragt zum Beispiel nach den Versänden einer Partie: GET /v1/epcis/events?EQ_bizStep=shipping&MATCH_epcClass={der Digital Link der Partie}.

A-REX zeichnet jeden Lesezugriff eines Schlüssels oder Clients auf. Damit ein verbundenes Unternehmen Ihre Ereignisse nicht mehr liest, entfernen Sie den Haken bei Rückverfolgbarkeitsereignisse auf der Seite seiner Verbindung; um einen Schlüssel zu stoppen, widerrufen Sie ihn.

Gut zu wissen

  • Die Schnittstelle liest nur. Nichts kann über sie Ereignisse in A-REX schreiben: Einträge laufen weiterhin über Ihre Freigaben.
  • Lange Verläufe kommen Seite für Seite; ein System, das viel mehr braucht, grenzt den Zeitraum ein.
  • Die Kennung der Partie in den Ereignissen ist ihr GS1 Digital Link, wenn das Produkt eine GTIN und die Partie einen Partiecode hat; sonst eine A-REX-Kennung.
  • Ihr technisches Team findet die vollständige Beschreibung mit jedem Filter in der Entwicklerdokumentation (EPCIS-Abfrageschnittstelle).