Intégration ERP

Note : Ceci est une page guide 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 heureux de vous assister.

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

Il est possible d'intégrer Azumuta avec un système ERP externe. Le plus souvent, cette intégration est utilisée pour la création automatique de commandes produit dans Azumuta — sur la base des 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 toutes autres données importantes) — sans saisie manuelle.

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

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

1. Comprendre les exigences : Identifiez les données et processus spécifiques qui doivent être intégrés 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 à la REST API d'Azumuta et du système ERP. L'authentification avec Azumuta se fait via des clés API.
3. Vérifier la documentation de l'API : Obtenez et examinez la documentation API d'Azumuta et du système ERP. Cette documentation fournira des détails sur les endpoints disponibles, les formats requête/réponse et les exigences d'authentification.
4. S'accorder sur le mapping des données : Mappez les champs et 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 basique de création de commandes produit, cela revient aux questions suivantes : comment le numéro de commande produit est-il déterminé ? Sur la base de quels articles les commandes produit sont-elles créées ? Quels paramètres ou variantes sont envoyés avec la commande produit nouvellement créée ?
5. Développement : Développez le 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 en fonction des informations provenant 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 d'Azumuta. D'une part, il est possible d'exécuter automatiquement des déclencheurs. Un déclencheur est un événement qui survient en conséquence 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 préférons cette méthode car seules les données nécessaires sont échangées au moment souhaité.

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 crée une charge inutile plus importante sur nos systèmes.

Nous vous présentons la première option, car c'est la méthode recommandée. Des 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'ID de l'instruction de travail et l'ID d'enregistrement sont inclus en tant que paramètres de requête (pour une requête GET) ou en tant que JSON (dans le cas d'une requête POST) dans le webhook.

Note : 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ù une application envoie des données à une 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.

Le système source envoie généralement une requête HTTP POST à une URL spécifiée par le système destinataire. Cette URL est souvent appelée « point de terminaison du webhook ». La requête POST inclut des données liées à l'événement sous la forme d'une payload. Cette payload contient des informations sur l'événement survenu, et est généralement au format JSON.

Pour utiliser des déclencheurs afin de transmettre des données vers le système ERP, une couche d'intégration doit être mise en place en premier. 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 la REST API afin de s'assurer que les informations appropriées existent pour la transmission vers le système ERP.