XSD
OASIS · 2.5
UBL 2.5 Credit Note
The UBL credit note in version 2.5 (August 2026), backward compatible with UBL 2.1.
About
A credit note corrects or cancels an invoice. UBL 2.5 keeps every UBL 2.1 credit note valid and adds new optional elements.
Good to know
- These are the normative schemas from the OASIS release, which still accept deprecated elements.
- The example is the UBL 2.1 credit note example shipped in the UBL 2.5 release.
Files
16 files · 869.9 KB-
maindoc/UBL-CreditNote-2.5.xsd main
-
common/UBL-CommonAggregateComponents-2.5.xsd
-
common/UBL-CommonBasicComponents-2.5.xsd
-
common/UBL-CommonExtensionComponents-2.5.xsd
-
common/UBL-QualifiedDataTypes-2.5.xsd
-
common/BDNDR-UnqualifiedDataTypes-1.1.xsd
-
common/UBL-ExtensionContentDataType-2.5.xsd
-
common/BDNDR-CCTS_CCT_SchemaModule-1.1.xsd
-
common/UBL-CommonSignatureComponents-2.5.xsd
-
common/UBL-XAdES01903v132-201601-2.5.xsd
-
common/UBL-XAdES01903v141-201601-2.5.xsd
-
common/UBL-SignatureAggregateComponents-2.5.xsd
-
common/UBL-xmldsig-core-schema-2.5.xsd
-
common/UBL-SignatureBasicComponents-2.5.xsd
-
common/UBL-xmldsig1-schema-2.5.xsd
-
common/UBL-xmldsig11-schema-2.5.xsd
The validator loads all of these with their folder structure, so includes and imports resolve as published.
Example document
UBL-CreditNote-2.1-Example.xml · 17 KB · valid against this schema
In CI and from code
The same schema by its name, ubl-2.5-credit-note, through the API.
npx @xmlvalid/cli validate "**/*.xml" --schema ubl-2.5-credit-note
- uses: xmlvalid/validate-action@v1
with:
files: "**/*.xml"
schema: ubl-2.5-credit-note
api-key: ${{ secrets.XMLVALID_API_KEY }}
curl https://xmlvalid.com/api/v1/validations \
-H "Authorization: Bearer $XMLVALID_API_KEY" \
-F document={{ $schema->example ?? 'document.xml' }} -F schema=ubl-2.5-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