Connecter Epicor Kinetic : recevoir commandes et clients, consulter le stock

Créez un compte de service et une API Key dans Epicor Kinetic, saisissez l’URL de base du serveur, le Company ID, le nom d’utilisateur, le mot de passe et l’API Key dans Integration, testez, mappez, activez.

Le connecteur Epicor Kinetic importe les commandes de vente et les clients de votre ERP Epicor Kinetic dans ce système et peut consulter les quantités de stock détenues dans Epicor. Il lit les données d’Epicor : il ne renvoie pas les changements de stock vers Epicor. Chaque demande utilise deux identifiants ensemble — le compte de service pour la connexion Basic et l’API Key — donc les deux sont toujours requis. Une connexion par instance Epicor et par société.

Prérequis#

• Une instance Epicor Kinetic à laquelle vous pouvez vous connecter, et son adresse de base serveur — pour le cloud, une forme comme https://mycompany.epicorsaas.com/MyInstance ; pour une installation sur site, https://<serveur>/<nom d’instance>.
• Votre Company ID, par ex. EPIC06. C’est le segment société dans l’adresse OData v2, il doit donc correspondre exactement à la société dont vous voulez importer les données.
• Un compte de service Epicor dédié, créé dans User Account Security Maintenance, avec accès à cette société. Son nom d’utilisateur et son mot de passe forment la moitié des identifiants.
• Droit de créer une clé dans API Key Maintenance et de lui donner un Access Scope couvrant Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc et Erp.BO.PartSvc.

Obtenir les identifiants#

1. Créez ou confirmez le compte de service dédié dans User Account Security Maintenance, et assurez-vous qu’il a accès à la société dont vous importerez les données. Notez son nom d’utilisateur et gardez son mot de passe prêt.
2. Ouvrez Epicor Kinetic → API Key Maintenance → New Key et créez une nouvelle API Key.
3. Donnez à la clé un Access Scope couvrant les trois services : Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc et Erp.BO.PartSvc. Une clé dont la portée omet un service ne peut pas lire ce type de données.
4. Copiez l’API Key au moment où elle s’affiche — elle ne s’affiche qu’une seule fois. Si vous la perdez, créez une nouvelle clé plutôt que de chercher l’ancienne.
5. Notez en même temps les deux autres valeurs : l’adresse de base du serveur, sans aucun suffixe /api, et le Company ID, par ex. EPIC06.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Epicor Kinetic → Nouvelle connexion.
2. base_url, obligatoire, URL de base du serveur Epicor : l’adresse de votre instance, par ex. https://mycompany.epicorsaas.com/MyInstance. N’ajoutez pas de suffixe /api — le système construit le reste de l’adresse.
3. company, obligatoire, Company ID : le segment société, par ex. EPIC06. Ce doit être la société à laquelle le compte de service peut accéder.
4. username, obligatoire, nom d’utilisateur du compte de service : le nom d’utilisateur du compte de service dédié créé dans User Account Security Maintenance.
5. password, obligatoire, mot de passe du compte de service : le mot de passe de ce même compte de service. C’est un champ de type mot de passe, conservé comme secret.
6. api_key, obligatoire, clé API REST : collez l’API Key copiée depuis API Key Maintenance → New Key, avec son Access Scope couvrant Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc et Erp.BO.PartSvc. C’est un champ de type mot de passe, conservé comme secret.

Tester la connexion#

Cliquez sur Tester la connexion. Le test vérifie d’abord que les cinq champs sont remplis — si base_url manque, il s’arrête avec MISSING_BASE_URL, et tout autre champ manquant arrête aussi le test avant tout envoi. Il fait ensuite une vraie demande en lecture seule avec les deux identifiants ensemble : il demande une seule commande de vente au service SalesOrder, en envoyant le compte de service en connexion Basic et l’API Key sur la même demande. Une réponse 200 compte comme un succès. L’erreur vous dit quel identifiant regarder : 401 signifie que le nom d’utilisateur ou le mot de passe du compte de service a été refusé, tandis que 400 ou 403 signifie que l’API Key elle-même a été refusée ou que son Access Scope ne couvre pas le service. Le test abandonne après environ 12 secondes si l’instance ne répond pas.

Mapping / choisir un modèle#

Choisissez le mapping standard Epicor Kinetic. Il travaille avec les trois services couverts par la portée de l’API Key : les commandes de vente viennent de Erp.BO.SalesOrderSvc, les clients de Erp.BO.CustomerSvc et les consultations de stock lisent Erp.BO.PartSvc. Après un test réussi, lancez une extraction et comparez une commande réelle côte à côte (numéro de commande, client, lignes et quantités), puis comparez la quantité d’une pièce avec ce qu’affiche Epicor, avant d’activer. Si un champ de votre instance diffère, ajustez ce champ dans le mapping plutôt que de renommer quoi que ce soit dans Epicor.

Activer#

Après activation, la connexion importe les commandes de vente et les clients d’Epicor Kinetic dans ce système selon la fréquence définie, et les consultations de stock lisent les quantités actuelles dans Epicor. Surveillez les premières extractions dans Runs / Logs et comparez-les avec Epicor avant de laisser la connexion sans surveillance.

Ce que cette connexion ne fait pas : elle ne renvoie pas les changements de stock vers Epicor Kinetic. Les quantités dans Epicor restent sous le contrôle d’Epicor — cette connexion ne fait que les lire. Continuez à gérer le stock dans Epicor même.

FAQ#

Le test échoue avec 401

Epicor a refusé la connexion Basic : le nom d’utilisateur ou le mot de passe du compte de service ne correspond pas, ou ce compte ne peut pas accéder à la société du champ company. Cette erreur concerne le compte de service — pas l’API Key.

Vérifiez username et password par rapport au compte dans User Account Security Maintenance, confirmez que ce compte a accès à la société saisie, puis retestez. Ne changez pas l’API Key pour un 401.

Le test échoue avec 400 ou 403

L’API Key elle-même a été refusée, ou son Access Scope ne couvre pas le service appelé par le test. Le compte de service peut être parfaitement correct — cette erreur concerne la clé et sa portée, la seconde moitié des identifiants.

Dans API Key Maintenance, vérifiez la clé collée et son Access Scope : il doit couvrir Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc et Erp.BO.PartSvc. Si la clé a été copiée incomplètement ou si la portée est insuffisante, corrigez la portée ou créez une nouvelle clé, collez-la en entier dans api_key, puis retestez.

Le test s’arrête avec MISSING_BASE_URL ou un autre message de champ manquant

L’un des cinq champs obligatoires est vide, le test s’est donc arrêté avant tout envoi. Les cinq — base_url, company, username, password et api_key — sont obligatoires, car chaque demande a besoin des deux identifiants et de l’adresse de la société.

Remplissez les cinq champs selon l’étape de saisie dans Integration, enregistrez, puis retestez. Pour base_url, utilisez l’adresse complète de l’instance, sans rien manquer au début.

Toutes les valeurs semblent correctes, mais le test échoue toujours

Une cause fréquente est l’adresse : si base_url se termine par un suffixe /api, le système ajoute ses propres segments d’adresse après, et la demande part vers une mauvaise adresse. La valeur company cause le même type d’échec — elle fait partie de l’adresse, donc un Company ID incorrect pointe le test vers une société qui ne répond pas pour ces identifiants.

Retirez tout suffixe /api de base_url pour qu’elle soit exactement l’adresse de l’instance, par ex. https://mycompany.epicorsaas.com/MyInstance, et revérifiez company par rapport au Company ID de la société à laquelle le compte de service peut accéder. Enregistrez et retestez avant de changer un identifiant.

Les commandes arrivent, mais les clients ou le stock non

La connexion elle-même fonctionne — le test a réussi sur le service SalesOrder. Le type de données manquant pointe vers la portée de l’API Key : chaque service a besoin de sa propre couverture, et une portée qui couvre SalesOrderSvc mais omet CustomerSvc ou PartSvc lit les commandes pendant que les deux autres restent vides.

Dans API Key Maintenance, étendez l’Access Scope de la clé pour couvrir les trois : Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc et Erp.BO.PartSvc. Si la portée ne peut pas être modifiée sur la clé existante, créez une nouvelle clé avec la portée complète, collez-la dans api_key, retestez, puis lancez une extraction.

Connecté, mais aucune commande de vente n’est importée

La connexion fonctionne — le test a réellement lu le service SalesOrder — mais il n’y a rien de nouveau à importer : la société dans Epicor n’a pas de nouvelles commandes de vente dans la plage d’extraction, ou les commandes présentes appartiennent à une autre société que celle du champ company.

Créez ou confirmez une commande de vente dans Epicor sous le même Company ID que celui de la connexion, lancez une extraction manuelle et confirmez que la commande apparaît dans l’aperçu ou dans Runs / Logs.