#Bisherige Schnittstelle

Vor der API v1 gab es POST /extern/transportauftraege. Sie läuft unverändert weiter, damit keine bestehende Anbindung bricht. Neue Anbindungen nutzen die API v1 (/extern/orders): strukturierte Adressen, Transportart und Zulassung, ändern und stornieren, OAuth 2.0 und Rechte je Zugang, ein einheitliches Fehlerformat (Endpunkte).

Was diese Seite beschreibt, gilt nur für die bisherige Schnittstelle.

#Endpunkte

Basisadresse: https://api.logicar.cloud/api/v1

#Anmeldung

Nur mit einem API-Schlüssel, als Authorization: Bearer lc_… oder X-API-Key: lc_…, mit dem Recht orders:write zum Einstellen und Steuern und orders:read zum Abfragen. Ein OAuth-Client und seine Token gelten hier nicht.

#Auftrag einstellen

POST /api/v1/extern/transportauftraege
Authorization: Bearer lc_live_…
Content-Type: application/json

Pflicht sind nur Abhol- und Zielort, jeweils als eine Zeile.

Auswahlfelder nehmen jede Schreibweise an (car wird CAR); ein unbekannter Wert ist ein Fehler, der die erlaubten Werte nennt. Feldnamen werden auch in snake_case angenommen (external_order_id, end_customer_email).

{
  "externalOrderId": "SAP-4500019283",
  "pickup": "Musterstraße 12, 20095 Hamburg",
  "delivery": "Beispielweg 5, 80331 München",
  "pickupDate": "2026-10-01T08:00:00Z",
  "expectedDeliveryDate": "2026-10-01T18:00:00Z",
  "vehicleType": "CAR",
  "fuelType": "DIESEL",
  "vin": "WVWZZZ1KZAW000001",
  "vehicleMake": "Volkswagen",
  "vehicleModel": "Golf",
  "vehicleYear": 2021,
  "pickupContactName": "Autohaus Beispiel, Frau Muster",
  "pickupContactPhone": "+49 40 123456",
  "deliveryContactName": "Fuhrpark Beispiel, Herr Beispiel",
  "deliveryContactPhone": "+49 89 654321",
  "notes": "Schlüssel liegt beim Empfang.",
  "endCustomerEmail": "empfaenger@example.com"
}

Antwort (201 Created):

{
  "art": "ORDER",
  "wiederholung": false,
  "orderId": "8c1d2e3f-4a5b-4c6d-9e7f-0a1b2c3d4e5f",
  "orderNumber": "26K7F070042E",
  "status": "OPEN",
  "externalOrderId": "SAP-4500019283",
  "verworfeneFelder": []
}

#Auftrag oder Anfrage

• art: "ORDER" — der Auftrag ist angelegt und wird zum vereinbarten Preis durchgeführt.
• art: "REQUEST" — dieser Fall braucht ein Angebot. Erst nach der Annahme entsteht der Auftrag, und Ihr System bekommt order.created. hinweis sagt in einem Satz, warum.

#Was verworfen wird

Anders als die API v1 lehnt die bisherige Schnittstelle unbekannte Felder nicht ab: sie übernimmt sie nicht. Preisfelder werden verworfen und in verworfeneFelder benannt, hinweis sagt es in Worten.

basePrice price priceNet priceGross priceVatRate manualPrice priceAdjustmentPercent discount status tenantId customerId driverId executingTenantId awardType orderSource priceSnapshot payoutNet payoutGross

#Wiederholungen

Wiedererkannt wird ein Aufruf über die externalOrderId, sonst über den Idempotency-Key — unter Aufträgen und Anfragen. Eine Wiederholung ergibt keinen zweiten Vorgang, sondern die Antwort des ersten mit wiederholung: true und HTTP 200. Geprüft wird die Kennung, nicht der Inhalt: ein zweiter Aufruf mit geänderten Feldern ändert den Auftrag nicht.

#Stand

GET /extern/transportauftraege/{kennung} nimmt jede Nummer, unter der Sie den Vorgang kennen: unsere Auftrags- oder Anfragenummer, die interne Kennung oder Ihre externalOrderId. Die Antwort nennt den internen Status:

Webhook-Endpunkte, die vor dem 23.09.2026 angelegt wurden, bekommen jeden Wechsel dieses Status als order.status_changed (bisheriges Format).

#Fehler

Fehlerantworten haben hier die Form { "error", "message", "details"?, "requestId" }:

{
  "error": "INVALID_INPUT",
  "message": "Die Auftragsdaten sind unvollständig.",
  "details": {
    "fehler": [
      { "feld": "delivery", "grund": "Der Zustellort fehlt." },
      { "feld": "vehicleType", "grund": "Unbekannter Wert. Erlaubt: CAR, COMBI, SUV, VAN, TRUCK_7_5, TRUCK_12, TRUCK_40." }
    ]
  },
  "requestId": "…"
}