Connecteur QuickBooks Online : migrez vers Odoo et gardez la maîtrise de chaque chiffre

Plus qu'une simple exportation CSV

Exporter un fichier, le réimporter, croiser les doigts : vous connaissez la chanson, et les dégâts que ça peut faire. Une facture qui perd son règlement. Un compte importé deux fois. Un taux de TVA recréé de travers. 

QuickBooks Online Connector adopte une approche différente. C'est un connecteur, mais bien plus qu'un simple outil de synchronisation. Il commence par reconstruire votre environnement QuickBooks Online dans Odoo, avec un mappage guidé et une reprise comptable sécurisée. Ensuite, il maintient les deux systèmes alignés grâce à une synchronisation continue. Le module est conçu pour les équipes comptables. Vous vous connectez, vous passez en revue les mappages suggérés, vous lancez la migration, et le connecteur gère la partie technique.

Une règle gouverne tout le reste : rien n'entre dans Odoo sans votre accord. Neuf étapes vous mènent de la connexion au mode Live, et vous pouvez revenir à chacune d'elles à tout moment.

Un prérequis avant de vous lancer : le connecteur fonctionne sur Odoo 19 (une version pour Odoo 18 existe aussi), hébergé sur Odoo.sh ou sur vos propres serveurs. Odoo Online, lui, n’accepte pas l’installation de ce type de module.

Avant l'import : inventaire et mappage

Tout commence avant l'import du premier enregistrement. Deux étapes déterminent la qualité de votre migration. 

Commencez par faire l'inventaire

Première étape : savoir exactement ce que contient votre société QuickBooks. Dès que vous êtes connecté, le connecteur lit les informations de votre société et le nombre réel d'enregistrements pour chaque objet.

Ensuite, vous choisissez ce que vous emmenez avec vous. Plan comptable, taxes, conditions de paiement, clients, fournisseurs, articles, devis, factures, paiements, bons de commande, écritures comptables : la plupart des objets sont activés par défaut. Les classes, lieux, pièces jointes et employés attendent votre feu vert. Vous voulez un historique plus léger ? Une plage de dates suffit.

Le mappage, ou l'art de ne rien écraser

C’est souvent là que tout se joue. Votre Odoo contient peut‑être déjà des comptes, des contacts et des produits. Faut‑il tout refaire à zéro ? Absolument pas.

L’assistant de correspondance fait le lien entre chaque élément QuickBooks et son équivalent dans Odoo, et affiche un niveau de confiance :

• Partenaires, par identifiant QuickBooks, numéro de TVA, e‑mail, puis nom
• Produits, par SKU, puis nom
• Comptes et taxes, par identifiant, numéro, nom et type

Une correspondance douteuse vous est soumise pour validation. Vous pouvez l’approuver, choisir un autre compte, en créer un nouveau ou passer la ligne. Les doublons potentiels sont suggérés, jamais fusionnés automatiquement. Les taxes jugées risquées restent bloquées : le connecteur préfère s’arrêter plutôt que de deviner.

Pendant la migration : pièces liées, erreurs sous contrôle

L’import est en cours. Deux questions vous trottent dans la tête : est‑ce que mes pièces restent liées, et que se passe‑t‑il si quelque chose bloque ?

Vos documents gardent leur histoire

Une facture seule ne vous dit pas grand‑chose. Reliée à son devis et à son règlement, elle devient une information exploitable. Le connecteur reconstruit vos documents opérationnels dans Odoo et préserve leurs liens :

• Devis → Facture 
• Facture → Paiement 
• Bon de commande → Facture fournisseur
• Facture fournisseur → Règlement de facture

Un seul paiement qui couvre trois factures ? Un règlement partiel qui traîne depuis le mois dernier ? Les affectations QuickBooks sont reprises à l’identique. Chaque écriture n’est comptabilisée qu’une seule fois.

Un détail utile : QuickBooks Online n’expose pas les commandes clients pour la plupart des entreprises. Vos devis QuickBooks deviennent des devis dans Odoo, et vos factures y sont rattachées.

Une erreur ? Le reste continue d’avancer

Imagine une migration de plusieurs milliers d’enregistrements qui s’effondre à cause d’une seule ligne. Le connecteur élimine ce risque en traitant chaque enregistrement QuickBooks comme une tâche indépendante. Si une tâche échoue, les autres continuent d’avancer.

Pause, reprise, nouvel essai : vous pilotez la file à tout moment. Les tâches bloquées redémarrent automatiquement. Le centre d’erreurs classe les problèmes par type (mapping, dépendances, API, comptabilité) et suggère une action pour chacun. Votre serveur redémarre en pleine migration ? La migration repart exactement où elle s’était arrêtée, car chaque enregistrement conserve son ID QuickBooks.

Le moment de vérité : vos chiffres tombent-ils juste ?

Migrer, c’est bien. Prouver que tout est bien arrivé, c’est mieux. Avant de passer en mode Live, vous lancez la réconciliation. Le connecteur compare Odoo avec les rapports QuickBooks sur cinq points : compte de résultat, bilan, comptes clients, comptes fournisseurs et banques. 

Un écart apparaît ? Vous descendez directement jusqu’aux écritures d’origine. Le module ne force jamais un équilibre artificiel : à vous de corriger le mapping ou de relancer la tâche. Vos chiffres sont justes parce qu’ils le sont vraiment, pas parce que quelqu’un les a ajustés.

Après le passage en mode Live : Odoo aux commandes, QuickBooks dans la boucle

La bascule ne coupe pas le lien. Elle change simplement les rôles. Odoo devient votre ERP opérationnel, et le connecteur continue de le synchroniser avec QuickBooks. Pendant la migration, les données circulent dans un seul sens, de QuickBooks vers Odoo. En mode « Live », la synchronisation incrémentale et les notifications automatiques (webhooks) maintiennent Odoo à jour. Une modification dans QuickBooks déclenche la récupération de l’enregistrement à jour, et pas une simple copie de la notification.

Vous voulez que QuickBooks suive aussi ce qui se passe dans Odoo ? Vous activez l’envoi d’Odoo vers QuickBooks objet par objet. Les documents financiers validés ne partent jamais automatiquement : votre équipe comptable décide de ce qui remonte. Plusieurs filiales ? Chaque connexion relie une société Odoo à une société QuickBooks, avec ses propres correspondances et sa propre file de tâches. Rien ne se mélange. Pour le pilotage, un tableau de bord financier réunit vos revenus, dépenses, créances, dettes et votre trésorerie. Il affiche aussi la progression de la synchronisation, l’état de la connexion et les erreurs ouvertes.