Le canal Manuel/API

Quand utiliser un canal Manuel/API

Un canal Manuel/API n'est lié à aucune boutique. Rien n'est importé vers un site et aucune commande n'arrive d'elle-même. Utilisez-le quand :

• Vous vendez sur votre propre site, sur une marketplace à laquelle nous ne nous connectons pas, sur les réseaux sociaux ou par téléphone, et voulez nous envoyer chaque commande vous-même.
• Vous avez votre propre système ou développeur et voulez nous envoyer des commandes via notre API.

Si votre boutique est sur une plateforme affichée sur la page Add Sales Channel, comme Shopify, WooCommerce, eBay ou TikTok Shop, connectez plutôt cette plateforme. Les produits sont alors importés pour vous et les commandes arrivent d'elles-mêmes.

Vous pouvez avoir plusieurs canaux Manuel/API, par exemple un par site.

Créer le canal

1. Ouvrez Chaînes dans le menu. Vous voyez la liste de vos Sales Channels.
2. Appuyez sur Ajouter un canal de vente. La page affiche Select channel you want to create.
3. Sur la carte Manual/API, appuyez sur Create.
4. Une fenêtre Create platform manual s'ouvre. Tapez un nom pour le canal, par exemple le nom de votre site. Le nom peut compter jusqu'à 28 caractères.
5. Appuyez sur Create.

Vous voyez le message Your Manual store has been created. et la page du canal s'ouvre.

Chacun de vos canaux a besoin de son propre nom. Si le nom est déjà utilisé par un autre de vos canaux, la fenêtre affiche une erreur. Choisissez un nom différent.

La page de votre canal

La page du canal a le nom de votre canal comme titre et le titre Manual/API order management. Elle affiche trois encadrés, chacun avec un lien View all :

• Orders : les commandes que vous avez passées dans ce canal.
• Clients : les personnes à qui vous envoyez des commandes.
• Products : les produits dans votre liste My Products.

Dans le menu, sous le nom du canal, vous trouvez :

• Baskets : les commandes que vous avez commencées et pas encore payées.
• My Products : les produits que vous vendez dans ce canal. Voir Gérer les produits sur le canal Manuel/API.
• Clients : vos acheteurs. Voir Gérer les clients.
• Orders : vos commandes passées. Voir Passer des commandes manuellement.
• API : jetons et documentation pour connecter votre propre système.

La façon habituelle de procéder :

1. Ajoutez les produits que vous vendez à My Products avec Add products. C'est nécessaire pour l'API. Pour les commandes que vous saisissez vous-même, c'est facultatif : le panier vous permet de choisir n'importe quel produit que nous vendons.
2. Quand vous recevez une commande, ouvrez Clients, trouvez votre acheteur ou ajoutez-le.
3. Sur la page du client, appuyez sur Create Order, ajoutez les produits et les quantités, et payez.

Changer le nom ou fermer le canal

Pour renommer le canal, appuyez sur Edit sur la page du canal et changez Store name.

Pour fermer un canal, allez dans Chaînes et appuyez sur le bouton de fermeture dans la colonne Action (infobulle Close channel). La fenêtre demande Are you sure you want to close this channel? et avertit This operation is irreversible. Un canal fermé quitte le menu. Vos commandes et factures passées sont conservées.

Connecter votre propre système avec l'API

L'API permet à votre site ou application de faire d'elle-même ce que vous faites sur les pages du canal : lire notre catalogue de produits avec les prix en direct, ajouter des produits à My Products, créer et changer des clients, créer des commandes, y ajouter des produits, les soumettre et les suivre. Vous pouvez aussi télécharger votre liste My Products en CSV ou en flux JSON pour charger des produits dans votre propre site.

Ouvrez API sous votre canal. La page comporte ces onglets :

• Overview : comment se connecter, l'adresse de base de l'API et le bouton API documentation. La documentation liste chaque point de terminaison avec des exemples.
• API tokens : les jetons de ce canal.
• API calls : les requêtes faites par votre système.
• History : les changements effectués sur votre compte.

Obtenir un jeton

1. Appuyez sur Generate API token.
2. Si le jeton ne sert qu'à lire des données, cochez Read only (cannot create, change or submit orders).
3. Appuyez sur Click to Generate.
4. Copiez le jeton avec l'icône de copie et gardez-le en lieu sûr. La fenêtre indique Put this token in a safe place, you won't be able to see it again. Le libellé court dans la liste des jetons n'est qu'un nom, pas le jeton.

Envoyez le jeton avec chaque requête dans l'en-tête Authorization: Bearer suivi de votre jeton. Chaque jeton appartient à un seul canal : les produits, clients et commandes que votre système crée vont vers ce canal. Pour empêcher un jeton de fonctionner, supprimez-le dans l'onglet API tokens.

Tester d'abord en staging

L'onglet Overview comporte aussi Open staging mirror. Le staging est une copie distincte du site où vous pouvez tester sans vraies commandes ni paiements. Connectez-vous avec le même e-mail et mot de passe. Le staging est réinitialisé régulièrement avec une copie fraîche, ce qui efface ce que vous y avez créé. Les jetons du site réel ne fonctionnent pas en staging : générez un jeton séparé sur le staging, et un nouveau après chaque réinitialisation. L'adresse de base du staging est indiquée dans l'onglet Overview.

Comment les commandes API sont payées

Quand votre système soumet une commande, nous la payons d'abord depuis le solde de votre compte, puis depuis vos cartes enregistrées. Ajoutez une carte avant de commencer. Une fois que vous avez un jeton, le menu affiche Saved Cards. Tant qu'aucune carte n'est enregistrée, la page API affiche You have no cards saved yet. avec un bouton Add card.

Si ni votre solde ni vos cartes ne couvrent la commande, elle est marquée Unpaid et ne part pas vers l'entrepôt. Ajoutez de l'argent à votre solde avec Top Up, ouvrez la commande et appuyez sur Pay … with balance. Le bouton s'affiche quand votre solde couvre le montant dû.

En cas de problème

• Le nom est déjà pris quand je crée le canal. Un autre de vos canaux ouverts porte ce nom. Tapez un nom différent. Le nom d'un canal fermé peut être réutilisé.
• Mes commandes n'arrivent pas d'elles-mêmes. Un canal Manuel/API ne récupère jamais de commandes depuis un site. Créez-les sur la page du client, ou envoyez-les depuis votre système via l'API. Si vous vendez sur une plateforme affichée sur la page Add Sales Channel, connectez cette plateforme comme son propre canal.
• Mes produits ne sont pas sur mon site. Nous n'importons rien depuis un canal Manuel/API. Chargez-les vous-même dans votre site, avec le téléchargement CSV sur My Products ou via l'API.
• J'ai perdu mon jeton API. Il ne peut pas être réaffiché. Générez un nouveau jeton, mettez-le dans votre système et supprimez l'ancien.
• L'API répond que je ne peux pas créer ou changer de commandes. Le jeton est en lecture seule. Générez un jeton sans Read only coché.
• L'API refuse mes requêtes pendant un moment. Chaque jeton peut faire jusqu'à 120 requêtes par minute. Ralentissez votre système et réessayez après une minute.
• L'API indique « This order has no products yet ». Ajoutez au moins un produit à la commande avant de la soumettre.
• L'API indique « Unable to find related portfolio item ». Via l'API, vous ajoutez un produit à une commande par son élément My Products, pas par le produit lui-même. Ajoutez d'abord le produit à My Products et utilisez l'identifiant de cet élément.
• L'API indique qu'une autre transaction avec le même produit existe déjà. Le produit est déjà sur la commande. Changez la quantité de cette ligne plutôt que de l'ajouter à nouveau.
• L'API indique que la commande « is already in the 'submitted' state and cannot be updated ». Les commandes soumises ne peuvent pas être changées ou supprimées via l'API. Demandez-nous dans le chat de notre site si la commande doit changer.
• Ma commande API affiche Unpaid. Votre solde et vos cartes enregistrées ne l'ont pas couverte. Rechargez votre solde, ouvrez la commande et appuyez sur Pay … with balance, et vérifiez que votre carte enregistrée est toujours valide.