Cette intégration est faite pour vous si vos commandes naissent dans Holded : ventes à des boutiques ou des distributeurs, commandes par téléphone ou par e-mail que vous saisissez comme commande de vente. Dès que vous en créez une, elle nous arrive pour être préparée. Et dans Holded vous voyez à tout moment où elle en est : son statut, le transporteur, le numéro de suivi et le stock réel que vous avez dans notre entrepôt.
Si vous vendez sur une boutique en ligne (Shopify, WooCommerce…) et n'utilisez Holded que pour facturer, vous n'avez pas besoin de cette intégration : connectez simplement votre boutique.
Avant de commencer
Vous devez être administrateur du compte Holded.
Tous les plans Holded incluent l'API, chacun avec un quota d'appels par mois. Nous l'expliquons plus bas, dans « Le quota de l'API Holded ».
Un compte Holded ne peut être connecté qu'à un seul compte Furgox.
1. Créez la clé d'API dans Holded
Dans Holded, allez dans Paramètres → API.
Cliquez sur Générer une nouvelle clé et donnez-lui un nom reconnaissable, par exemple
Furgox.Cochez ces autorisations :
inventory:sales-orders.readinventory:sales-orders.writeinventory:products.readinventory:products.writeinventory:warehouses.readinventory:warehouses.writecontacts:contacts.readdevelopers:webhooks.readdevelopers:webhooks.write
Copiez la clé. Holded ne l'affiche qu'une fois : si vous fermez la fenêtre sans la copier, il faudra en générer une autre.
2. Collez-la dans Furgox
Dans votre panel, ouvrez Intégrations, cliquez sur Connecter une boutique et choisissez Holded. Collez la clé et cliquez sur Connecter Holded.
Vous verrez une case, cochée par défaut : créer l'entrepôt « Furgox » comme entrepôt par défaut. Laissez-la cochée si toute votre marchandise est chez nous : vos nouvelles commandes utiliseront cet entrepôt dans Holded sans que vous ayez à le choisir à chaque fois.
3. Ce que nous faisons à la connexion
Nous vérifions la clé et ses autorisations. S'il en manque une, nous vous disons laquelle.
Nous créons l'entrepôt « Furgox » dans votre Holded (si vous en avez déjà un avec ce nom, nous l'utilisons). C'est là que vous verrez le stock réel de notre entrepôt.
Nous activons les avis de Holded pour être prévenus immédiatement de chaque commande de vente nouvelle ou modifiée.
Nous lisons votre catalogue, avec ses variantes, ses SKU et ses codes-barres.
Ce qui se passe ensuite
Commandes
Chaque commande de vente créée dans Holded nous arrive en quelques secondes. Les commandes en attente créées à partir de la connexion sont importées ; les brouillons et les commandes plus anciennes ne le sont pas. Les lignes de services, comme les frais de port, ne sont pas préparées : seulement les produits.
L'adresse de livraison est celle de la commande. Si la commande utilise l'adresse du client, nous la prenons dans sa fiche Holded : son adresse de livraison ou, à défaut, son adresse de facturation.
Si vous préférez vérifier chaque commande avant sa préparation, activez Accepter les commandes moi-même sur la fiche Holded de votre panel.
Statut et suivi dans Holded
Dans la section suivi de la commande, dans Holded, vous suivez chaque étape : en préparation, préparée, expédiée, livrée, incident, retournée ou annulée.
Quand elle quitte l'entrepôt, nous écrivons le transporteur et le numéro de suivi et la marquons comme expédiée. À la livraison, nous notons aussi la date de livraison.
Stock
L'entrepôt « Furgox » de votre Holded reflète les unités réelles de notre entrepôt, au fil des entrées de marchandise et des sorties de commandes. Nous ne touchons que les produits déjà arrivés chez Furgox : ce que vous ne nous avez pas encore envoyé reste tel quel.
Quand une commande est marquée comme expédiée, Holded déduit le stock de l'entrepôt de la commande. Si la commande était dans un autre de vos entrepôts Holded, nous lui rendons ces unités, car elles sont en réalité sorties du nôtre.
Produits
Votre catalogue Holded fait référence : quand vous créez ou modifiez un produit, nous le voyons immédiatement. Les packs ne sont pas importés comme produit à part : ce sont leurs composants qui sont préparés. Plus d'infos dans Ce que nous faisons de votre catalogue.
Le quota de l'API Holded
Holded limite les appels à son API selon votre plan : environ 500 par mois en Starter, 2 000 en Basic, 7 500 en Standard et davantage dans les plans supérieurs. C'est pourquoi les commandes nous arrivent par des avis, qui ne consomment pas de quota, et nous n'écrivons dans Holded que lorsque quelque chose change.
Malgré tout, chaque commande consomme environ cinq appels : lire la commande et le client, écrire le statut et l'expédition. Le plan Starter couvre environ 100 commandes par mois. Au-delà, un plan supérieur est conseillé.
Si le quota du mois est épuisé, nous suspendons la synchronisation jusqu'à son renouvellement par Holded et vous prévenons dans le panel. En attendant, nous continuons à préparer les commandes déjà reçues.
Ce que nous ne faisons pas
Nous ne créons pas de factures et ne touchons pas à votre comptabilité dans Holded : votre facturation reste la même.
Nous ne modifions pas vos SKU Holded : chaque produit est lié par son identifiant interne.
Si vous annulez ou supprimez une commande dans Holded avant que nous la préparions, nous l'annulons. Si elle était déjà préparée, nous vous prévenons pour voir ensemble quoi faire.
Si quelque chose ne va pas
« Holded n'a pas accepté la clé »
Holded répond de la même façon à une clé mal copiée et à une clé à laquelle il manque une autorisation. Vérifiez que vous l'avez collée en entier et que toutes les autorisations de la liste sont cochées. En cas de doute, générez-en une nouvelle.
« Holded ne nous laisse pas recevoir les avis de nouvelles commandes »
Holded ne permet qu'à un seul outil de recevoir chaque type d'avis. Si vous en avez déjà un autre connecté, nous vérifions vos commandes toutes les 30 minutes au lieu d'immédiatement, ce qui consomme plus de quota. Si vous n'utilisez plus cet autre outil, supprimez-le dans Paramètres → Webhooks de Holded et reconnectez.
Une commande ne m'arrive pas
Vérifiez qu'il ne s'agit pas d'un brouillon et qu'elle est en attente.
Les commandes datées d'avant la connexion ne sont pas importées.
Si la commande n'a pas d'adresse, ni sur elle ni sur la fiche du client, ou si ses produits ne sont pas dans votre catalogue, nous vous prévenons dans le panel. Corrigez-la dans Holded et elle arrivera d'elle-même.
J'ai régénéré ou supprimé la clé dans Holded
L'ancienne clé ne fonctionne plus et la fiche passe d'elle-même à Déconnectée. Cliquez sur Reconnecter et collez la nouvelle : la connexion existante est mise à jour, sans perdre de commandes ni d'historique. Plus d'infos dans Synchroniser, déconnecter ou supprimer une boutique.
Des questions sur les autorisations ou le quota ? Écrivez-nous depuis le chat du panel et nous verrons ensemble.