#Überblick

Mit der LOGICAR-Schnittstelle stellt Ihr System Fahrzeugüberführungen selbst ein — aus der Warenwirtschaft, dem Leasing- oder Flottensystem, ohne dass jemand Daten abtippt. Den Fortschritt bekommt Ihr System per Webhook zurück: von der Freigabe über die Abholung bis zur Übergabe mit Protokoll.

#Der Ablauf

Ihr System                          LOGICAR
────────────                        ───────────────────────────────────
POST /extern/oauth/token        ──▶ prüft Zugang und Rechte
                                ◀── 200 { access_token, expires_in: 3600 }
POST /extern/orders             ──▶ prüft, bepreist nach Ihrer Vereinbarung
                                ◀── 201 { kind: "ORDER", id, orderNumber, status }
                                    …freigegeben, Fahrer zugewiesen, abgeholt, zugestellt…
Ihr Webhook-Endpunkt            ◀── order.accepted, driver.assigned, vehicle.delivered, …
GET /extern/orders/{id}/status  ──▶ Stand jederzeit abfragen

#Die Begriffe

Zugang — mit ihm meldet sich Ihr System an: als OAuth-Client (Client-Kennung und Secret, dafür ein Token für eine Stunde) oder mit einem API-Schlüssel. Jeder Zugang hat einen Namen und eigene Rechte, etwa „SAP Produktion“ mit orders:write (Anmeldung).

Auftrag — eine Überführung, die LOGICAR durchführt. Er hat eine Kennung und eine Auftragsnummer von uns und, wenn Sie sie mitgeben, Ihre eigene (externalOrderId). Über alle drei finden Sie ihn wieder.

Anfrage — sieht Ihre Vereinbarung für einen Fall ein Angebot vor (etwa eine Strecke außerhalb der vereinbarten Standardfälle), entsteht zuerst eine Anfrage (kind: "REQUEST", HTTP 202). Sie bekommen ein Angebot; nach der Annahme wird daraus ein Auftrag, und Ihr System erhält order.created. Ein Angebot lesen, ablehnen und — wenn Ihre Vereinbarung es vorsieht — annehmen kann Ihr System auch selbst (Angebote).

Preis — bestimmt Ihre Vereinbarung mit LOGICAR, nicht der Aufruf. Einen Preis kann Ihr System gar nicht mitschicken: ein unbekanntes Feld wie basePrice ergibt 400 mit dem Feldnamen (Auftrag anlegen).

Webhook — eine HTTPS-Adresse Ihres Systems, an die LOGICAR jedes abonnierte Ereignis schickt, signiert und mit Wiederholungen (Webhooks einrichten).

Umgebung — Echtbetrieb oder Sandbox. Welche gilt, entscheidet allein der Zugang: ein Schlüssel lc_live_… oder lc_test_…. Dieselben Endpunkte, dieselben Prüfungen, dieselben Webhooks — nur dass in der Sandbox kein Fahrer losfährt (Die Sandbox).

#Was Sie brauchen

1. Ein Konto als Auftraggeber bei LOGICAR mit Administratorrechten.
2. Einen Zugang — zuerst einen für die Sandbox. Die Sandbox steht jedem Auftraggeber offen; den Echtbetrieb der Schnittstelle schaltet LOGICAR für Ihr Konto frei.
3. Für Rückmeldungen: eine per HTTPS erreichbare Adresse. Für die ersten Versuche genügt der Test-Empfänger der Plattform.

#Referenz zum Mitnehmen

Die vollständige Beschreibung als OpenAPI 3.1 liegt unter /openapi.json — zum Import in Postman, Insomnia oder einen Codegenerator. Sie entsteht aus demselben Code, der Ihre Aufrufe prüft, und ist deshalb immer auf dem Stand des Servers.

Systeme, die schon die bisherige Schnittstelle /extern/transportauftraege nutzen, laufen unverändert weiter.