Axonaut WooCommerce – documentation

Aperçu des fonctionnalités (Vidéo)

Introduction

Axonaut WooCommerce relie votre boutique WooCommerce à Axonaut. L’extension existe en deux versions :

• Version gratuite (FREE) — création manuelle de factures Axonaut, connexion par clé API utilisateur, synchronisation client (société / contact) avec SIRET et n° de TVA, champs checkout classique et Blocks, mapping TVA WooCommerce → Axonaut, délai de paiement (0 à 60 jours), multi-devises, téléchargement PDF en administration et Mon compte, colonne facture, journaux de diagnostic, compatibilité HPOS, option de conservation des données à la désinstallation.
• Version PRO — génération automatique selon statuts et condition d’émission (toutes / avec SIRET / sans SIRET), marquage comme payé dans Axonaut, envoi du PDF par e-mail, actions groupées et ZIP, mentions de facture avec variables, langue des documents, autoliquidation UE (B2B) et OSS (B2C), support prioritaire et licence. Nécessite la version FREE installée et active, ainsi qu’une licence PRO valide.

Cette documentation décrit la configuration et les fonctionnalités des deux versions. Les options PRO restent indisponibles tant que la licence n’est pas active.

1. Obtenir une clé API utilisateur Axonaut

Important : chaque boutique utilise sa propre clé API utilisateur Axonaut. Devikit ne fournit pas de clé partagée : vous la créez dans votre compte Axonaut, puis vous la collez dans WordPress.

1. Connectez-vous à Axonaut.
2. Cliquez sur l’icône clé à molette (paramètres), puis ouvrez la section API.
3. Créez une clé API utilisateur et copiez-la immédiatement. Conservez-la en lieu sûr : elle donne accès à votre compte Axonaut selon les droits de l’utilisateur associé.
4. Dans WordPress, ouvrez WooCommerce → Axonaut → Connexion, collez la clé, enregistrez, puis cliquez sur Tester la connexion.

Si la clé est compromise, révoquez-la dans Axonaut, créez-en une nouvelle, puis mettez à jour l’onglet Connexion. La clé est stockée uniquement dans votre base WordPress et n’est jamais envoyée à Devikit.

2. Installation de l’extension

Version FREE

1. Téléchargez le ZIP : invoicing-integration-for-axonaut-and-woocommerce-1.0.0.zip.
2. Dans WordPress : Extensions → Ajouter → Téléverser une extension.
3. Activez Invoicing Integration for Axonaut and WooCommerce.

Version PRO

1. Assurez-vous que la version FREE est installée et active. PRO complète FREE et ne fonctionne pas sans elle.
2. Téléversez et activez le ZIP PRO reçu après l’achat.
3. Allez dans WooCommerce → Axonaut → Licence et activez votre clé de licence.

3. Configuration de la connexion

Chemin : WooCommerce → Axonaut → Connexion.

1. Collez la clé API utilisateur Axonaut.
2. Cliquez sur Enregistrer les modifications.
3. Cliquez sur Tester la connexion. Un message de succès confirme l’accès au compte Axonaut.

Si vous enregistrez à nouveau les réglages en laissant le champ clé vide, l’extension conserve la clé déjà enregistrée. Après un test réussi, configurez les onglets Documents et TVA et Commande.

4. Documents et TVA

Chemin : WooCommerce → Axonaut → Documents et TVA.

Délai de paiement

Nombre de jours (0 à 60) appliqué à chaque facture Axonaut comme délai de règlement. Valeur par défaut : 7 jours. Disponible en FREE et en PRO.

Correspondance des taux de TVA

L’extension lit le taux appliqué sur chaque ligne WooCommerce (produits, livraison, frais) et cherche le taux correspondant dans votre compte Axonaut. Assurez-vous que vos taux WooCommerce et vos taux Axonaut sont configurés et actifs. Si aucun taux Axonaut ne correspond, la création de facture échoue avec un message explicite sur la commande.

Synchronisation du client

Avant chaque facture, l’extension crée ou met à jour la société et le contact Axonaut à partir de l’adresse de facturation WooCommerce, avec SIRET et n° de TVA lorsqu’ils sont renseignés. La recherche par e-mail limite les doublons. La commande doit disposer d’une adresse de facturation complète (e-mail, adresse, ville, code postal, pays).

5. Paramètres du checkout (Commande)

Chemin : WooCommerce → Axonaut → Commande.

Affichage SIRET et n° de TVA

• Toujours afficher — les champs restent visibles.
• Case « Je souhaite une facture » (checkout classique) — SIRET et/ou TVA n’apparaissent qu’après cochage. Le libellé de la case est personnalisable.
• Masqué (TVA uniquement) — si vous ne souhaitez pas demander le n° de TVA via l’extension.

Validation et champs obligatoires

• Valider le format SIRET — 14 chiffres.
• Valider le format TVA — code pays à 2 lettres suivi de 2 à 13 caractères alphanumériques.
• SIRET / TVA obligatoires — selon vos besoins B2B.

WooCommerce Blocks

Les champs SIRET et TVA sont pris en charge sur le checkout Blocks (section adresse de facturation). La case « Je souhaite une facture » est propre au checkout classique.

Extensions TVA déjà installées

Si une autre extension gère déjà le n° de TVA (WooCommerce EU VAT Number, Germanized, etc.), Axonaut WooCommerce ne duplique pas ce champ et réutilise la valeur existante. Le champ SIRET reste géré par l’extension Axonaut.

6. Facture manuelle, PDF et Mon compte (FREE et PRO)

Sur l’écran d’édition d’une commande, le panneau Axonaut permet de créer la facture manuellement, de télécharger le PDF et de consulter le numéro ou la dernière erreur éventuelle.

Dans la liste des commandes, la colonne Facture Axonaut indique l’état du document et un accès rapide au PDF.

Côté client : Mon compte → Commandes → Voir, bouton Télécharger la facture lorsqu’un PDF Axonaut est disponible. Seul le propriétaire de la commande (ou un administrateur) peut télécharger le fichier.

7. Mentions, langue et fiscalité (PRO)

Chemin : WooCommerce → Axonaut → Documents et TVA (licence PRO active).

Mentions / notes de facture

Le modèle de mentions obligatoires est injecté sur la facture Axonaut. Variables disponibles :

{order_id}, {order_number}, {order_date}, {order_date_raw}, {customer_name}, {customer_first_name}, {customer_last_name}, {customer_email}, {customer_phone}, {billing_company}, {billing_vat_id}, {billing_address}, {shipping_address}, {order_total}, {order_total_formatted}, {payment_method}, {shipping_method}

Langue de la facture

Choisissez une langue parmi celles disponibles dans votre compte Axonaut, ou laissez la langue du compte par défaut. Les langues se configurent dans Axonaut (paramètres de l’organisation), puis la liste se recharge dans WordPress.

Autoliquidation UE (B2B)

Lorsque l’option est activée (par défaut : oui), l’autoliquidation s’applique si le client a un n° de TVA, une raison sociale ou un SIRET, et que le pays de facturation est un pays de l’UE hors France. Les lignes peuvent être facturées à 0 % TVA avec la mention adaptée.

Régime OSS (B2C)

Lorsque l’option est activée (par défaut : oui), le régime OSS s’applique pour un client de l’UE hors France sans n° de TVA ni raison sociale. Les taux utilisés sont ceux calculés par WooCommerce pour le pays du client : vérifiez vos taux de taxe WooCommerce pour les pays concernés, et la présence des taux correspondants dans Axonaut.

8. Automatisation (PRO)

Chemin : WooCommerce → Axonaut → Automatisation.

• Activer l’automatisation — crée une facture Axonaut lorsque la commande passe à un statut sélectionné.
• Condition d’émission — toutes les commandes, uniquement lorsque le SIRET est renseigné, ou uniquement lorsque le SIRET n’est pas renseigné.
• Statuts de commande — par défaut : En cours et Terminée. Cochez les statuts adaptés à votre processus.

En cas d’échec temporaire lors de la création automatique, l’extension réessaie plusieurs fois avec un délai entre chaque tentative. Consultez le panneau Axonaut de la commande ou les journaux si une facture n’apparaît pas immédiatement.

9. Marquage comme payé (PRO)

Dans l’onglet Automatisation, activez Marquer comme payé dans Axonaut. Lorsque la commande WooCommerce est payée et que les totaux concordent, l’extension enregistre le paiement dans Axonaut.

10. Actions groupées et ZIP (PRO)

Depuis la liste des commandes WooCommerce, sélectionnez plusieurs commandes puis :

• Créer des factures Axonaut
• Télécharger les PDF de factures Axonaut (ZIP)

Le traitement affiche une barre de progression, puis un récapitulatif des succès et des erreurs.

11. E-mails PDF (PRO)

PRO enregistre un e-mail WooCommerce dédié à la facture Axonaut (réglable dans WooCommerce → Réglages → E-mails). Activez Envoyer le PDF de facture dans Automatisation pour l’envoi automatique à la création, ou déclenchez l’envoi manuellement depuis la commande.

12. Paramètres avancés

Chemin : WooCommerce → Axonaut → Avancé.

• Journaux de communication — à activer uniquement pour le diagnostic. Consultez WooCommerce → État → Journaux. La clé API est masquée dans les logs.
• Conserver les réglages et les données de commande lors de la désinstallation — si non coché, la désinstallation peut supprimer réglages, clé API et métadonnées Axonaut sur les commandes.

13. Licence (PRO)

Chemin : WooCommerce → Axonaut → Licence.

1. Saisissez la clé reçue après l’achat sur Axonaut WooCommerce PRO.
2. Cliquez sur Activer.
3. Le statut doit passer à actif. Vous recevez alors les mises à jour PRO dans l’administration WordPress.

Sans licence valide, l’automatisation, le marquage payé, les e-mails PDF, les actions groupées, les mentions, la langue, l’autoliquidation et l’OSS restent indisponibles.

14. Limitations et périmètre

• Pas d’avoirs / notes de crédit — l’extension ne crée pas d’avoirs Axonaut depuis WooCommerce. Gérez les avoirs directement dans Axonaut si nécessaire.
• Pas de mapping catalogue produits — les lignes de commande WooCommerce sont envoyées comme lignes de facture Axonaut (produits, livraison, frais), sans synchronisation d’un catalogue articles Axonaut.
• Taxes Axonaut — chaque taux WooCommerce utilisé doit exister dans Axonaut. Sinon la facture ne peut pas être créée.
• Multi-devises — la devise de la commande WooCommerce est reprise sur la société et le document Axonaut (EUR, USD, GBP, CHF, etc.). Les devises doivent être utilisables dans votre compte Axonaut.

15. Support et liens utiles

Pour toute question, aide à la configuration ou problème rencontré, contactez-nous directement :

• E-mail : hi@devikit.fr
• Formulaire de contact : devikit.fr/contact

Nous garantissons un support prioritaire et réactif aux détenteurs d’une licence PRO active.

• Produit PRO : https://devikit.fr/produit/axonaut-woocommerce-pro/
• Version FREE (ZIP) : télécharger

FAQ

Faut-il la version gratuite ?
Oui. PRO complète FREE et ne fonctionne pas sans elle.

Où obtenir la clé API ?
Dans Axonaut : icône clé à molette → API → créer une clé API utilisateur, puis la coller dans WooCommerce → Axonaut → Connexion.

Y a-t-il un quota de factures dans l’extension ?
Non. Les limites éventuelles dépendent de votre abonnement Axonaut.

Puis-je facturer seulement les commandes avec SIRET ?
Oui, via la condition d’émission en PRO (Uniquement lorsque le SIRET est renseigné). L’inverse (sans SIRET) est aussi disponible.

Le délai de paiement est-il disponible en FREE ?
Oui, dans Documents et TVA (0 à 60 jours).

L’extension crée-t-elle des avoirs ?
Non. Seules les factures sont gérées depuis WooCommerce.

Les champs SIRET / TVA fonctionnent-ils avec WooCommerce Blocks ?
Oui, dans l’adresse de facturation. La case « Je souhaite une facture » reste propre au checkout classique.

Support technique

Utilisateurs PRO

Pour toute question, aide à la configuration ou problème rencontré, contactez-nous directement : hi@devikit.fr ou formulaire de contact.

Utilisateurs FREE

La version gratuite ne bénéficie pas d’un support technique courant (aide à la configuration, conseils). Si vous rencontrez un bug dans le fonctionnement de l’extension, merci de nous le signaler par e-mail :

Signaler un bug : hi@devikit.fr