Zum Hauptinhalt springen

Confirm delivery via QR token

PUT 
/company/qr/confirm

Bestätigt den Abschluss einer Lieferung. Bei Bestätigung:

  • Der Sendungsstatus wechselt zu delivered
  • Die digitale Unterschrift des Empfängers wird erfasst
  • Liefernachweisfotos werden gespeichert (falls angehängt)
  • Der Geolokalisierungsort der Bestätigung wird erfasst
  • Der confirm_token wird ungültig gemacht
  • Die Dienstleistungszahlung wird verarbeitet (Stripe)
  • Das eCMR wird digital signiert
  • Bestätigungs-E-Mails werden an alle Beteiligten gesendet

Dieser Endpunkt ist ÖFFENTLICH – erfordert keine Authentifizierung.

Nutzungsablauf​

  1. Den confirm_token vom Endpunkt GET /company/qr/{token} abrufen
  2. Die digitale Unterschrift des Empfängers erfassen (Canvas base64)
  3. Optional: Fotos der Lieferung aufnehmen
  4. Diesen Endpunkt mit allen Daten aufrufen

Feld data​

Das Feld data muss als JSON-String im Multipart-Formular gesendet werden. Es enthält die Daten des Unterzeichners und seine digitale Unterschrift:

{
  name: Juan,
  surname: Pérez,
  taxid: 12345678A,
  email: juan@example.com,
  image: data:image/png;base64,iVBORw0KG...
}

Technische Hinweise​

  • Quellcode: src/features/company/qr_delivery/controller.js → confirmDelivery
  • Akzeptiert bis zu 6 angehängte Bilder (Feld images, hochgeladen zu S3)
  • Die Geolokalisierung ist optional, aber für die Prüfung empfohlen
  • Die Aktion ist unumkehrbar: Eine bestätigte Lieferung kann nicht in einen vorherigen Status zurückversetzt werden

Request​

Responses​

Lieferung erfolgreich bestätigt.