xmlvalid
Sign in Open validator
XSD+SCH KoSIT · 3.0.2, rules 2.6.0

XRechnung 3.0 Credit Note (UBL)

A German XRechnung credit note in UBL syntax, checked against the UBL 2.1 CreditNote schema, the EN 16931 rules and the XRechnung rules (BR-DE-*).

Validate with this schema Try it with the example

About

The credit note of XRechnung, the German CIUS of EN 16931: UBL's CreditNote document with type code 381, checked with the same rule layers as the XRechnung invoice. In CII, a credit note is a CrossIndustryInvoice with that type code, so the XRechnung CII entry covers both.

E-invoicing in Germany: 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.
  • Rule levels follow the KoSIT validator configuration (2026-08-31) for the credit note scenarios (XRechnung and CVD): a few code list rules are warnings there. Its "information" level is shown as a warning.
  • The XRechnung test suite has no UBL credit note, so the example is its invoice 01.02a (KoSIT, Apache License 2.0) turned into a credit note by us; the KoSIT validator accepts it.

Files

14 files · 2.7 MB
  • maindoc/UBL-CreditNote-2.1.xsd main
    56.3 KB View Download
  • common/UBL-CommonAggregateComponents-2.1.xsd
    2.3 MB View Download
  • common/UBL-CommonBasicComponents-2.1.xsd
    214.7 KB View Download
  • common/UBL-CommonExtensionComponents-2.1.xsd
    9.3 KB View Download
  • common/UBL-QualifiedDataTypes-2.1.xsd
    3.5 KB View Download
  • common/UBL-UnqualifiedDataTypes-2.1.xsd
    26.7 KB View Download
  • common/UBL-ExtensionContentDataType-2.1.xsd
    4.2 KB View Download
  • common/CCTS_CCT_SchemaModule-2.1.xsd
    44.2 KB View Download
  • common/UBL-CommonSignatureComponents-2.1.xsd
    5.4 KB View Download
  • common/UBL-SignatureAggregateComponents-2.1.xsd
    7.6 KB View Download
  • common/UBL-SignatureBasicComponents-2.1.xsd
    4.1 KB View Download
  • common/UBL-xmldsig-core-schema-2.1.xsd
    10.5 KB View Download
  • common/UBL-XAdESv132-2.1.xsd
    21.2 KB View Download
  • common/UBL-XAdESv141-2.1.xsd
    1.3 KB View Download

The validator loads all of these with their folder structure, so includes and imports resolve as published.

Business rules

Schematron · run in this order

The 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

xrechnung-creditnote-ubl.xml · 6.8 KB · passes the schema and the rules

View Open in validator

In CI and from code

The same schema by its name, xrechnung-3-ubl-credit-note, through the API.

npx @xmlvalid/cli validate "**/*.xml" --schema xrechnung-3-ubl-credit-note
- uses: xmlvalid/validate-action@v1
  with:
    files: "**/*.xml"
    schema: xrechnung-3-ubl-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=xrechnung-3-ubl-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