# 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

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.

## Where the field sits

BT-12 belongs to the Header part of the invoice. UBL 2.1 Syntax: Invoice › cac:ContractDocumentReference › cbc:ID. CII (UN/CEFACT) Syntax: rsm:CrossIndustryInvoice › rsm:SupplyChainTradeTransaction › ram:ApplicableHeaderTradeAgreement › ram:ContractReferencedDocument › ram:IssuerAssignedID.

## What goes wrong often

Avoid values like: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

## Valid Examples

- CON-2026-14

## Invalid Examples

- AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

## Related Fields

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

## XML Implementation

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

### CII (UN/CEFACT) Syntax
```
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram: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)

Trying it and buying a single conversion work without an account. Subscriptions from €10/month with annual billing (excl. taxes), or €5 per conversion (excl. taxes) without a subscription.

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