Skip to content

Error

FX-SCH-A-001077: Add a unit code to the free-of-charge quantity

In short

Error: fails the selected checks.

FX-SCH-A-001077 means a line's free-of-charge quantity is missing its unitCode attribute. Add the attribute to ram:ChargeFreeQuantity inside ram:SpecifiedLineTradeDelivery, using the code for the unit that quantity measures.

On this page

What it means

Each ram:ChargeFreeQuantity under a line's ram:SpecifiedLineTradeDelivery must have a unitCode attribute. This rule checks that the attribute exists; it does not check its value or require it to match the invoiced quantity's unit.

Why it matters

The unit code identifies what the free-of-charge quantity measures, such as items, hours or kilograms.

How to fix it

Check the unit used for the free-of-charge quantity on the affected line. Add the corresponding unitCode attribute to ram:ChargeFreeQuantity, for example unitCode="C62" for a count of items. Do not copy the invoiced quantity's unit unless it also describes the free quantity correctly. Export the corrected file and check it again.

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

Attribute '@unitCode' is required in this context.

Where this rule applies

Rule set Version
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 EXTENDED 2.5.2
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether FX-SCH-A-001077 still fails, and which other rules do.

Updated 6 November 2026