Connecter Acumatica : recevoir commandes et clients, consulter le stock

Connectez-vous à votre instance Acumatica avec un utilisateur API dédié, saisissez l’URL de l’instance, la société et la version de l’endpoint dans Integration, testez, mappez, activez.

Le connecteur Acumatica relie votre instance Acumatica Cloud ERP à Integration : il importe les commandes de vente et les clients dans le système et permet de consulter le stock détenu dans Acumatica. Une connexion sert une société Acumatica. Le stock peut être lu depuis Acumatica, mais les changements de stock ne sont pas renvoyés vers Acumatica par cette connexion.

Prérequis#

• Une instance Acumatica à laquelle vous pouvez vous connecter, et le nom exact de la société (tenant) utilisé à la connexion.
• Un utilisateur de connexion pour cette connexion — un utilisateur API dédié est recommandé — pouvant lire les commandes de vente, les clients et les articles de stock dans cette société.
• Un endpoint publié dans Acumatica → Web Service Endpoints. Si votre instance publie l’endpoint standard, son nom est généralement Default et sa version correspond à votre version d’Acumatica.
• Si la connexion de votre société exige une succursale, connaissez aussi son nom. Si la connexion ne demande pas de succursale, ce champ peut rester vide ensuite.

Obtenir les identifiants#

1. Il n’y a pas de clé séparée à créer pour ce connecteur. Les identifiants sont l’utilisateur de connexion Acumatica lui-même : préparez un utilisateur API dédié dans Acumatica, vérifiez que vous pouvez vous connecter avec, et notez son nom d’utilisateur et son mot de passe.
2. Notez le nom de la société (tenant) exactement comme il apparaît à la connexion, et le nom de la succursale si votre connexion en exige une. Ces valeurs doivent correspondre mot pour mot à l’instance.
3. Notez l’adresse de votre instance — l’adresse racine de votre instance Acumatica, par exemple https://mycompany.acumatica.com. N’ajoutez pas /entity à la fin.
4. Dans Acumatica, ouvrez Web Service Endpoints et vérifiez l’endpoint publié : notez son nom d’endpoint et sa version d’endpoint. Vous n’aurez à les saisir ensuite que s’ils diffèrent de Default et 24.200.001.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Acumatica → Nouvelle connexion.
2. base_url — Instance URL, obligatoire : saisissez l’adresse racine de votre instance Acumatica, par exemple https://mycompany.acumatica.com. N’ajoutez pas /entity à la fin.
3. company — Company, obligatoire : saisissez le nom de la société (tenant) exactement comme il apparaît lorsque vous vous connectez à Acumatica.
4. branch — Branch, facultatif : ne le remplissez que si la connexion de votre société exige une succursale. Si la connexion n’en demande pas, laissez-le vide.
5. username — Username, obligatoire : saisissez le nom de connexion de l’utilisateur API dédié que vous avez préparé dans Acumatica.
6. password — Password, obligatoire : saisissez le mot de passe de ce même utilisateur de connexion. Il est stocké chiffré et jamais réaffiché.
7. endpoint_name — Endpoint name, facultatif : laissez-le vide si votre instance publie l’endpoint standard — le système utilisera Default. Ne le remplissez que si Web Service Endpoints affiche un autre nom.
8. endpoint_version — Endpoint version, facultatif : laissez-le vide si votre instance publie la version 24.200.001 — le système utilisera 24.200.001. Saisissez la version exacte affichée dans Web Service Endpoints si la vôtre diffère ; la version doit correspondre à votre version d’Acumatica.

Tester la connexion#

Cliquez sur Tester la connexion. Le test fait deux choses dans l’ordre. D’abord, il se connecte à votre instance avec le nom d’utilisateur, le mot de passe, la société et la succursale saisis — la connexion ne réussit que si l’instance répond et renvoie une session, que le test utilise aussitôt puis ferme à la fin. Ensuite, avec cette session, il lit un seul article de stock via le nom et la version d’endpoint de la connexion. Un succès signifie que la connexion fonctionne, que l’endpoint répond et que l’utilisateur de connexion peut lire les articles de stock. Le test attend environ 12 secondes ; en cas de dépassement, vérifiez que l’adresse de l’instance est joignable et réessayez. En cas d’échec, gardez le code d’erreur exact affiché — la FAQ ci-dessous associe chaque code à sa cause et à sa solution.

Mapping / choisir un modèle#

Choisissez le modèle standard Acumatica. Il mappe les commandes de vente Acumatica vers les commandes standard et importe les clients avec elles, pour que numéros de commande, lignes, quantités et coordonnées client arrivent dans les bons champs. Les champs que le modèle peut lire viennent de l’endpoint publié sur votre instance : si votre instance publie un nom ou une version d’endpoint différent du standard, définissez d’abord endpoint_name et endpoint_version sur la connexion et revérifiez l’aperçu du mapping. Avant d’activer, ouvrez l’aperçu et confirmez sur une commande réelle que les lignes et les noms de clients sont corrects ; la consultation du stock lit directement les articles de stock et ne demande aucun mapping de commande.

Activer#

Après activation, Integration se connecte à votre instance Acumatica selon la fréquence définie, importe les nouvelles commandes de vente et les clients, et répond aux questions de stock en lisant les articles de stock dans Acumatica. Chaque session de connexion ne sert qu’à cette exécution et se ferme à sa fin. Ce que cette connexion ne fait pas : elle ne renvoie pas les changements de stock vers Acumatica ; ajustez donc les quantités dans Acumatica même quand le stock doit y être corrigé. Surveillez les premières commandes dans Runs / Logs avant de la laisser sans surveillance.

FAQ#

Le test échoue avec ENDPOINT_VERSION_MISMATCH — la lecture de l’article de stock renvoie 404

La connexion a fonctionné, mais le nom ou la version d’endpoint de la connexion ne correspond pas à l’endpoint publié sur votre instance. Le test cherche l’article de stock sous le nom et la version indiqués, et l’instance n’a rien publié à cette adresse, donc la lecture revient en 404. C’est la cause la plus fréquente quand la connexion elle-même est bonne.

Dans Acumatica, ouvrez Web Service Endpoints et copiez exactement le nom et la version de l’endpoint publié. Mettez-les dans endpoint_name et endpoint_version sur la connexion — ou videz les deux champs si l’endpoint publié est bien Default et 24.200.001. Enregistrez puis testez à nouveau.

Le test échoue avec INVALID_CREDENTIALS — la connexion renvoie 401 ou 400

L’instance a refusé la connexion : le nom d’utilisateur, le mot de passe ou le nom de la société ne correspond pas à ce que l’instance attend. Un nom de société saisi légèrement différemment de l’écran de connexion compte comme un identifiant incorrect, tout comme une succursale exigée par la connexion mais absente de la connexion Integration.

Connectez-vous à Acumatica dans votre navigateur avec le même utilisateur et vérifiez que le nom d’utilisateur, le mot de passe et le nom de la société y fonctionnent. Puis saisissez à nouveau username, password et company sur la connexion exactement comme dans le navigateur, ajoutez branch si cette connexion en demande une, et testez à nouveau.

Le test échoue avec MISSING_SCOPE — la lecture de l’article de stock renvoie 401 ou 403

La connexion a fonctionné et l’endpoint existe, mais l’utilisateur de connexion n’a pas le droit de lire les articles de stock dans cette société. L’instance refuse donc la lecture de l’article de stock même si l’utilisateur peut se connecter.

Dans Acumatica, donnez à l’utilisateur API dédié un accès en lecture aux articles de stock — ainsi qu’aux commandes de vente et aux clients, que la connexion lit aussi — dans cette société, ou basculez la connexion vers un utilisateur qui a déjà cet accès. Enregistrez puis testez à nouveau.

Le test échoue avec MISSING_BASE_URL ou MISSING_CREDENTIALS, ou la connexion n’atteint pas l’instance

Un champ obligatoire est vide, ou l’adresse de l’instance elle-même est incorrecte. MISSING_BASE_URL signifie que base_url est resté vide ; MISSING_CREDENTIALS signifie qu’il manque username, company ou password. Une erreur d’adresse fréquente est de terminer base_url par /entity — la connexion ajoute ses propres chemins après l’adresse racine, donc une adresse portant déjà ce suffixe envoie la connexion au mauvais endroit.

Remplissez tous les champs obligatoires — base_url, company, username et password — et vérifiez base_url : utilisez uniquement l’adresse racine de l’instance, par exemple https://mycompany.acumatica.com, sans rien après. Enregistrez puis testez à nouveau.