Invalid reason code for an allowance

Error FX-SCH-A-000601 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 of ram:ReasonCode is not in the designated code list. The test accepts a missing or empty value.

What the rule means

ram:ReasonCode assigns a standardized code to the reason for the allowance. A code that is not permitted cannot be matched to an entry in the designated code list.

Please use an allowed reason code for the allowance

The reason code for the allowance is not in the designated code list. You can change the value or leave it empty.

What to do
  1. Find the allowance in ram:SpecifiedTradeAllowanceCharge whose udt:Indicator is false.
  2. Check the value of ram:ReasonCode.
  3. Use a value from the designated code list or leave ram:ReasonCode empty.
  4. Generate the invoice again and validate it again.
What it looks like
✗ Triggers the message
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>false</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:ReasonCode>INVALID-CODE</ram:ReasonCode>
</ram:SpecifiedTradeAllowanceCharge>
✓ Correct
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>false</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:ReasonCode/>
</ram:SpecifiedTradeAllowanceCharge>
Technical details

The test applies to allowances with udt:Indicator equal to false and accepts an empty value or a value from code list cl with ID 29.

Where the rule applies

The rule applies to ram:ReasonCode of a document-level allowance in ram:SpecifiedTradeAllowanceCharge.

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