Intégration ERP

Remarque : Il s'agit d'un article hautement 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 serons ravis 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 de commandes produit dans Azumuta – basée sur les données de commande produit 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 toute autre donnée importante) – sans saisie manuelle.

L'intégration entre Azumuta et un système ERP utilise généralement REST API et implique plusieurs étapes. Gardez à l'esprit que les détails peuvent varier selon vos besoins et le système ERP utilisé.

Voici un aperçu général du processus :

1. Comprendre les besoins : Identifiez les données et processus spécifiques à intégrer entre Azumuta et le système ERP. Un exemple basique 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 aux REST API d'Azumuta et du système ERP. L'authentification avec Azumuta se fait via des clés API.
3. Consulter la documentation API : Obtenez et révisez la documentation API pour Azumuta et pour le système ERP. Cette documentation détaille les endpoints disponibles, les formats de requête/réponse et les exigences d'authentification.
4. Se mettre d'accord sur le mapping des données : Faites correspondre les champs et structures de données entre Azumuta et le système ERP. Assurez-vous d'une compréhension commune de la façon dont les données seront représentées et échangées. Pour l'exemple basique de création de commandes produit, cela se résume aux questions suivantes : comment le numéro de commande produit est-il déterminé ? À partir de quels articles les commandes produit sont-elles créées ? Quels paramètres ou variantes sont transmis avec la commande produit nouvellement créée ?
5. Développement : Développez la couche middleware ou les connecteurs pour faciliter la communication entre Azumuta et le système ERP. En général, on appelle cela la couche d'intégration, qui agit comme une « couche de colle » 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.

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

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

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

Nous vous montrerons la première option, car c'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 garantir le bon fonctionnement du webhook, les serveurs d'Azumuta doivent avoir accès au endpoint configuré. Le numéro de commande produit et, le cas échéant, l'instruction de travail et les ID d'enregistrement sont inclus en tant que paramètres de requête (pour une requête GET) ou en JSON (en cas de 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 la configuration pas à pas (endpoint, GET/POST, et payload POST personnalisé optionnel), voir Appeler un webhook depuis un déclencheur. Pour la configuration d'Api Device / clés API, voir Comment créer et gérer les clés API.

Remarque : Un webhook est un moyen pour un système d'en informer un autre en temps réel d'événements ou de mises à jour. C'est une méthode de communication entre deux applications, où une application 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 employer des déclencheurs en vue 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 les REST API afin de s'assurer que les informations appropriées existent pour la transmission au système ERP.