Connecter Cin7 : recevoir commandes et clients, consulter le stock
Dans Cin7 Omni, sur go.cin7.com, ouvrez une API connection et notez son nom d’utilisateur et son mot de passe, saisissez uniquement ces deux champs dans Integration, testez, mappez, activez : les commandes de vente et les clients arrivent et le stock peut être consulté.
Le connecteur Cin7 importe les commandes de vente et les clients de Cin7 Omni dans ce système et peut consulter les quantités de stock détenues dans Cin7, y compris les quantités disponibles et en main. Il lit les données de Cin7 : il ne renvoie pas les changements de stock vers Cin7 et n’écrit pas les commandes ni les clients vers Cin7. Il n’y a aucun champ d’adresse à saisir : le connecteur utilise toujours l’adresse officielle de l’API Cin7. Une connexion utilise une API connection de Cin7.
Prérequis#
- Un compte Cin7 Omni auquel vous pouvez vous connecter sur go.cin7.com.
- Droit dans Cin7 d’ouvrir ou de créer une API connection. Le nom d’utilisateur et le mot de passe de cette intégration proviennent de cette API connection.
- Le point clé avant de commencer : le nom d’utilisateur et le mot de passe de l’API ne sont pas votre compte de connexion Cin7. Saisir l’e-mail et le mot de passe de connexion à Cin7 ne permettra pas la connexion.
- Tenez compte des limites de l’API Cin7 en planifiant la fréquence d’extraction : 3 requêtes par seconde, 60 par minute et 5 000 par jour.
Obtenir les identifiants#
- Connectez-vous à Cin7 Omni sur go.cin7.com.
- Ouvrez la zone API connection et ouvrez l’API connection à utiliser pour cette intégration, ou créez-en une nouvelle.
- Notez le nom d’utilisateur de cette API connection. Ce nom est généré pour l’API connection et sert à l’authentification Basic : ce n’est pas votre nom de connexion Cin7.
- Notez le mot de passe d’API défini sur cette même API connection. Le nom d’utilisateur et le mot de passe doivent venir de la même API connection : ne mélangez pas les valeurs de deux connexions différentes.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Cin7 → Nouvelle connexion.
- username, obligatoire, nom d’utilisateur de l’API Cin7 : saisissez le nom d’utilisateur de l’API connection de Cin7. Le texte d’aide du champ indique API username.
- password, obligatoire, mot de passe de l’API Cin7 : saisissez le mot de passe d’API défini sur cette même API connection. C’est un champ de type mot de passe, conservé comme secret.
- Il n’y a rien d’autre à saisir. Cette connexion n’a pas de champ d’adresse : elle se connecte toujours à l’adresse officielle https://api.cin7.com/api, ne cherchez donc pas où la changer.
Tester la connexion#
Cliquez sur Tester la connexion. Si username ou password manque, le test s’arrête et signale le champ manquant avant d’envoyer la moindre requête, car l’authentification Basic exige les deux valeurs. Sinon, le test envoie une requête avec authentification Basic pour lire la liste des succursales, GET https://api.cin7.com/api/v1/Branches — la lecture la plus légère de Cin7. Une réponse 200 signifie que la connexion fonctionne. Une réponse 401 signifie que les identifiants sont invalides. Une réponse 403 signifie que les identifiants ont été acceptés, mais que cette API connection n’a pas la permission pour cette ressource : 401 et 403 renvoient à des corrections différentes, lisez donc le code avant de changer quoi que ce soit. Le test expire après 12 secondes.
Mapping / choisir un modèle#
Choisissez le mapping standard Cin7. Les commandes de vente sont lues depuis les données de commandes de vente de Cin7, les clients depuis les données de contacts de Cin7, et les consultations de stock lisent les données de stock de Cin7. 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), vérifiez un enregistrement client, puis comparez la quantité d’un produit avec ce qu’affiche Cin7, avant d’activer. Si un champ de vos commandes diffère, ajustez ce champ dans le mapping plutôt que de modifier les enregistrements dans Cin7.
Activer#
Après activation, la connexion importe les commandes de vente et les clients de Cin7 dans ce système selon la fréquence définie, dans les limites Cin7 de 3 requêtes par seconde, 60 par minute et 5 000 par jour, et les consultations de stock lisent les quantités actuelles dans Cin7. Surveillez les premières extractions dans Runs / Logs et comparez-les avec Cin7 avant de laisser la connexion sans surveillance.
Ce que cette connexion ne fait pas : elle ne renvoie pas les changements de stock vers Cin7 et n’écrit pas les commandes, les clients ni les résultats de fulfillment vers Cin7. Continuez à gérer cela dans Cin7 même, ou dans les systèmes où le travail se fait réellement.
FAQ#
Le test échoue avec 401 — identifiants invalides
Cin7 a rejeté l’authentification Basic. Le nom d’utilisateur ou le mot de passe ne correspond à aucune API connection dans Cin7 — le plus souvent parce que l’e-mail et le mot de passe de connexion Cin7 ont été saisis à la place, ou parce que le nom d’utilisateur et le mot de passe viennent de deux API connections différentes.
Dans Cin7 Omni, sur go.cin7.com, ouvrez l’API connection, copiez son nom d’utilisateur exactement dans le champ username, définissez ou copiez le mot de passe d’API de cette même connexion dans le champ password, enregistrez, puis retestez. N’utilisez pas votre mot de passe de connexion Cin7.
Le test échoue avec 403 — cette API connection n’a pas la permission pour cette ressource
C’est différent du 401 : Cin7 a accepté les identifiants, mais l’API connection n’est pas autorisée à lire la liste des succursales utilisée par le test. Changer encore le mot de passe ne corrigera pas un 403.
Dans Cin7, vérifiez l’accès accordé à cette API connection et autorisez-la à lire les ressources dont la connexion a besoin, ou passez à une API connection qui dispose déjà de cet accès. Gardez la même paire nom d’utilisateur et mot de passe de cette connexion, enregistrez, puis retestez.
Le test s’arrête avant d’envoyer une requête et signale un champ manquant
username ou password est vide. Le test a besoin des deux valeurs pour l’authentification Basic, il s’arrête donc au lieu d’envoyer une requête que Cin7 ne peut que rejeter.
Remplissez les deux champs depuis la même API connection dans Cin7 — nom d’utilisateur de la connexion, mot de passe défini sur cette même connexion — enregistrez, puis retestez.
J’ai saisi mon compte de connexion Cin7, mais la connexion ne marche pas
Le compte de connexion et les identifiants de l’API connection sont deux choses différentes dans Cin7. Cette connexion s’authentifie uniquement avec le nom d’utilisateur et le mot de passe d’une API connection, donc un compte de connexion parfaitement valide échoue quand même ici.
Allez dans go.cin7.com → API connection dans Cin7 Omni, ouvrez ou créez une API connection, et utilisez son nom d’utilisateur et son mot de passe d’API dans Integration au lieu de vos identifiants de connexion. Puis retestez.
Connecté, mais aucune commande de vente n’est importée
La connexion fonctionne — le test a lu la liste des succursales avec succès — mais il n’y a rien de nouveau à importer : Cin7 n’a pas de nouvelles commandes de vente dans la plage d’extraction, ou les enregistrements présents ne sont pas des commandes de vente.
Créez ou confirmez une commande de vente dans Cin7, lancez une extraction manuelle et confirmez que la commande apparaît dans l’aperçu ou dans Runs / Logs. Gardez la fréquence d’extraction dans les limites indiquées ci-dessus.
La consultation de stock ne renvoie aucune quantité pour un produit
La connexion peut lire le stock dans Cin7, mais ce produit n’a aucun enregistrement de stock correspondant à lire, ou le code produit du mapping ne correspond pas au produit dans Cin7. Le test peut réussir alors qu’un produit donné n’a toujours rien à renvoyer.
Vérifiez d’abord le produit et son enregistrement de stock dans Cin7, puis vérifiez le code produit de cet article dans le mapping et corrigez-le pour qu’il corresponde à Cin7. Relancez la consultation de stock pour ce seul produit.