XRechnung error codes

Specification identifier (BT-24) missing

Invoice number (BT-1) missing

Issue date (BT-2) missing

The invoice must carry an invoice type code (BT-3) — the code saying whether this is an invoice, a credit note or a partial invoice.

The invoice must name an invoice currency (BT-5).

The invoice must contain the seller name (BT-27) — the full registered name the company trades under.

Buyer name (BT-44) missing

Seller postal address (BG-5) missing

The seller postal address must contain a country code (BT-40) — the two-letter ISO 3166-1 code, not the country's name spelled out.

The invoice must contain the buyer postal address (BG-8) — the counterpart to BG-5 on the recipient's side.

The buyer postal address must contain a country code (BT-55) — the same requirement as BR-09, on the recipient's side.

The invoice must contain the sum of line net amounts (BT-106).

The invoice must contain the total amount without VAT (BT-109).

The invoice must contain the total amount with VAT (BT-112).

The invoice must contain the amount due for payment (BT-115).

Invoice with no line (BG-25)

Where the payee (BG-10) differs from the seller, the payee name (BT-59) must be provided.

Where the seller has a tax representative (BG-11), the representative's name (BT-62) must be provided.

Where the seller has a tax representative, that representative's postal address (BG-12) must be provided — the same requirement as BR-08, for a third party.

Tax representative without a country (BT-69)

Every invoice line (BG-25) must carry a line identifier (BT-126).

Every invoice line must carry an invoiced quantity (BT-129) — including where the line is a flat fee.

The invoiced quantity must carry a unit of measure (BT-130) — a code from UN/ECE Recommendation 20, not your item master's own abbreviation.

Every invoice line must carry a net amount (BT-131) — the amount of the row before VAT.

Item name (BT-153) missing

Every invoice line must carry an item net price (BT-146) — the price per unit after any price discount.

Negative net price (BT-146)

Negative gross price (BT-148)

Where both the start and the end of the invoicing period are given, the end must fall on or after the start.

Where both the start and the end of a line period are given, the end must fall on or after the start — the same check as BR-29, per line.

Every document-level allowance (BG-20) must carry an amount (BT-92).

Every document-level allowance (BG-20) must carry a VAT category code (BT-95).

Every document-level allowance (BG-20) must carry a reason — in plain text (BT-97), as a code (BT-98), or both.

Every document-level charge (BG-21) must carry an amount (BT-99).

Every document-level charge (BG-21) must carry a VAT category code (BT-102).

Every document-level charge (BG-21) must carry a reason — in plain text (BT-104), as a code (BT-105), or both.

Every invoice line allowance (BG-27) must carry an amount (BT-136).

Line allowance with no reason

Line charge with no amount (BT-141)

Every invoice line charge (BG-28) must carry a reason — in plain text (BT-144), as a code (BT-145), or both.

Every VAT breakdown block (BG-23) must contain the category taxable amount (BT-116).

Every VAT breakdown block (BG-23) must contain the category tax amount (BT-117).

VAT breakdown with no category code (BT-118)

Every VAT breakdown block must carry a VAT category rate (BT-119), unless the invoice is not subject to VAT at all.

A payment instruction (BG-16) must state the payment means code (BT-81) — how the invoice is meant to be paid.

Where a credit transfer is given as the payment means, the payee account identifier (BT-84) must accompany it.

Unmasked card number (BT-87)

Every additional supporting document (BG-24) must carry a reference (BT-122) — the number under which the recipient can find the document.

Where a separate VAT accounting currency (BT-6) is given, the tax total in that currency (BT-111) must be provided too.

Item attribute with no value (BT-161)

Every preceding invoice reference (BG-3) must contain the preceding invoice's number (BT-25).

Every tax representative party (BG-11) must carry its VAT identifier (BT-63).

Deliver-to address with no country (BT-80)

Credit transfer with no account (BT-84)

Where the seller electronic address (BT-34) is sent, it must carry a scheme identifier.

Where the buyer electronic address (BT-49) is sent, it must carry a scheme identifier.

Where the item standard identifier (BT-157) is sent, it must carry a scheme identifier.

Item classification with no scheme (BT-158)

Payment instructions (BG-16) missing

Seller contact (BG-6) missing

Seller city (BT-37) missing

Seller post code (BT-38) missing

Seller contact point (BT-41) missing

Contact telephone (BT-42) missing

Contact email (BT-43) missing

Buyer city (BT-52) missing

Buyer post code (BT-53) missing

Delivery address with no city (BT-77)

Delivery address with no post code (BT-78)

VAT category rate (BT-119) missing

Leitweg-ID (BT-10) or buyer reference

Seller not identifiable for tax

Invoice type code (BT-3) not permitted

Wrong Skonto format in BT-20

Invalid IBAN for credit transfer (BT-84)

Invalid IBAN for direct debit (BT-91)

Identifier is not XRechnung (BT-24)

Two attachments share a filename

Transfer with no bank details (BG-17)

Transfer with the wrong payment data

Card payment with no card data (BG-18)

Card payment with the wrong data

Direct debit, no mandate data (BG-19)

Direct debit with the wrong data

Correction with no reference (BG-3)

Telephone number too short (BT-42)

Email address not plausible (BT-43)

Creditor identifier (BT-90) missing

Debited account (BT-91) missing

Invoice type code (BT-3)

The currency attribute on every amount

Invoice currency (BT-5)

VAT accounting currency (BT-6)

VAT point date code (BT-8)

Object identifier scheme (BT-18)

Subject code of the free text (BT-21)

Scheme of any identifier

Scheme of a registration identifier

Item classification scheme (BT-158)

Country codes of the addresses (BT-40, BT-55, BT-69, BT-80)

Item country of origin (BT-159)

Payment means code (BT-81)

Tax category in the VAT breakdown (BT-118)

Tax category on line, allowance and charge (BT-151, BT-95, BT-102)

Allowance reason code (BT-98, BT-140)

Charge reason code (BT-105, BT-145)

Item standard identifier scheme (BT-157)

Exemption reason code scheme (BT-121)

Unit of measure (BT-130, BT-150)

MIME type of the attachment (BT-125)

Electronic address scheme (BT-34, BT-49)

Delivery location identifier scheme (BT-71)

The invoice may state the VAT point either as a date (BT-7) or as a code (BT-8), never as both.

Every invoice line (BG-25) must carry a VAT category code (BT-151) — S for the standard rate, E for exempt, Z for zero-rated, AE for reverse charge, and so on.

Document level allowance reason code (BT-98) and Document level allowance reason (BT-97) shall indicate the same type of allowance.never fires

Document level charge reason code (BT-105) and Document level charge reason (BT-104) shall indicate the same type of charge.never fires

Invoice line allowance reason code (BT-140) and Invoice line allowance reason (BT-139) shall indicate the same type of allowance reason.never fires

Invoice line charge reason code (BT-145) and Invoice line charge reason (BT-144) shall indicate the same type of charge reason.never fires

The VAT identifiers of the seller (BT-31), the tax representative (BT-63) and the buyer (BT-48) must begin with the ISO 3166-1 alpha-2 country code.

The sum of invoice line net amounts (BT-106) must equal the sum of the individual line net amounts (BT-131) exactly.

The sum of allowances at document level (BT-107) must equal the sum of the individual allowance amounts (BT-92) exactly.

Sum of charges (BT-108) does not match

The invoice total without VAT (BT-109) must equal the sum of all line net amounts (BT-131) minus document-level allowances (BT-107) plus document-level charges (BT-108).

The invoice total VAT amount (BT-110) must equal the sum of the tax amounts of all VAT categories (BT-117).

The invoice total with VAT (BT-112) must equal the total without VAT (BT-109) plus the total VAT amount (BT-110), exactly.

Amount due (BT-115) does not add up

Tax amount (BT-117) wrong for the rate

The invoice must contain at least one VAT breakdown group (BG-23) — one block per tax category, carrying the taxable amount, the tax amount, the category and the rate.

If an invoicing period (BG-14) is sent, at least one date must be in it: the start (BT-73), the end (BT-74), or both.

If a line period (BG-26) is sent on an invoice line, at least one date must be in it: the start (BT-134), the end (BT-135), or both.

Every document-level allowance (BG-20) must be justified — in plain text (BT-97), as a code (BT-98), or both.

Every document-level charge (BG-21) must carry a reason — in plain text (BT-104), as a code (BT-105), or both.

Every allowance on an invoice line (BG-27) must be justified — in plain text (BT-139), as a code (BT-140), or both.

Every charge on an invoice line (BG-28) must carry a reason — in plain text (BT-144), as a code (BT-145), or both.

So the buyer can identify the supplier automatically, at least one seller identifier must be present: a seller identifier (BT-29), the legal registration identifier (BT-30), or the VAT identifier (BT-31).

The invoice must name the business process (BT-23) — the identifier of the process it is being sent in.

If a separate VAT accounting currency (BT-6) is given, it must differ from the invoice currency (BT-5).

The document must contain no empty elements.

Buyer address (BT-49) missing

The seller electronic address (BT-34) must be provided — the counterpart to BT-49, the address a recipient can reply or send a response message to.

Where both the base amount and the percentage of an allowance or charge are given, the amount must follow from them exactly: base amount × percentage ÷ 100.

If the percentage of an allowance or charge is given, the base amount must accompany it.

If the base amount of an allowance or charge is given, the percentage must accompany it — the counterpart to R041.

The indicator saying whether this is a charge or an allowance must be exactly true or false — lower case, with no alternatives.

In CII the charge indicator of an allowance or charge at document or line level must be exactly true or false.

The same requirement as R043-1, but for the allowance or charge inside the price: ram:AppliedTradeAllowanceCharge under the gross price must carry an indicator of exactly true or false.

No charge is permitted inside a line's price.

Price calculation mismatch

The invoice may contain exactly one tax total in the invoice currency — that is, exactly one block carrying a breakdown.

A second tax block without a breakdown is permitted only where a separate VAT accounting currency (BT-6) is given — and then exactly one.

The tax total in the invoice currency and the tax total in the accounting currency must carry the same operational sign.

Mandate reference missing

On an invoice line the only additional document reference permitted is the object identifier — type code 130.

If a line has a period of its own, it must fall inside the invoicing period: the line's start date may not precede the invoice's start date.

A line period's end date may not fall after the end of the invoicing period — the counterpart to R110 at the other end.

A line's net amount must follow from the line's own figures: quantity × (net price ÷ price base quantity), plus the line's charges and minus its allowances.

Price base quantity is zero

The unit of the price base quantity must be the same as the unit of the invoiced quantity.

Document level allowance (BT-92)

Document level allowance base (BT-93)

Document level charge (BT-99)

Document level charge base (BT-100)

Sum of line net amounts (BT-106)

Sum of document level allowances (BT-107)

Sum of document level charges (BT-108)

Total without VAT (BT-109)

Total VAT amount (BT-110)

Total with VAT (BT-112)

Total VAT in accounting currency (BT-111)

Amount already paid (BT-113)

Rounding amount (BT-114)

Amount due for payment (BT-115)

Taxable base per VAT category (BT-116)

VAT amount per VAT category (BT-117)

Line net amount (BT-131)

Line level allowance (BT-136)

Line level allowance base (BT-137)

Line level charge (BT-141)

Line level charge base (BT-142)

MIME type of the embedded attachment (BT-125)

Line net amount from its sub lines (BT-131)

VAT information per sub line (BG-DEX-06)

Party identifier scheme (BT-29, BT-46, BT-60)

Legal registration identifier scheme (BT-30, BT-47, BT-61)

Item standard identifier scheme (BT-157)

Electronic address scheme (BT-34, BT-49)

Delivery location identifier scheme (BT-71)

Amount due including third-party payments (BT-115)

Third party payment type (BT-DEX-001)

Third party payment amount (BT-DEX-002)

Third party payment description (BT-DEX-003)

Decimals of that amount (BT-DEX-002)

Currency of that amount (BT-DEX-002)

Sub invoice lines in CII, which XRechnung does not have

The category must appear in the VAT breakdown (BG-23)

A line in this category forbids any tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rate

Whether an exemption reason (BT-120/BT-121) is required or forbidden

No other VAT breakdown beside the not-subject-to-VAT one

No invoice line in another VAT category

No document level allowance in another category

No document level charge in another category

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rate

Whether an exemption reason (BT-120/BT-121) is required or forbidden

A delivery date (BT-72) or an invoicing period (BG-14) must be given

The delivery country code (BT-80) must be given

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rate

Whether an exemption reason (BT-120/BT-121) is required or forbidden

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rateinactive in CII

Whether an exemption reason (BT-120/BT-121) is required or forbidden

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rateinactive in CII

Whether an exemption reason (BT-120/BT-121) is required or forbidden

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rate

Whether an exemption reason (BT-120/BT-121) is required or forbidden

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rate

Whether an exemption reason (BT-120/BT-121) is required or forbidden

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rate

Whether an exemption reason (BT-120/BT-121) is required or forbidden

The category must appear in the VAT breakdown (BG-23)

A line in this category requires a seller tax identifier

The same for a document level allowance

The same for a document level charge

The line VAT rate (BT-152)

The allowance VAT rate

The charge VAT rate

The taxable base (BT-116) as the sum of amounts in this category

The VAT amount (BT-117) from the taxable base and the rate

Whether an exemption reason (BT-120/BT-121) is required or forbidden

Contract reference becomes mandatory (BT-12)

Tender or lot reference becomes mandatory (BT-17)

At least one vehicle line per invoice (BG-25)

Permitted vehicle categories (BT-158)

Permitted drive types (BT-161)

A category requires a drive type (BT-158 → BT-160)

A drive type requires a category (BT-160 → BT-158)

Attachment URL is not absolute (BT-124)

Price base quantity (BT-149) inconsistent

Attachment with two descriptions (BT-123)

Attachment with two files (BT-125)

Wrong date format in UBL

Wrong date format in CII

Split payment only on a domestic Italian invoice

No standard-rated line beside a split-payment line

Eine Rechnung sollte zur Angabe des Liefer-/Leistungsdatums entweder BT-72 "Actual delivery date", BG-14 "Invoicing period" oder in jeder Rechnungsposition BG-26 "Invoice line period" enthalten.

Scheme of the item classification identifier (BT-158)