Skip to content

Error

FX-SCH-A-000295: An item attribute needs exactly one value

In short

Error: fails the selected checks.

FX-SCH-A-000295 means an item attribute on an invoice line (BG-32) has no value, or more than one (BT-161). Give each attribute exactly one value, such as Red, 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:Value, which is the attribute value (BT-161). This check applies to the EN 16931 profile of Factur-X and ZUGFeRD.

Why it matters

A name without a value tells the recipient nothing about the item, and two values for one name are ambiguous. 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 missing value, or delete the attribute if it is empty on purpose. 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:Value' 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-000295 still fails, and which other rules do.

Updated 5 November 2026