#Häufige Fragen

#Was brauche ich, um anzufangen?

Ein Konto als Auftraggeber bei LOGICAR und darin Administratorrechte. Damit legen Sie im Portal unter Einstellungen → API-Zugang einen Testzugang an und können sofort in der Sandbox loslegen (Schnellstart).

#Kostet die Sandbox etwas?

Nein. Testvorgänge werden nie durchgeführt und nie berechnet.

#Wie komme ich von der Sandbox in den Echtbetrieb?

LOGICAR schaltet den Echtbetrieb der Schnittstelle für Ihr Konto frei. Dann den Zugang tauschen (lc_test_… → lc_live_… bzw. ein OAuth-Client des Echtbetriebs) und einen Webhook-Endpunkt für den Echtbetrieb anlegen. Vorher die Checkliste durchgehen.

#Warum ist aus meinem Aufruf eine Anfrage geworden und kein Auftrag?

Ihre Vereinbarung sieht für diesen Fall ein Angebot vor — etwa weil Strecke oder Fahrzeug außerhalb der vereinbarten Standardfälle liegen. Die Antwort ist dann HTTP 202 mit kind: "REQUEST". Sie bekommen ein Angebot; nach der Annahme entsteht der Auftrag, und Ihr System erhält order.created (Auftrag oder Anfrage).

#Kann unser System ein Angebot selbst annehmen?

Lesen und ablehnen immer: GET /quotes/{id} und POST /quotes/{id}/decline. Annehmen mit POST /quotes/{id}/accept nur, wenn Ihre Vereinbarung mit LOGICAR das vorsieht — eine Annahme Ihres Systems ist verbindlich, ohne Unterschrift. Ob es so vereinbart ist, zeigt acceptance.viaApi in jedem Angebot; sonst nimmt ein Mensch über den Link in der Angebotsmail an (Angebote).

#Kann ich einen Auftrag über die API ändern oder stornieren?

Ja, bis zur Abholung: PATCH /api/v1/extern/orders/{id} ändert Termine, Ansprechpartner, Referenz, Hinweis, FIN und Kennzeichen, POST /api/v1/extern/orders/{id}/cancel storniert (Endpunkte). Danach klärt ein Mensch, was geschehen soll — der Fahrer ist dann mit dem Fahrzeug unterwegs. Verschobene Termine und Stornierungen erfährt Ihr System per Webhook (order.rescheduled, order.cancelled), auch wenn sie aus dem Portal kommen.

#Warum bekomme ich 400, wenn ich einen Preis mitschicke?

Preise bestimmt Ihre Vereinbarung, nicht der Aufruf. Ein Preisfeld gibt es deshalb nicht, und ein unbekanntes Feld ist ein Fehler — damit niemand glaubt, ein Preis sei vereinbart (mehr). Den Preis nach Ihrer Vereinbarung nennt die Antwort in price.

#Ich habe denselben Auftrag zweimal geschickt. Gibt es ihn jetzt doppelt?

Nicht, wenn beide Aufrufe denselben Idempotency-Key oder dieselbe externalOrderId trugen: der zweite bekommt die Antwort des ersten, mit dem Kopf Idempotent-Replayed: true (Wiederholungen).

#Bekomme ich die Übergabeprotokolle?

Ja. vehicle.picked_up und vehicle.delivered melden Abholung und Übergabe; sobald das Protokoll als Dokument vorliegt, kommt document.uploaded mit der Adresse zum Abruf (GET /api/v1/extern/orders/{id}/documents/{documentId}, Recht documents:read). Ist ein Schaden vermerkt, kommt damage.reported. Endpunkte im bisherigen Format bekommen weiter protocol.pickup.submitted und protocol.delivery.submitted mit Kilometerstand und Tankfüllung.

#Kommen Webhooks in der richtigen Reihenfolge?

Meist, aber nicht garantiert: nach einer Störung Ihres Endpunkts können Wiederholungen nach jüngeren Nachrichten eintreffen. Maßgeblich ist createdAt mit data.status (Zustellung).

#Gibt es OAuth 2.0 oder fertige Konnektoren für SAP, Dynamics oder Salesforce?

OAuth 2.0 ja: als Client Credentials, dem Standard von SAP Integration Suite, Azure Logic Apps und MuleSoft (Anmeldung). Fertige Konnektoren, mit denen LOGICAR Aufträge selbst aus SAP, Dynamics oder Salesforce abholt und den Stand dorthin zurückschreibt, sind geplant; wir kündigen sie im Änderungsprotokoll an. Eine Anbindung aus SAP funktioniert schon heute über die REST-Schnittstelle, etwa aus der SAP Integration Suite.

#Meine Frage steht hier nicht.

Schreiben Sie uns (Kontakt). Was mehrfach gefragt wird, kommt auf diese Seite.