Skip to content

Error

FX-SCH-A-000289: A buyer telephone entry must contain exactly one number

In short

Error: fails the selected checks.

FX-SCH-A-000289 means the telephone entry in the buyer's contact has no number, or more than one. Give it exactly one number, or remove the empty telephone entry.

On this page

What it means

If the buyer's contact has a telephone entry (ram:TelephoneUniversalCommunication, the buyer contact telephone number, BT-57), it must contain exactly one ram:CompleteNumber, which is the number itself. An empty telephone entry, or one with two numbers, fails. This check applies to the EN 16931 and Extended profiles of Factur-X and ZUGFeRD.

Why it matters

A telephone entry without a number says nothing, and a second number does not fit the model. The file then does not follow the profile and the recipient's system can refuse it.

How to fix it

In your invoicing software, open the buyer's contact details and either enter the telephone number or clear the field so that nothing is written. If the contact has several numbers, keep the one the recipient should use. If you build the XML yourself, give each ram:TelephoneUniversalCommunication one ram:CompleteNumber with the number as text.

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

Where this rule applies

Rule set Version
Factur-X 1.09 EN 16931 1.0.9-2
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 EN 16931 2.5.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-000289 still fails, and which other rules do.

Updated 5 November 2026