# BT-12 Contract reference

Reference to the contract that governs the invoiced delivery or service.

## Quick answer

> **Invoice basics**: Core document identifiers, dates, process identifiers, and high-level invoice context.

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

## In plain language

Reference to the contract that governs the invoiced delivery or service.

Reference to the contract that governs the invoiced delivery or service.

The contract reference helps buyers match the invoice to the legal agreement behind the order.

## What you usually enter here

Internal or external contract identifier

Typical valid values include: CON-2026-14

Optional according to EN 16931-1.

## What goes wrong often

Avoid values like: , AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

## Examples in context

The contract reference helps buyers match the invoice to the legal agreement behind the order.

Optional according to EN 16931-1.

## Valid Examples

- CON-2026-14

## Invalid Examples

- AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

## Related Fields

The contract reference helps buyers match the invoice to the legal agreement behind the order.

- [BT-13 Purchase Order Reference](/resources/xrechnung/bt-13-purchase-order-reference)
- [BT-17 Tender or lot reference](/resources/xrechnung/bt-17-tender-or-lot-reference)

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

### Data Type:
text

### Cardinality:
0..1

### Requirement:
Optional

### Max Length:
50 characters

### Since Version:
Optional

## XML Implementation

### UBL 2.1 Syntax
```
/Invoice/cac:ContractDocumentReference/cbc:ID
```

### CII (UN/CEFACT) Syntax
```
/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeAgreement/ram:ContractReferencedDocument/ram:IssuerAssignedID
```

## 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
The contract reference helps buyers match the invoice to the legal agreement behind the order.

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