Tirsdag, kl. 06.40, rampe 3 på lageret ved Basel. En lastebil leverer en pall med 48 elsykkelbatterier fra monteringsanlegget, skanneren piper, og lagerstyringssystemet registrerer varemottaket. Disse batteriene har nå vært gjennom tre systemer: produksjonsstyringen på fabrikken, transportfirmaets forsendelsessystem og nå lageret. Hvert av dem kjenner sin del av reisen.
Fra og med nå samles disse utdragene i Transpareo. Hvert arbeidsområde har et grensesnitt for EPCIS 2.0, GS1-standarden for hendelser i forsyningskjeden. Fabrikk, transportør og lager rapporterer sine hendelser til der batterienes produktpass er lagret, og du trenger ikke å opprette en egen tilkobling for noen av de tre partnerne.
Et format for produksjon, transport og lager
EPCIS står for Electronic Product Code Information Services. En EPCIS-hendelse gir svar på fire spørsmål: hvilke produkter, når, hvor og hvorfor. «Hvorfor» er forretningstrinnet, for eksempel produksjon, forsendelse eller varemottak, sammen med tilstanden produktet befinner seg i etterpå. Der systemer i dag utveksler hendelser i forsyningskjeden - noe som har vært vanlig i legemiddellogistikken i mange år - bruker mange av dem allerede EPCIS.
Uten et felles format må hver partner finne sin egen løsning: en tabell sendt via e-post fra fabrikken, en eksportfil fra speditøren, en rapport fra lageret - hver med sine egne kolonner. Hos Transpareo får hver partner egen tilgang til grensesnittet i ditt arbeidsområde og rapporterer sine hendelser i EPCIS. Grensesnittet er en del av Transpareo Connect, og stammdataene for batteriene fra ERP-systemet ditt overføres videre på vanlig måte.
Det en leverandør vet om batteriene, for eksempel vekten eller cellenes opprinnelse, blir sendt til deg via en egen kanal. Med Transpareo Upstream kan du be om disse opplysningene direkte fra leverandørene dine, noen der legger dem inn, og du sjekker svaret før det føres inn i passet. Via EPCIS rapporterer systemene til partnerne dine hva som skjer med batteriene: montert, sendt, ankommet.
En ny partner trenger bare én tilgang.
Fabrikken sender dataene fra et helt skift i én leveranse, opptil 10 000 hendelser på en gang. Transpareo sjekker hver enkelt hendelse opp mot GS1-skjemaet. På forespørsel fra partneren godkjennes leveransen enten i sin helhet eller ikke i det hele tatt, eller så godtar Transpareo alle gyldige hendelser og angir de feilaktige ved navn.
Hver hendelse har sitt eget produktpass
En hendelse identifiserer produktene ved hjelp av deres identifikasjonskoder: GTIN-koden med serienummeret til et enkelt batteri eller med dets produksjonsparti. På denne måten finner Transpareo produktpasset, og batterier til elsykler må ha sitt eget pass fra og med 18. februar 2027. Uansett om transportøren oppgir et batteri med EPC-identifikasjonsnummer eller som GS1 Digital Link, slik det står i QR-koden på passet, fører begge til det samme passet.
Hvis anlegget melder inn batterier som ennå ikke har et pass, går ingenting tapt. Hendelsene forblir lagret, og så snart passet er opprettet, vil søket etter det også finne dem.
Den samme forespørselen gir også informasjon om de offentlige hendelsene knyttet til selve passet, for eksempel utstedelse, reparasjon eller gjenvinning. Hver av disse vises slik de er signert i passets hendelsesfil, med en signatur som mottakeren kan verifisere.
En forespørsel viser hele batteriets livssyklus: hva partnerne har rapportert og hva passet har registrert.
Det en partner oppgir, står ved siden av passet. En varemottakelse vises altså ikke automatisk i det offentlige passet som kunder, verksteder og myndigheter leser. Det ville vært raskere å utvikle, men vi valgte å ikke gjøre det: Et signert produktpass er et dokument du står inne for, og en partners melding forblir denne partnerens uttalelse.
Hvis en partner gjør en feil, korrigerer vedkommende hendelsen med en feilmelding, slik EPCIS foreskriver. Den opprinnelige hendelsen forblir som den er, korreksjonen vises ved siden av, og den som henter frem opplysningene, ser begge deler.
Søk, lagre, abonner
De samme hendelsene hentes fra deres egne systemer og, innenfor rammen av deres tilgang, også fra deres partnere. En søk kan filtreres etter produkt, serienummer eller batch, tidsperiode, forretningstrinn, sted eller status. På denne måten kan kundeservicen deres se når en kundes batteri forlot lageret, uten å måtte ringe transportfirmaet.
En forespørsel som du trenger gjentatte ganger, kan du lagre under et navn og abonnere på den. Transpareo leverer de nye hendelsene så snart de kommer inn, eller etter en tidsplan, for eksempel hver morgen til samme tid. Hvis mottakeren angir en hemmelighet, har hver levering en signatur som viser at den kommer fra ditt arbeidsområde.
ERP-systemet deres får beskjed om varemottakelsen i Basel uten at noen trenger å videresende en fil.
Hvem ser hva
Hver tilgang har sine egne rettigheter, og «lese hendelser» og «rapportere hendelser» er to separate rettigheter. Du kan dessuten begrense en tilgang til bestemte pass. Transportfirmaet leser da hendelsene knyttet til batteriene hvis pass du gir dem tilgang til, samt det de selv har rapportert.
En samarbeidspartner ser nøyaktig de produktene du gir ham tilgang til.
Hendelsene finnes i EU, i arbeidsområdets egen database, akkurat som alle dine data hos Transpareo.
Hvorfor standarden er avgjørende
En partner hvis system er bygget i henhold til GS1s beskrivelse, skal kunne kommunisere med arbeidsområdet ditt uten at noen trenger å gjøre noen tilpasninger. Derfor følger grensesnittet for tilkoblingen, som GS1 har publisert for EPCIS 2.0, helt ned til feilmeldingene.
En standard er først til nytte for deg hvis partneren din bruker den slik den er skrevet.
Før hver nye versjon sjekker automatiske tester grensesnittets svar opp mot beskrivelsen og skjemaene fra GS1. På enkelte steder er beskrivelsen ufullstendig eller i strid med standardteksten. Der følger vi standarden, og en test vil gi beskjed så snart GS1 har rettet opp dette.
Der vi bevisst avviker fra standarden eller utelater en tillatt mulighet, bør en partner først og fremst være klar over tre punkter før han kobler til systemet sitt:
- Grensesnittet støtter JSON og JSON-LD, de to formatene som standarden krever for denne tilkoblingen. XML, som standarden tillater, støttes ikke.
- Identifikatorene returneres som GS1 Digital Link, slik standarden foreskriver uten nærmere angivelse, eller på forespørsel slik partneren har oppgitt dem. Grensesnittet tilbyr ikke muligheten til å konvertere hver enkelt identifikator til EPC-notasjonsformen.
- Abonnementene leveres til en adresse etter eget valg, og kun via en kryptert forbindelse (https). Vi tilbyr ikke levering via WebSocket.
Utviklere kan lese om hvordan systemet til en partner logger seg på med sin tilgang, og hvor grensesnittet ellers avviker fra standarden, i veiledningen i Transpareos API-dokumentasjon.
Tilbake til rampen
Kl. 06.41 meldte lageret varemottak, og kort tid etter får ERP-systemet beskjed om dette via abonnementet sitt. Den som søker etter serienummeret til et av de 48 batteriene, kan se hele reisen: montert på fabrikken, pakket på pallen, overtatt av transportfirmaet, ankommet i Basel - og ved siden av dette de registrerte hendelsene i batteriets «pass».
Spedisjonsfirmaet har fått tilgang til dette, og det rapporterer i det formatet som systemet deres uansett bruker.
Spørsmål om dette innlegget
Hva er EPCIS 2.0?
EPCIS 2.0 er GS1-standarden for hendelser i forsyningskjeden, vedtatt i 2022. En hendelse registrerer hvilke produkter som ble registrert når, hvor og i hvilket trinn i forretningsprosessen, samt hvilken tilstand de befinner seg i etterpå. Med versjon 2.0 ble JSON og JSON-LD lagt til som formater, samt et REST-grensesnitt som systemer kan bruke til å rapportere og hente frem hendelser.
Trenger jeg et eget EPCIS-arkiv?
Nei. Hvert arbeidsområde i Transpareo har sitt eget, med sin egen adresse. Det mottar hendelser, lagrer dem og svarer på forespørsler. Partnerne dine rapporterer dit, og dine egne systemer sender forespørsler dit.
Vil en rapportert hendelse endre produktpasset mitt?
Nei. En rapportert hendelse vises ved siden av passet og knyttes til det via passets identifikasjonsnummer. Den signerte historikken til passet og selve passet som kundene dine leser, forblir slik du har publisert dem.
Hvordan kobler en partner sitt system til?
Du oppretter en tilgang for ham til programmene og gir ham rett til å rapportere hendelser, og om ønskelig også rett til å lese dem. Ved hjelp av nøkkel og hemmelighet henter systemet hans et tilgangstoken og rapporterer hendelsene hans som et EPCIS-dokument til adressen til arbeidsområdet ditt. Hvis systemet hans allerede støtter EPCIS 2.0, trengs det bare adressen og tilgangen.
Hvordan kontrollerer Transpareo at grensesnittet oppfyller standarden?
Automatiske tester sjekker svarene for hver operasjon mot OpenAPI-beskrivelsen og JSON-skjemaene som GS1 publiserer for EPCIS 2.0 før hver nye versjon. Der beskrivelsen er ufullstendig eller strider mot standardteksten, følger vi standarden, og en test vil gi beskjed så snart GS1 har rettet opp feilen. Der grensesnittet avviker fra standarden, angir API-dokumentasjonen hvert enkelt sted.




