Les factures electròniques formen part de la comptabilitat moderna
La digitalització de la comptabilitat continua avançant. Fa temps que els formats de factura electrònica van molt més enllà d’un fitxer PDF enviat per correu electrònic.
Una autèntica factura electrònica conté dades estructurades que els sistemes de comptabilitat i ERP poden processar automàticament.
Amb el nostre nou projecte de codi obert per a Odoo 19 Community, volem donar resposta precisament a aquesta necessitat.
Hem desenvolupat diverses extensions que posem gratuïtament a disposició de la comunitat d’Odoo.
El projecte està disponible públicament a GitHub:
Odoo 19 Invoice E-Files a GitHub
Ens centrem especialment en Àustria, però una part de la solució també és interessant per a empreses de fora del país.
Tres mòduls per a factures electròniques
Actualment, el projecte consta de tres components principals:
- ebInterface 6.1 per a Àustria
- ZUGFeRD per a factures electròniques
- enviament automàtic a e-Rechnung.gv.at
Així reunim diverses necessitats relacionades amb les factures electròniques en un projecte de codi obert per a Odoo 19 Community.
ebInterface 6.1 – el format de facturació austríac
Un dels eixos del nostre desenvolupament és ebInterface 6.1.
ebInterface és el format estàndard austríac per a factures electròniques estructurades.
El nostre mòdul
l10n_at_ebinterface
genera un XML ebInterface 6.1 a partir d’una factura de client o un abonament d’Odoo.
Entre altres dades, es transfereix la informació rellevant de la factura d’Odoo a l’estructura XML:
- Emissor de la factura
- Destinatari de la factura
- Línies de factura
- Impostos
- Informació de pagament
- Dades bancàries
- Dades de la factura
El fitxer XML generat es vincula directament a la factura.
Per què hem desenvolupat un mòdul propi per fer-ho?
Durant el desenvolupament vam constatar que, actualment, no hi ha cap mòdul del nucli d’Odoo ni de l’OCA per a Odoo 19 Community que implementi l’estàndard natiu austríac ebInterface.
És precisament aquí on volíem intervenir.
En lloc de desenvolupar una solució austríaca només per a la nostra instal·lació, l’hem implementada com un mòdul independent de codi obert.
Així, la resta de la comunitat d’Odoo també se’n pot beneficiar.
ZUGFeRD automàticament amb cada factura
El segon eix del nostre projecte és ZUGFeRD.
ZUGFeRD combina una factura en PDF amb una factura XML estructurada.
El resultat és l’anomenada factura híbrida: les persones poden continuar llegint la factura en PDF, mentre que el programari pot processar automàticament les dades de facturació estructurades que conté.
En principi, Odoo 19 ja incorpora suport per a ZUGFeRD o CII.
A la pràctica, però, hi ha algunes limitacions.
El nostre mòdul
account_invoice_zugferd_ebinterface_auto
actua, per tant, precisament en aquest punt.
ZUGFeRD deixa de ser només una opció
Volíem un procés tan automatitzat com fos possible.
Per això, quan s’envia una factura de client, no es comprova prèviament si aquell client s’ha configurat individualment per utilitzar ZUGFeRD.
En lloc d'això, ZUGFeRD s'utilitza automàticament per a factures de client i abonaments.
A més, l’XML d’ebInterface generat s’inclou com a part de la factura.
Així s’obté un procés complet:
Factura d’Odoo → PDF → factura electrònica estructurada → enviament
sense que l’usuari hagi de fer passos addicionals amb cada factura.
També cobrim mancances d’Odoo 19 Community
Durant el desenvolupament, vam trobar algunes particularitats en la implementació d’Odoo 19.
Entre altres coses, l’exportador CII té dependències que poden causar problemes en instal·lacions que no corresponen a determinats països.
El nostre mòdul resol diverses d’aquestes limitacions pràctiques.
Entre aquestes limitacions hi ha:
- la manca de camps per als períodes d’ingressos diferits
- la restricció de la conversió a PDF/A-3 segons el país
- dades bancàries que falten o no s’han definit en factures existents
L’objectiu és que ZUGFeRD també es pugui utilitzar de manera fiable en empreses amb combinacions de països diferents de les previstes inicialment.
e-Rechnung.gv.at – enviament directe a l’Estat austríac
El tercer component és especialment interessant per a les empreses que facturen a organismes públics.
Amb
l10n_at_erechnung_gv_at
es pot enviar una factura ebInterface directament al servei web austríac e-Rechnung.gv.at.
Així, la simple creació de factures es converteix en un procés automatitzat de facturació electrònica.
Per exemple, el procés pot ser aquest:
Crear la factura a Odoo
↓
Generar l’XML d’ebInterface
↓
Enviar la factura
↓
Enviar automàticament ebInterface a e-Rechnung.gv.at
Així s’integra directament a Odoo un procés que, altrament, seria manual.
Enviament automàtic només per als clients que el necessiten
L’enviament a e-Rechnung.gv.at no s’activa de manera general per a tots els clients.
En lloc d'això, es pot activar en cada client austríac concret.
Per fer-ho, es desen les dades necessàries, com ara
- Número de proveïdor
- Grup de compres / número de sucursal
- Referència de la comanda
a la fitxa del client.
El mòdul també comprova si es compleixen els requisits per activar l’enviament.
Funcionament en proves i en producció
Per a e-Rechnung.gv.at es pot triar entre un entorn de proves i un de producció.
Les credencials d’accés al servei web USP es desen a la configuració d’Odoo.
Així, primer es pot preparar la integració en un entorn de proves abans d’utilitzar-la per enviar factures en producció.
Automatització per estalviar feina
Quan vam desenvolupar la solució, el nostre objectiu no era afegir més botons per al comptable.
Ben al contrari.
La idea és:
Reduir al mínim la feina manual.
Es crea una factura a Odoo.
Els formats estructurats necessaris es generen automàticament.
En enviar la factura, els fitxers corresponents s’hi adjunten automàticament.
A més, en el cas dels clients austríacs configurats adequadament, la factura també es pot enviar automàticament a e-Rechnung.gv.at.
És precisament aquesta automatització la que marca la diferència entre una simple exportació de fitxers i una solució de facturació electrònica realment integrada.
No amaguem els problemes de qualitat de les dades
Ara bé, un altre punt important de la nostra implementació és aquest:
La qualitat d’una factura electrònica depèn de la qualitat de les dades a partir de les quals es genera.
Per això no intentem substituir les dades obligatòries que falten per valors arbitraris sense avisar.
Per exemple, si falta informació obligatòria per a ZUGFeRD o ebInterface, Odoo ha d’avisar l’usuari.
Per exemple:
- país del client sense indicar
- informació fiscal que falta a les línies de factura
- dades bancàries que falten
Des del nostre punt de vista, això és millor que enviar una factura electrònica generada formalment però incorrecta quant al contingut.
Codi obert per a la comunitat d’Odoo
També posem aquest projecte a disposició de tothom gratuïtament i amb codi obert.
Per què?
Perquè nosaltres mateixos ens beneficiem del programari de codi obert.
Odoo Community ofereix una base excel·lent per a l’ERP, la comptabilitat i els processos empresarials. Quan ens falta alguna funció en el dia a dia, la desenvolupem.
I si la solució també pot ser interessant per a altres empreses, la posem a disposició de la comunitat.
Per a nosaltres, això és posar en pràctica la filosofia del codi obert.
Centrat en Àustria, però útil també fora del país
El projecte se centra clarament en Àustria.
ebInterface i e-Rechnung.gv.at són especialment interessants per a les empreses austríaques.
En canvi, la compatibilitat amb ZUGFeRD també és rellevant per a empreses de fora d’Àustria.
Per tant, el projecte no és una solució exclusivament austríaca.
Precisament la combinació de dades de factura estructurades i un document PDF/A-3 generat automàticament també pot ser interessant per a altres instal·lacions d'Odoo.
Per a Odoo 19 Community
Els mòduls s’han desenvolupat per a Odoo 19 Community.
Actualment, el repositori conté:
- l10n_at_ebinterface
- account_invoice_zugferd_ebinterface_auto
- l10n_at_erechnung_gv_at
Els mòduls tenen dependències entre si, de manera que només cal instal·lar els components necessaris per a cada cas d’ús.
La nostra contribució a la comunitat
No considerem aquest projecte un programari comercial acabat, sinó una contribució a l'evolució de l'Odoo Community.
Potser algú només necessita ebInterface.
Potser una altra empresa necessita ZUGFeRD.
Potser una empresa ha d’enviar regularment factures a organismes públics a través d’e-Rechnung.gv.at.
En tots tres casos, el nostre projecte pot servir de base.
I, com que el codi font està disponible obertament, qualsevol usuari pot revisar, adaptar i continuar desenvolupant la solució.
El codi obert vol dir millorar plegats
Estem convençuts que el codi obert ofereix un gran avantatge, especialment en els sistemes ERP.
Les empreses tenen necessitats diferents.
Una solució que funciona perfectament en una empresa pot necessitar adaptacions en una altra.
Amb el codi font obert, això és possible.
Per això agraïm que ens feu arribar:
- Comentaris
- Informes d’errors
- Propostes de millora
- Sol·licituds de fusió
- nous casos d’ús compatibles
Una bona solució comunitària no neix necessàriament amb el primer commit.
Es construeix amb les millores que hi aporten molts usuaris i desenvolupadors.
Utilitzeu el projecte de franc
Tot el codi font està disponible públicament a GitHub:
GitHub – Odoo 19 Invoice E-Files
També hi trobareu la informació d’instal·lació i la documentació de cada mòdul.
Per integrar el servei web austríac e-Rechnung.gv.at, també cal la biblioteca de Python Zeep.
La nostra contribució a un món Odoo obert
Amb aquest projecte volem demostrar que fins i tot els petits desenvolupaments propis poden aportar valor a tota una comunitat.
Inicialment vam desenvolupar els mòduls per donar resposta a necessitats concretes.
Ara posem aquestes solucions gratuïtament a disposició de tots els usuaris d’Odoo 19 Community.
Així, un desenvolupament a mida pot esdevenir una solució per a la comunitat.
Odoo 19. Codi obert. Factures electròniques. Àustria. I de franc per a la comunitat.
Precisament per això hem publicat aquest projecte.