Les factures electròniques formen part de la comptabilitat moderna
La digitalització de la comptabilitat continua avançant. Els formats de factura electrònica són des de fa temps molt més que 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 incidir precisament aquí.
Hem desenvolupat diverses extensions que posem gratuïtament a disposició de l'Odoo Community.
El projecte està disponible públicament a GitHub:
Odoo 19 Invoice E-Files a GitHub
El nostre focus és, sobretot, Àustria, però una part de la solució també resulta interessant per a empreses de fora d'Àustria.
Tres mòduls per a factures electròniques
Actualment el projecte consta de tres components essencials:
- ebInterface 6.1 per a Àustria
- ZUGFeRD per a factures electròniques
- transmissió automàtica a e-Rechnung.gv.at
Així combinem diferents requisits sobre factures electròniques en un únic projecte de codi obert per a Odoo 19 Community.
ebInterface 6.1: el format de factura austríac
Un dels eixos principals 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, a partir d'una factura de client o d'un abonament a Odoo, el corresponent XML d'ebInterface 6.1.
Així, entre altres coses, la informació rellevant de la factura d'Odoo es trasllada 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 s'enllaça directament amb la factura.
Per què hem desenvolupat un mòdul propi per a això?
Durant el desenvolupament hem constatat que, per a Odoo 19 Community, actualment no hi ha cap mòdul del nucli d'Odoo ni cap mòdul d'OCA per a l'estàndard natiu austríac ebInterface.
Precisament aquí volíem incidir.
En lloc de desenvolupar una solució austríaca només per a la nostra pròpia instal·lació, l'hem implementada com a mòdul de codi obert independent.
Així, la resta de la comunitat d'Odoo també se'n pot beneficiar.
ZUGFeRD automàtic 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: per a les persones, la factura continua sent llegible com a PDF, mentre que el programari pot analitzar automàticament les dades estructurades de la factura 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 ja no és només una opció
Volíem un procés tan automatitzat com fos possible.
Per això, en una factura de client enviada no es comprova primer si el client concret ha estat configurat individualment per a 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'adjunta com a part de la factura.
Així s'obté un procés continu:
Factura d'Odoo → PDF → factura electrònica estructurada → enviament
sense que l'usuari hagi de fer passos addicionals a cada factura.
Amb això també tanquem llacunes d'Odoo 19 Community
Durant la implementació ens hem topat amb algunes particularitats de la implementació d'Odoo 19.
Entre d'altres, hi ha dependències a l'exportador CII que poden causar problemes fora de determinades instal·lacions per país.
El nostre mòdul resol diverses d'aquestes limitacions pràctiques.
Entre elles:
- camps que falten per als períodes d'ingressos diferits (deferred revenue)
- la restricció per país de la conversió a PDF/A-3
- dades bancàries inexistents o no definides en factures ja existents
Així, ZUGFeRD ha de poder utilitzar-se de manera fiable també en empreses de fora de les constel·lacions de països previstes originalment.
e-Rechnung.gv.at: transmissió directa a l'Estat austríac
El tercer component és especialment interessant per a les empreses que emeten factures a clients del sector públic.
Amb
l10n_at_erechnung_gv_at
es pot transmetre una factura ebInterface directament al servei web d'e-Rechnung.gv.at austríac.
Així, de la simple creació de factures es passa a un procés de facturació electrònica automatitzat.
El procés pot ser, per exemple, així:
Crear la factura a Odoo
↓
Generar l'XML d'ebInterface
↓
Enviar la factura
↓
Transmetre automàticament l'ebInterface a e-Rechnung.gv.at
Així, un procés que d'altra manera seria manual s'integra directament a Odoo.
Transmissió automàtica només per als clients que ho necessiten
La transmissió a e-Rechnung.gv.at no s'activa de manera generalitzada per a tots els clients.
En lloc d'això, es pot activar en cada client austríac concret.
Per a això es desen les dades necessàries, com ara
- Número de proveïdor
- Grup de compradors / número de sucursal
- Referència de la comanda
al client.
El mòdul també comprova si es compleixen els requisits per a l'activació.
Entorn de proves i de producció
Per a e-Rechnung.gv.at es pot triar entre un entorn de proves i un de producció.
Les dades d'accés al servei web USP es desen a la configuració d'Odoo.
Així, la integració es pot preparar primer en un entorn de proves abans d'utilitzar-la per a l'enviament de factures en producció.
Automatització en lloc de feina addicional
Durant el desenvolupament, el nostre objectiu no era donar més botons al comptable.
Tot el contrari.
La idea és:
La mínima feina manual possible.
Es crea una factura a Odoo.
Els formats estructurats necessaris es generen automàticament.
En enviar-la, els fitxers corresponents s'adjunten automàticament.
I, en els clients austríacs configurats adequadament, la factura es pot transmetre a més, automàticament, a e-Rechnung.gv.at.
Precisament aquesta automatització marca la diferència entre una simple exportació de fitxers i una solució de factura electrònica realment integrada.
La qualitat de les dades no s'amaga sense més
Un punt important de la nostra implementació és, però, també el següent:
Una factura electrònica només pot ser tan bona com les dades a partir de les quals es genera.
Per això no intentem substituir en silenci amb valors qualssevol les dades obligatòries que falten.
Si, per exemple, falta informació obligatòria per a ZUGFeRD o ebInterface, Odoo ha d'avisar-ne l'usuari.
Entre això hi ha, per exemple:
- país que falta al client
- informació fiscal que falta en 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 l'Odoo Community
Aquest projecte també el posem a disposició gratuïtament com a codi obert.
Per què?
Perquè nosaltres mateixos ens beneficiem del programari de codi obert.
Odoo Community ofereix una base excel·lent per a ERP, comptabilitat i processos empresarials. Quan en la feina diària ens falta una funció, 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 codi obert viscut de debò.
Focus austríac, però no només per a Àustria
El projecte té un focus clarament austríac.
ebInterface i e-Rechnung.gv.at són especialment interessants per a empreses austríaques.
El suport de ZUGFeRD, en canvi, també és rellevant per a empreses de fora d'Àustria.
Així, el projecte no és exclusivament una solució 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 depenen els uns dels altres, de manera que, segons el cas d'ús, només cal instal·lar els components necessaris.
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 clients del sector públic mitjançant e-Rechnung.gv.at.
En els tres casos, el nostre projecte pot oferir una base.
I, com que el codi font està obert, qualsevol usuari pot revisar la solució, adaptar-la i continuar desenvolupant-la.
Codi obert vol dir: millorar plegats
Estem convençuts que el codi obert ofereix un gran avantatge, precisament en els sistemes ERP.
Les empreses tenen requisits diferents.
Una solució que funciona perfectament per a una empresa potser s'ha d'adaptar per a una altra.
Amb un codi font obert, això és possible.
Per això agraïm:
- Comentaris
- Informes d'errors (bug reports)
- Suggeriments de millora
- Pull requests
- altres casos d'ús compatibles
Una bona solució comunitària no sorgeix necessàriament amb el primer commit.
Sorgeix gràcies a l'evolució continuada per part de molts usuaris i desenvolupadors.
Utilitzar el projecte gratuïtament
Tot el codi font està disponible públicament a GitHub:
GitHub – Odoo 19 Invoice E-Files
Allà també hi ha la informació d'instal·lació i la documentació de cadascun dels mòduls.
Per a la integració del servei web austríac e-Rechnung.gv.at, cal a més la biblioteca de Python Zeep.
La nostra contribució a un món Odoo obert
Amb aquest projecte volem mostrar que fins i tot els desenvolupaments propis més petits poden crear valor afegit per a tota una comunitat.
Vam desenvolupar els mòduls originalment per resoldre requisits concrets.
Ara posem aquestes solucions gratuïtament a disposició de tots els usuaris d'Odoo 19 Community.
Així, un desenvolupament individual pot esdevenir una solució comunitària.
Odoo 19. Codi obert. Factures electròniques. Àustria. I gratuït per a la comunitat.
Precisament per això hem publicat aquest projecte.