Intégration ERP

Note : Il s'agit d'un article très technique. Nous vous recommandons donc d'impliquer votre service informatique lors de sa lecture. Si vous avez des questions ou des demandes, veuillez nous contacter via support@azumuta.com — nous nous ferons un plaisir de vous aider.

Intégration d'Azumuta avec un système ERP

Il est possible d'intégrer Azumuta à un système ERP externe. Le plus souvent, cette intégration sert à la création automatique des commandes produit dans Azumuta — basée sur les données de commande fournies par le système ERP.

L'avantage ? Vos commandes produit peuvent être créées automatiquement en un clin d'œil dans Azumuta (y compris ses paramètres, variantes et toutes autres données importantes) — sans aucune saisie manuelle.

L'intégration entre Azumuta et un système ERP utilise généralement l'API REST et implique plusieurs étapes. Gardez à l'esprit que les détails peuvent varier en fonction de vos besoins et du système ERP que vous utilisez.

Voici les grandes lignes du processus :

1. Comprendre les besoins : identifiez les données et processus spécifiques devant être intégrés entre Azumuta et le système ERP. Un exemple simple est la création automatique de commandes produit à partir des informations provenant du système ERP.
2. Authentification et autorisation : assurez-vous de disposer des identifiants et des permissions nécessaires pour accéder à l'API REST d'Azumuta et du système ERP. L'authentification avec Azumuta se fait via des clés API.
3. Consulter la documentation de l'API : obtenez et examinez la documentation de l'API pour Azumuta et pour le système ERP. Cette documentation fournit des détails sur les endpoints disponibles, les formats de requête/réponse et les éventuelles exigences d'authentification.
4. Se mettre d'accord sur le mapping des données : établissez la correspondance des champs et des structures de données entre Azumuta et le système ERP. Assurez-vous d'une compréhension commune de la manière dont les données seront représentées et échangées. Pour l'exemple simple de création de commandes produit, cela se résume aux questions suivantes : comment le numéro de commande produit est-il déterminé ? Sur la base de quels articles les commandes sont-elles créées ? Quels paramètres ou variantes sont envoyés avec la commande nouvellement créée ?
5. Développement : développez le middleware ou les connecteurs pour faciliter la communication entre Azumuta et le système ERP. On appelle généralement cela la couche d'intégration, qui agit comme une « couche de liaison » entre Azumuta et le système ERP.

Ci-dessous une représentation schématique de la création de commandes produit à partir des informations du système ERP.

Utilisation des déclencheurs pour récupérer des données depuis Azumuta

Il existe deux options pour extraire des données d'Azumuta. D'une part, il est possible d'exécuter automatiquement des déclencheurs. Un déclencheur est un événement qui se produit en conséquence d'un autre événement. Par exemple, un webhook sera appelé après qu'un opérateur ait complété une commande produit. Nous privilégions cette méthode car seules les données nécessaires sont échangées au moment voulu.

D'autre part, il est possible de récupérer périodiquement les données via notre API REST. Cette méthode est fortement déconseillée car elle génère une charge inutile supplémentaire sur nos systèmes.

Nous vous présentons la première option, qui est la méthode recommandée. Les déclencheurs peuvent être configurés pour une catégorie d'article afin d'être exécutés lorsqu'un événement spécifique se produit.

Dans l'exemple ci‑dessous, un webhook est appelé lorsqu'une commande produit liée à une catégorie d'article spécifique est complétée.

Pour que le webhook fonctionne, les serveurs d'Azumuta doivent pouvoir accéder à l'endpoint configuré. Le numéro de commande produit et, le cas échéant, l'instruction de travail et les IDs d'enregistrement sont inclus en tant que paramètres de requête (pour une requête GET) ou en JSON (pour une requête POST) dans le webhook. Chaque appel de webhook inclut également un apiKey provenant d'un workspace Api Device — vous devez avoir au moins un Api Device configuré pour que les webhooks fonctionnent.

Pour une configuration pas à pas (endpoint, GET/POST et payload POST personnalisé optionnel), voir Appeler un webhook depuis un déclencheur. Pour la configuration d'un Api Device / d'une clé API, voir Créer et gérer des clés API.

Remarque : Un webhook est un moyen pour un système d'informer un autre système d'événements ou de mises à jour en temps réel. C'est une méthode de communication entre deux applications, où l'une envoie des données à un endpoint URL spécifique lorsqu'un événement particulier se produit. Les webhooks sont couramment utilisés pour intégrer différents systèmes et automatiser des processus.

Pour utiliser des déclencheurs afin de transmettre des données au système ERP, une couche d'intégration doit d'abord être mise en place. La couche d'intégration est configurée comme endpoint désigné pour le déclencheur webhook. Ce composant middleware est capable d'interpréter les événements déclenchés par Azumuta. Si nécessaire, la couche d'intégration récupère des données supplémentaires via l'API REST afin de garantir que les informations nécessaires existent pour la transmission au système ERP.