Pular para o conteúdo principal
Fale com a gente

Integrações e API · Guia

Deixe o sistema de um comprador ler seus eventos de rastreabilidade

Os sistemas dos seus compradores e os seus leem os eventos dos seus lotes pela interface de consulta GS1 EPCIS 2.0, em vez de esperar arquivos. Você escolhe quais empresas conectadas podem lê-los.

Muitos compradores usam um sistema de rastreabilidade que fala GS1 EPCIS 2.0, o padrão mundial de "o que aconteceu com qual lote, quando e onde". A A-REX responde a esse padrão diretamente: o sistema deles pergunta e a A-REX responde com os eventos dos lotes, ao vivo, filtrados como a GS1 define. Sem arquivos para enviar.

O que o outro sistema lê

Cada evento diz o que aconteceu com um lote: foi criado, enviado, recebido, processado, inspecionado ou recebeu um certificado. Cada evento traz um passo de negócio GS1 (por exemplo shipping, envio) e, ao lado, as suas próprias palavras para o passo. Cada evento diz que foi declarado pela sua empresa: compartilhar eventos não os torna verificados.

  • O seu próprio sistema lê todos os eventos da sua empresa.
  • Uma empresa conectada lê os eventos dos lotes que você entregou a ela, e só enquanto você compartilha com ela Eventos de rastreabilidade (veja O que cada empresa compartilha). Ela vê as suas entregas a ela, nunca as suas entregas a outros, e o processamento até a entrega.

Dê acesso a um sistema

  1. Em Integrações, crie uma chave de API ou um cliente de máquina com o escopo read. Um comprador a cria na própria empresa: ele lê o que você compartilha com ele.
  2. Passe a quem opera esse sistema o endereço https://{endereço da API}/v1/epcis e a chave.
  3. O sistema deles pede, por exemplo, os envios de um lote: GET /v1/epcis/events?EQ_bizStep=shipping&MATCH_epcClass={o Digital Link do lote}.

A A-REX registra cada leitura de uma chave ou de um cliente. Para que uma empresa conectada pare de ler os seus eventos, desmarque Eventos de rastreabilidade na página da conexão; para parar uma chave, revogue-a.

Bom saber

  • A interface só lê. Nada pode gravar eventos na A-REX por ela: os registros continuam passando pelas suas aprovações.
  • Históricos longos chegam página por página; um sistema que precisa de muito mais restringe o período.
  • O identificador do lote nos eventos é o GS1 Digital Link quando o produto tem um GTIN e o lote um código de lote; senão, um identificador da A-REX.
  • A sua equipe técnica encontra a descrição completa, com cada filtro, na documentação para desenvolvedores (interface de consulta EPCIS).