BR-22 in your own invoice? Upload the file and find every error in seconds.
What does BR-22 mean?
Every line must state the invoiced quantity. Quantity times unit price gives the line amount.
Common causes of BR-22
- The element 'ram:BilledQuantity' in 'ram:SpecifiedLineTradeDelivery' is missing on a line.
- The quantity was given only in the line text, not in structured form.
- The whole 'SpecifiedLineTradeDelivery' block is missing.
How to fix BR-22
- Find the faulty spot in the XML. Open the XML of the invoice and go to field BT-129 along this XPath:
//ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity - Apply the fix. Add the Invoiced quantity (BT-129) for every Invoice line (BG-25) in the element 'ram:SpecifiedLineTradeDelivery/ram:BilledQuantity'. Enter the numeric quantity value, for example '3'.
- Validate again. Save the file and validate it again to check that BR-22 is no longer reported.
Concrete fix
Add the Invoiced quantity (BT-129) for every Invoice line (BG-25) in the element 'ram:SpecifiedLineTradeDelivery/ram:BilledQuantity'. Enter the numeric quantity value, for example '3'.
XPath
//ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantityBefore / after: the XML example
This is the spot in question before and after the fix (Cross Industry Invoice, ZUGFeRD/Factur-X).
Wrong
<ram:SpecifiedLineTradeDelivery>
</ram:SpecifiedLineTradeDelivery>
Correct
<ram:SpecifiedLineTradeDelivery>
<ram:BilledQuantity unitCode="C62">3</ram:BilledQuantity>
</ram:SpecifiedLineTradeDelivery>Frequent questions about BR-22
May the quantity be negative or zero?
Yes, negative quantities are allowed on credit-note-style lines. But the value must be present and numeric.
What is the difference from BT-130?
BT-129 is the numeric quantity value, BT-130 the matching unit of measure. Both sit together in the element 'ram:BilledQuantity' with the attribute 'unitCode'.
Related error codes
Check BR-22 automatically
Instead of digging through the XML by hand you can validate your ZUGFeRD or XRechnung file online – upload the PDF or the XML and you get every error with rule ID, affected field, fix and XPath, as a readable report or as JSON through the API.