Connecter Holded avec WooCommerce est l’étape qui transforme votre boutique d’un simple panier en un véritable système administratif : chaque commande payée devient, sans intervention manuelle, une facture correcte dans votre compte Holded. Dans ce guide pratique, nous nous concentrons sur l’action concrète de la connexion — générer la clé API, installer le plugin, mapper la facturation et émettre la première facture — afin que vous puissiez faire fonctionner le processus en une seule après-midi et sans mauvaises surprises comptables en fin de mois.
Connecter Holded avec WooCommerce : ce dont vous avez besoin avant de commencer
Avant de toucher au moindre réglage, il convient de préparer le terrain. La plupart des incidents ne viennent pas du plugin, mais de données fiscales incomplètes ou d’une clé API mal générée. Si vous passez en revue cette liste, la connexion se fera du premier coup :
- Un compte Holded actif avec des droits d’administrateur (les offres avec facturation électronique sont idéales).
- WooCommerce à jour et avec les données fiscales de votre entreprise complétées (NIF, adresse et raison sociale).
- Au moins une série de facturation définie dans Holded, distincte de vos factures manuelles ou d’autres canaux.
- Le plugin EHERO Woo Holded pour la facturation, qui transfère automatiquement chaque commande vers Holded.
- Les taxes de votre boutique (TVA standard, réduite, surtaxe d’équivalence le cas échéant) correctement configurées dans WooCommerce.
Cette partie complète notre guide général pour intégrer Holded avec WooCommerce : ici, nous ne parlons pas de stratégie, mais de la procédure technique de liaison étape par étape.
Générez la clé API dans Holded
La clé API est l’identifiant qui autorise votre boutique à créer des factures en votre nom. Connectez-vous au tableau de bord officiel de Holded, ouvrez le menu de votre compte et allez dans Configuration > Développeurs (selon l’offre, cela apparaît comme « API » ou « Intégrations »). Cliquez pour créer une nouvelle clé, donnez-lui un nom reconnaissable — par exemple « WooCommerce boutique » — et copiez-la dans un endroit sûr.
Gardez un détail clé à l’esprit : Holded n’affiche la clé complète qu’une seule fois. Si vous fermez la fenêtre sans la copier, vous devrez la révoquer et en générer une autre. Enregistrez-la dans votre gestionnaire de mots de passe, jamais dans un e-mail ou une note partagée.
Installez le plugin EHERO Woo Holded
Téléversez le ZIP du plugin depuis Extensions > Ajouter > Téléverser une extension dans votre WordPress et activez-le. Vous verrez une nouvelle section de réglages où vous collerez la clé API que vous venez de générer. En enregistrant, le plugin effectue un appel de validation vers Holded : si l’identifiant est correct, vous recevrez une confirmation en vert. C’est le moment où vous terminez réellement la liaison de votre boutique avec Holded au niveau des identifiants.
Comment connecter Holded avec WooCommerce étape par étape
Une fois la clé validée, le reste consiste à décider du comportement. Pour garder la connexion bien organisée, suivez cette séquence dans les réglages du plugin :
- Collez la clé API et enregistrez pour vérifier la connexion.
- Choisissez la série de facturation que la boutique utilisera (idéalement une série dédiée au canal en ligne).
- Définissez le déclencheur : émettre la facture lorsque la commande passe à « En cours de traitement » ou à « Terminée ».
- Décidez si le numéro de facture est attribué par Holded ou hérité de la commande.
- Activez, si nécessaire, l’envoi automatique du PDF au client.
Mappez la facturation : séries, taxes et données fiscales
Le mapping est la partie qui fait la différence entre une facture correcte et une facture que votre cabinet comptable refusera. Assurez-vous que les taux de TVA de WooCommerce correspondent à ceux définis dans Holded ; si votre boutique a un 21 % et que, dans Holded, cette taxe n’existe pas avec la même valeur, la facture sera créée avec des montants incohérents. Vérifiez également le mapping des contacts : le plugin recherche le client par NIF ou par e-mail et, s’il ne le trouve pas, le crée. Cela évite les doublons dans votre base de contacts Holded.
Pour les entreprises soumises à la réglementation antifraude, cette liaison constitue la base sur laquelle vous construisez ensuite un TPV pour WooCommerce avec VeriFactu. EHERO Woo Holded est compatible avec VeriFactu, de sorte que les factures qu’il génère respectent les exigences de traçabilité imposées.
Émettez votre première facture de test
Ne confiez pas la première émission à une vraie commande. Créez une commande de test avec un produit à faible montant, marquez-la comme payée et observez ce qui se passe. Si tout est correctement mappé, la facture apparaîtra en quelques secondes dans Holded avec la série, la taxe et le contact corrects. Vérifiez trois choses : que le numéro de série est celui prévu, que le total correspond à la commande et que le client a été créé ou lié sans doublon. Lorsque cette commande de test passe sans erreur, la connexion est terminée et vous pouvez passer en production en toute tranquillité.
Erreurs de connexion typiques et comment les résoudre
Bien que la liaison des deux plateformes soit un processus court, trois erreurs concentrent presque toutes les demandes de support. Les voici et voici comment les résoudre.
Clé API invalide ou sans autorisations
Si, lors de l’enregistrement, vous recevez une erreur d’identifiant, vérifiez que vous n’avez pas copié d’espaces au début ou à la fin de la clé. La deuxième cause la plus fréquente est une clé avec des autorisations limitées : certaines offres Holded génèrent des clés en lecture seule qui ne peuvent pas créer de factures. Générez-en une nouvelle avec des droits d’écriture et validez à nouveau.
Erreurs de série de facturation
Lorsque la facture n’est pas émise et que le journal mentionne la « série », il manque presque toujours la sélection d’une série valide ou celle-ci a été supprimée dans Holded. Créez une série exclusive pour le canal en ligne, séparez-la de celle que vous utilisez pour les factures manuelles et choisissez-la à nouveau dans le plugin. Vous éviterez ainsi des sauts de numérotation qui compliquent ensuite la clôture trimestrielle.
| Aspect | Facturation manuelle | Connexion avec EHERO Woo Holded |
|---|---|---|
| Temps par commande | 3 à 5 minutes à copier les données | Automatique, zéro minute |
| Risque d’erreur | Élevé (montants, NIF, série) | Faible, données héritées de la commande |
| Numérotation de série | Manuelle, avec des sauts fréquents | Consécutive et contrôlée |
| Compatibilité VeriFactu | Dépend de la méthode | Oui, intégrée |
Questions fréquentes
Ai-je besoin de connaissances techniques pour faire cette connexion ?
Non. Le processus se limite à générer une clé API, installer le plugin et coller la clé. Tout le mapping se fait depuis un écran de réglages, sans toucher au code ni aux bases de données.
Le plugin synchronise-t-il aussi le stock entre Holded et la boutique ?
Non. EHERO Woo Holded se concentre sur la facturation : il transforme chaque commande en facture dans Holded. La gestion du stock est un flux différent et ne fait pas partie de cette connexion.
Puis-je utiliser des fonctions d’IA dans la facturation ?
Toute fonction assistée par IA fonctionne en mode BYOK, c’est-à-dire avec votre propre clé du fournisseur. Vous contrôlez la clé et les dépenses ; le plugin n’inclut pas de consommation tierce de sa propre initiative.
Que se passe-t-il si je change la clé API plus tard ?
Il suffit de coller la nouvelle clé dans les réglages et d’enregistrer pour que le plugin la valide à nouveau. Si vous révoquez l’ancienne dans Holded, faites-le juste après avoir confirmé que la nouvelle connexion répond correctement.
Conclusion
Connecter Holded avec WooCommerce est plus rapide qu’il n’y paraît lorsque vous préparez la clé API, définissez une série propre et validez avec une commande de test avant de passer en production. Avec ces quatre précautions — identifiant correct, taxes alignées, série dédiée et test réel — vous laisserez la facturation fonctionner sans surveillance et conformément à VeriFactu. Passez à l’action avec le plugin de facturation Holded pour WooCommerce de EHERO et transformez chaque commande en facture sans jamais recopier une donnée à la main.