XRechnung 2.1.0: UBL validation rule changes

The rule requires cac:PaymentMeans/cbc:PaymentMeansCode to contain a payment means code from the UNCL4461 list accepted by this rule. The value must not contain a space after surrounding whitespace is removed (i.e. it must be a single token), and the resulting token must be one of the codes explicitly listed in the test, such as 1, 10, 30, 58, or ZZZ. Because the rule is fatal, an invoice that does not meet this is rejected.

Set cac:PaymentMeans/cbc:PaymentMeansCode to one of the allowed UNCL4461 codes listed in the rule, for example 30 or 58, and make sure there is no internal whitespace in the element value. If the invoice currently uses a code not in this list, replace it with an allowed code; the rule only accepts the listed codes.

The rule requires the cbc:TaxExemptionReasonCode element (in CII: ram:ExemptionReasonCode) to contain a value that appears in the CEF VATEX code list. The test first checks that the normalized value contains no space, then checks that the uppercase form of the value is present in the list provided by the rule. A document fails if the value contains a space or is not in that list.

Set the cbc:TaxExemptionReasonCode (or ram:ExemptionReasonCode) value to one of the codes listed in the rule's CEF VATEX code list, for example VATEX-EU-79-C or VATEX-FR-FRANCHISE. Ensure the value has no spaces; case is ignored by the test, but using the exact uppercase form is safest. If the current value is not in the list, replace it with the correct VAT exemption reason code.

The rule requires cbc:TaxCurrencyCode (UBL) or ram:TaxCurrencyCode (CII) to hold an ISO 4217 alpha-3 currency code from the list accepted by BR-CL-05. It passes only when the normalized value is exactly one of the 178 listed codes, for example EUR, USD, or GBP. A document fails if the element is empty, contains only whitespace, has an internal space, or uses a code not on that list.

Put a valid ISO 4217 alpha-3 currency code in the tax currency field, such as EUR, USD, or GBP. Ensure the value has no internal spaces (surrounding whitespace is ignored by the rule) and is not empty or only whitespace. Check that the code is present in the BR-CL-05 list; if the current code is something else, replace it with the correct three-letter ISO 4217 code.

The rule requires the invoice currency code to be a valid ISO 4217 alpha-3 currency code. It checks that the code contains no spaces and appears in the rule's list of accepted currency codes. A document fails if cbc:DocumentCurrencyCode (UBL) or ram:InvoiceCurrencyCode (CII) is empty, contains whitespace, or is not one of the listed codes.

Set the currency code element to a three-letter ISO 4217 code from the list allowed by the rule, for example EUR, USD, or GBP. In UBL use cbc:DocumentCurrencyCode; in CII use ram:InvoiceCurrencyCode. Ensure the value contains no spaces.

The rule checks the item classification identifier scheme identifier in cac:CommodityClassification/cbc:ItemClassificationCode[@listID] (UBL) or ram:ClassCode[@listID] (CII). After surrounding whitespace is ignored, the value must not contain any internal space and must exactly match one of the 185 listed UNTDID 7143 codes, for example AA, AB, AC, EN, or ZZZ. A missing value, a value with internal spaces, or any value not in that list violates this fatal rule.

Set the listID attribute to a valid UNTDID 7143 code from the rule's list, e.g. AA, AB, AC, EN, or ZZZ. The value may have leading or trailing whitespace, but after trimming it must be exactly one of those 185 codes and contain no internal spaces. If you do not know which code applies to the item classification, check the UNTDID 7143 list for the correct scheme identifier.

The rule requires that a coded charge reason (cbc:AllowanceChargeReasonCode in UBL or ram:ReasonCode in CII) on a charge (ChargeIndicator = true) be a single code from the UNCL 7161 list given in the rule. Ignoring surrounding whitespace, the value must not contain internal spaces and must exactly match one of the listed codes, for example AA, AAA, AAC. If the value is not one of the listed codes, or contains internal spaces, the document fails this fatal rule.

Set the charge reason code element to a valid UNCL 7161 code from the rule's list. In UBL, this is cbc:AllowanceChargeReasonCode inside cac:AllowanceCharge where cbc:ChargeIndicator is true; in CII, it is ram:ReasonCode inside ram:SpecifiedTradeAllowanceCharge where ram:ChargeIndicator is true. Replace any free-text description or unknown code with the appropriate single code from the list, and ensure no multiple codes or internal spaces are entered. Check your code mapping or configuration for the correct charge reason code.

The rule requires that the @currencyID attribute on amount elements (UBL) or on ram:TaxTotalAmount (CII) contains an ISO 4217 alpha-3 currency code from the list accepted by the rule, and that the code contains no spaces. Because the severity is fatal, an invoice that does not satisfy this condition is rejected with message [BR-CL-03]-currencyID MUST be coded using ISO code list 4217 alpha-3.

Set the currencyID attribute to a valid three-letter ISO 4217 alpha-3 code that appears in the rule's list, for example EUR or USD. Ensure the value is not empty and contains no spaces. In UBL this applies to amount elements such as cbc:TaxAmount; in CII it applies to ram:TaxTotalAmount[@currencyID]. If the current value is not a valid code, correct it in the source system.