EPCIS 2.0: os eventos de todos os parceiros num único local

EPCIS 2.0: os eventos de todos os parceiros num único local

Através da interface EPCIS 2.0 da Transpareo, a fábrica, a empresa de transportes e o armazém comunicam os seus eventos para o local onde se encontram os seus passaportes do produto.

Terça-feira, 6h40, rampa 3 no armazém perto de Basileia. Um camião traz uma palete com 48 baterias para bicicletas elétricas da fábrica de montagem, o leitor de código de barras emite um sinal sonoro e o sistema de gestão de armazém regista a entrada de mercadorias. Entretanto, estas baterias já passaram por três sistemas: o controlo de produção na fábrica, o sistema de expedição da transportadora e, agora, o armazém. Cada um deles conhece a sua parte do percurso.

A partir de agora, estes dados são reunidos no Transpareo. Cada espaço de trabalho dispõe de uma interface para o EPCIS 2.0, a norma da GS1 para eventos na cadeia de abastecimento. A fábrica, a transportadora e o armazém comunicam os seus eventos para o local onde se encontram os passaportes dos produtos das baterias, e não é necessário criar uma ligação específica para nenhum dos três parceiros.

Um formato para a fábrica, a empresa de transportes e o armazém

EPCIS significa Electronic Product Code Information Services. Um evento EPCIS responde a quatro perguntas: que produtos, quando, onde e porquê. O «porquê» corresponde à etapa do processo empresarial - por exemplo, fabrico, expedição ou receção de mercadorias - , juntamente com o estado em que o produto se encontra posteriormente. Nos casos em que os sistemas trocam atualmente informações sobre eventos da cadeia de abastecimento - algo que, na logística farmacêutica, já acontece há anos - , muitos deles já utilizam o EPCIS.

Sem formato comum, cada parceiro tem de seguir o seu próprio caminho: uma tabela enviada por e-mail a partir da fábrica, um ficheiro de exportação da empresa de transportes, um relatório do armazém, cada um com as suas próprias colunas. Na Transpareo, cada parceiro recebe um acesso próprio à interface do seu espaço de trabalho e regista os seus eventos no EPCIS. A interface faz parte do Transpareo Connect, e os dados de base das baterias provenientes do seu ERP continuam a ser transmitidos da forma habitual.

As informações que um fornecedor possui sobre as baterias, tais como o seu peso ou a origem das células, chegam até si por uma via separada. Através do Transpareo Upstream, pode solicitar essas informações diretamente aos seus fornecedores; alguém da parte deles introduz os dados e o senhor verifica a resposta antes de esta ser inserida no passaporte. Através do EPCIS, os sistemas dos seus parceiros comunicam o que acontece com as baterias: montadas, enviadas, recebidas.

Um novo parceiro só precisa de um acesso.

A fábrica envia os dados de montagem de um turno inteiro numa única remessa, podendo incluir até 10 000 eventos de uma só vez. Transpareo verifica cada evento em relação ao esquema da GS1. A pedido do parceiro, a remessa é considerada válida na totalidade ou não é válida de todo; caso contrário, a Transpareo aceita todos os eventos válidos e identifica os eventos com erros.

Cada evento tem o seu passaporte do produto

Um evento identifica os produtos através dos seus códigos de identificação: o GTIN com o número de série de uma bateria individual ou com o seu lote. É com base nisso que a Transpareo encontra o passaporte do produto, e as baterias para bicicletas elétricas necessitarão de um passaporte próprio a partir de 18 de fevereiro de 2027. Quer a empresa de transporte indique uma bateria como identificador EPC ou como GS1 Digital Link, tal como no código QR do passaporte, ambos conduzem ao mesmo passaporte.

Se a fábrica comunicar baterias cujo registo ainda não tenha sido criado, nada se perde. Os registos permanecem guardados e, assim que o registo estiver disponível, a consulta relativa ao mesmo irá localizá-los.

A mesma consulta fornece também os eventos públicos do próprio passaporte, tais como a sua emissão, uma reparação ou a reciclagem. Cada um deles é apresentado tal como foi assinado no ficheiro de eventos do passaporte, com a respetiva assinatura, que o destinatário pode verificar.

Uma consulta mostra todo o percurso de uma bateria: o que os parceiros comunicaram e o que o seu «pass» registou.

O que um parceiro regista fica indicado ao lado do passaporte. Assim, uma entrada de mercadorias não aparece automaticamente no passaporte público, que é consultado por clientes, oficinas e autoridades. Teria sido mais rápido implementar isso, mas decidimos não o fazer: um passaporte do produto assinado é um documento pelo qual V.ª assume a responsabilidade, e a informação fornecida por um parceiro continua a ser uma declaração desse parceiro.

Se um dos parceiros cometer um erro, corrige o seu evento através de uma declaração de erro, tal como previsto pelo EPCIS. O evento original mantém-se, a correção é registada ao lado e quem consultar o registo vê ambos.

Consultar, guardar, subscrever

Esses mesmos eventos consultam os seus próprios sistemas e, dentro dos limites do seu acesso, também os dos seus parceiros. Uma consulta pode ser efetuada por produto, número de série ou lote, por período, etapa comercial, local ou estado. Desta forma, o seu serviço de apoio ao cliente pode verificar quando é que a bateria de uma cliente saiu do armazém, sem ter de contactar a empresa de transportes.

Guarde uma consulta de que necessita frequentemente com um nome e subscreva-a. O Transpareo enviará então os novos eventos assim que estes chegarem ou de acordo com um horário definido, por exemplo, todas as manhãs à mesma hora. Se o destinatário definir uma senha, cada envio incluirá uma assinatura que lhe permitirá reconhecer que provém do seu espaço de trabalho.

O seu ERP fica a saber da entrada de mercadorias em Basileia, sem que seja necessário enviar qualquer ficheiro.

Quem vê o quê

Cada acesso tem os seus próprios direitos, sendo que «ler eventos» e «comunicar eventos» são dois direitos distintos. Além disso, pode limitar um acesso a determinados registos. A empresa de transportes irá então ler os eventos relativos às baterias cujos passaportes lhe tiver autorizado, bem como os eventos que ela própria tiver comunicado.

Um parceiro vê exatamente os produtos que lhe disponibilizar.

Os eventos encontram-se na UE, na base de dados própria do seu espaço de trabalho, tal como todos os seus dados na Transpareo.

Por que razão o padrão é importante

Um parceiro cujo sistema tenha sido desenvolvido de acordo com a descrição da GS1 deverá comunicar com o seu espaço de trabalho sem que seja necessário qualquer ajuste. Por esse motivo, a interface de ligação publicada pela GS1 para o EPCIS 2.0 segue as especificações até ao nível das mensagens de erro.

Uma norma só lhe será útil se o seu parceiro a utilizar tal como está escrita.

Antes de cada nova versão, os testes automáticos verificam as respostas da interface em relação à descrição e aos esquemas da GS1. Em alguns pontos, a descrição está incompleta ou contradiz o texto da norma. Nesses casos, seguimos a norma, e um teste sinaliza assim que a GS1 corrigir o ponto em questão.

Nos casos em que nos desviamos deliberadamente ou omitimos uma opção disponível, um parceiro deve, acima de tudo, ter conhecimento de três pontos antes de ligar o seu sistema:

  • A interface utiliza JSON e JSON-LD, os dois formatos exigidos pela norma para esta ligação. O XML, cuja utilização é facultativa, não é suportado por esta interface.
  • Os identificadores são devolvidos como GS1 Digital Link, tal como previsto pela norma na ausência de outras indicações, ou, se assim for solicitado, tal como foram comunicados pelo parceiro. A interface não permite a conversão de cada identificador para o formato EPC.
  • As assinaturas são enviadas para a morada da sua escolha e apenas através de uma ligação encriptada (https). Não disponibilizamos a entrega através de WebSocket.

Os programadores podem consultar o guia da documentação da API da Transpareo para saberem como é que o sistema de um parceiro efetua o início de sessão com o seu acesso e em que outros aspetos a interface difere do padrão.

De volta à rampa

Às 6h41, o armazém comunicou a entrada de mercadorias e, pouco depois, o seu ERP fica a par disso, através da sua subscrição. Quem consultar o número de série de uma das 48 baterias poderá acompanhar o seu percurso: montada na fábrica, colocada no palete, recolhida pela transportadora, chegada a Basileia, e, ao lado, os eventos registados no seu «passaporte».

A empresa de transportes recebeu acesso para esse efeito e envia os dados no formato que o seu sistema já suporta.

Perguntas sobre este artigo

O que é o EPCIS 2.0?

O EPCIS 2.0 é a norma da GS1 para eventos na cadeia de abastecimento, adotada em 2022. Um evento regista quais os produtos que foram registados, quando, onde e em que etapa do processo comercial, bem como o seu estado posterior. Com a versão 2.0, foram introduzidos os formatos JSON e JSON-LD, bem como uma interface REST, através da qual os sistemas comunicam e consultam eventos.

Preciso de ter o meu próprio repositório EPCIS?

Não. Cada espaço de trabalho no Transpareo possui uma, com o seu próprio endereço. Esta recebe eventos, armazena-os e responde a consultas. Os seus parceiros enviam informações para esse espaço de trabalho e os seus próprios sistemas consultam-no.

Um evento comunicado altera o meu passaporte do produto?

Não. Um evento registado aparece ao lado do passaporte e é associado a este através do seu identificador. O histórico assinado do passaporte e o passaporte que os seus clientes consultam permanecem tal como os publicou.

Como é que um parceiro integra o seu sistema?

Cria-se para ele um acesso para programas e concede-lhe o direito de comunicar eventos e, se assim o desejar, também o direito de os ler. Com a chave e a senha, o seu sistema obtém um token de acesso e comunica os seus eventos sob a forma de um documento EPCIS para o endereço do seu espaço de trabalho. Caso o sistema dele já seja compatível com o EPCIS 2.0, bastam apenas a morada e o acesso.

De que forma é que a Transpareo verifica se a interface cumpre a norma?

Os testes automáticos verificam, antes de cada nova versão, as respostas de cada operação em relação à descrição da OpenAPI e aos esquemas JSON publicados pela GS1 para o EPCIS 2.0. Nos casos em que a descrição estiver incompleta ou contradizer o texto da norma, seguimos a norma, e um teste sinaliza o problema assim que a GS1 corrigir a parte em questão. Nos casos em que a interface se desvia da norma, a documentação da API indica cada ponto em questão.

Notícias sobre « Transpareo Connect », assim que estiverem disponíveis

Descrevemos o que construímos e porquê, numa linguagem compreensível.