Provide the tax category exactly once

Error FX-SCH-A-000178 Factur-X

Element 'ram:CategoryCode' 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:CategoryCode must occur exactly once in ram:ApplicableTradeTax. The element is missing or occurs more than once.

What the rule means

ram:CategoryCode identifies the tax category of the relevant VAT breakdown. The category must be stated unambiguously.

Please provide the tax category exactly once

The tax category is missing from the invoice’s VAT section or appears more than once. You can resolve this by having exactly one occurrence there.

What to do
  1. Locate the relevant ram:ApplicableTradeTax.
  2. Check that ram:CategoryCode occurs exactly once within it.
  3. Generate the invoice again and validate it once more.
Technical details

The XPath test uses count(ram:CategoryCode)=1 to require exactly one direct child element named ram:CategoryCode.

Where the rule applies

The rule applies to each ram:ApplicableTradeTax in the document-level VAT breakdown.

Context (rule/@context)
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ ram:ApplicableTradeTax
Test expression (assert/@test)
count(ram:CategoryCode)=1