Elektronické faktúry patria k modernému účtovníctvu
Digitalizácia účtovníctva napreduje. Formáty elektronických faktúr sú pritom už dávno viac než len súbor PDF odoslaný e-mailom.
Skutočná elektronická faktúra obsahuje štruktúrované dáta, ktoré môžu účtovné a ERP systémy automaticky spracovať.
Naším novým open source projektom pre Odoo 19 Community chceme nadviazať práve tu.
Vyvinuli sme niekoľko rozšírení, ktoré komunite Odoo poskytujeme bezplatne.
Projekt je verejne dostupný na GitHube:
Odoo 19 Invoice E-Files na GitHube
Naše zameranie je predovšetkým na Rakúsko, ale časť riešenia je zaujímavá aj pre firmy mimo Rakúska.
Tri moduly pre elektronické faktúry
Projekt v súčasnosti pozostáva z troch základných komponentov:
- ebInterface 6.1 pre Rakúsko
- ZUGFeRD pre elektronické faktúry
- automatické odosielanie na e-Rechnung.gv.at
Tým spájame rôzne požiadavky týkajúce sa elektronických faktúr v jednom open source projekte pre Odoo 19 Community.
ebInterface 6.1 – rakúsky formát faktúr
Jedným z hlavných bodov nášho vývoja je ebInterface 6.1.
ebInterface je rakúsky štandardný formát pre štruktúrované elektronické faktúry.
Náš modul
l10n_at_ebinterface
vytvára z odberateľskej faktúry, resp. dobropisu v Odoo zodpovedajúci súbor XML ebInterface 6.1.
Pritom sa do štruktúry XML prenášajú okrem iného relevantné informácie z faktúry Odoo:
- Vystaviteľ faktúry
- Príjemca faktúry
- Položky faktúry
- Dane
- Platobné údaje
- Bankové spojenie
- Údaje o faktúre
Vytvorený súbor XML sa pritom priamo prepojí s faktúrou.
Prečo sme na to vyvinuli vlastný modul?
Pri vývoji sme zistili, že pre Odoo 19 Community momentálne nie je k dispozícii zodpovedajúci modul jadra Odoo ani modul OCA pre rakúsky natívny štandard ebInterface.
Práve tu sme chceli nadviazať.
Namiesto toho, aby sme rakúske riešenie vyvíjali len pre našu vlastnú inštaláciu, realizovali sme ho ako samostatný open source modul.
Vďaka tomu z neho môže profitovať aj zvyšok komunity Odoo.
ZUGFeRD automaticky s každou faktúrou
Druhým ťažiskom nášho projektu je ZUGFeRD.
ZUGFeRD kombinuje faktúru vo formáte PDF so štruktúrovanou faktúrou vo formáte XML.
Výsledkom je takzvaná hybridná faktúra: Pre človeka zostáva faktúra čitateľná ako PDF, zatiaľ čo softvér dokáže obsiahnuté štruktúrované údaje faktúry automaticky vyhodnotiť.
Odoo 19 už v základe prináša podporu pre ZUGFeRD, resp. CII.
V praxi však existuje niekoľko obmedzení.
Náš modul
account_invoice_zugferd_ebinterface_auto
preto nadväzuje práve tu.
ZUGFeRD už nie len ako možnosť
Chceli sme čo najviac automatizovaný priebeh.
Pri odoslanej odberateľskej faktúre sa preto najprv nekontroluje, či je príslušný zákazník individuálne nakonfigurovaný pre ZUGFeRD.
Namiesto toho sa ZUGFeRD pre odberateľské faktúry a dobropisy používa automaticky.
Okrem toho sa vytvorený XML ebInterface pridá ako súčasť faktúry.
Vzniká tak súvislý proces:
Faktúra Odoo → PDF → štruktúrovaná e-faktúra → odoslanie
bez toho, aby musel používateľ pri každej faktúre vykonávať ďalšie kroky.
Zapĺňame pritom aj medzery v Odoo 19 Community
Pri realizácii sme narazili na niektoré zvláštnosti v implementácii Odoo 19.
Okrem iného existujú v exportéri CII závislosti, ktoré môžu mimo určitých krajinských inštalácií spôsobovať problémy.
Náš modul pritom odstraňuje viaceré z týchto praktických obmedzení.
Patria sem okrem iného:
- chýbajúce polia pre obdobia odložených výnosov (Deferred Revenue)
- obmedzenie konverzie PDF/A-3 podľa krajiny
- chýbajúce, resp. nenastavené bankové spojenia pri existujúcich faktúrach
Vďaka tomu sa má ZUGFeRD dať spoľahlivo používať aj vo firmách mimo pôvodne plánovaných krajinských konštelácií.
e-Rechnung.gv.at – priame odoslanie rakúskemu štátu
Tretia súčasť je zaujímavá najmä pre firmy, ktoré vystavujú faktúry verejným objednávateľom.
S modulom
l10n_at_erechnung_gv_at
je možné odoslať faktúru ebInterface priamo na rakúsku webovú službu e-Rechnung.gv.at.
Z čistého vystavovania faktúr sa tak stáva automatizovaný proces elektronickej fakturácie.
Priebeh môže vyzerať napríklad takto:
Vytvoriť faktúru v Odoo
↓
Vytvoriť XML ebInterface
↓
Odoslať faktúru
↓
Automaticky odoslať ebInterface na e-Rechnung.gv.at
Inak manuálny proces sa tak priamo integruje do Odoo.
Automatické odosielanie len pre potrebných zákazníkov
Odosielanie na e-Rechnung.gv.at sa neaktivuje paušálne pre každého zákazníka.
Namiesto toho ho možno aktivovať pri príslušnom rakúskom zákazníkovi.
Potrebné údaje, ako napríklad
- Číslo dodávateľa
- Skupina nákupcov / číslo pobočky
- Referencia objednávky
sa na tento účel uložia pri zákazníkovi.
Modul pritom kontroluje aj to, či sú splnené predpoklady na aktiváciu.
Testovacia a produkčná prevádzka
Pre e-Rechnung.gv.at je možné zvoliť medzi testovacím a produkčným prostredím.
Prístupové údaje k webovej službe USP sa ukladajú v nastaveniach Odoo.
Integráciu tak možno najprv pripraviť v testovacom prostredí, než sa nasadí do produkčného odosielania faktúr.
Automatizácia namiesto ďalšej práce
Naším cieľom pri vývoji nebolo dať účtovníkovi ďalšie tlačidlá.
Naopak.
Myšlienka je:
Čo najmenej manuálnej práce.
Faktúra sa vytvorí v Odoo.
Potrebné štruktúrované formáty sa vygenerujú automaticky.
Pri odoslaní sa príslušné súbory automaticky pripoja.
A pri zodpovedajúco nakonfigurovaných rakúskych zákazníkoch možno faktúru navyše automaticky odoslať na e-Rechnung.gv.at.
Práve táto automatizácia robí rozdiel medzi jednoduchým exportom súborov a skutočne integrovaným riešením pre elektronickú fakturáciu.
Kvalita údajov sa jednoducho neskrýva
Dôležitým bodom našej implementácie je však aj toto:
Elektronická faktúra môže byť len taká dobrá, aké sú údaje, z ktorých vzniká.
Preto sa nesnažíme chýbajúce povinné údaje potichu nahrádzať akýmikoľvek hodnotami.
Ak napríklad chýbajú povinné informácie pre ZUGFeRD alebo ebInterface, má na to Odoo používateľa upozorniť.
Patria sem napríklad:
- chýbajúca krajina pri zákazníkovi
- chýbajúce daňové informácie na položkách faktúry
- chýbajúce bankové spojenie
Z nášho pohľadu je to lepšie, než odoslať formálne vytvorenú, ale obsahovo nesprávnu elektronickú faktúru.
Open source pre komunitu Odoo
Aj tento projekt poskytujeme bezplatne ako open source.
Prečo?
Pretože sami profitujeme z open source softvéru.
Odoo Community ponúka vynikajúci základ pre ERP, účtovníctvo a podnikové procesy. Ak nám pri každodennej práci nejaká funkcia chýba, vyvinieme ju.
A ak môže byť riešenie zaujímavé aj pre iné firmy, poskytneme ho komunite.
Pre nás je to žitý open source.
Rakúske zameranie – ale nielen pre Rakúsko
Projekt má jasné rakúske ťažisko.
ebInterface a e-Rechnung.gv.at sú zaujímavé najmä pre rakúske firmy.
Podpora ZUGFeRD je naproti tomu relevantná aj pre firmy mimo Rakúska.
Projekt tak nie je výlučne rakúskym riešením.
Práve kombinácia štruktúrovaných údajov faktúry a automaticky vytvoreného dokumentu PDF/A-3 môže byť zaujímavá aj pre iné inštalácie Odoo.
Pre Odoo 19 Community
Moduly boli vyvinuté pre Odoo 19 Community.
Repozitár v súčasnosti obsahuje:
- l10n_at_ebinterface
- account_invoice_zugferd_ebinterface_auto
- l10n_at_erechnung_gv_at
Moduly sú navzájom závislé, takže podľa prípadu použitia stačí nainštalovať len potrebné komponenty.
Náš príspevok komunite
Tento projekt nevnímame ako hotový komerčný softvér, ale ako príspevok k ďalšiemu rozvoju komunity Odoo.
Možno niekto potrebuje len ebInterface.
Možno iná firma potrebuje ZUGFeRD.
Možno musí firma pravidelne posielať faktúry verejným objednávateľom cez e-Rechnung.gv.at.
V každom z týchto troch prípadov môže náš projekt poskytnúť základ.
A keďže je zdrojový kód voľne dostupný, každý používateľ môže riešenie preskúmať, upraviť a ďalej rozvíjať.
Open source znamená: spoločne sa zlepšovať
Sme presvedčení, že open source prináša najmä pri ERP systémoch veľkú výhodu.
Firmy majú rôzne požiadavky.
Riešenie, ktoré perfektne funguje pre jednu firmu, treba možno pre inú upraviť.
S otvoreným zdrojovým kódom je to možné.
Preto sa tešíme z:
- Spätná väzba
- Hlásenia chýb
- Návrhy na zlepšenie
- Pull Requests
- ďalšie podporované prípady použitia
Dobré komunitné riešenie nevzniká nevyhnutne pri prvom commite.
Vzniká ďalším rozvojom mnohými používateľmi a vývojármi.
Používajte projekt bezplatne
Kompletný zdrojový kód je verejne dostupný na GitHube:
GitHub – Odoo 19 Invoice E-Files
Nachádzajú sa tam aj informácie o inštalácii a dokumentácia jednotlivých modulov.
Na integráciu rakúskej webovej služby e-Rechnung.gv.at je navyše potrebná knižnica Pythonu Zeep.
Náš príspevok k otvorenému svetu Odoo
Týmto projektom chceme ukázať, že aj menšie vlastné vývojové práce môžu priniesť pridanú hodnotu celej komunite.
Moduly sme pôvodne vyvinuli na riešenie konkrétnych požiadaviek.
Teraz tieto riešenia bezplatne poskytujeme všetkým používateľom komunity Odoo 19.
Z individuálneho vývoja tak môže vzniknúť komunitné riešenie.
Odoo 19. Open source. Elektronické faktúry. Rakúsko. A bezplatne pre komunitu.
Práve preto sme tento projekt zverejnili.