Gibt eine paginierbare Liste der Bestandsfahrzeuge zurück, inklusive Stammdaten, technischer Daten, Garantie- und Schlüsseldaten sowie Standort.

Parameter

GET /api/vehicles/list?token=IHRGEHEIMERCATAMATOKEN
    (sämtliche Bestandsfahrzeuge)

GET /api/vehicles/list?token=IHRGEHEIMERCATAMATOKEN&take=10&offset=10
    (maximal 10 Fahrzeuge ab dem 10. Datensatz)

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

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

{
  "data": {
    "108": {
      "id": 108,
      "intern_id": "FZ-00108",
      "branch_id": 1,
      "fabricator_id": "12",
      "fabricator": "Volkswagen",
      "kind_id": "1",
      "name": "Golf",
      "modell": "VII 2.0 TDI",
      "name_modell": "Golf VII 2.0 TDI",
      "chassis_number": "WVWZZZ1KZAW000000",
      "plate": "M-AB 1234",
      "registration_date": "15.03.2020",
      "registration_year": 2020,
      "general_inspection": "01.06.2027",
      "purchased_at": "02.08.2026",
      "nextservice_at": "01.03.2027",
      "added_time": "16.08.2026",
      "mileage": 84500,
      "power_ps": "150",
      "power_kw": "110",
      "cubic": "1968",
      "seats": "5",
      "gas": "Diesel",
      "emission_id": "6d",
      "geartype_id": "2",
      "drivetype_id": "1",
      "type_id": 2,
      "type_name": "Gebrauchtfahrzeug",
      "category_id": 2704,
      "category": "Fahrzeugeinkauf §25a",
      "vat_removeable": 0,
      "vehicle_category_id": "3",
      "color": "Schwarz",
      "basic_color": "Schwarz",
      "interiorcolor": "Stoff Anthrazit",
      "status_type": 1,
      "status": 1,
      "mobile_status": 1,
      "location_id": "1",
      "location_name": "Halle 1",
      "description_html": "<p>Scheckheftgepflegt</p>",
      "..."
    }
  },
  "status": 1,
  "message": "Success"
}

Felder im Fahrzeug-Objekt

Diese 81 Felder liefert /api/vehicles/list. /api/vehicles/listing liefert dieselben Felder außer purchase_price und diff_tax plus neun Zusatzfelder, /api/vehicles/byid liefert 74 davon – die Unterschiede stehen jeweils im entsprechenden Abschnitt.

Ruft ein einzelnes Bestandsfahrzeug anhand seiner ID ab.

Parameter

GET /api/vehicles/byid?id=1&token=IHRGEHEIMERCATAMATOKEN

{
  "data": {
    "1": {
      "id": 1,
      "intern_id": "FZ-00001",
      "fabricator_id": "12",
      "fabricator": "Volkswagen",
      "name": "Golf",
      "modell": "VII 2.0 TDI",
      "chassis_number": "WVWZZZ1KZAW000000",
      "..."
    }
  },
  "status": 1,
  "message": "Success"
}

Liefert die Fahrzeuge, die für die Fahrzeugbörse bzw. die eigene Webseite freigegeben sind – inklusive Verkaufspreis, Verfügbarkeitsstatus und Foto-URLs. Dieser Endpunkt ist die Grundlage der CATAMA CarListing-Anbindung.

Parameter

GET /api/vehicles/listing?token=IHRGEHEIMERCATAMATOKEN
    (alle freigegebenen Fahrzeuge mit Thumbnails)

GET /api/vehicles/listing?token=IHRGEHEIMERCATAMATOKEN&photosize=full
    (mit Bildern in voller Größe)

GET /api/vehicles/listing?token=IHRGEHEIMERCATAMATOKEN&take=20&offset=0&photos=0
    (erste 20 Fahrzeuge ohne Bilder)

Zusatzfelder gegenüber /api/vehicles/list

Die Antwort enthält 79 der 81 Felder aus /api/vehicles/list (ohne purchase_price und diff_tax) und zusätzlich diese neun:

{
  "data": {
    "108": {
      "id": 108,
      "fabricator": "Volkswagen",
      "name_modell": "Golf VII 2.0 TDI",
      "registration_year": 2020,
      "mileage": 84500,
      "price": "18900.00",
      "carlisting_vk_netto": "15882.35",
      "carlisting_uvp_price": "21500.00",
      "carlisting_show_uvp": 1,
      "carlisting_show_freight": 0,
      "finance_additionalcost_transport": "690.00",
      "carlisting_status": 1,
      "carlisting_status_name": "Verfügbar",
      "photos": [
        "https://ihre-instanz.catama-software.de/storage/images/mobiles/108/t_bild1.jpg",
        "https://ihre-instanz.catama-software.de/storage/images/mobiles/108/t_bild2.jpg"
      ],
      "..."
    }
  },
  "status": 1,
  "message": "Success"
}

Legt ein neues Bestandsfahrzeug an. Die Anlage läuft intern über dieselbe Routine wie die Fahrzeugmaske in CATAMA – Intern-Nummern-Vergabe, Schlüsseltresor-Zuordnung, Standardbilder und der Eintrag im Änderungsprotokoll verhalten sich identisch zur manuellen Anlage.

Die Felder werden form-encoded (application/x-www-form-urlencoded) oder als JSON-Body übergeben.

Pflichtfelder

Schreibbare Felder (create und update)

Einkaufs-Steuerart und Warengruppe

Die DATEV-Konten hängen an der Warengruppe des Fahrzeugs (category_id bzw. category), nicht an der Fahrzeugkategorie. Ob die Umsatzsteuer ausgewiesen wird, steuert vat_removeable. Beide Felder lassen sich bei create und update setzen:

Für den innergemeinschaftlichen Erwerb gibt es kein eigenes Kennzeichen – er wird über eine eigene Warengruppe mit den passenden Konten abgebildet. Übergeben Sie diese deshalb immer explizit.

POST /api/vehicles/update
Content-Type: application/x-www-form-urlencoded

token=IHRGEHEIMERCATAMATOKEN
&id=108
&vat_removeable=0
&category_id=22

(alternativ statt category_id: &category=Fahrzeugeinkauf §25a)

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

token=IHRGEHEIMERCATAMATOKEN
&fabricator_id=12
&name=Golf
&modell=VII 2.0 TDI
&chassis_number=WVWZZZ1KZAW000000
&mileage=84500
&price=18900,00
&purchase_price=15400,00
&registration_date=15.03.2020
&general_inspection=06.2027
&vat_removeable=0
&category_id=22
&user_id=74

{
  "status": 1,
  "message": "Success",
  "data": {
    "vehicle": {
      "id": 108,
      "intern_id": "FZ-00108",
      "name": "Golf",
      "modell": "VII 2.0 TDI",
      "fabricator_id": 12,
      "status_type": 1,
      "mobile_status": 1,
      "branch_id": 1,
      "category_id": 22,
      "vat_removeable": 0
    }
  },
  "vehicle_id": 108
}

Fehlerfälle

Ändert ein bestehendes Bestandsfahrzeug. POST und PATCH verhalten sich identisch – beide führen ein Teil-Update durch: Es werden ausschließlich die Felder geschrieben, die im Request enthalten sind. Alle übrigen Daten des Fahrzeugs, einschließlich Fotos, Dokumenten und Datumsfeldern, bleiben unverändert.

Pflichtfelder

Dazu mindestens ein schreibbares Feld aus der Tabelle bei /api/vehicles/create. branch_id wird beim Update ignoriert – ein Fahrzeug bleibt in seiner Filiale.

PATCH /api/vehicles/update
Content-Type: application/x-www-form-urlencoded

token=IHRGEHEIMERCATAMATOKEN&id=108&mileage=87200&user_id=74
    (nur der Kilometerstand wird geändert)

POST /api/vehicles/update
Content-Type: application/json

{ "token": "IHRGEHEIMERCATAMATOKEN", "id": 108, "price": "17900.00", "mobile_status": 2 }
    (Preis senken und auf "reserviert" setzen)

{
  "status": 1,
  "message": "Success",
  "data": {
    "vehicle": {
      "id": 108,
      "updated_fields": ["mileage"],
      "recalculated_documents": []
    }
  },
  "vehicle_id": 108
}

Fehlerfälle

Referenz: status_type

Referenz: mobile_status