# 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.

- [Validate XML](/en/xrechnung-validator?source=resource&bt=BT-127)
- [Convert invoice](/en/pdf-to-xrechnung?source=resource&bt=BT-127)

## 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

## Related Fields

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

- [BT-126 Invoice line identifier](/resources/xrechnung/bt-126-invoice-line-identifier)

## 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
```

## 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.

- [Convert invoice](/en/pdf-to-xrechnung)
- [Fill in XRechnung in the form](/en/create-xrechnung)

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

- [KoSIT Validator](https://erechnungsvalidator.service-bw.de/)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)