Connecter votre ERP et d’autres systèmes

Votre ERP connaît déjà vos récoltes, réceptions et expéditions. Le connecter évite que quiconque les saisisse deux fois. Tout se trouve dans Paramètres › Intégrations, en cinq onglets : Webhooks, Entrants, Clients machine, Adresses IP et Identité des justificatifs (l’identité avec laquelle vos passeports produit sont signés, voir Identité des justificatifs). Les propriétaires et administrateurs configurent les connexions des entreprises de production ; dans un sandbox, les opérateurs peuvent aussi les configurer.

Rien de ce qui arrive d’un autre système n’agit tout seul : cela devient un événement, un brouillon ou une approbation, et une personne doit l’approuver.

Choisir la bonne méthode

Recevoir des messages de votre ERP

1. Dans Entrants, sélectionnez Ajouter un point de terminaison entrant.
2. Expéditeur : nommez-le (par exemple « Réceptions ERP ») et choisissez Comment l’expéditeur signe.
3. Accès et limites : si vous le souhaitez, limitez les Adresses d’expéditeur autorisées, et fixez la taille et le débit des messages.
4. Message d’exemple : collez un message type. Ses champs deviennent le format attendu.
5. Sélectionnez Créer et confirmez avec votre code d’authentification. Copiez l’Adresse et le secret dans votre ERP : le secret n’est affiché qu’une fois.

Les messages qui ne correspondent pas aux champs attendus sont En quarantaine. Ouvrez-en un pour le Vérifier à nouveau après avoir corrigé les champs, ou l’Écarter.

Envoyer des événements à votre ERP (webhooks)

1. Dans Webhooks, sélectionnez Ajouter un point de terminaison.
2. Destination : un nom, l’URL https de votre système et le Format (CloudEvents (recommandé) ou JSON simple). Cochez Les automatisations peuvent envoyer vers ce point de terminaison si des étapes d’automatisation doivent y envoyer des messages.
3. Événements : Partir d’un modèle (Tout sur les lots, Approbations, Rapports, Changements de l’annuaire, Problèmes uniquement, Règles de lots et compléments), ou choisissez des événements par groupe. Par exemple, Livraison en attente et Livraison en échec préviennent votre ERP quand une livraison approuvée est retenue ou ne peut pas être effectuée.
4. Vérification, puis Créer. Copiez le secret de signature. A-REX envoie une requête de vérification, et le point de terminaison devient Actif quand votre système y répond.

Un point de terminaison reçoit les événements de sa propre entreprise : de vrais événements dans une entreprise de production, des événements d’entraînement dans un sandbox. Les messages contiennent des identifiants et des liens, pas des noms. Chaque point de terminaison liste ses Livraisons avec chaque tentative ; les envois en échec sont retentés, et Récupérer / rejouer les manquants renvoie ce que votre système a manqué. Autorisez dans votre pare-feu les adresses indiquées dans Adresses IP.

Vérifier qu’un message vient d’A-REX

Chaque message webhook est signé avec le secret du point de terminaison, qui commence par whsec_. Votre système doit vérifier cette signature avant de faire confiance à un message. Ouvrez le point de terminaison dans Webhooks : le panneau Vérifier les signatures fournit du code prêt à l’emploi en TypeScript, Python, Java et C# que votre équipe informatique peut copier. Pendant un Renouveler le secret, l’ancien et le nouveau secret sont tous deux valides pendant la période de chevauchement que vous choisissez : passez donc les deux à la vérification.

Clients machine

Dans Clients machine, sélectionnez Créer un client, choisissez son Accès (Lecture, Proposition) et sa Méthode de connexion : Clé privée (recommandé) ou Secret client. Aucun accès ne permet d’approuver : ce qu’un système propose attend une personne. Les secrets client et les clés d’API indiquent à quel type d’entreprise ils appartiennent : ils commencent par arex_cs_prod_ ou arex_cs_sandbox_, et arex_sk_prod_ ou arex_sk_sandbox_, de sorte qu’une clé d’entraînement n’est jamais prise pour une clé de production. Les clés créées auparavant fonctionnent toujours.

Descriptions de l’API et des événements

Pour votre équipe informatique, A-REX décrit son API en OpenAPI 3.1 et chaque événement webhook en AsyncAPI 3.0. Les deux sont générés à partir de la plateforme elle-même : ils correspondent donc à ce qu’elle accepte et envoie. Vos développeurs peuvent demander les fichiers actuels dans Support, puis se connecter avec un client machine.

Vos propres identifiants

Les partenaires, sites et produits peuvent porter l’identifiant propre à votre entreprise, le code qu’ils ont dans votre ERP. Votre intégration peut alors retrouver un producteur, une exploitation ou un produit par votre code, et les messages peuvent l’inclure : votre ERP n’a jamais besoin de connaître les identifiants d’A-REX.

Import de fichier

L’import de fichier (CSV) des réceptions de récolte, des livraisons, des résultats de laboratoire et des entrées de l’annuaire arrive dans Intégrations. Il vérifie d’abord chaque ligne et liste les erreurs, puis crée des approbations en attente, jamais des modifications directes.

S’exercer dans un sandbox

Essayez tout avant que votre entreprise de production ne l’utilise :

• Créez un sandbox depuis votre organisation : Nouvelle entreprise › Un sandbox. C’est une entreprise d’exercice aux données fictives, et ses points de terminaison reçoivent ses propres événements : approuvez une récolte d’exercice et voyez arriver le vrai message. Les opérateurs peuvent y ajouter des points de terminaison ; dans une entreprise de production, les points de terminaison demandent un propriétaire ou un administrateur et son second facteur.
• Sur un point de terminaison, sélectionnez Envoyer un événement d’exemple pour envoyer un exemple signé, marqué comme exemple, et voir la requête et la réponse exactes.
• L’exécution de test d’une automatisation ne fait que simuler ses messages : rien n’atteint vos systèmes réels. Voir Automatisations.