Vocabulary
48 keys in 3 tiers. Each key has its own page with the definition, value format, conditions and legal anchors.
A row name is the registry label followed by the key in brackets, for example
Marke [vehicle.make]. Keys marked statutory carry a feature that VAT law requires on the invoice; they must always be written with their label.
The marker vehicle.specificationId is listed first because every vehicle line starts with it.
Core (13)
Needed to identify and describe a vehicle on sales, trade-in and workshop invoices, plus the statutory features of VAT law.
| Key | Label (EN) | Label (DE) | Representation | Unit | Status |
|---|---|---|---|---|---|
vehicle.specificationId
|
VINvoice specification | VINvoice-Spezifikation | Id | ||
vehicle.roleCode
|
Vehicle role | Fahrzeugrolle | Code | ||
vehicle.vin
|
Vehicle identification number (VIN) | Fahrzeug-Identifizierungsnummer (FIN) | Number | ||
vehicle.make
|
Make | Marke | Name | ||
vehicle.model
|
Model | Modell | Name | ||
vehicle.conditionCode
|
Vehicle condition | Fahrzeugzustand | Code | ||
vehicle.firstRegistrationDate
|
Date of first registration | Datum der Erstzulassung | Date | ||
vehicle.odometerReadingKm
|
Odometer reading (km) | Kilometerstand (km) | Measure, km | kilometre | statutory |
vehicle.odometerReadingMi
|
Odometer reading (mi) | Meilenstand (mi) | Measure, mi | statute mile | statutory |
vehicle.maximumNetPowerKw
|
Maximum net power (kW) | Höchste Nutzleistung (kW) | Measure, kW | kilowatt | |
vehicle.newMeansOfTransportIndicator
|
New means of transport | Neues Fahrzeug (USt) | Indicator | statutory | |
vehicle.firstEntryIntoServiceDate
|
First entry into service | Erste Inbetriebnahme | Date | statutory | |
vehicle.marginSchemeIndicator
|
Margin scheme | Differenzbesteuerung | Indicator | statutory |
Recommended (13)
Widely available facts that receivers commonly ask for.
| Key | Label (EN) | Label (DE) | Representation | Unit | Status |
|---|---|---|---|---|---|
vehicle.registrationNumber
|
Registration number | Amtliches Kennzeichen | Number | ||
vehicle.registrationCountryCode
|
Country of registration | Zulassungsland | Code | ||
vehicle.odometerReadingStatusCode
|
Odometer reading status | Status des Zählerstands | Code | ||
vehicle.odometerReadingDate
|
Date of odometer reading | Datum des Zählerstands | Date | ||
vehicle.configuration
|
Vehicle configuration | Modellausführung | Text | ||
vehicle.engineCapacityCm3
|
Engine capacity (cm3) | Hubraum (cm3) | Measure, cm3 | cubic centimetre | |
vehicle.energySourceCode
|
Fuel or power source | Kraftstoffart oder Energiequelle | Code, repeatable | ||
vehicle.powertrainTypeCode
|
Powertrain type | Antriebsart | Code | ||
vehicle.categoryCode
|
Vehicle category | Fahrzeugklasse | Code | ||
vehicle.basicColourCode
|
Basic colour | Grundfarbe | Code, repeatable | ||
vehicle.nextRoadworthinessTestDate
|
Next roadworthiness test | Nächste technische Prüfung | Date | ||
vehicle.usableBatteryEnergyKwh
|
Usable battery energy (kWh) | Nutzbare Batterieenergie (kWh) | Measure, kWh | kilowatt hour | |
vehicle.typeApprovalNumber
|
Type-approval number | Typgenehmigungsnummer | Number |
Optional (22)
Provisional for 12 months after first publication; some wait for a legal review.
| Key | Label (EN) | Label (DE) | Representation | Unit | Status |
|---|---|---|---|---|---|
vehicle.de.hsn
|
German manufacturer key number (HSN) | Herstellerschlüsselnummer (HSN) | Number | provisional | |
vehicle.de.tsn
|
German type key number (TSN) | Typschlüsselnummer (TSN) | Number | provisional | |
vehicle.exhaustEmissionLevelCode
|
Exhaust emission level | Abgasnorm | Code | ||
vehicle.wltpCo2EmissionsGPerKm
|
WLTP CO2 emissions (g/km) | CO2-Emissionen WLTP (g/km) | Measure, g/km | g/km | |
vehicle.nedcCo2EmissionsGPerKm
|
NEDC CO2 emissions (g/km) | CO2-Emissionen NEFZ (g/km) | Measure, g/km | g/km | |
vehicle.bodyworkCode
|
Code for bodywork | Code des Aufbaus | Code | ||
vehicle.seatingPositionCount
|
Number of seating positions | Anzahl der Sitzplätze | Count | ||
vehicle.modelYear
|
Model year | Modelljahr | Year | ||
vehicle.manufactureDate
|
Date of manufacture | Herstellungsdatum | Date | ||
vehicle.wltpElectricRangeKm
|
WLTP electric range (km) | Elektrische Reichweite WLTP (km) | Measure, km | kilometre | |
vehicle.batteryStateOfHealthPercent
|
State of health (%) | Alterungszustand (%) | Percent | percent | |
vehicle.batteryStateOfHealthDate
|
State of health date | Alterungszustand ermittelt am | Date | ||
vehicle.batteryStateOfHealthMethodCode
|
State of health method | Ermittlungsmethode | Code | ||
vehicle.batteryPassportUrl
|
Battery passport link | Batteriepass-Link | Url | ||
vehicle.maximumMassKg
|
Maximum mass (kg) | Technisch zulässige Gesamtmasse (kg) | Measure, kg | kilogram | |
vehicle.registeredMaximumMassKg
|
Registered maximum mass (kg) | Zulässige Gesamtmasse (kg) | Measure, kg | kilogram | |
vehicle.catalogueId
|
Catalogue identifier | Katalogkennung | Id, repeatable | ||
vehicle.approvedType
|
Type (type-approval) | Typ (Typgenehmigung) | Name | ||
vehicle.approvedVariant
|
Variant (type-approval) | Variante (Typgenehmigung) | Name | ||
vehicle.approvedVersion
|
Version (type-approval) | Version (Typgenehmigung) | Name | ||
vehicle.axleCount
|
Number of axles | Anzahl der Achsen | Count | ||
vehicle.cumulativeOperatingHours
|
Cumulative operating hours | Betriebsstundenstand | Measure, h | hour |
Reserved names (3)
These names are reserved and are not keys. Do not write them; readers ignore them. They may not be used for any other meaning.
| Reserved name | Label (EN) | Label (DE) |
|---|---|---|
vehicle.previousHolderCount reserved
|
Number of previous holders | Anzahl der Vorhalter |
vehicle.knownAccidentDamageIndicator reserved
|
Known accident damage | Bekannter Unfallschaden |
vehicle.knownUnrepairedDamageIndicator reserved
|
Known unrepaired damage | Unreparierter Schaden |
Also available as registry.json, registry.csv, context.jsonld and as a JSON Schema, vehicle-facts.schema.json (CC0 1.0).