Tisdag, kl. 06.40, ramp 3 på lagret nära Basel. En lastbil levererar en pall med 48 elcykelbatterier från monteringsfabriken, skannern piper och lagerhanteringssystemet registrerar varumottagningen. Tre system har nu registrerat dessa batterier: produktionsstyrningen på fabriken, speditörens försändelsessystem och nu lagret. Varje system känner till sin del av resan.
Från och med nu samlas dessa utdrag i Transpareo. Varje arbetsyta har en gränssnitt för EPCIS 2.0, GS1:s standard för händelser i leveranskedjan. Fabrik, speditör och lager rapporterar sina händelser till den plats där batteriernas produktpass finns, och ni behöver inte bygga en egen anslutning för någon av de tre parterna.
Ett format för fabrik, speditör och lager
EPCIS står för Electronic Product Code Information Services. En EPCIS-händelse besvarar fyra frågor: vilka produkter, när, var och varför. ”Varför” avser affärssteget, till exempel tillverkning, leverans eller varumottagning, tillsammans med det tillstånd som produkten befinner sig i därefter. Där system idag utbyter händelser i leveranskedjan - vilket har varit fallet inom läkemedelslogistiken i flera år - använder många av dem redan EPCIS. Även produktpasset i sig dokumenterar i EPCIS vad som har hänt med en produkt, i ett av dess tre ordböcker.
Utan ett gemensamt format måste varje partner hitta sin egen lösning: en tabell via e-post från fabriken, en exportfil från speditören, en rapport från lagret - alla med sina egna kolumner. Hos Transpareo får varje partner en egen åtkomst till gränssnittet för din arbetsyta och rapporterar sina händelser i EPCIS. Transpareo Connect kopplar samman andra system med Transpareo via API, webhooks och nu även EPCIS 2.0. Stamuppgifterna för batterierna från ditt ERP-system skickas vidare på det vanliga sättet.
Den information som en leverantör har om batterierna, till exempel deras vikt eller cellernas ursprung, skickas till er via en separat kanal. Med Transpareo Upstream begär du dessa uppgifter direkt från dina leverantörer, någon där matar in dem och du kontrollerar svaret innan det läggs in i passet. Via EPCIS rapporterar dina partners system vad som händer med batterierna: monterade, avsända, ankomna.
En ny partner behöver bara ett konto.
Fabriken skickar en hel skifts data i en leverans, upp till 10 000 händelser åt gången. Transpareo kontrollerar varje händelse mot GS1-schemat. På partnerns begäran godkänns leveransen i sin helhet eller inte alls, alternativt tar Transpareo emot alla giltiga händelser och anger vilka som är felaktiga.
Om GTIN, serienummer och batchnummer i produktpasset
En händelse identifierar produkterna utifrån deras identifieringsnummer. Om den identifierar ett batteri utifrån dess GTIN, tillsammans med serienumret eller batchnumret, hittar Transpareo produktpasset utifrån detta, och batterier till elcyklar måste från och med den 18 februari 2027 ha ett eget pass. En händelse som endast anger pallen leder inte till något pass. Oavsett om transportföretaget anger ett batteri med EPC-kod eller som GS1 Digital Link, precis som i passets QR-kod, leder båda till samma pass.
Om anläggningen rapporterar batterier vars pass ännu inte har skapats går ingenting förlorat. Händelserna förblir sparade, och så snart passet finns kommer sökningen efter det att hitta dem.
Samma sökning visar även de offentliga händelserna för själva passet, till exempel när det utfärdades, en reparation eller återvinning. Varje händelse visas precis som den har signerats i passets händelsefil, med en signatur som mottagaren kan verifiera.
En sökning visar ett batteris hela livscykel: vad samarbetspartnerna har rapporterat och vad dess pass har registrerat.
Det som en partner rapporterar anges bredvid passet. En varumottagning visas alltså inte automatiskt i det offentliga passet, som kunder, verkstäder och myndigheter läser. Det hade gått snabbare att bygga in den funktionen, men vi valde att inte göra det: Ett signerat produktpass är ett dokument som du står för, och en partners anmälan förblir just den partnerns uttalande.
Om en partner gör ett fel korrigerar denne sin händelse med en felrapport, enligt vad EPCIS föreskriver. Den ursprungliga händelsen kvarstår, korrigeringen visas bredvid, och den som gör en förfrågan ser båda.
Söka, spara, prenumerera
Dessa händelser hämtas från era egna system och, inom ramen för deras åtkomst, även från era samarbetspartners. En sökning kan göras efter produkt, serienummer eller sats, tidsperiod, affärssteg, plats eller status. På så sätt kan er kundtjänst se när en kunds batteri lämnade lagret utan att behöva ringa transportföretaget.
En sökning som du behöver göra om och om igen kan du spara under ett namn och prenumerera på den. Transpareo skickar sedan de nya händelserna så snart de kommer in, eller enligt ett schema, till exempel varje morgon vid samma tidpunkt. Om mottagaren anger en hemlighet förses varje leverans med en signatur som visar att den kommer från din arbetsyta.
Ers ERP-system får information om varumottagningen i Basel utan att någon behöver vidarebefordra en fil.
Vem ser vad
Varje åtkomst har sina egna behörigheter, och att läsa händelser och rapportera händelser är två separata behörigheter. Du kan dessutom begränsa en åtkomst till vissa pass. Transportföretaget läser då händelserna för de batterier vars pass du har gett dem tillgång till, samt de händelser som de själva har rapporterat.
En partner ser exakt de produkter som du ger honom tillgång till.
Händelserna finns inom EU, på din arbetsyta, precis som alla dina uppgifter hos Transpareo.
Varför standarden är avgörande
En partner vars system är uppbyggt enligt GS1:s beskrivning ska kunna kommunicera med er arbetsyta utan att någon behöver göra några anpassningar. Annars krävs en översättning mellan partnerns system och er arbetsyta, och vid varje översättning kan ett värde förlora sin betydelse. Därför följer gränssnittet för anslutningen, som GS1 publicerar för EPCIS 2.0, även felmeddelandena.
En standard är bara till nytta om er partner använder den precis som den är skriven.
Innan varje ny version släpps kontrollerar automatiska tester att gränssnittets svar överensstämmer med GS1:s beskrivning och scheman. På vissa ställen är beskrivningen ofullständig eller står i strid med standardtexten. I dessa fall följer vi standarden, och ett test avger ett meddelande så snart GS1 har korrigerat avsnittet.
I de fall där vi medvetet avviker från standarden eller utelämnar ett tillåtet alternativ bör en partner framför allt känna till tre saker innan han ansluter sitt system:
- Gränssnittet stöder JSON och JSON-LD, de två format som standarden kräver för denna anslutning. XML, som standarden tillåter, stöds inte.
- Identifierare returneras som GS1 Digital Link, enligt vad standarden föreskriver om inget annat anges, eller på begäran i den form som partnern har rapporterat dem. Gränssnittet erbjuder inte möjligheten att omvandla varje identifierare till EPC-format.
- Prenumerationer levereras till en adress som du själv väljer, och endast via en krypterad anslutning (https). Vi erbjuder inte leverans via WebSocket.
I Transpareos API-dokumentation kan utvecklare läsa om hur ett partnersystem loggar in med sina inloggningsuppgifter och på vilka andra punkter gränssnittet avviker från standarden.
Tillbaka till rampen
Klockan 06.41 har lagret rapporterat varumottagningen, och strax därefter får ert ERP-system informationen via sitt abonnemang. Den som söker efter serienumret på ett av de 48 batterierna kan följa dess resa: monterat på fabriken, packat på pallen, övertaget av speditören, ankommet till Basel - och bredvid detta visas de registrerade händelserna i dess pass.
Speditören har fått tillgång till detta och rapporterar i det format som deras system redan stöder.
Frågor om detta inlägg
Vad är EPCIS 2.0?
EPCIS 2.0 är GS1:s standard för händelser i leveranskedjan, som antogs 2022. En händelse dokumenterar vilka produkter som registrerades när, var och vid vilket steg i affärsprocessen, samt i vilket skick de befinner sig därefter. I version 2.0 tillkom formaten JSON och JSON-LD samt ett REST-gränssnitt som systemen kan använda för att rapportera och hämta händelser.
Vad har EPCIS med det digitala produktpasset att göra?
Det digitala produktpasset beskriver vad en produkt är, och EPCIS registrerar vad som har hänt med den. I Transpareo publicerar varje pass sina egna händelser som en signerad EPCIS-fil, och dina partners händelser kopplas till passet via GTIN med serienummer eller batchnummer.
Behöver jag ett eget EPCIS-arkiv?
Nej. Varje arbetsyta i Transpareo har ett eget, med sin egen adress. Det tar emot händelser, lagrar dem och besvarar förfrågningar. Dina samarbetspartner rapporterar dit, och dina egna system gör förfrågningar där.
Påverkar en rapporterad händelse mitt produktpass?
Nej. En rapporterad händelse visas bredvid passet och kopplas till det via dess identifieringsnummer. Passets signerade historik och det pass som dina kunder läser förblir precis som du har publicerat dem.
Hur ansluter en partner sitt system?
Ni skapar en åtkomst för program åt honom och ger honom rätten att rapportera händelser, samt rätten att läsa dem om så önskas. Med nyckel och hemlighet hämtar hans system en åtkomsttoken och rapporterar sina händelser som EPCIS-dokument till adressen för ert arbetsytor. Om hans system redan stöder EPCIS 2.0 behövs endast adressen och åtkomsten.
Hur kontrollerar Transpareo att gränssnittet följer standarden?
Automatiska tester kontrollerar före varje ny version svaren för varje operation mot OpenAPI-beskrivningen och de JSON-scheman som GS1 publicerar för EPCIS 2.0. Om beskrivningen är ofullständig eller strider mot standardtexten följer vi standarden, och ett test rapporterar detta så snart GS1 har korrigerat avsnittet. Om gränssnittet avviker från standarden anges varje sådant ställe i API-dokumentationen.




