This module is an extension of the module account_invoice_import to add the ability to import UBL XML invoices. The UBL (Universal Business Language) standard is a XML standard for business documents (invoices, purchase orders, etc...) created by OASIS (Organization for the Advancement of Structured Information Standards). The UBL standard became the ISO/IEC 19845 standard in December 2015 (cf the official announce _).
This module works well with e-fff invoices as used in Belgium (e-fff invoices are UBL invoices with an embedded PDF file).
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Lets you import supplier invoices and refunds received as UBL XML files (or PDFs containing a UBL XML attachment) directly into Odoo, creating vendor bills with lines, taxes and attachments.
This module extends the invoice import wizard so it can read UBL XML files, the international standard for electronic business documents (ISO/IEC 19845). When you import a supplier invoice file, Odoo recognises the UBL format and fills in the vendor bill automatically.
What it reads from the file: - Supplier and customer identification (including VAT number and electronic address) - Invoice number, invoice date, due date and the supplier's order reference - Currency, untaxed total, tax-inclusive total and payable amount - Invoice lines with product, description, quantity, unit of measure, unit price, line subtotal and taxes - Payment information: IBAN and BIC when the payment means code is 31 - Embedded attachments referenced in the file, which are added to the bill
Business rules it applies: - Only documents whose type code is 380 (invoice) or 381 (refund) are accepted; other UBL document types are rejected with an error message. - A refund type code creates a vendor refund instead of a vendor bill. - The XML is validated against the UBL schema before import. - If the global line total does not match the sum of the line amounts, a warning is logged (small rounding differences are tolerated).
It works inside the existing invoice import wizard and adds UBL to the list of supported formats shown there. It relies on the account.invoice.import and base.ubl models.
Depends on
Models and fields (1)
- account.invoice.import · new model
Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 3 confirmed, 6 with no information of 9 versions.
Sources · Odoo 12.0
Confirmed on 2026-11-03 in branch 12.0 of OCA/edi.
terminal Installation and usage
OCA documentation · Odoo 16.0Configuration
Source · Odoo 16.0There is no configuration specific to this module. Please refer to the configuration section of the modules account_invoice_import and account_tax_unece.
Usage
Source · Odoo 16.0Refer to the usage section of the module account_invoice_import.
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.