Saltar al contenido principal
Habla con nosotros

Integraciones y API · Guía

Deja que el sistema de un comprador lea tus eventos de trazabilidad

Los sistemas de tus compradores y los tuyos leen los eventos de tus lotes por la interfaz de consulta GS1 EPCIS 2.0, en lugar de esperar archivos. Tú eliges qué empresas conectadas pueden leerlos.

Muchos compradores usan un sistema de trazabilidad que habla GS1 EPCIS 2.0, el estándar mundial de "qué le pasó a qué lote, cuándo y dónde". A-REX responde a ese estándar directamente: su sistema pregunta y A-REX responde con los eventos de los lotes, en vivo, filtrados como define GS1. Sin archivos que enviar.

Qué lee el otro sistema

Cada evento dice qué le pasó a un lote: se creó, se envió, se recibió, se procesó, se inspeccionó o recibió un certificado. Cada evento lleva un paso de negocio GS1 (por ejemplo shipping, envío) y, al lado, tus propias palabras para el paso. Cada evento dice que lo declaró tu empresa: compartir eventos no los vuelve verificados.

  • Tu propio sistema lee todos los eventos de tu empresa.
  • Una empresa conectada lee los eventos de los lotes que le entregaste, y solo mientras compartes con ella Eventos de trazabilidad (ver Qué comparte cada empresa). Ve tus entregas a ella, nunca tus entregas a otros, y el procesamiento hasta la entrega.

Da acceso a un sistema

  1. En Integraciones, crea una clave de API o un cliente de máquina con el alcance read. Un comprador la crea en su propia empresa: lee lo que tú compartes con él.
  2. Da a quienes operan ese sistema la dirección https://{dirección de la API}/v1/epcis y la clave.
  3. Su sistema pide, por ejemplo, los envíos de un lote: GET /v1/epcis/events?EQ_bizStep=shipping&MATCH_epcClass={el Digital Link del lote}.

A-REX registra cada lectura de una clave o un cliente. Para que una empresa conectada deje de leer tus eventos, desmarca Eventos de trazabilidad en la página de su conexión; para detener una clave, revócala.

Para tener en cuenta

  • La interfaz solo lee. Nada puede escribir eventos en A-REX por ella: los registros siguen pasando por tus aprobaciones.
  • Los historiales largos llegan página por página; un sistema que necesita mucho más acota el período.
  • El identificador del lote en los eventos es su GS1 Digital Link cuando el producto tiene un GTIN y el lote un código de lote; si no, un identificador de A-REX.
  • Tu equipo técnico encuentra la descripción completa, con cada filtro, en la documentación para desarrolladores (interfaz de consulta EPCIS).