Zum Inhalt springen
LOGICAR Entwickler Suchen

#Szenarien

Auf dieser Seite

Jeder Testvorgang durchläuft ein Szenario. Jeder Schritt setzt einen Stand und schickt genau die Webhooks, die der Echtbetrieb in dieser Lage schicken würde.

#Die Szenarien

Standard STANDARD

Ausgeschrieben, Fahrer zugewiesen und angenommen, abgeholt, zugestellt, abgeschlossen.

  1. Auftrag angelegt order.created order.accepted
  2. Fahrt ausgeschrieben
  3. Fahrer zugewiesen order.scheduled driver.assigned
  4. Fahrer hat angenommen
  5. Fahrer auf dem Weg zur Abholung pickup.started pickup.arrived
  6. Fahrzeug abgeholt vehicle.picked_up transport.started
  7. Am Ziel angekommen delivery.arrived
  8. Fahrzeug übergeben vehicle.delivered
  9. Auftrag abgeschlossen order.completed

Verspätung DELAY

Wie Standard, unterwegs verschiebt sich der Liefertermin um zwei Stunden (transport.delayed und order.rescheduled; im bisherigen Format order.updated).

  1. Auftrag angelegt order.created order.accepted
  2. Fahrt ausgeschrieben
  3. Fahrer zugewiesen order.scheduled driver.assigned
  4. Fahrer hat angenommen
  5. Fahrer auf dem Weg zur Abholung pickup.started pickup.arrived
  6. Fahrzeug abgeholt vehicle.picked_up transport.started
  7. Verspätung gemeldet transport.delayed order.rescheduled
  8. Am Ziel angekommen delivery.arrived
  9. Fahrzeug übergeben vehicle.delivered
  10. Auftrag abgeschlossen order.completed

Schaden DAMAGE

Wie Standard, das Übergabeprotokoll am Ziel meldet einen Schaden (hasDamage: true).

  1. Auftrag angelegt order.created order.accepted
  2. Fahrt ausgeschrieben
  3. Fahrer zugewiesen order.scheduled driver.assigned
  4. Fahrer hat angenommen
  5. Fahrer auf dem Weg zur Abholung pickup.started pickup.arrived
  6. Fahrzeug abgeholt vehicle.picked_up transport.started
  7. Am Ziel angekommen delivery.arrived
  8. Fahrzeug mit Schaden übergeben vehicle.delivered damage.reported
  9. Auftrag abgeschlossen order.completed

Stornierung CANCELLATION

Ausgeschrieben, Fahrer zugewiesen, dann storniert (order.cancelled).

  1. Auftrag angelegt order.created order.accepted
  2. Fahrt ausgeschrieben
  3. Fahrer zugewiesen order.scheduled driver.assigned
  4. Auftrag storniert order.cancelled

Angebot erforderlich QUOTE_REQUIRED

Es entsteht eine Anfrage statt eines Auftrags; nach Angebot und Annahme wird daraus ein Auftrag. Über POST /quotes wartet die Simulation nach dem Angebot auf Ihre Annahme oder Ablehnung.

  1. Anfrage eingegangen
  2. Angebot versendet
  3. Angebot angenommen
  4. Auftrag aus dem Angebot angelegt order.created order.accepted
  5. Fahrt ausgeschrieben
  6. Fahrer zugewiesen order.scheduled driver.assigned
  7. Fahrer hat angenommen
  8. Fahrer auf dem Weg zur Abholung pickup.started pickup.arrived
  9. Fahrzeug abgeholt vehicle.picked_up transport.started
  10. Am Ziel angekommen delivery.arrived
  11. Fahrzeug übergeben vehicle.delivered
  12. Auftrag abgeschlossen order.completed

#Szenario wählen

Mit dem Kopf X-Sandbox-Scenario beim Einstellen. Ohne Angabe gilt STANDARD.

bash
curl -X POST https://api.logicar.cloud/api/v1/extern/orders \
  -H "Authorization: Bearer $LOGICAR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Sandbox-Scenario: DAMAGE" \
  -H "X-Sandbox-Mode: manual" \
  -d '{
    "externalOrderId": "TEST-SCHADEN-1",
    "pickup": { "street": "Musterstraße 12", "postalCode": "20095", "city": "Hamburg" },
    "delivery": { "street": "Beispielweg 5", "postalCode": "80331", "city": "München" }
  }'

Mit einem Live-Zugang werden beide Köpfe nicht beachtet.

#Automatisch oder von Hand

Standardmäßig läuft ein Szenario von selbst, ein Schritt nach dem anderen im Abstand einiger Sekunden (Grenzen). Mit X-Sandbox-Mode: manual wartet der Vorgang, bis Sie weiterschalten — praktisch, um jeden Schritt in Ruhe im eigenen System zu verfolgen:

bash
# Nächster Schritt
curl -X POST https://api.logicar.cloud/api/v1/extern/sandbox/orders/SBX-2026-00001/advance \
  -H "Authorization: Bearer $LOGICAR_TOKEN" \
  -H "Content-Type: application/json" -d '{}'

# Alle verbleibenden Schritte auf einmal
curl -X POST https://api.logicar.cloud/api/v1/extern/sandbox/orders/SBX-2026-00001/advance \
  -H "Authorization: Bearer $LOGICAR_TOKEN" \
  -H "Content-Type: application/json" -d '{ "toEnd": true }'

Der Pfad nimmt die Kennung, die Auftrags- oder die Anfragenummer (SBX-…); Recht orders:write, mit Token oder Schlüssel. Die Antwort zeigt den Vorgang wie GET /orders/{id} und in scenario, wo das Szenario steht (step, steps, finished, last). Ist es durchgelaufen, antwortet die Schnittstelle 409 SANDBOX_FINISHED; mit einem Echtzugang 403 SANDBOX_ONLY. Weiterschalten geht auch bei automatischen Vorgängen — dann eben früher.

Ein Angebot, das Sie mit POST /quotes angefordert haben, nimmt die Automatik nicht selbst an: nach dem Versand wartet sie auf Ihre Annahme oder Ablehnung (Angebote). Wer von Hand weiterschaltet, spielt dagegen den Kunden, der über den Link annimmt.

Die bisherige Steuerung unter /extern/sandbox/transportauftraege/{kennung}/weiter und …/abschliessen bleibt für die bisherige Schnittstelle; sie nimmt nur API-Schlüssel und antwortet in deren Format.

#Überblick

GET /extern/sandbox/transportauftraege liefert Ihre letzten Testvorgänge mit Szenario, Schritt und Verlauf. Dieselbe Übersicht zeigt das Portal unter Einstellungen → Sandbox.

Hinweis

Die Endpunkte unter /extern/sandbox/… gibt es nur mit einem Testschlüssel. Mit einem Live-Schlüssel antworten sie 403 SANDBOX_ONLY.