EPCIS 2.0: alle partneres begivenheder i produktpaset

EPCIS 2.0: alle partneres begivenheder i produktpaset

Hvordan overføres begivenhederne i forsyningskæden til det digitale produktpas? Via EPCIS 2.0: Hver partner logger ind på sit eget arbejdsområde med sin egen adgang.

Tirsdag, kl. 6.40, rampe 3 på lageret ved Basel. En lastbil leverer en palle med 48 e-cykelbatterier fra samlefabrikken, scanneren bipper, og lagerstyringssystemet registrerer varemodtagelsen. Disse batterier har nu været igennem tre systemer: produktionsstyringen på fabrikken, speditørens forsendelsessystem og nu lageret. Hvert system kender sin del af rejsen.

Fra nu af samles disse udtræk i Transpareo. Hvert arbejdsområde har en grænseflade til EPCIS 2.0, GS1’s standard for begivenheder i forsyningskæden. Fabrik, transportvirksomhed og lager indberetter deres begivenheder til det sted, hvor batteriernes produktpas er gemt, og De behøver ikke oprette en separat forbindelse til nogen af de tre partnere.

Et format til fabrik, transportfirma og lager

EPCIS står for Electronic Product Code Information Services. En EPCIS-hændelse besvarer fire spørgsmål: hvilke produkter, hvornår, hvor og hvorfor. »Hvorfor« henviser til den forretningsmæssige handling, f.eks. produktion, forsendelse eller varemodtagelse, sammen med den tilstand, produktet befinder sig i efterfølgende. Hvor systemer i dag udveksler begivenheder i forsyningskæden - hvilket har været tilfældet inden for lægemiddellogistikken i årevis - taler mange af dem allerede EPCIS. Også selve produktpasset registrerer i EPCIS, hvad der er sket med et produkt, i en af sine tre ordbøger.

Uden et fælles format må hver partner finde sin egen løsning: en tabel sendt via e-mail fra fabrikken, en eksportfil fra speditøren, en rapport fra lageret - hver med sine egne kolonner. Hos Transpareo får hver partner sin egen adgang til grænsefladen i dit arbejdsområde og indberetter sine hændelser i EPCIS. Transpareo Connect forbinder andre systemer med Transpareo via API, webhooks og nu også EPCIS 2.0. Stammeoplysningerne om batterierne fra dit ERP-system overføres fortsat på den sædvanlige måde.

De oplysninger, som en leverandør har om batterierne - f.eks. deres vægt eller cellernes oprindelse - sendes til dig via en separat kanal. Med Transpareo Upstream kan du anmode om disse oplysninger direkte hos dine leverandører; en medarbejder der indtaster dem, og du kontrollerer svaret, inden det føres ind i paset. Via EPCIS rapporterer dine partneres systemer, hvad der sker med batterierne: monteret, afsendt, ankommet.

En ny partner behøver kun én adgang.

Fabrikken sender en hel skifts samlede data i én levering, op til 10.000 hændelser på én gang. Transpareo kontrollerer hver enkelt hændelse i forhold til GS1-skemaet. Efter partnerens ønske gælder leveringen enten i sin helhed eller slet ikke, eller også accepterer Transpareo alle gyldige hændelser og angiver de fejlbehæftede ved navn.

Om GTIN, serienummer og batchnummer i produktpaset

I vores videovejledning viser vi, hvordan der oprettes en separat signeret version for hver hændelse i et pas, og hvordan du kan åbne og downloade det fulde hændelsesdokument i EPCIS-standarden.

En hændelse identificerer produkterne ved hjælp af deres identifikationskoder. Hvis den identificerer et batteri ved hjælp af dets GTIN, sammen med serienummeret eller batchenummeret, finder Transpareo på den baggrund produktpasset, og batterier til elcykler . En begivenhed, der kun angiver pallen, fører ikke til et pas. Uanset om transportfirmaet angiver et batteri med en EPC-identifikationskode eller som GS1 Digital Link, som i produktpassets QR-kode, fører begge til det samme pas.

Hvis anlægget registrerer batterier, for hvilke der endnu ikke er oprettet et pas, går intet tabt. Begivenhederne forbliver gemt, og så snart paset er oprettet, vil søgningen efter det også finde dem.

Den samme forespørgsel viser også de offentlige begivenheder knyttet til selve paset, f.eks. dets udstedelse, en reparation eller genbrug. Hver begivenhed vises præcis som den er angivet i pasets begivenhedsfil, med sin signatur, som modtageren kan kontrollere.

En forespørgsel viser et batteris hele livscyklus: hvad partnerne har rapporteret, og hvad dets pas har registreret.

Det, som en partner indberetter, vises ved siden af paset. En varemodtagelse vises altså ikke automatisk i det offentlige pas, som kunder, værksteder og myndigheder kan læse. Det ville have været hurtigere at implementere, men vi har valgt ikke at gøre det: Et signeret produktpas er et dokument, som du står inde for, og en partners indberetning forbliver denne partners udtalelse.

Hvis en partner begår en fejl, retter vedkommende sin hændelse ved hjælp af en fejlmeddelelse, som EPCIS foreskriver. Den oprindelige hændelse forbliver, rettelsen står ved siden af, og den, der søger på den, kan se begge dele.

Søg, gem, abonner

Disse samme hændelser hentes fra jeres egne systemer og, inden for rammerne af deres adgang, også fra jeres partnere. En forespørgsel kan sorteres efter produkt, serienummer eller batch, tidsperiode, forretningstrin, sted eller status. På den måde kan jeres kundeservice se, hvornår en kundes batteri forlod lageret, uden at skulle ringe til transportfirmaet.

En forespørgsel, som du har brug for igen og igen, kan du gemme under et navn og abonnere på den. Transpareo leverer derefter de nye begivenheder, så snart de indkommer, eller efter en tidsplan, f.eks. hver morgen på samme tid. Hvis modtageren har angivet en hemmelighed, er hver levering forsynet med en signatur, som viser, at den stammer fra dit arbejdsområde.

Jeres ERP-system får besked om varemodtagelsen i Basel, uden at nogen behøver at videresende en fil.

Hvem ser hvad

Hver adgang har sine egne rettigheder, og »Læs hændelser« og »Rapporter hændelser« er to separate rettigheder. Du kan desuden begrænse en adgang til bestemte pas. Transportfirmaet kan så læse hændelserne vedrørende de batterier, hvis pas du har givet dem adgang til, samt de hændelser, de selv har rapporteret.

En partner kan kun se de produkter, som du giver ham adgang til.

Begivenhederne findes i EU, i din arbejdsområdes egen database, ligesom alle dine data hos Transpareo.

Hvorfor standarden er afgørende

En partner, hvis system er opbygget i henhold til GS1’s beskrivelse, skal kunne kommunikere med dit arbejdsområde uden at nogen behøver at foretage justeringer. Ellers kræves der en oversættelse mellem partnerens system og dit, og ved hver oversættelse kan en værdi miste sin betydning. Derfor følger den grænseflade, som GS1 offentliggør til EPCIS 2.0, helt ned til fejlmeddelelserne.

En standard er først til nytte, hvis din partner bruger den, præcis som den er skrevet.

Før hver ny version kontrollerer automatiske tests, om grænsefladens svar stemmer overens med GS1’s beskrivelse og skemaer. På nogle punkter er beskrivelsen ufuldstændig eller i modstrid med standardens tekst. I disse tilfælde følger vi standarden, og en test udløser en fejlmeddelelse, så snart GS1 har rettet det pågældende sted.

Hvor vi bevidst afviger fra standarden eller udelader en tilladt mulighed, bør en partner især være opmærksom på tre punkter, inden han tilslutter sit system:

  • Grænsefladen understøtter JSON og JSON-LD, de to formater, som standarden kræver for denne integration. XML, som standarden tillader, tilbydes ikke.
  • Identifikationskoder returneres som GS1 Digital Link, som standarden foreskriver, medmindre andet er angivet, eller efter ønske i den form, som partneren har indberettet dem. Grænsefladen tilbyder ikke at konvertere hver enkelt identifikationskode til EPC-format.
  • Abonnementer leveres til en adresse efter eget valg og udelukkende via en krypteret forbindelse (https). Vi tilbyder ikke levering via WebSocket.

Udviklere kan læse i vejledningen i Transpareos API-dokumentation, hvordan et partnersystem logger ind med sin adgangskode, og hvor grænsefladen ellers afviger fra standarden.

Tilbage til rampen

Kl. 06.41 har lageret meldt varemodtagelsen, og kort efter får jeres ERP-system besked via sit abonnement. Hvis man slår serienummeret på et af de 48 batterier op, kan man se dets rejse: monteret på fabrikken, pakket på pallen, afhentet af transportfirmaet, ankommet til Basel - og ved siden af de registrerede begivenheder i dets »pas«.

Speditionsfirmaet har modtaget en adgang til dette formål og indberetter i det format, som dets system i forvejen understøtter.

Spørgsmål til dette indlæg

Hvad er EPCIS 2.0?

EPCIS 2.0 er GS1’s standard for begivenheder i forsyningskæden, vedtaget i 2022. En hændelse registrerer, hvilke produkter der er blevet registreret hvornår, hvor og i hvilket forretningstrin, samt i hvilken tilstand de befinder sig derefter. Med version 2.0 blev JSON og JSON-LD tilføjet som formater samt en REST-grænseflade, hvorigennem systemer kan rapportere og forespørge hændelser.

Hvad har EPCIS med det digitale produktpas at gøre?

Det digitale produktpas beskriver, hvad et produkt er, og EPCIS registrerer, hvad der er sket med det. Hos Transpareo offentliggør hvert produktpas sine egne hændelser som en signeret EPCIS-fil, og dine partneres hændelser knyttes til det via GTIN med serienummer eller batchnummer.

Har jeg brug for mit eget EPCIS-repositorium?

Nej. Hvert arbejdsområde i Transpareo har sit eget, med sin egen adresse. Det modtager hændelser, gemmer dem og besvarer forespørgsler. Dine partnere rapporterer dertil, og dine egne systemer forespørger der.

Vil en indberettet hændelse ændre mit produktpas?

Nej. En rapporteret hændelse vises ved siden af paset og kan knyttes til det via dets identifikationsnummer. Pasets signerede historik og det pas, som jeres kunder læser, forbliver således, som I har offentliggjort dem.

Hvordan tilslutter en partner sit system?

De opretter adgang til programmerne for ham og giver ham ret til at indberette hændelser samt, hvis han ønsker det, ret til at læse dem. Ved hjælp af nøgle og hemmelighed henter hans system et adgangstoken og indberetter sine hændelser som et EPCIS-dokument til adressen på jeres arbejdsområde. Hvis hans system allerede understøtter EPCIS 2.0, er det kun adressen og adgangen, der skal angives.

Hvordan kontrollerer Transpareo, at grænsefladen overholder standarden?

Automatiske test kontrollerer før hver ny version svarene på hver operation i forhold til OpenAPI-beskrivelsen og de JSON-skemaer, som GS1 offentliggør for EPCIS 2.0. Hvor beskrivelsen er ufuldstændig eller i modstrid med standardens tekst, følger vi standarden, og en test udløser en fejlmeddelelse, så snart GS1 har rettet det pågældende sted. Hvor grænsefladen afviger fra standarden, angiver API-dokumentationen hvert enkelt sted.

Nyheder fra Transpareo Connect, så snart de foreligger

Vi beskriver, hvad vi bygger, og hvorfor, i et letforståeligt sprog.