Skip to content

Error

FX-SCH-A-000294: An item attribute needs exactly one name

In short

Error: fails the selected checks.

FX-SCH-A-000294 means an item attribute on an invoice line (BG-32) has no name, or more than one (BT-160). Give each attribute exactly one name, such as Colour, or remove the attribute.

On this page

What it means

An item attribute (BG-32) is a name and value pair that describes the item on a line, such as Colour and Red. Each ram:ApplicableProductCharacteristic must contain exactly one ram:Description, which is the attribute name (BT-160). This check applies to the EN 16931 profile of Factur-X and ZUGFeRD.

Why it matters

A value without a name, or one value with two names, cannot be turned into a clear description of the item. The file does not follow the profile and the recipient's system can reject it.

How to fix it

Open the line in your invoicing software and look for item properties, attributes or custom fields. Fill in the name of each one, or delete the attribute if you do not need it. If you build the XML yourself, every ram:ApplicableProductCharacteristic needs one ram:Description and one ram:Value.

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:Description' must occur exactly 1 times.

Where this rule applies

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

Check your file

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

Updated 5 November 2026