Who has to use it
Article 299-B of the Public Contracts Code, added by Decree-Law 111-B/2017 of 31 August, which transposes Directive 2014/55/EU, obliges contractors to issue electronic invoices. Public bodies have had to accept them since 18 April 2019, and some only since 18 April 2020 (Decree-Law 123/2018 of 28 December). Large companies are already obliged. For small, medium and micro companies, the transitional regime of article 9(4) of Decree-Law 111-B/2017 was extended to 31 December 2026 by Law 73-A/2025 (State Budget for 2026, article 260(2)): the obligation starts on 1 January 2027, as eSPap's FAQ confirms.
The State Budget proposal for 2027 (article 138(2)), approved in general on 28 October 2026 and not yet through its final overall vote, would postpone the SME deadline, to 31 December 2027. It only counts once published in the Diário da República.
The legal basis of the format is Portaria 289/2019, and CIUS-PT version 2.1.1, of 26 February 2021, is in eSPap's technical standards.
CIUS-PT's own rules
The official CIUS-PT 2.1.1 Schematron adds its own rules to those of EN 16931. These are some that the module meets on an invoice made in Odoo:
| Rule | What it requires |
|---|---|
| BR-CIUS-PT-01 and -03 | Seller and buyer VAT numbers with the country prefix (PT…) |
| BR-CIUS-PT-66 | A delivery address |
| BR-CIUS-PT-17 | An exempt line carries its exemption reason as an item property |
| BR-CIUS-PT-65 | A credit or debit note carries the reference of the preceding invoice |
| UC027 | ATCUD in BT-18 with schemeID "ANG" and the QR code in BT-125, in base64 |
In Odoo, with CIUS-PT & ATCUD
Odoo 17 to 20 have no CIUS-PT generator. In the CIUS-PT & ATCUD module, every issued invoice has a "CIUS-PT XML" button: it builds the UBL 2.1 file with the CustomizationID urn:cen.eu:en16931:2017#compliant#urn:feap.gov.pt:CIUS-PT:2.1.1, the Portuguese document type (FT, FR, ND or NC), the VAT categories, prefixed VAT numbers, the delivery address, the exemption reason on exempt lines and the ATCUD and QR code as in use case UC027. The file is attached to the invoice and downloaded. The button only shows on an invoice that already has an ATCUD.

What the module does not do: send the XML to the public body. You deliver the file through the channel you already use to invoice the public sector.

The full price: €9 per Odoo version on Odoo Apps plus the FlexigoTech Cloud subscription, Standard at €29 a month or €290 a year, VAT excluded, with a 14-day trial and no card. The module's AT certification is in progress. Until then, documents carry certificate 0, and a business that invoices under Portuguese rules with invoicing software cannot use it yet to issue its legal invoices (what the law requires).
How it was tested
Version 19.0 of the module has 259 automated tests. The XML one presses the button as a user would and checks that the file is attached to the invoice with the CIUS-PT 2.1.1 CustomizationID, the invoice number, the budget commitment, the ATCUD with schemeID "ANG" and the amount payable.
Does a PDF invoice still count as an electronic invoice?
Until 31 December 2026, yes: article 95(3) of Law 73-A/2025 says so. CIUS-PT is the format required for invoices to the public administration.
Does the XML replace the PDF invoice?
For the public body, the XML is the document. The PDF with the QR code remains the printed invoice for other customers.
Keep reading
Checked against the linked sources
Sources
- files.diariodarepublica.pt/1s/2017/08/16802/0189402052.pdf
- files.diariodarepublica.pt/1s/2018/12/25000/0596005962.pdf
- files.diariodarepublica.pt/1s/2025/12/25002/0000200271.pdf
- www.espap.gov.pt/FrontEnd/Paginas/Areas/SP_Fin/SP_Fin_FEAP_FAQ_tpl_1.aspx
- www.espap.gov.pt/spfin/normas/Paginas/normas.aspx
- app.parlamento.pt/OE2027/HTML/OrcamentoEstado2027.html
- Module source code: CIUS-PT & ATCUD, services/cius_pt.py, views/account_move_views.xml, tests/
- Module source code: CIUS-PT & ATCUD, services/cius_pt.py
- apps.odoo.com/apps/modules/20.0/flexigo_portugal_efatura_e_invoice_connector
- Module source code: CIUS-PT & ATCUD, __manifest__.py
- github.com/odoo/odoo/tree/20.0/addons/l10n_pt
- info.portaldasfinancas.gov.pt/pt/informacao_fiscal/legislacao/diplomas_legislativos/Docume
