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
    9.6 KB View Download
  • common/UBL-CommonAggregateComponents-2.5.xsd
    366.4 KB View Download
  • common/UBL-CommonBasicComponents-2.5.xsd
    299.5 KB View Download
  • common/UBL-CommonExtensionComponents-2.5.xsd
    9.3 KB View Download
  • common/UBL-QualifiedDataTypes-2.5.xsd
    6.8 KB View Download
  • common/BDNDR-UnqualifiedDataTypes-1.1.xsd
    73.3 KB View Download
  • common/UBL-ExtensionContentDataType-2.5.xsd
    4.8 KB View Download
  • common/BDNDR-CCTS_CCT_SchemaModule-1.1.xsd
    44.2 KB View Download
  • common/UBL-CommonSignatureComponents-2.5.xsd
    3.7 KB View Download
  • common/UBL-XAdES01903v132-201601-2.5.xsd
    23.4 KB View Download
  • common/UBL-XAdES01903v141-201601-2.5.xsd
    3.5 KB View Download
  • common/UBL-SignatureAggregateComponents-2.5.xsd
    4.7 KB View Download
  • common/UBL-xmldsig-core-schema-2.5.xsd
    10.5 KB View Download
  • common/UBL-SignatureBasicComponents-2.5.xsd
    3.9 KB View Download
  • common/UBL-xmldsig1-schema-2.5.xsd
    1.3 KB View Download
  • common/UBL-xmldsig11-schema-2.5.xsd
    4.9 KB View Download

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