What it means
Each ram:SpecifiedLineTradeDelivery must contain exactly one ram:BilledQuantity. It carries the invoiced quantity (BT-129), with the unit of measure (BT-130) in its unitCode attribute. This rule counts quantity elements, not their values or attributes. It applies to the Basic and EN 16931 profiles of Factur-X and ZUGFeRD.
Why it matters
The invoiced quantity is an input to the line amount calculation. Missing or repeated quantity elements do not match the required line structure.
How to fix it
Check that the affected line shows the quantity and unit you actually billed. If you create the XML yourself, add the missing ram:BilledQuantity or remove unintended duplicates inside ram:SpecifiedLineTradeDelivery, retaining the correct quantity and unitCode. If your software produces the faulty structure, ask its supplier to correct the export. Export again and recheck.
Once the file is corrected, check it again for free: Validate a ZUGFeRD invoice
Or fix the invoice in a form and download the corrected file, for 1 credit: Fix a rejected e-invoice Beta
The rule as published
Element 'ram:BilledQuantity' must occur exactly 1 times. Where this rule applies
| Rule set | Version |
|---|---|
| Factur-X 1.09 BASIC | 1.0.9-2 |
| Factur-X 1.09 EN 16931 | 1.0.9-2 |
| ZUGFeRD 2.5 BASIC | 2.5.2 |
| ZUGFeRD 2.5 EN 16931 | 2.5.2 |
Check your file
Drop your e-invoice to see whether FX-SCH-A-000276 still fails, and which other rules do.
Related rules
- FX-SCH-A-000277 A late payment penalty period needs a unit code
- FX-SCH-A-000278 Each line must have exactly one set of VAT details
- FX-SCH-A-000279 Each line must have exactly one line total block
- FX-SCH-A-000282 The invoiced object scheme must be an accepted code
- FX-SCH-A-000283 A supporting document can have only one description (EN 16931 and Extended)
- FX-SCH-A-000284 A supporting document can hold only one attached file (EN 16931 and Extended)