📘

Fahrzeugbestand / Kfz-Handel

vehicles inventory_logistics 🛡️ RLS Protected

Fahrzeugbestand / Kfz-Handel — aus Code abgeleitete Prozess- und API-Dokumentation.

Fachliche Bestimmung: Logistik, Versand & Fuhrpark steuert den externen Warentransport und die betriebliche Mobilität: Frachtführeranbindung (DHL, UPS, Dachser, Schenker), Packstückbildung mit NVE/SSCC-Etikettierung, Tourenplanung und Ladelistengenerierung, unternehmenseigene Fuhrparkverwaltung mit digitalem Fahrtenbuch, gesetzliche Führerscheinkontrolle nach § 21 StVG Halterhaftung sowie UVV-Sicherheitsprüfungen nach DGUV Vorschrift 70.

Fachprozess-Erzählung & KI-Architektur Workflows & Lifecycles (1) Fachprozesse & Capabilities (17) Data Models & Fields (2) Entry Points (UI & APIs) (10) Regulatory & Compliance

⚡ Workflows & Lifecycles

Fahrzeugausgabe, UVV-Prüfung & Fahrtenbuch `fleet_vehicle_handover_and_uvv`

Fuhrparkverwaltung von der Fahrzeugübergabe über die gesetzliche Führerscheinprüfung bis zum digitalen Fahrtenbuch und UVV-Check.

sequenceDiagram autonumber actor Driver as Fahrer / Mitarbeiter actor FleetMgr as Fuhrparkleiter participant FleetApp as Fuhrpark- & Fahrzeugmodul participant Compliance as Halterhaftung & UVV-Register Driver->>FleetMgr: Fahrzeugübernahme anfordern FleetMgr->>Compliance: Führerscheingültigkeit prüfen (§ 21 StVG) Compliance-->>FleetMgr: Führerschein gültig FleetMgr->>FleetApp: Übergabeprotokoll erstellen (km, Tank, Fotos) Driver->>FleetApp: Digitale Signatur bei Übergabe Driver->>FleetApp: Fahrtenbucheintrag (Dienstfahrt, Route, km) FleetApp->>Compliance: Nächste UVV-Prüfung terminieren

1. LICENSE_CHECK

Führerscheinkontrolle

Regelmäßige oder anlassbezogene Überprüfung der Fahrerlaubnis nach Halterhaftung (§ 21 StVG).

Aktionen: Sichtprüfung/RFID erfassen, Audit-Nachweis

2. HANDOVER_PROTOCOL

Übergabeprotokoll

Fahrzeugübergabe mit Kilometerstand, Tankstand, Vorschäden und Ausstattungsprüfung.

Aktionen: Übergabeprotokoll signieren, Schäden fotografieren

3. TRIP_RECORD

Fahrtenbucherfassung

Digitales Fahrtenbuch mit Start-/Zielort, Fahrtzweck (Dienstfahrt/Privat) und km-Stand.

Aktionen: Finanzamtskonform sichern, Privatanteil buchen

4. UVV_INSPECTION

UVV-Sicherheitsprüfung

Jährliche Sicherheitsprüfung nach DGUV Vorschrift 70 (Bremsen, Reifen, Verbandkasten, Warnweste).

Aktionen: Prüfprotokoll ablegen, Neue Prüfplakette

⚙️ Fachprozesse & Capabilities (System-Fachlogik)

Registrierte Fachoperationen und System-Capabilities dieses Moduls zur Steuerung von Workflows, Kaskaden und KI-Agenten.

Gesamt: 17 manual_entry: 1 engine: 14 operator_surface: 1 engine_step: 1

Capability & Schlüssel	Fachliche Bezeichnung	Ausführung / Coverage	Risikostufe & Freigabe	Effekte & Kaskaden
Agent-Einstieg logistics_tour_agent `agent_entry:logistics_tour_agent`	Agent-Einstieg logistics_tour_agent Quelle: `code:module_agent_map`	manual_entry	✓ Auto	Keine Seiteneffekte deklariert
Fahrzeugverkauf abschließen `capability:sell_vehicle` Op: `sell_vehicle`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	🔒 Freigabe nötig Risiko: `external_effect`	`vehicle.sold` `invoice.created`
Fahrzeugbestand anlegen `capability:vehicle.create` Op: `vehicle.create`	Intent: `create_vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.created`
Inserat `capability:vehicle.listing.publish` Op: `vehicle.listing.publish`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.listing.publish`
Zulassung `capability:vehicle.registration.transfer` Op: `vehicle.registration.transfer`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.registration.transfer`
Werkstatt `capability:vehicle.service.book` Op: `vehicle.service.book`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.service.book`
Inzahlungnahme `capability:vehicle.trade.in_appraise` Op: `vehicle.trade.in_appraise`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.trade.in_appraise`
Vehicle: add reconditioning cost `capability:vehicles.vehicle.add_reconditioning_cost` Op: `vehicles.vehicle.add_reconditioning_cost`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.add_reconditioning_cost`
Vehicle: create sales invoice `capability:vehicles.vehicle.create_sales_invoice` Op: `vehicles.vehicle.create_sales_invoice`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.create_sales_invoice`
Vehicle: create trade in agreement `capability:vehicles.vehicle.create_trade_in_agreement` Op: `vehicles.vehicle.create_trade_in_agreement`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.create_trade_in_agreement`
Vehicle: create vehicle `capability:vehicles.vehicle.create_vehicle` Op: `vehicles.vehicle.create_vehicle`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.create_vehicle`
Vehicle: export autoscout24 json `capability:vehicles.vehicle.export_autoscout24_json` Op: `vehicles.vehicle.export_autoscout24_json`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.export_autoscout24_json`
Vehicle: export csv `capability:vehicles.vehicle.export_csv` Op: `vehicles.vehicle.export_csv`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.export_csv`
Vehicle: export mobile de json `capability:vehicles.vehicle.export_mobile_de_json` Op: `vehicles.vehicle.export_mobile_de_json`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.export_mobile_de_json`
Vehicle: update vehicle `capability:vehicles.vehicle.update_vehicle` Op: `vehicles.vehicle.update_vehicle`	Objekt: `vehicle` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `business_record`	`vehicle.update_vehicle`
vehicle: edit form `form_surface_anchor:vehicle.edit`	Objekt: `vehicle` Quelle: `code:erp_form_surface`	operator_surface	✓ Auto	Keine Seiteneffekte deklariert
sell vehicle `gateway:sell_vehicle` Op: `sell_vehicle`	sell vehicle Quelle: `code:engine_facade`	⚙️ Engine	✓ Auto	Keine Seiteneffekte deklariert

🧠 Fachprozess-Erzählung & Dual Knowledge Architektur

Synthese aus der ideologischen Blaupause (Meta-Fachlogik / Soll), der faktischen System-Implementierung (System-Fachlogik / Ist) und No-Code Customizing für KI-Consultants.

Dual Knowledge Layer

📖

Der durchgängige Businessprozess im Detail (End-to-End Fließtext-Erzählung)

Der durchgängige Logistik-, Versand- und Fuhrparkprozess in der betrieblichen Praxis

Die pünktliche und unbeschädigte Zustellung von Waren beim Kunden sowie der sichere und rechtlich einwandfreie Betrieb der Firmenfahrzeuge bilden das logistische Rückgrat jedes Handels- und Fertigungsunternehmens.

1. Warenausgang & Versandbereitstellung (Dispatch Staging)

Sobald das Lager (inventory) die Kommissionierung für einen Verkaufsauftrag (sales) abschließt, übernimmt das Logistikmodul:

Packstückbildung: Die gepickten Artikel werden in Versandkartons oder auf Europaletten konsolidiert. Das System ermittelt Brutto-, Netto- und Volumengewicht.
NVE / SSCC-Etikettierung: Jedes Packstück erhält eine weltweit eindeutige Nummer der Versandeinheit (NVE / Serial Shipping Container Code - SSCC) als GS1-128-Barcode.
Frachtführer-Auswahl & Ratenvergleich: Anhand von Gewicht, Destination (Inland, EU, Drittland) und gewünschter Laufzeit (Standard vs. Express) vergleicht das System hinterlegte Tarife oder ruft Live-Raten über Speditions-APIs ab (DHL, UPS, DPD, Dachser, DB Schenker, Kühne+Nagel).
Labeldruck: Über die integrierte Druckserver-Bridge (printbridge) wird das offizielle Versandetikett mit Routing-Barcode auf dem Thermotransferdrucker am Packtisch ausgegeben.

2. Ladelisten & Speditionsübergabe (Manifest & Handover)

Bei Paletten- und Speditionssendungen fasst das System Packstücke zu einer Ladeliste / einem Frachtbrief (CMR-Frachtbrief) zusammen (cap:logistics.shipment.generate_manifest).
Bei Abholung durch den Speditionsfahrer quittiert dieser die Anzahl der übernommenen Packstücke auf dem Handheld oder Lieferschein.
Warenausgangs-Gateway: Der Gateway setzt den Sendungsstatus auf Im Transit (in_transit) und übermittelt die Sendungsverfolgungsnummer (Tracking-ID) per E-Mail an den Kunden.

3. Eigener Fuhrpark & Tourenplanung (Fleet & Routing)

Verfügt das Unternehmen über eigene Liefer- oder Montagefahrzeuge:

Fahrzeugstamm (fleet): Verwaltung von PKWs, Transportern, LKWs und Anhängern mit Kennzeichen, Nutzlast, Ladevolumen und Wartungsintervallen.
Tourenoptimierung: Aufträge eines Liefergebiets werden wege- und zeitoptimiert zu einer Ausliefertour zusammengefasst. Das System berücksichtigt Zeitfenster, LKW-Mautstrecken und Lenk- und Ruhezeiten.
Rollende Fahrzeuglager: Kundendienstfahrzeuge führen einen eigenen mobilen Ersatzteilbestand, der vor Abfahrt aufgefüllt wird.

4. Halterhaftung & Führerscheinkontrolle (§ 21 StVG)

Als Fahrzeughalter haftet die Geschäftsführung strafrechtlich, wenn Mitarbeitern ohne gültige Fahrerlaubnis ein Firmenwagen überlassen wird:

Regelmäßige Pflichtprüfung: Das System erzwingt alle 6 Monate (oder anlassbezogen) die Führerscheinprüfung aller Dienstwagenberechtigten (cap:fleet.vehicle.verify_license).
Audit-Nachweis: Die Prüfung erfolgt per Sichtprüfung mit Scan oder über manipulationssichere RFID-Führersiegelsysteme. Das Prüfergebnis wird unveränderbar im Audit-Trail protokolliert.

5. Digitales Fahrtenbuch & Finanzamtskonformität

Zur Versteuerung des geldwerten Vorteils (Alternative zur 1%-Regelung) führt das Modul ein digitales, finanzamtskonformes Fahrtenbuch.
Fahrten werden mit Startort, Zielort, Kilometerstand, Fahrtzweck (Dienstfahrt, Arbeitsweg, Privatfahrt) und besuchtem Kunden erfasst.
Nachträgliche Manipulationen an Zeitstempeln oder Routendaten sind softwareseitig ausgeschlossen.

6. UVV-Sicherheitsprüfung nach DGUV Vorschrift 70

Gewerblich genutzte Fahrzeuge unterliegen der jährlichen Prüfung auf Betriebssicherheit nach DGUV Vorschrift 70 (UVV Fahrzeuge):
- Überprüfung von Bremsen, Reifen, Gurten, Ladungssicherungsmitteln (Spanngurte, Antirutschmatten), Warnwesten und Verbandkasten.
Das System terminiert die UVV-Prüfung und sperrt das Fahrzeug bei Fristüberziehung für Neuvergaben im Kalender (cap:fleet.vehicle.schedule_uvv).

🏛️

Meta-Fachlogik: Ideologische Blaupause, Soll-Weltbild & Normen

Meta-Fachlogik: Die ideologische Blaupause & das normative Weltbild

Die Meta-Fachlogik stützt sich auf das Transport- und Speditionsrecht (HGB §§ 407 ff., ADSp 2017), das Straßenverkehrsgesetz (§ 21 StVG), die Berufsgenossenschaftlichen Vorschriften (DGUV V70) und Steuerrichtlinien zum Fahrtenbuch.

1. Frachtrecht & Haftung (HGB §§ 407 ff., CMR, ADSp 2017)

Frachtvertrag & Haftungskorridor: Gesetzliche Haftungsbegrenzung des Frachtführers nach HGB § 431 (8,33 SZR pro kg) bzw. CMR im internationalen Straßengüterverkehr.
Sorgfaltspflicht der Ladungssicherung (§ 22 StVO / VDI 2700): Der Absender ist für die verkehrssichere Verladung und Ladungssicherung verantwortlich. Das Soll-Modell verlangt Dokumentation geeigneter Sicherungsmittel vor Abfahrt.

2. Gesetzliche Halterhaftung (§ 21 Abs. 1 Nr. 2 StVG)

Wer als Fahrzeughalter anordnet oder zulässt, dass jemand ein Fahrzeug führt, der die erforderliche Fahrerlaubnis nicht besitzt, macht sich strafbar (Freiheitsstrafe bis zu einem Jahr oder Geldstrafe).
Das Soll-Modell verbietet die Zuweisung von Dienstwagen an Mitarbeiter mit ungeprüftem oder abgelaufenem Führerschein.

3. Invarianten des Soll-Modells

Kein Warenausgang ohne lückenlose Packstück- und Gewichtsdokumentation.
Keine Fahrzeugausgabe ohne verifizierten Führerscheinprüfungsnachweis.
Ein finanzamtskonformes Fahrtenbuch darf keine rückwirkenden, unprotokollierten Änderungen zulassen.
Fahrzeuge mit überzogener UVV-Prüfung oder abgelaufenem TÜV sind für den Fahrdienst zu sperren.

Normbezug für `vehicles`

Prüfkatalog Standards-Registry v2026.10.1. Dieser Abschnitt ordnet Prüfreferenzen zu und stellt nicht fest, dass das Modul eine Norm einhält; keine Kataloganforderung ist als PASS bewertet.

Im Prüfkatalog ist keine modulspezifische Anforderung und keine primäre Prüfreferenz hinterlegt.

Im Auditauftrag zusätzlich genannt und nicht im Prüfkatalog v2026.10.1: ISO 3779, ISO 3780. Dafür gibt es hier keine Klausel und keine Aussage, dass eine Vorgabe eingehalten wird.

Plattformweite Katalogwerke mit Geltungsbereich all (unter anderem WCAG 2.2, EN 301 549 V4.1.1, ISO 9241-110:2020, ISO 9241-210:2019, ISO/IEC 25010:2023, ISO 9001:2026, ISO/IEC 27001:2022, APQC PCF 8.0, DSGVO, EU AI Act) umfassen dieses Modul mit. Wo der Volltext fehlt, bleibt der Zugang ohne Quelle, lizenzpflichtig oder nur als öffentliche Zusammenfassung gekennzeichnet. Auch diese Nennung weist keine eingehaltene Vorgabe nach.

⚙️

Systemische Fachlogik: Faktische Umsetzung in Centurio ERP & Capabilities

Systemische Fachlogik: Die faktische Umsetzung in Centurio ERP

Die System-Fachlogik dokumentiert die Realisierung in den Modulen logistics und fleet.

1. Datenmodelle & Semantische Schicht (ORM)

LogisticsShipment: Sendungskopf (Felder: id, tenant_id, shipment_number, carrier_code, tracking_number, service_level, total_weight_kg, package_count, shipping_label_url, status).
ShipmentPackage: Einzelne Packstücke (Felder: shipment_id, sscc_nve, weight_kg, dimensions_cm).
FleetVehicle: Fahrzeugstamm (Felder: id, license_plate, vin_chassis, vehicle_type, assigned_driver_id, odometer_km, next_inspection_date, next_uvv_date, status [active, maintenance, locked]).
FleetTrip: Fahrtenbucheintrag (Felder: vehicle_id, driver_id, start_time, end_time, start_km, end_km, trip_type [business, commute, private], purpose, customer_id).
DriverLicenseCheck: Revisionssicherer Nachweis der Führerscheinkontrolle.

2. Das Capability-Register

cap:logistics.shipment.create: Erzeugung einer Sendung und Ratenabfrage.
cap:logistics.shipment.generate_label: Druck des Frachtführer-Versandlabels via PrintBridge.
cap:logistics.shipment.generate_manifest: Ladelistenerstellung und Speditionsavis.
cap:logistics.shipment.track: Statusabfrage der Tracking-Events beim Carrier.
cap:fleet.vehicle.verify_license: Erfassung der gesetzlichen Führerscheinprüfung.
cap:fleet.vehicle.log_trip: Verbuchung eines Fahrtenbucheintrags.
cap:fleet.vehicle.schedule_uvv: Planung der jährlichen Sicherheitsprüfung nach DGUV 70.

3. Der Gateway `gw:shipment_dispatch@v1`

Sichert den Warenausgang ab:

Validierung: Prüft Gewicht, Versandadresse und Gefahrgutdeklaration.
Statuswechsel: LogisticsShipment.status = 'dispatched'.
Outbox-Signal: Feuert SHIPMENT_DISPATCHED und triggert die Kundenbenachrichtigung mit Tracking-Link.

4. Statusmodelle

Sendung: draft ➔ labeled ➔ manifested ➔ in_transit ➔ delivered oder exception.
Fahrzeug: available ➔ in_use ➔ maintenance_due ➔ locked (z.B. wegen fehlender UVV).

🤖

KI-Consultant Leitfaden: Customizing- & No-Code-Konzept (Soll-Ist-Synthese)

AI Solution Architect Blueprint

KI-Consultant Blueprint: Customizing & No-Code Architektur

Anleitung für Solution Architects zur Einrichtung von Logistik- und Fuhrparkprozessen.

1. Kundenanforderungsanalyse

Welche Frachtführer und Speditionen müssen angebunden werden?
Sollen Versandkosten dem Kunden nach Staffel oder mit Festpauschalen in Rechnung gestellt werden?
Gibt es Gefahrguttransporte (ADR-Auflagen mit Tunnelbeschränkungen)?

2. No-Code Zusatzfelder (Custom Fields)

Im No-Code Studio (/semantic/customizing):

Auf LogisticsShipment:
- customs_declaration_mrn (Text): Movement Reference Number bei Ausfuhr in Drittländer (ATLAS).
- liftgate_required (Checkbox): Hebebühnenzustellung erforderlich.
Auf FleetVehicle:
- fuel_card_number (Text): Flottentankkartennummer für Tankbelegabgleich.
- toll_onboard_unit_id (Text): OBU-Gerätenummer für automatische LKW-Maut.

3. No-Code Workflow Canvas DAGs

Blueprint A: Automatisches Tracking & Proaktiver Lieferverzugs-Alert

Trigger-Node: Webhook des Paketdienstes (z.B. DHL Event shipment.delayed).
Condition-Node: event.delay_days >= 2.
Action-Node: Sende automatische SMS/E-Mail an Kunden: "Ihre Sendung verzögert sich um 2 Tage; Tracking-Link hier."

Blueprint B: Automatische Sperre bei überfälliger Führerscheinkontrolle

Trigger-Node: Täglicher Scan der Führerscheingültigkeit.
Condition-Node: driver.last_license_check_date < current_date - 180_days.
Action-Node: Sperre Fahrzeugzuweisung für diesen Fahrer und sende Eskalations-Mail an Fuhrparkleiter.

📚 Operative Prozessbegriffe & Transaktionsschnittstellen

Zentrale Fachbegriffe im Prozesszusammenhang (Operatives Modell)

NVE / SSCC (Nummer der Versandeinheit)

18-stellige, weltweit eindeutige Seriennummer für Packstücke und Paletten.

Halterhaftung (§ 21 StVG)

Strafrechtliche Verantwortung des Fahrzeughalters zur Prüfung der Fahrerlaubnis.

UVV-Prüfung (DGUV Vorschrift 70)

Jährliche berufsgenossenschaftliche Sicherheitsprüfung gewerblicher Fahrzeuge.

Finanzamtskonformes Fahrtenbuch

Lückenloser, manipulationssicherer Nachweis aller Fahrten zur Besteuerung.

Frachtbrief (CMR)

Beförderungsdokument im internationalen Straßengüterverkehr mit Haftungsbestimmungen.

Ladeliste (Manifest)

Übergabeprotokoll aller an einen Frachtführer übergebenen Packstücke.

📥 Eingänge & Trigger (Inputs)

Versandbereite Packstücke aus dem Warenausgang des Lagers
Speditionsaufträge aus Streckengeschäften (Dropshipping)
Fahrzeugdaten und Fahrtenbucheingaben der Fahrer
Prüffristen für Führerscheine und Hauptuntersuchungen

📤 Ausgänge & Arbeitsergebnisse (Outputs)

Frachtführer-Versandlabels mit Barcodes (DHL, UPS, Dachser)
Speditions-Ladelisten und CMR-Frachtbriefe
Audit-Nachweise über durchgeführte Führerscheinkontrollen (§ 21 StVG)
Finanzamtskonforme Fahrtenbuchberichte (PDF/Excel)
Tracking-Links und Lieferzeit-Avis an Kunden

⚡ Kaskaden & Folgeprozesse (Cascades)

shipment_dispatched -> update_sales_order_status: Auftrag wird als versendet markiert
tracking_delivered -> trigger_customer_review: Einladung zur Kundenzufriedenheitsbewertung
license_check_failed -> lock_vehicle_assignment: Fahrersperre im Fuhrpark
uvv_expired -> set_vehicle_status_maintenance: Fahrzeugsperre bis zur Werkstattprüfung

🛡️ Nebenprozesse & Resilienz

Schadensabwicklung bei Transportschäden mit Speditionsregress
Zollabfertigung und Ausfuhranmeldung über ATLAS bei Drittlandsendungen
Kraftstoff- und Tankkartenabrechnung mit Plausibilitätsprüfung (Verbrauch l/100km)
Bußgeldbearbeitung und Zeugenfragebogenverwaltung im Fuhrpark

💡 No-Code Checkliste & Praxistipps

Speditions- und Paketdienst-Zugangsdaten (API-Keys) im System hinterlegen
Zyklen für Führerscheinprüfung (Standard: 6 Monate) in Fuhrparkrichtlinien definieren
Frachtkostenstaffeln nach Gewicht und Postleitzahlenzonen pflegen
No-Code Zusatzfelder für Maut-OBU und Gefahrgut auf LogisticsShipment anlegen

🗄️ Data Models & Fields

VehicleTradeInAgreements vehicle_trade_in_agreements RLS Aktiv

24 Fields / Columns

Tabelle vehicle_trade_in_agreements

Feldname	Data Type	Required	Schlüssel	Functional Meaning
`agreement_number`	`VARCHAR(32)`	Ja *	-	Feld agreement_number
`customer_id`	`UUID`	Ja *	FK ➔ customers.id	Feld customer_id
`vehicle_id`	`UUID`	Ja *	FK ➔ vehicles.id	Feld vehicle_id
`agreed_price`	`NUMERIC(14, 2)`	Ja *	-	Feld agreed_price
`existing_financing_bank`	`VARCHAR(128)`	Nein	-	Feld existing_financing_bank
`existing_financing_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld existing_financing_amount
`net_credit_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld net_credit_amount
`offset_sales_invoice_id`	`UUID`	Nein	FK ➔ invoices.id	Feld offset_sales_invoice_id
`declaration_accident_free`	`BOOLEAN`	Ja *	-	Feld declaration_accident_free
`declaration_commercial_use`	`BOOLEAN`	Ja *	-	Feld declaration_commercial_use
`number_of_keys`	`INTEGER`	Ja *	-	Feld number_of_keys
`registration_doc_part1_present`	`BOOLEAN`	Ja *	-	Feld registration_doc_part1_present
`registration_doc_part2_present`	`BOOLEAN`	Ja *	-	Feld registration_doc_part2_present
`status`	`VARCHAR(32)`	Ja *	-	Feld status
`notes`	`TEXT`	Nein	-	Feld notes
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

Vehicles vehicles RLS Aktiv

58 Fields / Columns

Tabelle vehicles

Feldname	Data Type	Required	Schlüssel	Functional Meaning
`vin`	`VARCHAR(17)`	Ja *	-	Feld vin
`license_plate`	`VARCHAR(32)`	Nein	-	Feld license_plate
`make`	`VARCHAR(64)`	Ja *	-	Feld make
`model`	`VARCHAR(64)`	Ja *	-	Feld model
`variant`	`VARCHAR(128)`	Nein	-	Feld variant
`body_type`	`VARCHAR(32)`	Nein	-	Feld body_type
`first_registration_date`	`DATE`	Nein	-	Feld first_registration_date
`mileage`	`INTEGER`	Ja *	-	Feld mileage
`fuel_type`	`VARCHAR(32)`	Ja *	-	Feld fuel_type
`transmission`	`VARCHAR(32)`	Ja *	-	Feld transmission
`power_kw`	`INTEGER`	Nein	-	Feld power_kw
`power_hp`	`INTEGER`	Nein	-	Feld power_hp
`engine_displacement_ccm`	`INTEGER`	Nein	-	Feld engine_displacement_ccm
`exterior_color`	`VARCHAR(64)`	Nein	-	Feld exterior_color
`interior_color`	`VARCHAR(64)`	Nein	-	Feld interior_color
`hsn`	`VARCHAR(4)`	Nein	-	Feld hsn
`tsn`	`VARCHAR(4)`	Nein	-	Feld tsn
`emission_class`	`VARCHAR(32)`	Nein	-	Feld emission_class
`tuv_until`	`DATE`	Nein	-	Feld tuv_until
`previous_owners`	`INTEGER`	Ja *	-	Feld previous_owners
`accident_free`	`BOOLEAN`	Ja *	-	Feld accident_free
`damage_notes`	`TEXT`	Nein	-	Feld damage_notes
`features`	`JSONB`	Ja *	-	Feld features
`status`	`VARCHAR(32)`	Ja *	-	Feld status
`tax_regime`	`VARCHAR(32)`	Ja *	-	Feld tax_regime
`purchase_date`	`DATE`	Nein	-	Feld purchase_date
`purchase_price`	`NUMERIC(14, 2)`	Ja *	-	Feld purchase_price
`purchase_type`	`VARCHAR(32)`	Ja *	-	Feld purchase_type
`seller_customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld seller_customer_id
`supplier_id`	`UUID`	Nein	FK ➔ suppliers.id	Feld supplier_id
`reconditioning_cost`	`NUMERIC(14, 2)`	Ja *	-	Feld reconditioning_cost
`total_cost`	`NUMERIC(14, 2)`	Ja *	-	Feld total_cost
`asking_price`	`NUMERIC(14, 2)`	Ja *	-	Feld asking_price
`min_price`	`NUMERIC(14, 2)`	Nein	-	Feld min_price
`sold_price`	`NUMERIC(14, 2)`	Nein	-	Feld sold_price
`sold_date`	`DATE`	Nein	-	Feld sold_date
`buyer_customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld buyer_customer_id
`invoice_id`	`UUID`	Nein	FK ➔ invoices.id	Feld invoice_id
`purchase_id`	`UUID`	Nein	FK ➔ purchases.id	Feld purchase_id
`trade_in_for_vehicle_id`	`UUID`	Nein	FK ➔ vehicles.id	Feld trade_in_for_vehicle_id
`location`	`VARCHAR(128)`	Nein	-	Feld location
`ad_title`	`VARCHAR(255)`	Nein	-	Feld ad_title
`ad_description`	`TEXT`	Nein	-	Feld ad_description
`is_listed_mobile_de`	`BOOLEAN`	Ja *	-	Feld is_listed_mobile_de
`mobile_de_ad_id`	`VARCHAR(64)`	Nein	-	Feld mobile_de_ad_id
`is_listed_autoscout24`	`BOOLEAN`	Ja *	-	Feld is_listed_autoscout24
`autoscout24_ad_id`	`VARCHAR(64)`	Nein	-	Feld autoscout24_ad_id
`listing_status`	`VARCHAR(32)`	Ja *	-	Feld listing_status
`images`	`JSONB`	Ja *	-	Feld images
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

🔌 Entry Points (UI & APIs)

Art	Method	Endpoint / Path	Titel & Zweck	Required Role
⚡ REST API	GET	`/vehicles`	vehicles_page Semantic binding: inventory_only; mutation=False	`vehicles`
⚡ REST API	GET	`/vehicles/export/autoscout24`	export_autoscout24_route Semantic binding: inventory_only; mutation=False	`vehicles`
⚡ REST API	GET	`/vehicles/export/csv`	export_vehicles_csv_route Semantic binding: inventory_only; mutation=False	`vehicles`
⚡ REST API	GET	`/vehicles/export/mobile-de`	export_mobile_de_route Semantic binding: inventory_only; mutation=False	`vehicles`
⚡ REST API	GET	`/vehicles/new`	vehicle_create_page Semantic binding: inventory_only; mutation=False	`vehicles`
⚡ REST API	GET	`/vehicles/{vehicle_id}`	vehicle_detail_page Semantic binding: inventory_only; mutation=False	`vehicles`
⚡ REST API	POST	`/vehicles`	create_vehicle_form Semantic binding: operator_surface; mutation=True	`vehicles`
⚡ REST API	POST	`/vehicles/trade-in`	create_trade_in_route Semantic binding: operator_surface; mutation=True	`vehicles`
⚡ REST API	POST	`/vehicles/{vehicle_id}/create-invoice`	create_vehicle_invoice_route Semantic binding: operator_surface; mutation=True	`vehicles`
⚡ REST API	POST	`/vehicles/{vehicle_id}/reconditioning`	add_vehicle_reconditioning_cost Semantic binding: operator_surface; mutation=True	`vehicles`

🛡️ Regulatory & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

GoBD Nachvollziehbarkeit
Mandanten-Isolation (PostgreSQL RLS)