Skip to main content
Portugal · public-sector e-invoicing

CIUS-PT: the XML Portuguese public bodies accept, from an Odoo invoice

CIUS-PT is the Portuguese version of the European e-invoicing standard EN 16931, published by eSPap in the UBL 2.1 syntax (the UN/CEFACT one is still being built). It is the format suppliers use to invoice Portuguese public administration bodies. The version in force is 2.1.1, which adds the invoice's ATCUD and QR code to the XML.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 18 November 2026

Key facts

Versions
Odoo 17, 18, 19 and 20
Checked
against the sources linked at the end
Reading time
3 min

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:

RuleWhat it requires
BR-CIUS-PT-01 and -03Seller and buyer VAT numbers with the country prefix (PT…)
BR-CIUS-PT-66A delivery address
BR-CIUS-PT-17An exempt line carries its exemption reason as an item property
BR-CIUS-PT-65A credit or debit note carries the reference of the preceding invoice
UC027ATCUD 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.

Customer invoice in Odoo with the CIUS-PT XML button, the ATCUD and the AT QR code
The invoice in Odoo with the CIUS-PT XML button, which only shows when the invoice has an ATCUD (test data).

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 module's series list in Odoo with the AT validation code
The series the XML's ATCUD comes from, each with its AT validation code (test data).

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

Invoicing in Portugal with Odoo: what the law requires and what Odoo is missingWhat Portuguese law requires from businesses invoicing with Odoo, with the laws and dates in force on 17-11-2026, what Odoo ships and what the modules cover.The ATCUD code, explained with an Odoo invoiceThe ATCUD is the series validation code, a hyphen and the document's sequential number. How the series is registered with the AT and what Odoo does with it.Accounting and invoicing SAF-T in Portugal: what each file holds and when it is dueThe two SAF-T (PT) files: invoicing reported by the 5th, accounting filed before the IES from financial year 2027. Laws, deadlines and what each Odoo module generates.
Checked against the linked sources

Sources