Les factures électroniques font partie de la comptabilité moderne
La numérisation de la comptabilité progresse sans cesse. Les formats de facture électronique sont depuis longtemps bien plus qu'un fichier PDF envoyé par e-mail.
Une véritable facture électronique contient des données structurées qui peuvent être traitées automatiquement par les systèmes de comptabilité et les ERP.
Avec notre nouveau projet open source pour Odoo 19 Community, nous voulons précisément répondre à ce besoin.
Nous avons développé plusieurs extensions que nous mettons gratuitement à la disposition de la communauté Odoo.
Le projet est disponible publiquement sur GitHub :
Odoo 19 Invoice E-Files sur GitHub
Notre priorité va en particulier à l'Autriche, mais une partie de la solution est également intéressante pour les entreprises en dehors de l'Autriche.
Trois modules pour les factures électroniques
Le projet se compose actuellement de trois composants essentiels :
- ebInterface 6.1 pour l'Autriche
- ZUGFeRD pour les factures électroniques
- transmission automatique à e-Rechnung.gv.at
Nous réunissons ainsi différentes exigences liées aux factures électroniques dans un seul projet open source pour Odoo 19 Community.
ebInterface 6.1 – le format de facture autrichien
Un axe majeur de notre développement est ebInterface 6.1.
ebInterface est le format standard autrichien pour les factures électroniques structurées.
Notre module
l10n_at_ebinterface
génère, à partir d'une facture client ou d'un avoir dans Odoo, un XML ebInterface 6.1 correspondant.
Les informations pertinentes de la facture Odoo sont notamment transférées dans la structure XML :
- Émetteur de la facture
- Destinataire de la facture
- Lignes de facture
- Taxes
- Informations de paiement
- Coordonnées bancaires
- Données de facturation
Le fichier XML généré est directement associé à la facture.
Pourquoi avons-nous développé notre propre module pour cela ?
Lors du développement, nous avons constaté qu'il n'existe actuellement, pour Odoo 19 Community, aucun module du noyau Odoo ni module OCA correspondant pour la norme ebInterface native autrichienne.
C'est précisément là que nous voulions agir.
Plutôt que de développer une solution autrichienne uniquement pour notre propre installation, nous l'avons réalisée sous forme de module open source autonome.
Le reste de la communauté Odoo peut ainsi en profiter également.
ZUGFeRD automatiquement avec chaque facture
Le deuxième axe de notre projet est ZUGFeRD.
ZUGFeRD combine une facture PDF avec une facture XML structurée.
Le résultat est ce que l'on appelle une facture hybride : pour l'humain, la facture reste lisible au format PDF, tandis qu'un logiciel peut exploiter automatiquement les données de facturation structurées qu'elle contient.
Odoo 19 prend déjà en charge ZUGFeRD ou CII en principe.
Dans la pratique, il existe cependant certaines limitations.
Notre module
account_invoice_zugferd_ebinterface_auto
intervient donc précisément à cet endroit.
ZUGFeRD n'est plus seulement une option
Nous voulions un processus aussi automatisé que possible.
Pour une facture client envoyée, on ne vérifie donc pas d'abord si le client concerné a été configuré individuellement pour ZUGFeRD.
À la place, ZUGFeRD est utilisé automatiquement pour les factures clients et les avoirs.
En outre, le XML ebInterface généré est joint comme élément de la facture.
Il en résulte un processus continu :
Facture Odoo → PDF → facture électronique structurée → envoi
sans que l'utilisateur ait à effectuer des étapes supplémentaires pour chaque facture.
Nous comblons aussi des lacunes dans Odoo 19 Community
Lors de la mise en œuvre, nous avons rencontré quelques particularités dans l'implémentation d'Odoo 19.
Il existe notamment des dépendances dans l'exportateur CII qui peuvent causer des problèmes en dehors de certaines installations spécifiques à un pays.
Notre module corrige plusieurs de ces limitations pratiques.
Cela comprend notamment :
- des champs manquants pour les périodes de produits constatés d'avance (Deferred Revenue)
- la restriction par pays de la conversion PDF/A-3
- des coordonnées bancaires manquantes ou non renseignées sur les factures existantes
ZUGFeRD doit ainsi pouvoir être utilisé de manière fiable aussi par les entreprises situées en dehors des configurations nationales initialement prévues.
e-Rechnung.gv.at – transmission directe à l'État autrichien
Le troisième composant est particulièrement intéressant pour les entreprises qui facturent des donneurs d'ordre publics.
Avec
l10n_at_erechnung_gv_at
une facture ebInterface peut être transmise directement au service web e-Rechnung.gv.at autrichien.
La simple création de factures devient ainsi un processus de facturation électronique automatisé.
Le déroulement peut par exemple se présenter ainsi :
Créer la facture dans Odoo
↓
Générer le XML ebInterface
↓
Envoyer la facture
↓
Transmettre automatiquement l'ebInterface à e-Rechnung.gv.at
Un processus autrement manuel est ainsi directement intégré dans Odoo.
Transmission automatique uniquement pour les clients concernés
La transmission à e-Rechnung.gv.at n'est pas activée de manière générale pour tous les clients.
Elle peut en revanche être activée pour chaque client autrichien concerné.
Pour cela, les informations nécessaires, par exemple
- numéro de fournisseur
- groupe d'acheteurs / numéro de filiale
- référence de commande
sont enregistrées sur la fiche du client.
Le module vérifie également si les conditions d'activation sont remplies.
Mode test et mode production
Pour e-Rechnung.gv.at, il est possible de choisir entre un environnement de test et un environnement de production.
Les identifiants d'accès au service web USP sont enregistrés dans les paramètres d'Odoo.
L'intégration peut ainsi d'abord être préparée dans un environnement de test avant d'être utilisée pour l'envoi de factures en production.
De l'automatisation plutôt que du travail supplémentaire
Notre objectif lors du développement n'était pas de donner davantage de boutons au comptable.
Bien au contraire.
L'idée est la suivante :
Le moins de travail manuel possible.
Une facture est créée dans Odoo.
Les formats structurés nécessaires sont générés automatiquement.
Lors de l'envoi, les fichiers correspondants sont joints automatiquement.
Et pour les clients autrichiens configurés en conséquence, la facture peut en outre être transmise automatiquement à e-Rechnung.gv.at.
C'est précisément cette automatisation qui fait la différence entre une simple exportation de fichiers et une véritable solution de facturation électronique intégrée.
La qualité des données n'est pas simplement masquée
Un point important de notre implémentation est toutefois aussi le suivant :
Une facture électronique ne peut être aussi bonne que les données à partir desquelles elle est générée.
C'est pourquoi nous ne cherchons pas à remplacer silencieusement des mentions obligatoires manquantes par des valeurs quelconques.
Si, par exemple, des informations obligatoires pour ZUGFeRD ou ebInterface sont manquantes, Odoo doit en avertir l'utilisateur.
Cela comprend par exemple :
- pays manquant chez le client
- informations fiscales manquantes sur les lignes de facture
- coordonnées bancaires manquantes
À notre avis, c'est préférable à l'envoi d'une facture électronique formellement générée mais dont le contenu est erroné.
Open source pour la communauté Odoo
Ce projet aussi, nous le mettons à disposition gratuitement en open source.
Pourquoi ?
Parce que nous profitons nous-mêmes des logiciels open source.
Odoo Community offre une excellente base pour l'ERP, la comptabilité et les processus d'entreprise. Lorsqu'il nous manque une fonction dans notre travail quotidien, nous la développons.
Et si la solution peut aussi intéresser d'autres entreprises, nous la mettons à la disposition de la communauté.
Pour nous, c'est de l'open source vécu.
Priorité à l'Autriche – mais pas uniquement pour l'Autriche
Le projet a une orientation clairement autrichienne.
ebInterface et e-Rechnung.gv.at sont intéressants en particulier pour les entreprises autrichiennes.
La prise en charge de ZUGFeRD, en revanche, est également pertinente pour les entreprises en dehors de l'Autriche.
Le projet n'est donc pas exclusivement une solution autrichienne.
C'est précisément la combinaison de données de facturation structurées et d'un document PDF/A-3 généré automatiquement qui peut aussi être intéressante pour d'autres installations Odoo.
Pour Odoo 19 Community
Les modules ont été développés pour Odoo 19 Community.
Le dépôt contient actuellement :
- l10n_at_ebinterface
- account_invoice_zugferd_ebinterface_auto
- l10n_at_erechnung_gv_at
Les modules dépendent les uns des autres, de sorte que, selon le cas d'usage, seuls les composants nécessaires doivent être installés.
Notre contribution à la communauté
Nous ne voyons pas ce projet comme un logiciel commercial abouti, mais comme une contribution à l'évolution de la communauté Odoo.
Peut-être que quelqu'un n'a besoin que d'ebInterface.
Peut-être qu'une autre entreprise a besoin de ZUGFeRD.
Peut-être qu'une entreprise doit envoyer régulièrement des factures à des donneurs d'ordre publics via e-Rechnung.gv.at.
Dans ces trois cas, notre projet peut offrir une base.
Et comme le code source est ouvertement disponible, chaque utilisateur peut examiner la solution, l'adapter et la faire évoluer.
Open source, c'est progresser ensemble
Nous sommes convaincus que l'open source offre un grand avantage, en particulier pour les systèmes ERP.
Les entreprises ont des exigences différentes.
Une solution qui fonctionne parfaitement pour une entreprise doit peut-être être adaptée pour une autre.
Avec un code source ouvert, c'est possible.
C'est pourquoi nous accueillons volontiers :
- des retours
- des rapports de bugs
- des suggestions d'amélioration
- des pull requests
- d'autres cas d'usage pris en charge
Une bonne solution communautaire ne naît pas forcément dès le premier commit.
Elle naît de l'évolution continue assurée par de nombreux utilisateurs et développeurs.
Utiliser le projet gratuitement
L'intégralité du code source est disponible publiquement sur GitHub :
GitHub – Odoo 19 Invoice E-Files
Vous y trouverez également les informations d'installation et la documentation de chacun des modules.
Pour l'intégration du service web autrichien e-Rechnung.gv.at, la bibliothèque Python Zeep est en outre nécessaire.
Notre contribution à un monde Odoo ouvert
Avec ce projet, nous souhaitons montrer que même de petits développements internes peuvent apporter une valeur ajoutée à toute une communauté.
Nous avons développé les modules à l'origine pour répondre à des besoins concrets.
Nous mettons maintenant ces solutions gratuitement à la disposition de tous les utilisateurs d'Odoo 19 Community.
Un développement individuel peut ainsi devenir une solution communautaire.
Odoo 19. Open source. Factures électroniques. Autriche. Et gratuit pour la communauté.
C'est précisément pour cela que nous avons publié ce projet.