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

Pas juste un simple export 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 paiement. Un compte importé deux fois. Un taux de TVA recréé de travers. 

QuickBooks Online Connector adopte une autre approche. C’est bien un connecteur, mais c’est plus qu’un outil de synchronisation. Il commence par reconstruire votre environnement QuickBooks Online dans Odoo, avec un mapping guidé et une reconstitution comptable sécurisée. Ensuite, il garde les deux systèmes alignés grâce à une synchronisation continue. Le module est conçu pour les équipes comptables. Vous vous connectez, vous vérifiez les correspondances proposées, vous lancez la migration, et le connecteur se charge de la partie technique.

Une règle pilote tout le reste : rien n’entre dans Odoo sans votre accord. Neuf étapes vous amènent de la connexion au mode Production, et vous pouvez revenir à chacune d’entre elles.

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 mapping

Tout commence avant même que le premier enregistrement soit importé. 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 qui vous accompagne. Plan comptable, TVA, conditions de paiement, clients, fournisseurs, articles, devis, factures, paiements, bons de commande, écritures comptables : la plupart des objets sont activés par défaut. Classes, emplacements, pièces jointes et employés attendent votre feu vert. Vous voulez un historique plus léger ? Une plage de dates suffit.

Le mapping, 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 articles. Faut‑il tout reconstruire ? Absolument pas.

L’assistant de correspondance associe chaque élément QuickBooks à son équivalent dans Odoo et affiche un niveau de confiance :

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

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

Pendant la migration : documents liés, erreurs sous contrôle

L’importation est en cours. Deux questions vous viennent à l’esprit : est‑ce que mes documents restent liés, 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 paiement, elle devient une information exploitable. Le connecteur reconstruit vos documents opérationnels dans Odoo et conserve leurs liens :

• Devis → Facture 
• Facture → Paiement 
• Commande fournisseur → Note de frais
• Note de frais → Paiement de note de frais

Un paiement couvre trois factures ? Un paiement partiel en suspens depuis le mois dernier ? Les imputations QuickBooks sont reprises exactement telles quelles. Chaque écriture est comptabilisée une seule fois.

Un détail utile : QuickBooks Online n’expose pas les bons de commande pour la plupart des sociétés. Vos devis QuickBooks deviennent des offres 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’écroule à cause d’une seule ligne. Le connecteur élimine ce risque en traitant chaque enregistrement QuickBooks comme une tâche à part entière. 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 (correspondances, dépendances, API, comptabilité) et propose une action pour chacun. Votre serveur redémarre en pleine migration ? La migration reprend exactement où elle s’était arrêtée, parce que 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 passé, c’est mieux. Avant de passer en mode Live, vous lancez le rapprochement. Le connecteur compare Odoo et les rapports QuickBooks sur cinq points : compte de résultats, bilan, comptes clients, comptes fournisseurs et banque. 

Un écart apparaît ? Vous descendez directement jusqu’aux écritures d’origine. Le module n’impose jamais un équilibrage forcé : à vous de corriger la correspondance ou de relancer la tâche. Vos chiffres sont justes parce qu’ils le sont réellement, 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.