VINvoice
An open, vendor-neutral convention for vehicle data in EU e-invoices.
VINvoice is a usage convention for invoices that follow EN 16931, such as Factur-X and
ZUGFeRD, XRechnung and Peppol BIS Billing. It is not a new XML format. The vehicle
identification number goes into the line object identifier BT-128 with the UNTDID 1153 scheme AKG. Every other vehicle fact is one item-attribute row (BG-32), named
Label [key] and holding a plain value: an ISO date, an integer without separators or
a lower-case token. A marker row vehicle.specificationId = vehicle/1.0 makes the line a vehicle
line. Invoices that follow the convention remain valid EN 16931 invoices, so no format owner has
to change anything.
- 13 core keys
- 13 recommended keys
- 22 optional keys
- 19 test invoices
- 0 failed rules in 71 validator runs
Example: a used car on one invoice line
The rows of a dealer-to-dealer sale under the margin scheme, as they appear in the Factur-X
invoice sale-25a.fx.cii.xml. A
viewer shows the readable label; software reads only the key in brackets.
| Name (BT-160) | Value (BT-161) |
|---|---|
VINvoice-Spezifikation [vehicle.specificationId]
|
vehicle/1.0
|
Fahrzeugrolle [vehicle.roleCode]
|
supply
|
Fahrzeug-Identifizierungsnummer (FIN) [vehicle.vin]
|
TSTVEH016N0000001
|
Marke [vehicle.make]
|
Volkswagen
|
Modell [vehicle.model]
|
Golf
|
Modellausführung [vehicle.configuration]
|
2.0 TDI Life
|
Fahrzeugzustand [vehicle.conditionCode]
|
used
|
Datum der Erstzulassung [vehicle.firstRegistrationDate]
|
2022-03-18
|
Kilometerstand (km) [vehicle.odometerReadingKm]
|
48200
|
Höchste Nutzleistung (kW) [vehicle.maximumNetPowerKw]
|
110
|
Hubraum (cm3) [vehicle.engineCapacityCm3]
|
1968
|
Kraftstoffart oder Energiequelle [vehicle.energySourceCode]
|
diesel
|
Grundfarbe [vehicle.basicColourCode]
|
grey
|
Nächste technische Prüfung [vehicle.nextRoadworthinessTestDate]
|
2027-03
|
Differenzbesteuerung [vehicle.marginSchemeIndicator]
|
true
|
Lagernummer [com.example.stockNumber]
|
STK-26-0042
|
Line object identifier (BT-128), scheme
AKG
|
TSTVEH016N0000001
|
All data in examples is fictional. VINs use the test prefix TST with a valid check digit.
The same line in UBL and the full XML are on the examples page.
Read further
- Specification Rules, conformance levels, CII and UBL bindings, VAT handling.
- Vocabulary All 48 keys with definitions, value formats and legal anchors.
- Code lists Closed token lists, units and external lists.
- Examples and downloads Test invoices in CII and UBL, registry as JSON, CSV and JSON-LD.
- Validation How the test corpus was validated, and the reference checker.
- Governance Neutrality charter, change process, how to propose a key, licences.