What causes the UBL-CR-009 error?

Element contains an attribute not defined in UBL 2.1 schema.

How do I fix UBL-CR-009?

Remove non-standard attributes from elements. You can also use Invoice Navigator's automatic Fixer tool to correct this instantly.

Is UBL-CR-009 a critical error?

Yes, UBL-CR-009 is a critical error that will cause invoice rejection. It must be fixed before submission to ensure your invoice is accepted by the recipient's system.

Can UBL-CR-009 be automatically fixed?

Many instances of UBL-CR-009 can be automatically corrected using Invoice Navigator's Fixer tool. Upload your invoice and the tool will identify and fix common issues, including invalid or unknown attribute.

Which accounting software causes UBL-CR-009?

UBL-CR-009 is commonly seen in exports from Custom invoice generators. These software packages sometimes generate invoices that need adjustment to meet full compliance standards.

Error codes · UBL 2.1

UBL-CR-009In your invoicing software

Disallowed element: cbc:PaymentAlternativeCurrencyCode

This is the rejection, word for word: „[UBL-CR-009] UBL 2.1 Invoice schema does not include `cbc:PaymentAlternativeCurrencyCode`. This element must be removed for EN 16931 compliance.“

XPath: Various elements with extra attributes

What to have readyNothing. The file has to be re-exported from your invoicing software; we check it again afterwards.

What we doInvoice Navigator automatically removes the disallowed `cbc:PaymentAlternativeCurrencyCode` element from your Invoice.

Choose the rejected invoiceor drop it here

XRechnung XML or ZUGFeRD PDF. Checking is free · corrected file €1.90 · the first every 30 days is free · no sign-up.

If you enter it yourself in your invoicing software

Before

<Invoice>
  <cbc:PaymentAlternativeCurrencyCode>value</cbc:PaymentAlternativeCurrencyCode>
</Invoice>

After

<Invoice>
  <!-- cbc:PaymentAlternativeCurrencyCode removed for EN 16931 compliance -->
</Invoice>

Element order is part of the rule: if the element sits in the wrong place, the validator rejects with UBL-CR-009.

What the finding looks likeExample

FindingStructure invalid · UBL-CR-009

Location/Invoice/cbc:PaymentAlternativeCurrencyCode

From youA re-exported file

ThenRe-export

ProofSHA-256 and /verify link after the check

Often appears together with

UBL-CR-001Disallowed element: ext:UBLExtensions