Allowed reason code for the allowance

Error FX-SCH-A-000520 Factur-X

Value of 'ram:ReasonCode' is not allowed.

Mandatory rule: As long as it is violated, the invoice is invalid and will be rejected by validators.
What is wrong

The value in ram:ReasonCode for the allowance is neither empty nor included in the code list used by this rule.

What the rule means

If provided, the reason code for the allowance must come from the permitted code list. The rule concerns an allowance because ram:ChargeIndicator has the value false, and it also accepts an empty value.

Please use an allowed reason code for the allowance

This rule does not recognize the value in ram:ReasonCode for the allowance as allowed. You can use a value from the applicable code list or leave the value empty.

What to do
  1. Check ram:ReasonCode for the allowance.
  2. Use an entry from the applicable code list or leave the value empty.
  3. Regenerate the invoice and check it again.
Technical details

The test selects ram:SpecifiedTradeAllowanceCharge with ram:ChargeIndicator equal to false and accepts an empty value or an entry from FACTUR-X_BASIC_codedb.xml, code list 21.

Where the rule applies

The rule applies to ram:ReasonCode for a document-level allowance. It applies when ram:ChargeIndicator has the value false.

Context (rule/@context)
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator="false"]/ ram:ReasonCode
Test expression (assert/@test)
string-length($codeValue21)=0 or document('FACTUR-X_BASIC_codedb.xml')/codedb/cl[@id=21]/enumeration[@value=$codeValue21]