Преминете към съдържание

Електронни фактури в Odoo 19: ebInterface, ZUGFeRD и e-Rechnung.gv.at безплатно за общността

5 септември 2026 г. от
Електронни фактури в Odoo 19: ebInterface, ZUGFeRD и e-Rechnung.gv.at безплатно за общността
Alexander Biringer | Biricon IT Services GmbH

Електронните фактури са част от съвременното счетоводство

Дигитализацията на счетоводството продължава да напредва. Електронните формати за фактури отдавна са много повече от PDF файл, изпратен по имейл.

Истинската електронна фактура съдържа структурирани данни, които счетоводните и ERP системите могат да обработват автоматично.

Именно върху това искаме да работим с новия си проект с отворен код за Odoo 19 Community.

Разработихме няколко разширения, които предоставяме безплатно на общността на Odoo.

Проектът е публично достъпен в GitHub:

Odoo 19 Invoice E-Files в GitHub

Основният ни фокус е върху Австрия, но част от решението е полезна и за предприятия извън нея.

Три модула за електронни фактури

В момента проектът се състои от три основни компонента:

  • ebInterface 6.1 за Австрия
  • ZUGFeRD за електронни фактури
  • автоматично изпращане до e-Rechnung.gv.at

Така обединяваме различни изисквания към електронните фактури в един проект с отворен код за Odoo 19 Community.

ebInterface 6.1 – австрийският формат за фактури

Едно от основните направления в нашата разработка е ebInterface 6.1.

ebInterface е австрийският стандартен формат за структурирани електронни фактури.

Нашият модул

l10n_at_ebinterface

генерира съответния ebInterface-6.1-XML от клиентска фактура или кредитно известие в Odoo.

В XML структурата се прехвърля съответната информация от фактурата в Odoo, включително:

  • Издател на фактурата
  • Получател на фактурата
  • Редове на фактурата
  • Данъци
  • Информация за плащането
  • Банкови данни
  • Данни за фактурата

Генерираният XML файл се свързва директно с фактурата.

Защо разработихме собствен модул за това?

По време на разработката установихме, че за Odoo 19 Community в момента няма подходящ модул в ядрото на Odoo или модул на OCA за австрийския стандарт ebInterface.

Именно тук искахме да допринесем.

Вместо да разработим решение за Австрия само за собствената си инсталация, го реализирахме като самостоятелен модул с отворен код.

Така и останалата част от общността на Odoo може да се възползва от него.

ZUGFeRD автоматично с всяка фактура

Второто основно направление в нашия проект е ZUGFeRD.

ZUGFeRD съчетава PDF фактура със структурирана XML фактура.

Резултатът е т.нар. хибридна фактура: хората могат да я четат като PDF, а софтуерът може автоматично да обработва съдържащите се в нея структурирани данни.

Odoo 19 по принцип вече включва поддръжка на ZUGFeRD, респ. CII.

На практика обаче има някои ограничения.

Нашият модул

account_invoice_zugferd_ebinterface_auto

е насочен именно към това.

ZUGFeRD вече не е само опция

Искахме процесът да бъде възможно най-автоматизиран.

Затова при изпращане на клиентска фактура не се проверява предварително дали съответният клиент е конфигуриран индивидуално за ZUGFeRD.

Вместо това ZUGFeRD се използва автоматично за клиентските фактури и кредитните известия.

Освен това генерираният ebInterface-XML се включва като част от фактурата.

Така се получава цялостен процес:

Фактура в Odoo → PDF → структурирана електронна фактура → изпращане

без потребителят да трябва да извършва допълнителни стъпки за всяка фактура.

Запълваме и пропуски в Odoo 19 Community

По време на разработката се сблъскахме с някои особености в реализацията на Odoo 19.

Наред с другото, в модула за експорт в CII има зависимости, които могат да причинят проблеми при инсталации с локализации за държави извън определен набор.

Нашият модул отстранява няколко от тези практически ограничения.

Сред тях са:

  • липсващи полета за периодите на приходите за бъдещи периоди
  • ограничаването на конвертирането в PDF/A-3 според държавата
  • липсващи или непосочени банкови данни в съществуващи фактури

Целта е ZUGFeRD да може да се използва надеждно и от предприятия извън първоначално предвидените комбинации от държави.

e-Rechnung.gv.at – директно изпращане до австрийската държава

Третият компонент е особено полезен за предприятия, които издават фактури на публични възложители.

С

l10n_at_erechnung_gv_at

фактура във формат ebInterface може да се изпрати директно до австрийската уеб услуга e-Rechnung.gv.at.

Така обикновеното създаване на фактури се превръща в автоматизиран процес на електронно фактуриране.

Процесът може да изглежда например така:

Създаване на фактура в Odoo

↓

Генериране на ebInterface XML

↓

Изпращане на фактурата

↓

Автоматично изпращане на ebInterface до e-Rechnung.gv.at

Така процес, който иначе се извършва ръчно, се интегрира директно в Odoo.

Автоматично изпращане само за клиентите, за които е необходимо

Изпращането до e-Rechnung.gv.at не се активира по подразбиране за всички клиенти.

Вместо това то може да се активира за съответния австрийски клиент.

За целта необходимите данни, като например

  • Номер на доставчика
  • Група за покупки / номер на филиала
  • Референция на поръчката

се записват в данните на клиента.

Модулът също така проверява дали са изпълнени условията за активиране.

Тестов и продукционен режим

За e-Rechnung.gv.at може да се избира между тестова и продукционна среда.

Данните за достъп до уеб услугата USP се въвеждат в настройките на Odoo.

Така интеграцията може първо да се подготви в тестова среда, преди да започне да се използва за реално изпращане на фактури.

Автоматизация вместо допълнителна работа

При разработката целта ни не беше да добавим още бутони за счетоводителя.

Напротив.

Идеята е:

Възможно най-малко ръчна работа.

В Odoo се създава фактура.

Необходимите структурирани формати се генерират автоматично.

При изпращане съответните файлове се прикачват автоматично.

А за австрийските клиенти със съответните настройки фактурата може допълнително да се изпраща автоматично до e-Rechnung.gv.at.

Именно тази автоматизация отличава обикновения експорт на файлове от едно наистина интегрирано решение за електронно фактуриране.

Проблемите с качеството на данните не се прикриват

Важен момент в нашата имплементация е обаче и следното:

Качеството на електронната фактура зависи от качеството на данните, от които е създадена.

Затова не се опитваме да заместваме липсващите задължителни данни с произволни стойности, без да уведомим потребителя.

Ако например липсва задължителна информация за ZUGFeRD или ebInterface, Odoo трябва да уведоми потребителя.

Такива са например:

  • липсваща държава в данните на клиента
  • липсваща данъчна информация в редовете на фактурата
  • липсващи банкови данни

Според нас това е по-добре, отколкото да изпратим електронна фактура, която е формално генерирана, но съдържа неверни данни.

Отворен код за общността на Odoo

Предоставяме и този проект безплатно с отворен код.

Защо?

Защото и ние самите се възползваме от софтуера с отворен код.

Odoo Community предлага отлична основа за ERP, счетоводство и бизнес процеси. Когато в ежедневната ни работа липсва дадена функция, я разработваме.

А когато решението може да бъде полезно и за други предприятия, го предоставяме на общността.

За нас това е отвореният код на практика.

С фокус върху Австрия, но не само за Австрия

Проектът е насочен предимно към Австрия.

ebInterface и e-Rechnung.gv.at са от интерес най-вече за австрийските предприятия.

Поддръжката на ZUGFeRD обаче е релевантна и за фирми извън Австрия.

Така проектът не се ограничава до решение само за Австрия.

Именно комбинацията от структурирани данни за фактурата и автоматично генериран документ PDF/A-3 може да бъде полезна и за други инсталации на Odoo.

За Odoo 19 Community

Модулите са разработени за Odoo 19 Community.

В момента хранилището съдържа:

  • l10n_at_ebinterface
  • account_invoice_zugferd_ebinterface_auto
  • l10n_at_erechnung_gv_at

Модулите имат зависимости помежду си, така че според конкретния случай е необходимо да се инсталират само нужните компоненти.

Нашият принос към общността

Разглеждаме този проект не като завършен търговски софтуер, а като принос към развитието на общността на Odoo.

Някой може да се нуждае само от ebInterface.

Друго предприятие може да се нуждае от ZUGFeRD.

Може би дадено предприятие трябва редовно да изпраща фактури на публични възложители чрез e-Rechnung.gv.at.

И в трите случая нашият проект може да послужи за основа.

А тъй като изходният код е свободно достъпен, всеки потребител може да преглежда, адаптира и доразвива решението.

Отвореният код означава да се усъвършенстваме заедно

Убедени сме, че отвореният код предлага голямо предимство именно при ERP системите.

Предприятията имат различни изисквания.

Решение, което работи отлично за едно предприятие, може да се нуждае от адаптиране за друго.

Отвореният изходен код прави това възможно.

Затова ще се радваме да получим:

  • обратна връзка
  • сигнали за грешки
  • предложения за подобрения
  • заявки за включване на промени (pull requests)
  • поддръжка на допълнителни случаи на употреба

Доброто решение за общността невинаги се появява още с първия commit.

То се изгражда с приноса на много потребители и разработчици, които го доразвиват.

Използвайте проекта безплатно

Целият изходен код е публично достъпен в GitHub:

GitHub – Odoo 19 Invoice E-Files

Там ще намерите и информация за инсталирането, както и документацията за отделните модули.

За интеграцията с австрийската уеб услуга e-Rechnung.gv.at е необходима и библиотеката за Python Zeep.

Нашият принос към един отворен свят на Odoo

С този проект искаме да покажем, че дори малки собствени разработки могат да бъдат полезни за цяла общност.

Първоначално разработихме модулите, за да отговорим на конкретни изисквания.

Сега предоставяме тези решения безплатно на всички потребители на Odoo 19 Community.

Така една индивидуална разработка може да се превърне в решение за цялата общност.

Odoo 19. Отворен код. Електронни фактури. Австрия. И безплатно за общността.

Именно затова публикувахме този проект.

Да разработваме заедно, вместо да дублираме усилията си.

Към проекта в GitHub