À quoi sert cette intégration ?
L'intégration Odoo permet de synchroniser automatiquement vos Acheteurs et vos Créances depuis Odoo vers Afakto. Vos données de facturation sont disponibles dans Afakto pour préparer et automatiser vos cessions au factor, sans ressaisie manuelle.
Données synchronisées :
Vos Acheteurs (raison sociale, coordonnées, identifiants)
Vos créances clients comptabilisées
L'accès est en lecture seule : Afakto ne modifie aucune donnée dans votre compte Odoo.
Prérequis
Un compte Afakto actif avec au moins une entreprise créée
Une instance Odoo accessible en ligne, au format https://<nom-instance>.odoo.com
Les droits nécessaires dans Odoo pour générer une clé API
Il est recommandé de renseigner le champ code client sur chaque client Odoo concerné par une créance. S'il est vide, Afakto utilise l'identifiant interne Odoo pour rapprocher l'Acheteur.
Étape 1 : Générer une clé API dans Odoo
Connectez-vous à votre instance Odoo
Ouvrez Préférences, puis Compte de sécurité
Cliquez sur Nouvelle clé API et saisissez une description
Copiez la clé générée et conservez-la, elle n'est plus affichée après la fermeture de la fenêtre
Recommandation : créez un utilisateur Odoo dédié à Afakto, avec un accès limité aux clients (res.partner) et aux créances (account.move).
Étape 2 : Ouvrir la fiche entreprise dans Afakto
Connectez-vous à votre espace Afakto sur app.afakto.com
Dans le menu latéral gauche, cliquez sur Administration, puis Entreprises
Sélectionnez l'entreprise que vous souhaitez connecter à Odoo
Étape 3 : Renseigner les identifiants Odoo
Sur la fiche entreprise, cliquez sur le bouton Connecter ERP en bas de page
Dans la liste des connecteurs disponibles, sélectionnez Odoo
Renseignez l'URL de votre instance Odoo et la clé API générée à l'étape 1
Validez la connexion
Étape 4 : Synchroniser vos données
La fiche entreprise affiche une section Odoo
Cliquez sur Synchroniser pour lancer la première synchronisation
Une fois la synchronisation terminée, vos Acheteurs et vos Créances sont disponibles dans Afakto
Ce qui est importé
Les factures sont récupérées en premier. Afakto identifie ensuite les clients qui portent effectivement des factures et n'importe que ceux-là.
Seules les créances comptabilisées sont importées. Les brouillons sont exclus, et les factures déjà intégralement payées sont ignorées.
Gérer la connexion
Depuis la fiche entreprise dans Afakto, la section Odoo vous permet de :
Synchroniser : lancer une synchronisation à tout moment pour récupérer les données les plus récentes
Se déconnecter : dissocier votre compte Odoo de cette entreprise
Durée de validité de la clé API
La durée de vie d'une clé API dépend de votre version d'Odoo :
Odoo 16 et 17 : aucun réglage de durée. Les clés sont permanentes, l'écran demande uniquement une description.
Odoo 18 : un sélecteur de durée est proposé, avec une option Clé persistante pour une clé sans expiration. Si cette option n'est pas cochée, la clé expire et la synchronisation s'interrompt sans avertissement préalable.
Odoo 19 : la durée est limitée à trois mois maximum, sans exception. Une connexion durable suppose donc une rotation trimestrielle planifiée de la clé.
Questions fréquentes
La synchronisation est-elle automatique ?
Oui. Une synchronisation automatique est exécutée chaque jour ouvré, du lundi au vendredi à 6h10 CET, pour toutes les entreprises connectées. Vous pouvez également lancer une synchronisation manuelle à tout moment depuis la fiche entreprise.
Afakto peut-il modifier mes données Odoo ?
Non. L'intégration est en lecture seule. Afakto récupère vos clients et vos factures, mais ne crée, ne modifie et ne supprime aucune donnée dans Odoo.
Pourquoi certains Acheteurs ou certaines factures n'apparaissent-ils pas dans Afakto ?
Trois causes principales : l'acheteur n'a pas de créances ouvertes dans odoo, la facture est encore à l'état de brouillon, ou la facture est déjà intégralement payée.
Puis-je connecter plusieurs entreprises ?
Oui. Une entreprise Odoo correspond à une entreprise Afakto. Si plusieurs entreprises Afakto appartiennent à la même organisation et partagent la même instance Odoo, les identifiants de connexion ne sont saisis qu'une seule fois. Vous sélectionnez ensuite la société Odoo correspondant à chaque entreprise Afakto.
Ma synchronisation a cessé de fonctionner, que dois-je vérifier ?
Vérifiez en premier lieu la validité de votre clé API dans Odoo. Selon votre version, la clé peut avoir expiré. Consultez la section sur la durée de validité de la clé API.
Comment déconnecter Odoo ?
Ouvrez la fiche entreprise concernée dans Afakto et cliquez sur Se déconnecter dans la section Odoo.