Skip to main content

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.

Quick actions

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

Header
UBL 2.1 Syntax
  1. Invoice
  2. cac:ContractDocumentReference
  3. cbc:IDBT-12
CII (UN/CEFACT) Syntax
  1. rsm:CrossIndustryInvoice
  2. rsm:SupplyChainTradeTransaction
  3. ram:ApplicableHeaderTradeAgreement
  4. ram:ContractReferencedDocument
  5. ram:IssuerAssignedIDBT-12
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

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

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.

Official sources and tools