Odoo
Intégration avec le logiciel comptable Odoo pour les clients et les factures
Dernière mise à jour le
La connexion Odoo de Tillor exporte les clients et les factures comptabilisées vers Odoo. Les rapports de paiement vers Odoo suivront dans une prochaine version ; d'ici là, utilisez Admisol si vous voulez transmettre automatiquement les rapports de paiement.
Installation
- Allez dans Paramètres et ouvrez l'App Marketplace.
- Cherchez la carte Odoo et cliquez sur Installer.
- Renseignez d'abord sous Connexion :
- URL Odoo - par exemple
https://mijnbedrijf.odoo.comou simplementmijnbedrijf(Tillor complète alors l'URL.odoo.com) - Nom d'utilisateur - utilisateur ayant accès à l'API
- Clé API - clé API (Odoo : profil utilisateur > clés API)
- URL Odoo - par exemple
- Cliquez sur Continuer vers la base de données. Tillor récupère les bases de données disponibles (ou vous laisse saisir le nom manuellement).
- Choisissez la base sous Base de données et terminez l'installation.
À l'enregistrement, Tillor teste la connexion.
Un seul système comptable actif
Si Admisol et Odoo sont tous deux installés, Tillor utilise Admisol pour l'export (priorité fixe). N'installez Odoo que si vous n'utilisez plus Admisol.
Paramètres comptables (application Odoo)
Après l'installation, vous réglez les paramètres d'export via Paramètres sur l'application Odoo (en plus de l'URL, de la base de données, de l'utilisateur et de la clé API). Tillor récupère en direct depuis Odoo les journaux de ventes et les comptes de produits ; vous les choisissez via un champ de recherche (code et nom).
| Champ dans l'application | Par défaut | Signification |
|---|---|---|
| Code journal des ventes | INV | Journal des ventes dans Odoo portant ce code |
| Compte de produit par défaut | 700000 | Compte de produit utilisé quand la ligne de facture n'a pas de numéro de compte général propre |
| Comptabiliser les factures automatiquement | désactivé | Comptabiliser directement dans Odoo après l'export |
| Joindre le PDF de facture | activé | PDF de la facture Tillor en pièce jointe de la facture Odoo |
| Joindre l'UBL Peppol | activé | UBL Peppol en pièce jointe supplémentaire (uniquement si Tillor a déjà cet UBL) |
Pour chaque ligne de facture, Tillor cherche d'abord un compte Odoo ayant le même code que le numéro de compte général de la ligne ; sinon, il prend le compte de produit par défaut. Pour la TVA, Tillor cherche dans Odoo une TVA de vente avec le même pourcentage que sur la ligne.
Régimes de TVA
Une ligne de facture avec un régime sans TVA, comme l'autoliquidation, a besoin dans Odoo de sa propre TVA de vente : un 0 % ordinaire atterrit dans la mauvaise case de votre déclaration. Indiquez donc dans les paramètres d'export, pour chaque régime que vous utilisez, le nom de la TVA de vente dans Odoo, exactement comme il apparaît dans Odoo sous Comptabilité > Configuration > Taxes (dans un Odoo belge par exemple 0% EU S pour les services dans l'UE). Il y a cinq champs : autoliquidation (services UE), autoliquidation (cocontractant), livraison intracommunautaire, exportation hors UE et exonéré de TVA.
Si le champ d'un régime est vide ou si la TVA n'existe pas dans Odoo, l'export de cette facture s'arrête avec un message d'erreur. Renseignez le nom et renvoyez la facture.
PDF de facture dans Odoo
Avec Joindre le PDF de facture (activé par défaut), Tillor envoie le même PDF que dans Tillor. Lors d'un nouvel export, cela se fait avant la comptabilisation dans Odoo, afin que l'aperçu à droite de la facture puisse être lié. Le nom de fichier suit le numéro de facture Tillor (par ex. INV_2026_0001.pdf). Tillor place aussi ce PDF comme pièce jointe principale de la facture Odoo.
Dans les Événements de la facture Tillor, vous voyez si l'export a réussi, avec le client, la facture, le PDF et l'UBL.
- Si la facture Odoo existe déjà (même référence : le numéro de facture Tillor), Tillor met à jour le client, les lignes, les dates et la référence de paiement. Si la facture était déjà comptabilisée dans Odoo, Tillor la remet d'abord en brouillon, adapte les données et la comptabilise à nouveau lorsque Comptabiliser les factures automatiquement est activé ou que la facture était déjà comptabilisée.
- Ensuite, les pièces jointes PDF et UBL sont remplacées ou ajoutées lorsque ces options sont activées.
- Si l'envoi échoue après la création d'une facture brouillon, cette facture Odoo est supprimée afin qu'un export suivant puisse réessayer.
UBL Peppol dans Odoo
Avec Joindre l'UBL Peppol (activé par défaut), Tillor envoie l'UBL Peppol comme pièce jointe supplémentaire de la facture Odoo. Le nom de fichier suit le numéro de facture Tillor (par ex. INV_2026_0001.xml).
- Tillor ne génère pas d'UBL lui-même : le fichier n'est disponible qu'après une livraison Peppol réussie.
- Si l'UBL n'est pas encore prêt au moment de l'export, Tillor ignore la pièce jointe UBL ; dès que l'UBL arrive, elle est ajoutée à la facture Odoo existante.
- Si l'envoi de l'UBL échoue, l'ensemble de l'export Odoo n'échoue pas (contrairement au PDF). Seule une erreur de PDF sur une nouvelle facture annule le brouillon Odoo.
Factures
- Lors de la comptabilisation ou de la recomptabilisation d'une facture, Tillor exporte automatiquement la facture vers Odoo.
- Manuellement : actions de la facture > export vers la comptabilité (même bouton que pour Admisol).
- Seules les factures au statut Comptabilisé sont exportées.
- S'il existe déjà une facture Odoo avec le même numéro de facture Tillor, aucune seconde facture n'est créée. Tillor met à jour le client, les lignes et les dates sur cette facture (par exemple après un transfert vers un autre client ou une recomptabilisation) et remplace les pièces jointes PDF/UBL lorsque ces options sont activées.
- Si le PDF de la facture change après un paiement (ou un autre montant sur le document), Tillor remplace la pièce jointe PDF existante dans Odoo dès que le nouveau PDF est prêt. Il n'y a pas de seconde facture Odoo et aucun paiement n'est comptabilisé dans Odoo.
Clients
Les clients sont mis à jour ou créés dans Odoo avec le numéro de client Tillor comme référence. Les partenaires existants portant le même numéro sont mis à jour.
Rapports de paiement
L'envoi automatique et manuel des rapports de paiement vers Odoo n'est pas encore disponible. Le processus quotidien de rapport de paiement ignore Odoo sans message d'erreur.
Prérequis dans Odoo
- Journal des ventes avec le code configuré (par défaut
INV) - Comptes généraux dont les codes correspondent aux lignes Tillor ou au compte de produit par défaut
- Facultatif : taux de TVA de vente dans Odoo avec les mêmes pourcentages que dans Tillor