Zum Hauptinhalt springen

Create a new vehicle in the fleet

POST 
/company/vehicles/

Registriert ein neues Fahrzeug im Fuhrpark des Unternehmens mit zugehörigen Metadaten und optionalen Datei-Uploads.

Ziel​

Unternehmen ermöglichen, Fahrzeuge mit detaillierten Spezifikationen in ihren Fuhrpark aufzunehmen, einschließlich Frachtarten, Transportfähigkeiten und Dokumentation (Bilder und ITV-Zertifikate).

Anwendungsfälle​

  • Ein neu erworbenes Fahrzeug mit allen Spezifikationen registrieren
  • Fahrzeugdokumentation hochladen (Bild, ITV-Zertifikat)
  • Ein Fahrzeug als Standardfahrzeug des Benutzers für digitale Signaturvorgänge festlegen
  • Fuhrparkdaten aus externen Systemen migrieren

Validierungsablauf​

flowchart TD
  A[Anfrage empfangen] --> B{Zahlungslimit OK?}
  B -->|Nein| C[402 Zahlung erforderlich]
  B -->|Ja| D{Benutzer hat Unternehmen?}
  D -->|Nein| E[401 CIA_NOT_FOUND]
  D -->|Ja| F{Erforderliche Felder vorhanden?}
  F -->|Nein| G[400 Validierungsfehler]
  F -->|Ja| H{shipping_type = fresh?}
  H -->|Ja| I{fresh_cargo_temp gültig?}
  I -->|Nein| J[400 Temp erforderlich]
  I -->|Ja| K[Fahrzeug erstellen]
  H -->|Nein| K
  K --> L{default_vehicle = true?}
  L -->|Ja| M[Benutzer-Standard aktualisieren]
  L -->|Nein| N[Nutzung für Abrechnung registrieren]
  M --> N
  N --> O[Erstelltes Fahrzeug zurückgeben]

Zahlungslimits​

Dieser Endpunkt unterliegt über die Middleware isPaymentUpdate den Limits des Zahlungsplans. Wenn das Unternehmen sein Fahrzeuglimit erreicht hat, schlägt die Anfrage mit Fehler 402 fehl.

Bedingte Validierung​

  • Wenn shipping_type = 'fresh', ist das Feld `

Request​

Responses​

Fahrzeug erfolgreich erstellt.

Response Headers