# 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

Canonical EN 16931 / XRechnung facts for this business term — citable from this anchor.

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

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

Relevant rule codes: BR-2

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

## Validation Rules

### BR-2
BR-2

## 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/)
- [Invoice Converter](/pdf-to-xrechnung)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)