Votre propre connexion via l'API

Si votre boutique ou votre système ne figure pas dans la liste des plateformes, vous le connectez vous-même via l'API Stockhub. Pour cela, vous choisissez API pour un nouveau canal de vente. Stockhub crée alors un token avec lequel votre propre système envoie des commandes à Stockhub et consulte par exemple le stock et les expéditions.

Avec un canal API, Stockhub ne récupère rien lui-même et n'envoie rien à votre système. C'est votre propre système, ou le développeur qui le construit, qui appelle l'API.

Canal API ou connexion OpenAPI

Un canal API est la même chose qu'une connexion sur la page OpenAPI (Intégrations > OpenAPI). Vous pouvez le créer à deux endroits :

• via Intégrations > Canaux de vente, comme décrit ci-dessous. Vous renseignez alors aussi un Nom de l'expéditeur.
• avec le bouton Nouvelle connexion OpenAPI sur la page OpenAPI. Cela est expliqué dans Koppelen met de Stockhub API.

Quelle que soit la façon dont vous le créez, le canal apparaît ensuite sur la page OpenAPI, et non dans l'aperçu des canaux de vente.

Créer la connexion dans Stockhub

1. Dans le menu, allez dans Intégrations > Canaux de vente.

2. Cliquez sur Nouveau canal de vente. La fenêtre Ajouter un canal de vente s'ouvre.

3. Choisissez API.

4. Renseignez les champs :

   • Description : un nom reconnaissable pour la connexion. Sur la page OpenAPI, vous le retrouvez sous Nom.
   • Nom de l'expéditeur : le nom qui figure sur l'étiquette d'expédition.

   Pour API, vous ne saisissez pas d'identifiants. Tester la connexion n'est pas nécessaire : il n'y a encore rien à tester.

   

5. Cliquez sur Suivant.

6. Vous voyez les paramètres sous Traitement automatique des données. Pour un canal API, Stockhub n'utilise pas ces paramètres, car c'est votre propre système qui envoie et consulte les données. Vous pouvez les laisser tels quels.

7. Cliquez sur Enregistrer.

Après la création

Un canal API est actif tout de suite. L'entreprise de fulfilment n'a pas besoin de l'activer d'abord. Si vous voyez quand même le message Activation du canal de vente en attente après l'enregistrement, vous pouvez l'ignorer pour un canal API.

Vous trouvez le token de la connexion sur la page OpenAPI : dans le menu, allez dans Intégrations > OpenAPI. C'est là aussi que vous modifiez le nom ou supprimez la connexion. Le fonctionnement et l'endroit où trouver la documentation technique de l'API sont expliqués dans Koppelen met de Stockhub API.

Les commandes que votre système crée via l'API arrivent sur ce canal. Vous les voyez dans Stockhub avec vos autres commandes.

Ne partagez le token qu'avec la personne qui construit votre connexion. Avec le token, quelqu'un peut créer des commandes en votre nom.