Connecteur Axonaut pour WooCommerce — Documentation
Installer, connecter et configurer le Connecteur Axonaut pour WooCommerce : factures ou devis, sociétés et contacts, avoirs, import de l'historique.
Le Connecteur Axonaut pour WooCommerce relie votre boutique WooCommerce à l’ERP/CRM français Axonaut. Il pousse automatiquement vos commandes dans Axonaut sous forme de factures ou de devis, crée les sociétés et contacts correspondants, génère des avoirs lors des remboursements et vous permet d’importer votre historique. Tout le traitement s’effectue en arrière-plan via Action Scheduler, sans impact sur le checkout, et reste idempotent : une commande n’est jamais synchronisée deux fois.
Prérequis
- WordPress 6.0 ou supérieur
- WooCommerce 7.0 ou supérieur
- PHP 7.4 ou supérieur
- Un compte Axonaut actif et sa clé API
Le plugin ne requiert aucune dépendance Composer sur votre serveur et est compatible avec le stockage haute performance des commandes (HPOS) comme avec l’ancien stockage.
Installation
- Depuis l’administration WordPress, allez dans Extensions > Ajouter > Téléverser une extension.
- Sélectionnez le fichier ZIP du plugin, puis cliquez sur Installer maintenant.
- Activez l’extension.
- Un nouveau menu WooCommerce > Axonaut apparaît dans l’administration.
Connexion à Axonaut
Rendez-vous dans WooCommerce > Axonaut, onglet Réglages.
Récupérer votre clé API
Dans votre compte Axonaut, ouvrez la section Paramètres puis Développeurs. Copiez votre clé API personnelle.
Renseigner et tester la clé
Collez la clé dans le champ Clé API Axonaut, puis cliquez sur Tester la connexion. Un message vert confirme que la connexion est établie ; un message rouge indique une clé invalide ou un problème réseau.
La clé est stockée de façon sécurisée et n’est jamais affichée en clair une fois enregistrée. Le test de connexion utilise la clé saisie dans le champ, même avant l’enregistrement.
Configuration
Type de document
Choisissez le document créé dans Axonaut à partir d’une commande : Facture ou Devis. Ce choix s’applique à toutes les commandes synchronisées.
Statuts déclencheurs
Cochez les statuts de commande qui déclenchent l’envoi vers Axonaut (par exemple Terminée). Dès qu’une commande atteint l’un de ces statuts, elle est mise en file d’attente pour synchronisation. Chaque commande n’est envoyée qu’une seule fois, même si elle change plusieurs fois de statut.
Contacts
Activez cette option pour que l’acheteur soit créé comme contact (employee) rattaché à la société dans Axonaut. La société, elle, est toujours créée : Axonaut en a besoin pour rattacher factures et devis.
Remboursements
Activez cette option pour qu’un remboursement WooCommerce génère automatiquement un avoir dans Axonaut. Cela ne s’applique qu’aux commandes déjà synchronisées en facture.
Date de paiement
Lorsqu’elle est activée, la date de paiement est transmise à Axonaut pour les commandes déjà réglées.
Produits
Option facultative : synchronise vos produits WooCommerce vers le catalogue Axonaut lors de leur création ou mise à jour.
Maintenance
Définissez la durée de rétention du journal (en jours) et activez le mode debug pour journaliser l’intégralité des réponses de l’API en cas de diagnostic.
Synchronisation des commandes
Quand une commande atteint un statut déclencheur, le connecteur :
- résout ou crée la société Axonaut correspondante ;
- construit le document ligne par ligne, avec le taux de TVA calculé pour chaque ligne ;
- ajoute les frais de port et les frais éventuels comme lignes dédiées ;
- transmet la date de paiement si la commande est déjà réglée ;
- crée la facture ou le devis dans Axonaut et enregistre son identifiant sur la commande.
Le traitement est asynchrone (Action Scheduler) : il n’allonge pas le temps de passage en caisse. En cas d’erreur temporaire de l’API (429 ou 5xx), l’envoi est automatiquement re-tenté avec un délai croissant, jusqu’à cinq fois.
Sociétés, contacts et TVA intracommunautaire
La société Axonaut est créée à partir des données de facturation. Le connecteur distingue automatiquement les clients professionnels (champ société renseigné) des particuliers, et reporte le numéro de TVA intracommunautaire détecté depuis les principaux plugins de TVA UE.
Déduplication
Avant tout appel à l’API, le connecteur cherche une société déjà résolue : d’abord sur la commande elle-même, puis sur le compte client (le cas échéant), puis sur une commande précédente portant le même e-mail de facturation. Les acheteurs récurrents, même en commande invitée, sont ainsi reconnus sans créer de doublon.
Avoirs et remboursements
Un remboursement WooCommerce, total ou partiel, sur une commande déjà synchronisée en facture, génère automatiquement un avoir dans Axonaut, lié à la facture d’origine.
- Les remboursements par ligne sont repris ligne par ligne, avec la TVA recalculée.
- Les remboursements par montant produisent une ligne d’avoir globale.
- Les frais de port remboursés sont ajoutés comme ligne dédiée.
Chaque avoir est idempotent : un même remboursement ne génère jamais deux avoirs.
Import de l’historique
L’onglet Import permet de pousser vos commandes existantes vers Axonaut.
- Choisissez une plage de dates (facultative) et les statuts de commande à inclure.
- Cliquez sur Démarrer l’import.
- Les commandes sont parcourues par lots en arrière-plan via Action Scheduler ; les commandes déjà synchronisées sont automatiquement ignorées.
Suivez l’avancement dans l’onglet Journal.
Action groupée sur la liste des commandes
Depuis la liste des commandes (écran HPOS ou ancien écran), sélectionnez une ou plusieurs commandes, puis choisissez l’action groupée Synchroniser vers Axonaut. Un message indique le nombre de commandes mises en file d’attente et celles ignorées car déjà synchronisées.
Meta box et resynchronisation manuelle
Sur la fiche d’une commande, la boîte Axonaut affiche l’état de synchronisation : type et numéro du document créé, société liée et date. Si la commande n’est pas encore synchronisée, un bouton Synchroniser maintenant permet un envoi immédiat, avec affichage de la dernière erreur le cas échéant.
Journal d’activité et mode debug
L’onglet Journal affiche les dernières opérations (créations de sociétés, factures, avoirs, erreurs), avec un lien direct vers la commande concernée. La durée de rétention est configurable. Le mode debug ajoute au journal le détail complet des réponses de l’API, utile pour diagnostiquer un problème.
Synchronisation des produits (optionnel)
Lorsque l’option est activée, chaque création ou mise à jour de produit WooCommerce est répercutée dans le catalogue Axonaut (nom, référence SKU, prix hors taxe, taux de TVA). La correspondance est mémorisée pour mettre à jour le bon produit Axonaut lors des modifications suivantes.
Compatibilité HPOS
Le plugin déclare sa compatibilité avec le stockage haute performance des commandes (High-Performance Order Storage). Toutes les métadonnées de synchronisation sont enregistrées via l’API des commandes WooCommerce, ce qui garantit un fonctionnement identique avec l’ancien stockage et avec HPOS.
Hooks pour développeurs
Le connecteur expose plusieurs points d’extension pour adapter les données envoyées à Axonaut :
df_axonaut_company_payload— filtre les données de la société avant création.df_axonaut_employee_payload— filtre les données du contact avant création.df_axonaut_document_payload— filtre les données de la facture ou du devis.df_axonaut_credit_note_payload— filtre les données de l’avoir.df_axonaut_product_payload— filtre les données du produit synchronisé.df_axonaut_vat_meta_keys— personnalise les clés de méta où chercher le numéro de TVA.df_axonaut_order_synced— action déclenchée après synchronisation réussie d’une commande.df_axonaut_refund_synced— action déclenchée après création d’un avoir.
Dépannage
Le test de connexion échoue
Vérifiez que la clé API est correcte et active dans votre compte Axonaut, et que votre serveur peut joindre l’API Axonaut en sortie HTTPS.
Une commande n’est pas synchronisée
Assurez-vous que son statut figure parmi les statuts déclencheurs et qu’elle n’a pas déjà été synchronisée. Consultez le journal ainsi que la boîte Axonaut de la commande pour la dernière erreur. Vérifiez également que la file Action Scheduler s’exécute (WooCommerce > État > Actions planifiées).
Un avoir n’a pas été créé
Les avoirs ne sont générés que pour les commandes déjà synchronisées en facture (pas en devis) et lorsque l’option des remboursements est activée.
Ne modifiez pas manuellement l’identifiant de document Axonaut enregistré sur une commande : c’est lui qui garantit qu’une commande n’est jamais envoyée deux fois.