Exactly one complete number for the buyer agent’s fax contact

Error FX-SCH-A-000654 Factur-X

Element 'ram:CompleteNumber' must occur exactly 1 times.

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

ram:FaxUniversalCommunication does not contain exactly one ram:CompleteNumber: the element is missing or occurs more than once.

What the rule means

The fax communication requires exactly one element for the complete number in this XML context. A missing or repeated element does not match the expected structure.

Please provide exactly one complete number for the buyer agent’s fax contact

The buyer agent’s fax contact is missing ram:CompleteNumber or contains it more than once. Exactly one such element meets the structural requirement.

What to do
  1. Check ram:FaxUniversalCommunication in the buyer agent’s contact.
  2. Make sure it contains exactly one ram:CompleteNumber element.
  3. Generate the invoice again and validate it once more.
What it looks like
✗ Triggers the message
<ram:FaxUniversalCommunication/>
✓ Correct
<ram:FaxUniversalCommunication>
  <ram:CompleteNumber/>
</ram:FaxUniversalCommunication>
Technical details

The XPath counts direct ram:CompleteNumber elements under ram:FaxUniversalCommunication and requires exactly one.

Where the rule applies

The rule applies to ram:CompleteNumber within the ram:FaxUniversalCommunication fax communication of the buyer agent’s contact.

Context (rule/@context)
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ ram:BuyerAgentTradeParty/ram:DefinedTradeContact/ram:FaxUniversalCommunication
Test expression (assert/@test)
count(ram:CompleteNumber)=1