EPCIS 2.0: de gebeurtenissen van alle partners in het productpaspoort

EPCIS 2.0: de gebeurtenissen van alle partners in het productpaspoort

Hoe worden de gebeurtenissen in de toeleveringsketen in het digitaal productpaspoort opgenomen? Via EPCIS 2.0: elke partner meldt zich met zijn eigen toegang aan in uw werkruimte.

Dinsdag, 06.40 uur, laadperron 3 in het magazijn bij Bazel. Een vrachtwagen brengt een pallet met 48 accu’s voor e-bikes vanuit de assemblagefabriek; de scanner piept en het magazijnbeheersysteem registreert de goederenontvangst. Deze accu’s zijn inmiddels door drie systemen verwerkt: de productiecontrole in de fabriek, het verzendsysteem van de expediteur en nu het magazijn. Elk systeem kent zijn eigen deel van het traject.

Vanaf nu worden deze gegevens in Transpareo gebundeld. Elke werkruimte beschikt over een interface voor EPCIS 2.0, de GS1-standaard voor gebeurtenissen in de toeleveringsketen. Fabriek, transportbedrijf en magazijn melden hun gebeurtenissen daar waar de productpaspoorten van de accu’s zich bevinden, en u hoeft voor geen van de drie partners een eigen koppeling te bouwen.

Eén oplossing voor fabriek, transportbedrijf en magazijn

EPCIS staat voor Electronic Product Code Information Services. Een EPCIS-gebeurtenis geeft antwoord op vier vragen: welke producten, wanneer, waar en waarom. Het ‘waarom’ betreft de bedrijfsstap, zoals productie, verzending of goederenontvangst, samen met de toestand waarin het product zich daarna bevindt. Waar systemen tegenwoordig gebeurtenissen in de toeleveringsketen uitwisselen - in de farmaceutische logistiek gebeurt dit al jaren - spreken veel van deze systemen al EPCIS. Ook het productpaspoort zelf legt in EPCIS vast wat er met een product is gebeurd, in een van zijn drie woordenboeken.

Zonder een gemeenschappelijk formaat moet elke partner zijn eigen weg vinden: een tabel per e-mail vanuit de fabriek, een exportbestand van de expediteur, een rapport vanuit het magazijn, elk met hun eigen kolommen. Bij Transpareo krijgt elke partner een eigen toegang tot de interface van uw werkruimte en rapporteert hij zijn gebeurtenissen in EPCIS. Transpareo Connect koppelt andere systemen aan Transpareo via de API, webhooks en nu ook EPCIS 2.0. De stamgegevens van de accu’s uit uw ERP-systeem worden op de gebruikelijke manier doorgegeven.

De informatie die een leverancier over de accu’s heeft, zoals het gewicht of de herkomst van de cellen, wordt via een aparte route aan u doorgegeven. Via Transpareo Upstream vraagt u deze gegevens rechtstreeks bij uw leveranciers op; iemand daar voert ze in en u controleert het antwoord voordat het in het paspoort wordt opgenomen. Via EPCIS melden de systemen van uw partners wat er met de accu’s gebeurt: gemonteerd, verzonden, aangekomen.

Een nieuwe partner heeft slechts één toegang nodig.

De fabriek verzendt de gegevens van een volledige ploeg in één verzending, tot wel 10.000 gebeurtenissen tegelijk. Transpareo controleert elke gebeurtenis aan de hand van het GS1-schema. Op verzoek van de partner geldt de levering in haar geheel of helemaal niet, of Transpareo neemt elke geldige gebeurtenis over en noemt de foutieve gebeurtenissen bij naam.

Via GTIN, serienummer en partijnummer naar het productpaspoort

In onze videorondleiding laten wij zien hoe voor elke gebeurtenis op een paspoort een eigen, ondertekende versie wordt aangemaakt en hoe u het volledige gebeurtenisdocument volgens de EPCIS-standaard kunt openen en downloaden.

Een gebeurtenis identificeert de producten aan de hand van hun identificatiecodes. Als een accu wordt aangeduid met zijn GTIN, in combinatie met het serienummer of de batch, vindt Transpareo op basis daarvan het bijbehorende productpaspoort; accu’s voor e-bikes . Een gebeurtenis waarbij alleen de pallet wordt vermeld, leidt niet tot een paspoort. Of de vervoerder een accu nu als EPC-code of als GS1 Digital Link vermeldt , zoals in de QR-code van het paspoort, beide leiden tot hetzelfde paspoort.

Als de fabriek accu’s meldt waarvoor nog geen paspoort is aangemaakt, gaat er niets verloren. De gebeurtenissen blijven opgeslagen en zodra het paspoort beschikbaar is, worden ze bij het opvragen daarvan meegevonden.

Dezelfde zoekopdracht levert ook de openbare gebeurtenissen van het paspoort zelf op, zoals de uitgifte ervan, een reparatie of de recycling. Elk van deze gebeurtenissen wordt weergegeven zoals het gebeurtenissenbestand van het paspoort deze heeft ondertekend, met de bijbehorende handtekening die de ontvanger kan controleren.

Een zoekopdracht geeft het volledige traject van een accu weer: wat de partners hebben gemeld en wat zijn paspoort heeft geregistreerd.

Wat een partner meldt, wordt naast het paspoort vermeld. Een goederenontvangst verschijnt dus niet vanzelf in het openbare paspoort dat door klanten, werkplaatsen en overheidsinstanties wordt geraadpleegd. Dat zou sneller te realiseren zijn geweest, maar wij hebben daar niet voor gekozen: een ondertekend productpaspoort is een document waarvoor u instaat, en de melding van een partner blijft de verklaring van die partner.

Indien een partner een fout maakt, corrigeert hij zijn gebeurtenis met een foutmelding, zoals EPCIS dat voorschrijft. De oorspronkelijke gebeurtenis blijft staan, de correctie wordt ernaast vermeld, en wie de gegevens opvraagt, ziet beide.

Opvragen, opslaan, abonneren

Deze gebeurtenissen worden opgevraagd bij uw eigen systemen en, binnen de grenzen van hun toegangsrechten, ook bij uw partners. Een zoekopdracht kan worden uitgevoerd op product, serienummer of partij, op periode, transactiestap, locatie of status. Zo kan uw klantenservice zien wanneer de accu van een klant het magazijn heeft verlaten, zonder dat zij de vervoerder hoeven te bellen.

Een zoekopdracht die u steeds weer nodig hebt, kunt u onder een naam opslaan en u erop abonneren. Transpareo bezorgt vervolgens de nieuwe gebeurtenissen zodra deze binnenkomen, of volgens een schema, bijvoorbeeld elke ochtend op hetzelfde tijdstip. Als de ontvanger een geheim instelt, is elke bezorging voorzien van een handtekening, waaraan hij kan herkennen dat deze afkomstig is uit uw werkruimte.

Uw ERP-systeem wordt op de hoogte gebracht van de goederenontvangst in Bazel, zonder dat iemand een bestand hoeft door te sturen.

Wie wat ziet

Elke toegang heeft zijn eigen rechten, en het lezen van gebeurtenissen en het melden van gebeurtenissen zijn twee afzonderlijke rechten. U kunt een toegang bovendien beperken tot bepaalde pasjes. Het transportbedrijf leest dan de gebeurtenissen met betrekking tot de accu’s waarvan u de pasjes aan het bedrijf vrijgeeft, en de gebeurtenissen die het zelf heeft gemeld.

Een partner ziet uitsluitend de producten die u voor hem vrijgeeft.

De gebeurtenissen bevinden zich in de EU, in de eigen database van uw werkruimte, net als al uw gegevens bij Transpareo.

Waarom de norm van belang is

Een partner wiens systeem is opgebouwd volgens de specificaties van GS1, dient rechtstreeks te communiceren met uw werkruimte, zonder dat iemand iets hoeft aan te passen. Anders is er een vertaling nodig tussen zijn systeem en het uwe, en bij elke vertaling kan een waarde zijn betekenis verliezen. Daarom is de interface voor de koppeling die GS1 voor EPCIS 2.0 publiceert, tot in de foutmeldingen toe gedetailleerd uitgewerkt.

Een norm heeft pas nut als uw partner deze precies zo toepast als deze is opgesteld.

Vóór elke nieuwe versie controleren automatische tests of de antwoorden van de interface voldoen aan de beschrijving en de schema’s van GS1. Op sommige punten is de beschrijving onvolledig of in tegenspraak met de tekst van de norm. In die gevallen volgen wij de norm, en er wordt een foutmelding gegenereerd zodra GS1 het betreffende punt heeft gecorrigeerd.

Wanneer wij bewust afwijken of een toegestane mogelijkheid achterwege laten, dient een partner vooral drie punten te kennen voordat hij zijn systeem aansluit:

  • De interface ondersteunt JSON en JSON-LD, de twee formaten die de norm voor deze koppeling voorschrijft. XML, dat volgens de norm optioneel is, wordt niet ondersteund.
  • Identificatiecodes worden teruggestuurd als GS1 Digital Link, zoals de norm voorschrijft bij gebrek aan andere specificaties, of desgewenst zoals de partner deze heeft opgegeven. De interface biedt geen mogelijkheid om elke identificatiecode om te zetten naar de EPC-notatie.
  • Abonnementen worden verzonden naar een adres naar keuze, en uitsluitend via een beveiligde verbinding (https). Wij bieden geen verzending via WebSocket aan.

Hoe het systeem van een partner zich met zijn inloggegevens aanmeldt en op welke andere punten de interface afwijkt van de standaard, kunnen ontwikkelaars nalezen in de handleiding van de API-documentatie van Transpareo.

Terug naar de laadperron

Om 6.41 uur heeft het magazijn de goederenontvangst gemeld, en kort daarna is uw ERP-systeem hiervan op de hoogte via zijn abonnement. Wie het serienummer van een van de 48 accu’s opvraagt, ziet het traject ervan: in de fabriek gemonteerd, op de pallet verpakt, door de vervoerder overgenomen, in Bazel aangekomen, en daarnaast de geregistreerde gebeurtenissen in het ‘paspoort’ van de accu.

Het transportbedrijf heeft hiervoor toegang gekregen en rapporteert in het formaat dat haar systeem sowieso ondersteunt.

Vragen over dit artikel

Wat is EPCIS 2.0?

EPCIS 2.0 is de GS1-standaard voor gebeurtenissen in de toeleveringsketen, die in 2022 is goedgekeurd. Een gebeurtenis legt vast welke producten wanneer, waar en bij welke bedrijfsstap zijn geregistreerd en in welke toestand zij zich daarna bevinden. Met versie 2.0 zijn JSON en JSON-LD als formaten toegevoegd, evenals een REST-interface waarmee systemen gebeurtenissen kunnen melden en opvragen.

Wat heeft EPCIS te maken met het digitale productpaspoort?

Het digitaal productpaspoort beschrijft wat een product is, en EPCIS registreert wat ermee is gebeurd. Bij Transpareo publiceert elk paspoort zijn eigen gebeurtenissen als een ondertekend EPCIS-bestand, en de gebeurtenissen van uw partners worden via de GTIN aan het paspoort gekoppeld op basis van het serienummer of de partij.

Heb ik een eigen EPCIS-repository nodig?

Nee. Elke werkruimte in Transpareo heeft er één, met een eigen adres. Deze ontvangt gebeurtenissen, slaat ze op en beantwoordt verzoeken. Uw partners sturen daar hun gegevens naartoe, en uw eigen systemen vragen daar informatie op.

Heeft een gemelde gebeurtenis invloed op mijn productpaspoort?

Nee. Een gemelde gebeurtenis wordt naast het paspoort weergegeven en is via de identificatiecode van het paspoort aan het paspoort gekoppeld. De ondertekende geschiedenis van het paspoort en het paspoort dat uw klanten lezen, blijven zoals u ze hebt gepubliceerd.

Hoe koppelt een partner zijn systeem aan?

U maakt voor hem een toegang voor programma’s aan en verleent hem het recht om gebeurtenissen te melden, en desgewenst ook het recht om deze te lezen. Met een sleutel en een geheim haalt zijn systeem een toegangstoken op en meldt zijn gebeurtenissen als EPCIS-document aan het adres van uw werkruimte. Als zijn systeem al EPCIS 2.0 ondersteunt, zijn alleen het adres en de toegang nodig.

Hoe controleert Transpareo of de interface aan de norm voldoet?

Automatische tests controleren vóór elke nieuwe versie de antwoorden van elke bewerking aan de hand van de OpenAPI-beschrijving en de JSON-schema’s die GS1 voor EPCIS 2.0 publiceert. Indien de beschrijving onvolledig is of in strijd is met de tekst van de norm, volgen wij de norm, en er wordt een foutmelding gegenereerd zodra GS1 de betreffende passage heeft gecorrigeerd. Indien de interface afwijkt van de norm, wordt elke afwijking in de API-documentatie vermeld.

Nieuws uit Transpareo Connect, zodra het beschikbaar is

Wij beschrijven wat wij bouwen en waarom, in begrijpelijke taal.