L'intégration avec Odoo vous permet d'enrichir votre interface Fygr grâce à la remontée automatique de vos factures clients et fournisseurs. Une fois la connexion établie, Fygr récupère vos factures sur les 12 derniers mois et les rafraîchit à chaque synchronisation.
📖 Cette intégration s'adresse aux utilisateurs d'Odoo en mode Odoo Online, Odoo.sh ou auto-hébergé (On-Premise), dès lors que l'API XML-RPC d'Odoo est accessible depuis Internet. Les versions 16, 17 et 18 d'Odoo sont prises en charge.
Mettre en place la connexion
Pour intégrer votre compte Odoo avec votre compte Fygr, suivez les étapes ci-dessous :
Sur votre compte Fygr, cliquez sur le bonhomme en haut à droite, puis sur
Intégrations:
Cliquez sur
Ajouter une intégration:
Sélectionnez
Odoo, puis cliquez surValider:
Renseignez les informations de connexion à votre compte Odoo (URL de votre instance, nom de la base de données, identifiant utilisateur, mot de passe ou clé API, et identifiant de société), puis cliquez sur
Valider:
Reprenez l'identifiant utilisateur et le mot de passe (ou la clé API) de votre compte
Odoo:
🔐 Authentification à deux facteurs (2FA). Si vous avez activé la 2FA sur votre compte Odoo, vous ne pouvez pas utiliser votre mot de passe Odoo : il faut générer une clé API depuis votre profil Odoo (Préférences → Compte sécurité → Nouvelle clé API) et la renseigner à la place du mot de passe dans le formulaire d'intégration Fygr. Voir la documentation officielle Odoo pour le détail.
🏢 Trouver votre identifiant de société Odoo. Dans Odoo, ouvrez le menu Paramètres → Sociétés → sélectionnez votre société : l'identifiant numérique est visible dans l'URL de la fiche (paramètre id=). Cet identifiant est nécessaire pour que Fygr cible la bonne entité juridique au sein de votre base Odoo (utile si vous gérez plusieurs sociétés dans la même instance).
Sélectionnez les données que vous souhaitez importer depuis
Odoo, puis cliquez surSynchroniser les données:
Une fois la synchronisation terminée, cliquez sur
Voir mon dashboard:
Rendez-vous dans l'onglet
Échéancespour visualiser toutes vos factures importées :
Pour en savoir plus, consultez notre tutoriel vidéo 👇🏻
Ce qui est remonté dans Fygr
Selon les cases cochées à l'étape 6, Fygr remonte :
Les factures clients (échéances clients / 411) sur les 12 derniers mois
Les factures fournisseurs (échéances fournisseurs / 401) sur les 12 derniers mois
Les avoirs (refunds) clients et fournisseurs, comptabilisés en signe inverse de la facture d'origine
Le tiers associé à chaque facture (client ou fournisseur), avec son nom légal
Pour chaque facture, Fygr récupère :
Le numéro de facture (champ name, ou display_name en repli si le numéro n'est pas encore défini)
La date d'émission et la date d'échéance (ou émission + 30 jours par défaut si la date d'échéance n'est pas renseignée dans Odoo)
Les montants HT, TVA et TTC dans la devise de la facture
Le restant dû (champ amount_residual d'Odoo)
Le libellé, reconstruit à partir des lignes de la facture
Un lien direct vers la facture dans Odoo (champ access_url), accessible depuis Fygr en un clic
Le statut, déduit du statut Odoo et de l'état de paiement
📖 Correspondance des statuts Odoo → Fygr
Brouillon (draft) → ignoré, la facture n'est pas remontée tant qu'elle reste en brouillon
Comptabilisée + non payée → En cours (ou En retard si la date d'échéance est dépassée)
Partiellement payée (restant dû inférieur au total) → Partiellement payée
Payée (payment_state = paid) → Payée, avec la date du dernier paiement effectif
Annulée (state = cancel) → Annulée
Bonnes pratiques pour une donnée propre dans Fygr
📅 Renseignez systématiquement la date d'échéance sur vos factures Odoo. Sans cette date, Fygr applique une échéance par défaut de 30 jours après la date d'émission, ce qui peut décaler la facture sur votre prévisionnel de trésorerie.
🏷️ Validez vos factures dans Odoo. Les factures qui restent en brouillon ne remontent pas dans Fygr : si vous ne voyez pas une facture, vérifiez d'abord qu'elle est bien comptabilisée. À l'inverse, une facture marquée comme Payée ou Annulée dans Odoo voit son statut mis à jour automatiquement dans Fygr à la synchronisation suivante.
🔁 Volumes importants. La synchronisation traite jusqu'à environ 5 000 factures par catégorie (clients / fournisseurs) à chaque rafraîchissement. Si votre volume dépasse ce seuil, contactez le support pour qu'on cale ensemble la stratégie d'import la plus adaptée.
🏢 Multi-sociétés Odoo. Si votre instance Odoo regroupe plusieurs sociétés, l'intégration Fygr est rattachée à une seule société Odoo (celle dont vous avez renseigné l'ID à l'étape 4). Pour synchroniser plusieurs sociétés, créez une intégration Fygr par société.
Intégrations sur-mesure
⚙️ Certaines configurations Odoo sortent du cadre standard décrit ci-dessus : filtrage personnalisé sur les états de facture (par exemple pour exclure certains états Odoo ou inclure des états personnalisés propres à votre workflow comptable), exploitation de champs personnalisés propres à votre instance, ou règles de mapping spécifiques.
Ces cas sont gérables : Fygr peut configurer une intégration sur-mesure adaptée à votre instance. Pour cela, prenez contact avec votre référent Fygr ou avec le support en décrivant brièvement votre besoin et nous reviendrons vers vous avec une proposition.
Besoin d'aide ? N'hésitez pas à contacter notre équipe support :
📞 01 76 50 33 88
📧 [email protected]
📝 contactez-nous via le chat