Connecteur Axonaut PrestaShop — Documentation
Installer et configurer le connecteur Axonaut pour PrestaShop : clé API, synchronisation clients, factures/devis, produits, cron et dépannage.
Le module Connecteur Axonaut PrestaShop (dfaxonaut, éditeur DataFirefly) synchronise automatiquement vos clients, commandes et produits entre PrestaShop et Axonaut, le logiciel de gestion français (CRM, facturation, devis, trésorerie). Ce guide couvre l’installation, la configuration, le fonctionnement des synchronisations et le dépannage.
Prérequis
- PrestaShop 8.x ou 9.x, PHP 7.4 à 8.3.
- Un compte Axonaut actif avec accès à l’API v2.
- Votre clé API Axonaut (userApiKey), disponible dans Axonaut sous Paramètres > Développeurs > Clé API.
Installation
- Dans le back-office PrestaShop, ouvrez Modules > Module Manager > Envoyer un module et déposez le fichier ZIP du module.
- Une fois installé, cliquez sur Configurer.
- Un nouvel onglet Axonaut Connector apparaît également sous Paramètres avancés : il donne accès au tableau de bord et aux journaux.
Le module n’installe aucune dépendance Composer au déploiement : l’autoloader PSR-4 est intégré. Rien d’autre n’est requis côté serveur.
Configuration
Clé API et test de connexion
Collez votre clé API Axonaut dans le champ Clé API Axonaut puis enregistrez. Rendez-vous ensuite dans le tableau de bord (Paramètres avancés > Axonaut Connector) et cliquez sur Tester la connexion : le module interroge l’endpoint /me d’Axonaut et affiche le compte associé si tout est correct.
Synchronisation des clients
Activez Synchroniser les clients pour que chaque création de compte, mise à jour du compte ou modification d’adresse crée ou mette à jour une société Axonaut accompagnée de son contact. Le module détecte automatiquement les professionnels (raison sociale ou TVA intracommunautaire renseignée) et les particuliers (B2C), et transmet l’adresse, la TVA intracommunautaire et le numéro d’entreprise lorsqu’ils sont disponibles.
Synchronisation des commandes
Activez Synchroniser les commandes, puis choisissez :
- Mode : créer une facture ou un devis Axonaut.
- Statuts déclencheurs : la commande est envoyée la première fois qu’elle atteint l’un des statuts sélectionnés (par exemple « Paiement accepté »).
- Prix TTC : envoyer les prix unitaires taxes incluses plutôt que hors taxes.
Chaque commande transmise reprend les lignes produits (référence, taux de TVA, quantité) et ajoute les frais de port en ligne dédiée. Une commande déjà envoyée n’est jamais dupliquée.
Synchronisation des produits (optionnelle)
Activez Synchroniser les produits pour refléter votre catalogue (référence, nom, prix, TVA, description courte) dans les produits Axonaut. La synchronisation se déclenche à chaque mise à jour d’une fiche produit.
Tâche cron
Les synchronisations sont mises en file d’attente et traitées en tâche de fond. Un traitement inline léger est tenté à la volée dans les hooks, mais pour un fonctionnement fiable, planifiez la tâche cron affichée dans la configuration :
curl -s "https://votre-boutique.tld/index.php?fc=module&module=dfaxonaut&controller=cron&token=VOTRE_TOKEN"Fréquence recommandée : toutes les 5 à 15 minutes. Le cron traite la file, purge les éléments terminés (7 jours) et les journaux anciens (30 jours). Le token est régénérable depuis la page de configuration.
Si vous régénérez le token, pensez à mettre à jour l’URL dans votre planificateur de tâches (cron serveur, tâche PrestaShop ou service externe).
Tableau de bord et journaux
L’onglet Axonaut Connector affiche les compteurs (en attente / synchronisés / en échec) et le journal complet des opérations, filtrable et exportable. Deux actions sont disponibles :
- Traiter la file maintenant : force le traitement immédiat des éléments en attente.
- Relancer les échecs : remet en file les éléments passés en échec après 5 tentatives.
Fonctionnement de la file et des relances
Chaque entité à synchroniser (client, commande, produit) est déposée dans une file. En cas d’erreur temporaire (réseau, quota API), le module réessaie automatiquement jusqu’à 5 fois, puis marque l’élément en échec. Les erreurs sont journalisées avec leur message, ce qui facilite le diagnostic. Le mode debug ajoute les payloads et réponses complets de l’API dans les journaux.
Dépannage
- « Clé API vide » : renseignez la clé dans la configuration avant de tester la connexion.
- Erreur HTTP 401/403 : la clé API est invalide ou révoquée. Régénérez-la dans Axonaut.
- Commandes non envoyées : vérifiez que le statut atteint fait partie des statuts déclencheurs et que la synchronisation des commandes est activée.
- Éléments en échec : ouvrez le journal pour lire le message d’erreur, corrigez la cause, puis cliquez sur Relancer les échecs.
- Rien ne se synchronise en tâche de fond : vérifiez que la tâche cron est bien planifiée et que le token de l’URL correspond à celui de la configuration.
Notes techniques
- API utilisée : Axonaut REST API v2, authentification par en-tête userApiKey.
- Endpoints : /me, /companies, /companies/{id}/employees, /employees/{id}, /products, /invoices, /quotations.
- Tables créées : dfaxonaut_map (correspondances PrestaShop ↔ Axonaut), dfaxonaut_queue (file), dfaxonaut_log (journaux).
- Compatible multiboutique PrestaShop.