# Connecteur Axonaut PrestaShop — Documentation
> 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…
- Page:
- Langue: fr
- Mis à jour le: 2026-07-06
- Autres langues: [en](https://www.datafirefly.com/en/documentation/connecteur-axonaut-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/connecteur-axonaut-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/connecteur-axonaut-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/connecteur-axonaut-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/connecteur-axonaut-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/connecteur-axonaut-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/connecteur-axonaut-prestashop/index.md)
- Index:
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
1. Dans le back-office PrestaShop, ouvrez _Modules > Module Manager > Envoyer un module_ et déposez le fichier ZIP du module.
2. Une fois installé, cliquez sur _Configurer_.
3. 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.