Zum Hauptinhalt springen

Get delivery information by QR token

GET 
/company/qr/:token

Hole alle Informationen einer Lieferung anhand ihres eindeutigen QR-Tokens ab.

Das QR-Token wird beim Erstellen der Lieferung generiert. Beim Scannen des QR-Codes mit der mobilen App gibt dieser Endpunkt die Lieferdetails zurück und rotiert dabei das Token:

  • Entfernt das qr_token aus der Lieferung
  • Generiert ein neues confirm_token (wird in PUT /confirm verwendet)

Dieser Endpunkt ist ÖFFENTLICH – erfordert keine Authentifizierung.

Typischer Nutzungsablauf​

  1. Der Transporteur erreicht das Ziel und scannt den QR-Code
  2. Die App ruft diesen Endpunkt mit dem Token aus dem QR-Code auf
  3. Die Lieferdetails werden dem Empfänger/Unterzeichner angezeigt
  4. Der Unterzeichner bestätigt die Lieferung über PUT /company/qr/confirm

Zurückgegebene Felder​

  • Versanddaten (service_code, status, cargo_type, etc.)
  • Lade- und Entladeadresse (etl_address, etd_address)
  • Zugewiesenes Fahrzeug und Fahrer
  • Geschätzte und tatsächliche Daten/Zeiten
  • confirm_token zur Verwendung bei der Bestätigung

Technische Hinweise​

  • Quellcode: src/features/company/qr_delivery/controller.js → getDeliveryFromToken
  • Das ursprüngliche qr_token wird nach der ersten Abfrage ungültig
  • Das generierte confirm_token ist erforderlich, um die Lieferung abzuschließen

Request​

Responses​

Lieferinformationen erfolgreich abgerufen.