Skip to main content

BT-127 Invoice line note

Free text note at line level containing supplementary information for the line item.

BT-127 (Invoice line note) is free-text commentary scoped to a single invoice line. Optional under EN 16931, it lets sellers document line-specific facts — discount rationale, delivery references, project codes — without leaking them into the document-level note (BT-22). Example: "Includes 10% volume discount per framework agreement".

BT-127 · EN 16931 / XRechnung 3.x

BT Reference Card

Key EN 16931 and XRechnung facts for this business term.

BT code
BT-127
Name
Invoice line note
Cardinality
Optional (O)
Business group
BG-25 INVOICE LINE
Data type
Text
Example value
Includes 10% volume discount per framework agreement.

Quick answer

Free text note at line level containing supplementary information for the line item.

Line items

The goods or services on each invoice line, including quantities, prices, and VAT.

Quick actions

In plain language

Free text note at line level containing supplementary information for the line item.

Free text note at line level containing supplementary information for the line item.

Provides additional context or special instructions for the specific line item.

What you usually enter here

Free text description

Typical valid values include: Additional configuration, Rush order, Custom specifications

Optional according to EN 16931-1.

What goes wrong often

Avoid values like: , AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Examples in context

Provides additional context or special instructions for the specific line item.

Optional according to EN 16931-1.

Valid Examples

  • Additional configuration
  • Rush order
  • Custom specifications

Invalid Examples

  • AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

XML mapping and field facts

Open the technical reference if you need XML paths, validator rule codes, legal wording, or schema-specific mapping details.

Field ID:

BT-127

Data Type:

text

Cardinality:

0..1

Requirement:

Optional

Max Length:

500 characters

Since Version:

Optional

XML Implementation

UBL 2.1 Syntax
/Invoice/cac:InvoiceLine/cbc:Note
CII (UN/CEFACT) Syntax
/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementLineMonetarySummation/ram:LineNote

Next step

Create an XRechnung from your PDF

The converter reads the invoice and shows the fields it found before download, so you can check and correct the values. No PDF? Fill in the XRechnung directly in the form.

Download requires an account. Subscriptions from €10/month with annual billing (excl. taxes), or €5 per conversion (excl. taxes) without a subscription.

Why the standard cares about this field

Business Context

Provides additional context or special instructions for the specific line item.

Legal Requirement

Optional according to EN 16931-1.

Official sources and tools