Dienstag, 6.40 Uhr, Rampe 3 im Lager bei Basel. Ein Lastwagen bringt eine Palette mit 48 E-Bike-Akkus aus dem Montagewerk, der Scanner piept, und das Lagerverwaltungssystem bucht den Wareneingang. Drei Systeme haben diese Akkus inzwischen gesehen: die Fertigungssteuerung im Werk, das Sendungssystem der Spedition und jetzt das Lager. Jedes kennt seinen Ausschnitt der Reise.
Ab sofort laufen diese Ausschnitte in Transpareo zusammen. Jeder Arbeitsbereich hat eine Schnittstelle für EPCIS 2.0, den Standard von GS1 für Ereignisse in der Lieferkette. Werk, Spedition und Lager melden ihre Ereignisse dorthin, wo die Produktpässe der Akkus liegen, und für keinen der drei Partner bauen Sie eine eigene Anbindung.
Ein Format für Werk, Spedition und Lager
EPCIS steht für Electronic Product Code Information Services. Ein EPCIS-Ereignis beantwortet vier Fragen: welche Produkte, wann, wo und warum. Das Warum ist der Geschäftsschritt, etwa Herstellung, Versand oder Wareneingang, zusammen mit dem Zustand, in dem das Produkt danach ist. Wo Systeme heute Ereignisse der Lieferkette austauschen, in der Pharmalogistik seit Jahren, sprechen viele von ihnen bereits EPCIS. Auch der Produktpass selbst hält in EPCIS fest, was mit einem Produkt geschah, in einem seiner drei Wörterbücher.
Ohne gemeinsames Format braucht jeder Partner seinen eigenen Weg: eine Tabelle per Mail aus dem Werk, eine Exportdatei der Spedition, ein Bericht aus dem Lager, jede mit ihren eigenen Spalten. Bei Transpareo erhält jeder Partner einen eigenen Zugang zur Schnittstelle Ihres Arbeitsbereichs und meldet seine Ereignisse in EPCIS. Transpareo Connect verbindet andere Systeme mit Transpareo, über die API, Webhooks und jetzt EPCIS 2.0. Die Stammdaten der Akkus aus Ihrem ERP kommen weiter auf dem gewohnten Weg.
Was ein Lieferant über die Akkus weiss, etwa ihr Gewicht oder die Herkunft der Zellen, kommt auf einem eigenen Weg zu Ihnen. Mit Transpareo Upstream fragen Sie diese Angaben direkt bei Ihren Lieferanten an, jemand dort trägt sie ein, und Sie prüfen die Antwort, bevor sie in den Pass kommt. Über EPCIS melden die Systeme Ihrer Partner, was mit den Akkus geschieht: montiert, versandt, angekommen.
Ein neuer Partner braucht nur einen Zugang.
Das Werk schickt die Montage einer ganzen Schicht in einer Lieferung, bis zu 10’000 Ereignisse auf einmal. Transpareo prüft jedes Ereignis gegen das Schema von GS1. Auf Wunsch des Partners gilt die Lieferung ganz oder gar nicht, oder Transpareo übernimmt jedes gültige Ereignis und nennt die fehlerhaften beim Namen.
Über GTIN, Seriennummer und Charge zum Produktpass
Ein Ereignis nennt die Produkte an ihren Kennungen. Nennt es einen Akku an seiner GTIN, zusammen mit der Seriennummer oder mit der Charge, findet Transpareo daran seinen Produktpass, und Akkus für E-Bikes brauchen ab dem 18. Februar 2027 einen eigenen Pass. Ein Ereignis, das nur die Palette nennt, führt zu keinem Pass. Ob die Spedition einen Akku als EPC-Kennung schreibt oder als GS1 Digital Link, wie im QR-Code des Passes, beide führen zum selben Pass.
Meldet das Werk Akkus, deren Pass noch nicht angelegt ist, geht nichts verloren. Die Ereignisse bleiben gespeichert, und sobald es den Pass gibt, findet die Abfrage zu ihm sie mit.
Dieselbe Abfrage liefert auch die öffentlichen Ereignisse des Passes selbst, etwa seine Veröffentlichung, eine Reparatur oder das Recycling. Jedes kommt so, wie die Ereignisdatei des Passes es signiert hat, mit seiner Signatur, die der Empfänger prüfen kann.
Eine Abfrage zeigt die ganze Reise eines Akkus: was die Partner gemeldet haben und was sein Pass signiert hat.
Was ein Partner meldet, steht neben dem Pass. Ein Wareneingang erscheint also nicht von selbst im öffentlichen Pass, den Kundinnen, Werkstätten und Behörden lesen. Das wäre schneller gebaut gewesen, und wir haben uns dagegen entschieden: Ein signierter Produktpass ist ein Dokument, für das Sie geradestehen, und die Meldung eines Partners bleibt die Aussage dieses Partners.
Irrt sich ein Partner, korrigiert er sein Ereignis mit einer Fehlererklärung, wie EPCIS sie vorsieht. Das ursprüngliche Ereignis bleibt stehen, die Korrektur steht daneben, und wer abfragt, sieht beide.
Abfragen, speichern, abonnieren
Dieselben Ereignisse fragen Ihre eigenen Systeme ab und, im Rahmen ihres Zugangs, auch Ihre Partner. Eine Abfrage wählt nach Produkt, Seriennummer oder Charge, nach Zeitraum, Geschäftsschritt, Ort oder Zustand. So sieht Ihr Kundendienst, wann der Akku einer Kundin das Lager verlassen hat, ohne bei der Spedition anzurufen.
Eine Abfrage, die Sie immer wieder brauchen, speichern Sie unter einem Namen und abonnieren sie. Transpareo stellt dann die neuen Ereignisse zu, sobald sie eintreffen, oder nach einem Zeitplan, etwa jeden Morgen zur selben Zeit. Legt der Empfänger ein Geheimnis fest, trägt jede Zustellung eine Signatur, an der er erkennt, dass sie aus Ihrem Arbeitsbereich kommt.
Ihr ERP erfährt vom Wareneingang in Basel, ohne dass jemand eine Datei weiterleitet.
Wer was sieht
Jeder Zugang hat seine eigenen Rechte, und Ereignisse lesen und Ereignisse melden sind zwei getrennte Rechte. Einen Zugang können Sie zudem auf bestimmte Pässe begrenzen. Die Spedition liest dann die Ereignisse zu den Akkus, deren Pässe Sie ihr freigeben, und was sie selbst gemeldet hat.
Ein Partner sieht genau die Produkte, die Sie ihm freigeben.
Die Ereignisse liegen in der EU, in der eigenen Datenbank Ihres Arbeitsbereichs, wie alle Ihre Daten bei Transpareo.
Warum es auf den Standard ankommt
Ein Partner, dessen System nach der Beschreibung von GS1 gebaut ist, soll mit Ihrem Arbeitsbereich sprechen, ohne dass jemand etwas anpasst. Sonst braucht es zwischen seinem System und Ihrem eine Übersetzung, und mit jeder kann ein Wert seine Bedeutung verlieren. Darum folgt die Schnittstelle der Anbindung, die GS1 für EPCIS 2.0 veröffentlicht, bis in die Fehlermeldungen.
Ein Standard nützt Ihnen erst, wenn Ihr Partner ihn so spricht, wie er geschrieben ist.
Automatische Tests prüfen vor jeder neuen Version die Antworten der Schnittstelle gegen die Beschreibung und die Schemas von GS1. An einigen Stellen ist die Beschreibung unvollständig oder widerspricht dem Text des Standards. Dort folgen wir dem Standard, und ein Test meldet sich, sobald GS1 die Stelle korrigiert.
Wo wir bewusst abweichen oder eine freigestellte Möglichkeit weglassen, sollte ein Partner vor allem drei Punkte kennen, bevor er sein System anbindet:
- Die Schnittstelle spricht JSON und JSON-LD, die beiden Formate, die der Standard für diese Anbindung verlangt. XML, das er freistellt, bietet sie nicht an.
- Kennungen kommen als GS1 Digital Link zurück, wie es der Standard ohne andere Angabe vorsieht, oder auf Wunsch so, wie der Partner sie gemeldet hat. Jede Kennung in die EPC-Schreibweise umzurechnen, bietet die Schnittstelle nicht an.
- Abonnements stellen an eine Adresse Ihrer Wahl zu, und nur über eine verschlüsselte Verbindung (https). Die freigestellte Zustellung über WebSocket bieten wir nicht an.
Wie sich das System eines Partners mit seinem Zugang anmeldet und wo die Schnittstelle sonst noch vom Standard abweicht, lesen Entwickler im Leitfaden der API-Dokumentation von Transpareo.
Zurück an die Rampe
Um 6.41 Uhr hat das Lager den Wareneingang gemeldet, und kurz danach weiss Ihr ERP davon, über sein Abonnement. Wer nach der Seriennummer eines der 48 Akkus fragt, sieht seine Reise: montiert im Werk, auf die Palette gepackt, von der Spedition übernommen, in Basel angekommen, und daneben die signierten Ereignisse seines Passes.
Die Spedition hat dafür einen Zugang erhalten, und sie meldet in dem Format, das ihr System ohnehin spricht.
Fragen zu diesem Beitrag
Was ist EPCIS 2.0?
EPCIS 2.0 ist der Standard von GS1 für Ereignisse in der Lieferkette, verabschiedet 2022. Ein Ereignis hält fest, welche Produkte wann, wo und bei welchem Geschäftsschritt erfasst wurden und in welchem Zustand sie danach sind. Mit der Version 2.0 kamen JSON und JSON-LD als Formate dazu und eine REST-Schnittstelle, über die Systeme Ereignisse melden und abfragen.
Was hat EPCIS mit dem Digitalen Produktpass zu tun?
Der Digitale Produktpass beschreibt, was ein Produkt ist, und EPCIS hält fest, was mit ihm geschah. Bei Transpareo veröffentlicht jeder Pass seine eigenen Ereignisse als signierte EPCIS-Datei, und die Ereignisse Ihrer Partner finden über GTIN mit Seriennummer oder Charge zu ihm.
Brauche ich ein eigenes EPCIS-Repository?
Nein. Jeder Arbeitsbereich in Transpareo hat eines, unter seiner eigenen Adresse. Es nimmt Ereignisse an, bewahrt sie auf und beantwortet Abfragen. Ihre Partner melden dorthin, und Ihre eigenen Systeme fragen dort ab.
Ändert ein gemeldetes Ereignis meinen Produktpass?
Nein. Ein gemeldetes Ereignis steht neben dem Pass und findet über dessen Kennung zu ihm. Die signierte Geschichte des Passes und der Pass, den Ihre Kundinnen und Kunden lesen, bleiben so, wie Sie sie veröffentlicht haben.
Wie bindet ein Partner sein System an?
Sie legen für ihn einen Zugang für Programme an und geben ihm das Recht, Ereignisse zu melden, auf Wunsch auch das Recht, sie zu lesen. Mit Schlüssel und Geheimnis holt sein System ein Zugangstoken und meldet seine Ereignisse als EPCIS-Dokument an die Adresse Ihres Arbeitsbereichs. Spricht sein System bereits EPCIS 2.0, kommen nur die Adresse und der Zugang dazu.
Wie prüft Transpareo, dass die Schnittstelle dem Standard folgt?
Automatische Tests prüfen vor jeder neuen Version die Antworten jeder Operation gegen die OpenAPI-Beschreibung und die JSON-Schemas, die GS1 für EPCIS 2.0 veröffentlicht. Wo die Beschreibung unvollständig ist oder dem Text des Standards widerspricht, folgen wir dem Standard, und ein Test meldet sich, sobald GS1 die Stelle korrigiert. Wo die Schnittstelle vom Standard abweicht, nennt die API-Dokumentation jede Stelle.




