#Auftragsstatus

Auf dieser Seite

Status
Bereitschaft
Bisherige Schnittstelle

Intern durchläuft ein Auftrag viele Stände: Pool, Ausschreibung, Übernahme durch einen Betrieb, Annahme durch den Fahrer. Ihr System bekommt davon ein kleines, stabiles Vokabular, abgeleitet aus dem internen Stand. Ein neuer interner Zwischenschritt bricht so nichts in Ihrer Anbindung.

#Status

Status	Bedeutung	Ereignis
`RECEIVED`	Angelegt, noch nicht zur Planung freigegeben — es fehlt etwas, oder LOGICAR prüft.	`order.created`
`ACCEPTED`	Zur Planung freigegeben, noch niemand eingeplant.	`order.accepted`
`SCHEDULED`	Ein ausführendes Unternehmen oder ein Fahrer ist eingeplant.	`order.scheduled` `driver.assigned`
`PICKUP_STARTED`	Der Fahrer ist auf dem Weg zum Abholort oder dort.	`pickup.started`
`IN_TRANSIT`	Abgeholt und unterwegs; das Abholprotokoll liegt vor.	`vehicle.picked_up` `transport.started`
`AT_DELIVERY`	Am Zielort, die Übergabe läuft.	`delivery.arrived`
`DELIVERED`	Übergeben; das Übergabeprotokoll liegt vor.	`vehicle.delivered`
`COMPLETED`	Abgeschlossen.	`order.completed`
`CANCELLED`	Storniert.	`order.cancelled`

Solange ein Vorgang auf ein Angebot wartet (kind: "REQUEST"):

Status	Bedeutung	Ereignis
`QUOTE_REQUIRED`	Anfrage eingegangen, das Angebot wird erstellt.	—
`QUOTE_SENT`	Das Angebot ist bei Ihnen.	—
`QUOTE_ACCEPTED`	Angebot angenommen, der Auftrag entsteht.	—
`REJECTED`	Abgelehnt.	`order.rejected`

Das Angebot zu einer Anfrage — Beträge, Fassung, Annahme — hat eigene Stände: Angebote.

Nur vorwärts gemeldet: Die Ereignisse der Tabelle kommen, wenn ein Auftrag diesen Stand erreicht. Wird ein Stand übersprungen, kommt nur das Ereignis des erreichten. Geht ein Auftrag zurück — ein Fahrer gibt ihn ab, er wird neu eingeplant —, gibt es dafür kein Ereignis; GET /orders/{id}/status zeigt den Stand (Ereignisse).
Neue Werte können hinzukommen, umbenannt wird keiner (Versionen). Behandeln Sie einen unbekannten Status wie „in Arbeit“, statt abzubrechen.
Ändern und Stornieren über die API gehen bis einschließlich SCHEDULED; ab PICKUP_STARTED antwortet die Schnittstelle 409.

#Bereitschaft

readiness sagt, ob ein Auftrag zur Planung freigegeben ist — und wenn nicht, worauf er wartet:

`readiness.status`	Bedeutung
`INCOMPLETE`	Es fehlt eine Angabe, etwa die Fahrgestellnummer oder ein Ansprechpartner.
`WAITING_FOR_DOCUMENTS`	Es fehlt eine Vollmacht oder eine Unterlage zum Fahrzeug.
`WAITING_FOR_REGISTRATION`	Das Fahrzeug braucht noch ein Kennzeichen oder eine Zulassung.
`WAITING_FOR_CUSTOMER`	Ihre Freigabe steht aus, etwa die Annahme eines Angebots.
`IN_REVIEW`	LOGICAR prüft den Auftrag von Hand.
`READY_FOR_PLANNING`	Nichts fehlt mehr, der Auftrag wird eingeplant.
`PLANNING`	Die Fahrt ist ausgeschrieben.
`SCHEDULED`	Ein Betrieb oder Fahrer ist eingeplant.
`CANCELLED`	Storniert.

readiness.missing nennt, was fehlt — je Eintrag code (etwa TRANSPORT_AUTHORIZATION), category (INFORMATION, AUTHORIZATION, DOCUMENT, REGISTRATION, OTHER), blocking (ohne das wird nicht geplant) und responsible: CONTRACTING_PARTY heißt, es liegt bei Ihnen; LOGICAR, es liegt bei uns (etwa ein Kurzzeitkennzeichen, das wir besorgen). documentsRequired sagt, ob der Auftrag überhaupt Vollmachten oder Unterlagen braucht.

Fordert LOGICAR eine Vollmacht oder Unterlage bei Ihnen an, kommt der Webhook document.required; ist alles da, order.accepted.

#Bisherige Schnittstelle

Die bisherige Schnittstelle /extern/transportauftraege antwortet mit dem internen Status; dort stehen dessen Werte.