# VINvoice

> VINvoice is an open, vendor-neutral convention for structured vehicle data in EN 16931 e-invoices (Factur-X / ZUGFeRD, XRechnung, Peppol BIS Billing). It adds no XML: the vehicle identification number (VIN) goes into the invoice line object identifier BT-128 with scheme `AKG`; every other vehicle fact is one BG-32 item attribute (BT-160 name, BT-161 value) named `Label [key]` with a plain value; the marker row `vehicle.specificationId` = `vehicle/1.0` makes a line a vehicle line. Invoices stay valid EN 16931 invoices.

Status: draft for review (registry vehicle/1.0-draft, 2026-10-24). Not yet a published standard. VINvoice is not endorsed by CEN, FeRD, KoSIT, OpenPeppol or any public authority.

Use VINvoice when software writes or reads e-invoices about vehicles (sales, trade-ins, workshop and service, leasing, rental, transport) and needs machine-readable vehicle data such as VIN, make, model, first registration, odometer reading, power or the margin-scheme flag. For a complete implementation guide in one file, read llms-full.txt.

## Specification

- [Implementation guide (llms-full.txt)](https://vinvoice.org/llms-full.txt): everything an implementer needs in one plain-text file
- [Specification](https://vinvoice.org/specification/): vehicle lines, row names and values, conformance levels 0 to 2, CII and UBL bindings, reading rules, VAT and margin scheme
- [Naming rules](https://vinvoice.org/naming-rules/): how keys, labels and tokens are named
- [Vocabulary](https://vinvoice.org/vocabulary/): all 48 keys with definitions, grammars and legal anchors
- [Code lists](https://vinvoice.org/code-lists/): token lists, EU code lists and units

## Machine-readable registry

- [registry.json](https://vinvoice.org/downloads/registry.json): the normative registry (CC0-1.0)
- [vehicle-facts.schema.json](https://vinvoice.org/downloads/vehicle-facts.schema.json): JSON Schema for the facts of one vehicle line
- [vinvoice.sch](https://vinvoice.org/downloads/vinvoice.sch): ISO Schematron rules for CII and UBL invoices
- [context.jsonld](https://vinvoice.org/downloads/context.jsonld): JSON-LD context
- [registry.csv](https://vinvoice.org/downloads/registry.csv): the registry as a table

## Examples

- [sale-25a.fx.cii.xml](https://vinvoice.org/examples/sale-25a.fx.cii.xml) (CII): Used car sold between two dealers under the margin scheme (second-hand goods), conformance level 2.
- [sale-25a.peppol.ubl.xml](https://vinvoice.org/examples/sale-25a.peppol.ubl.xml): the same sale in UBL
- [All 19 test invoices](https://vinvoice.org/examples/)

## Tools

- [Validation](https://vinvoice.org/validation/): how the test invoices were validated; reference checker rules V-01 to V-22
- [Source repository](https://github.com/Autaxo/vinvoice): registry sources, reference checker (Python), tests

## Optional

- [Governance](https://vinvoice.org/governance/): neutrality charter, change process, how to propose a key, licences
- [Implementations](https://vinvoice.org/implementations/): software that writes or reads VINvoice