Aller au contenu principal

Intégrations et API · Guide

Laissez le système d’un acheteur lire vos événements de traçabilité

Les systèmes de vos acheteurs et les vôtres lisent les événements de vos lots par l’interface de requête GS1 EPCIS 2.0, au lieu d’attendre des fichiers. Vous choisissez quelles entreprises connectées peuvent les lire.

Beaucoup d’acheteurs utilisent un système de traçabilité qui parle GS1 EPCIS 2.0, la norme mondiale de « ce qui est arrivé à quel lot, quand et où ». A-REX répond directement à cette norme : leur système demande, A-REX répond avec les événements des lots, en direct, filtrés comme GS1 le définit. Aucun fichier à envoyer.

Ce que lit l’autre système

Chaque événement dit ce qui est arrivé à un lot : il a été créé, expédié, reçu, transformé, inspecté ou a reçu un certificat. Chaque événement porte une étape métier GS1 (par exemple shipping, expédition) et, à côté, vos propres mots pour l’étape. Chaque événement dit qu’il a été déclaré par votre entreprise : partager des événements ne les rend pas vérifiés.

  • Votre propre système lit tous les événements de votre entreprise.
  • Une entreprise connectée lit les événements des lots que vous lui avez livrés, et seulement tant que vous partagez avec elle les Événements de traçabilité (voir Ce que partage chaque entreprise). Elle voit vos livraisons à elle, jamais vos livraisons à d’autres, et la transformation jusqu’à la livraison.

Donner accès à un système

  1. Dans Intégrations, créez une clé d’API ou un client machine avec la portée read. Un acheteur la crée dans sa propre entreprise : il lit ce que vous partagez avec lui.
  2. Donnez à ceux qui exploitent ce système l’adresse https://{adresse de l’API}/v1/epcis et la clé.
  3. Leur système demande, par exemple, les expéditions d’un lot : GET /v1/epcis/events?EQ_bizStep=shipping&MATCH_epcClass={le Digital Link du lot}.

A-REX enregistre chaque lecture par une clé ou un client. Pour qu’une entreprise connectée cesse de lire vos événements, décochez Événements de traçabilité sur la page de sa connexion ; pour arrêter une clé, révoquez-la.

Bon à savoir

  • L’interface ne fait que lire. Rien ne peut écrire d’événements dans A-REX par elle : les enregistrements passent toujours par vos approbations.
  • Les longs historiques arrivent page par page ; un système qui a besoin de beaucoup plus réduit la période.
  • L’identifiant du lot dans les événements est son GS1 Digital Link quand le produit a un GTIN et le lot un code de lot ; sinon, un identifiant A-REX.
  • Votre équipe technique trouve la description complète, avec chaque filtre, dans la documentation pour les développeurs (interface de requête EPCIS).