Payment reference at most once

Error CII-SR-469 Syntax (UBL/CII)

[CII-SR-469] - Payment reference (BT-83) shall occur at most once in the document.

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

PaymentReference occurs more than once in ApplicableHeaderTradeSettlement. The rule allows at most one such element.

What the rule means

The payment reference identifies the payment reference information. Stating it only once at document level avoids duplicate references.

Affected fields BT-83
Please include the payment reference only once

The invoice contains more than one PaymentReference. You can limit the information to one element.

What to do
  1. Find all PaymentReference elements in ApplicableHeaderTradeSettlement.
  2. Check the value set through FacturXInvoice.PaymentReference.
  3. Remove the additional PaymentReference entry.
  4. Regenerate the invoice and validate it again.
What it looks like
✗ Triggers the message
<ram:ApplicableHeaderTradeSettlement>
  <ram:PaymentReference>REF-1</ram:PaymentReference>
  <ram:PaymentReference>REF-2</ram:PaymentReference>
</ram:ApplicableHeaderTradeSettlement>
✓ Correct
<ram:ApplicableHeaderTradeSettlement>
  <ram:PaymentReference>REF-1</ram:PaymentReference>
</ram:ApplicableHeaderTradeSettlement>
Check in FactoorSharp
  • FacturXInvoice.PaymentReference (BT-83)
Technical details

The XPath counts all PaymentReference elements under ApplicableHeaderTradeSettlement; the test passes when there is at most one.

Where the rule applies

The rule applies to PaymentReference within ApplicableHeaderTradeSettlement at document level.

Context (rule/@context)
/rsm:CrossIndustryInvoice
Test expression (assert/@test)
count(//ram:ApplicableHeaderTradeSettlement/ram:PaymentReference) <= 1