Gibt eine paginierbare Liste der Kundenfahrzeuge zurück, inklusive Stammdaten, technischer Daten, Garantie- und Schlüsseldaten. Optional lassen sich die Daten des zugeordneten Kunden mitliefern.

Parameter

GET /api/customerscars/list?token=IHRGEHEIMERCATAMATOKEN
    (sämtliche Kundenfahrzeuge)

GET /api/customerscars/list?token=IHRGEHEIMERCATAMATOKEN&take=50&offset=0
    (die ersten 50 Fahrzeuge)

GET /api/customerscars/list?token=IHRGEHEIMERCATAMATOKEN&statusid=2
    (nur inaktive Fahrzeuge)

GET /api/customerscars/list?token=IHRGEHEIMERCATAMATOKEN&withcustomerdata=1
    (mit den Daten des zugeordneten Kunden)

GET /api/customerscars/list?token=IHRGEHEIMERCATAMATOKEN&branch_id=2
    (nur Fahrzeuge der Filiale 2)

{
  "data": {
    "1085": {
      "id": 1085,
      "customer_id": 200,
      "intern_id": "KFZ-001",
      "branch_id": 1,
      "fabricator_id": "3",
      "fabricator": "Volkswagen",
      "kind_id": "2",
      "name": "Golf VII",
      "modell": "1.4 TSI",
      "chassis_number": "WVWZZZ3CZWE123456",
      "plate": "B-AB 1234",
      "registration_date": "15.03.2019",
      "mileage": 85000,
      "power_ps": "150",
      "power_kw": "110",
      "cubic": "1395",
      "gas": "Benzin",
      "general_inspection": "01.03.2026",
      "nextservice_at": "01.09.2026",
      "color": "Silber metallic",
      "basic_color": "Silber",
      "category_id": "3",
      "description_html": "<p>Scheckheftgepflegt</p>",
      "..."
    },
    "1086": { "..." }
  },
  "status": 1,
  "message": "Success"
}

Felder im Fahrzeug-Objekt

Die folgenden 68 Felder liefern alle drei Lese-Endpunkte (list, byid, byparam) identisch. Leere Datumsfelder kommen als leerer String.

Ruft ein Kundenfahrzeug anhand der Fahrzeug-ID ab – oder alle Fahrzeuge eines Kunden anhand der Kunden-ID. Die Feldstruktur entspricht /api/customerscars/list.

Parameter

GET /api/customerscars/byid?token=IHRGEHEIMERCATAMATOKEN&id=1085
    (ein bestimmtes Fahrzeug)

GET /api/customerscars/byid?token=IHRGEHEIMERCATAMATOKEN&customerid=200&withcustomerdata=1
    (alle Fahrzeuge des Kunden 200, mit Kundendaten)

Fehlerfälle

Sucht Kundenfahrzeuge anhand der Fahrgestellnummer (VIN) und/oder des Kennzeichens. Die Feldstruktur der Antwort entspricht /api/customerscars/list.

Parameter

GET /api/customerscars/byparam?token=IHRGEHEIMERCATAMATOKEN&vin=WVWZZZ3CZWE123456
    (Suche über die vollständige Fahrgestellnummer)

GET /api/customerscars/byparam?token=IHRGEHEIMERCATAMATOKEN&vin=ZZZ3CZ
    (Teilstring der Fahrgestellnummer)

GET /api/customerscars/byparam?token=IHRGEHEIMERCATAMATOKEN&plate=B-AB

Fehlerfälle

Legt ein neues Kundenfahrzeug an und ordnet es einem bestehenden Kunden zu. Der Kunde und das Fabrikat müssen bereits im System existieren. Die Felder werden form-encoded (application/x-www-form-urlencoded) oder als JSON-Body übergeben.

Pflichtfelder

Optionale Felder – Text

Optionale Felder – Zahlen

Optionale Felder – Datum

POST /api/customerscars/create
Content-Type: application/x-www-form-urlencoded

token=IHRGEHEIMERCATAMATOKEN
&customer_id=200
&fabricator=3
&name=Golf VII
&modell=1.4 TSI
&chassis_number=WVWZZZ3CZWE123456
&mobile_sign=B-AB 1234
&ez=15.03.2019
&general_inspection=03.2026
&mileage=85000

{
  "data": {
    "clientmobile_id": 1085,
    "customer_id": 200,
    "fabricator": 3,
    "name": "Golf VII",
    "branch_id": 1,
    "modell": "1.4 TSI",
    "chassis_number": "WVWZZZ3CZWE123456",
    "mobile_sign": "B-AB 1234",
    "ez": "15.03.2019",
    "general_inspection": "03.2026",
    "mileage": "85000"
  },
  "status": 1,
  "message": "Success",
  "clientmobile_id": 1085
}

Fehlerfälle

Kundendaten-Objekt (withcustomerdata=1)

Wird bei list, byid oder byparam der Parameter withcustomerdata=1 gesetzt, enthält die Antwort zusätzlich das Objekt customer_data mit den Stammdaten des zugeordneten Kunden.

Feldnamen beim Lesen und beim Schreiben

Einige Felder heißen beim Anlegen anders als in der Leseantwort. Diese Tabelle listet alle Abweichungen:

Änderungen und Löschen

Für Kundenfahrzeuge gibt es derzeit keinen Endpunkt zum Ändern oder Löschen. Bestehende Fahrzeuge werden in CATAMA über die Kundenakte gepflegt. Ein Teil-Update wie bei den Bestandsfahrzeugen (/api/vehicles/update) existiert hier nicht.

Antwortformat

Alle vier Endpunkte antworten mit Content-Type: application/json; charset=utf-8 und einem Objekt mit den Schlüsseln status (1 = Erfolg, 0 = Fehler), message und data. Der HTTP-Statuscode ist immer 200, auch im Fehlerfall – maßgeblich ist das Feld status. Das unterscheidet die Kundenfahrzeug-Endpunkte von den Schreib-Endpunkten der Bestandsfahrzeuge, die zusätzlich sprechende HTTP-Codes setzen.