Portugal CIUS-PT Credit Note (UBL)
Portuguese e-invoice credit note (UBL, CIUS-PT)
A Portuguese credit note (nota de crédito) for the public administration, checked against the UBL 2.1 CreditNote schema and the CIUS-PT rules.
About
CIUS-PT covers invoices and credit notes for Portuguese public bodies, in UBL 2.1. A credit note uses the UBL CreditNote document; CIUS-PT allows its own type codes, such as NC.
E-invoicing in Portugal: the rules in short and how to check an invoice →
Good to know
- Rules run only when the document matches the schema. Documents over 50 MB are checked against the schema only.
- The rules are eSPap's Schematron for CIUS-PT 2.1.1 (26 February 2021), with the EN 16931 rules as CIUS-PT adapts them.
- The example is the credit note of eSPap's CIUS-PT use cases with the identifier of the current release (CIUS-PT:2.1.1); as published, it names 1.0.0.
Files
14 files · 2.7 MB · Download all (.zip)-
maindoc/UBL-CreditNote-2.1.xsd main
-
common/UBL-CommonAggregateComponents-2.1.xsd
-
common/UBL-CommonBasicComponents-2.1.xsd
-
common/UBL-CommonExtensionComponents-2.1.xsd
-
common/UBL-QualifiedDataTypes-2.1.xsd
-
common/UBL-UnqualifiedDataTypes-2.1.xsd
-
common/UBL-ExtensionContentDataType-2.1.xsd
-
common/CCTS_CCT_SchemaModule-2.1.xsd
-
common/UBL-CommonSignatureComponents-2.1.xsd
-
common/UBL-SignatureAggregateComponents-2.1.xsd
-
common/UBL-SignatureBasicComponents-2.1.xsd
-
common/UBL-xmldsig-core-schema-2.1.xsd
-
common/UBL-XAdESv132-2.1.xsd
-
common/UBL-XAdESv141-2.1.xsd
The validator loads all of these with their folder structure, so includes and imports resolve as published.
Business rules
Schematron · run in this orderThe rules run after the schema check, only when the document matches the schema, and in your browser like the schema check (with SaxonJS by Saxonica). Each finding names its rule, such as BR-CO-15, and the line it points at; each rule has a page with what it checks.
Example document
pt-cius-credit-note.xml · 84.3 KB · passes the schema and the rules
In CI and from code
The same schema by its name, pt-cius-credit-note, through the API.
npx @xmlvalid/cli validate "**/*.xml" --schema pt-cius-credit-note
- uses: xmlvalid/validate-action@v1
with:
files: "**/*.xml"
schema: pt-cius-credit-note
api-key: ${{ secrets.XMLVALID_API_KEY }}
curl https://xmlvalid.com/api/v1/validations \
-H "Authorization: Bearer $XMLVALID_API_KEY" \
-F document=@pt-cius-credit-note.xml \
-F schema=pt-cius-credit-note
Free accounts get 100 API validations a month. On Pro, a URL monitor can check a published document against this schema every hour and email you when it breaks. More CI setups