Passa al contenuto principale

Confirm delivery via QR token

PUT 
/company/qr/confirm

Conferma il completamento di una consegna. Confermando:

  • Lo stato della spedizione passa a delivered
  • Viene registrata la firma digitale del destinatario
  • Vengono salvate le foto di prova della consegna (se allegate)
  • Viene registrata la geolocalizzazione della conferma
  • Il confirm_token viene invalidato
  • Viene elaborato il pagamento del servizio (Stripe)
  • L'eCMR viene firmato digitalmente
  • Vengono inviate email di conferma a tutte le parti

Questo endpoint è PUBBLICO — non richiede autenticazione.

Flusso d'uso​

  1. Ottenere il confirm_token dall'endpoint GET /company/qr/{token}
  2. Raccogliere la firma digitale del destinatario (canvas base64)
  3. Opzionalmente, scattare foto della consegna
  4. Chiamare questo endpoint con tutti i dati

Campo data​

Il campo data deve essere inviato come stringa JSON nel form multipart. Contiene i dati del firmatario e la sua firma digitale:

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

Note tecniche​

  • Codice sorgente: src/features/company/qr_delivery/controller.js → confirmDelivery
  • Accetta fino a 6 immagini allegate (campo images, caricate su S3)
  • La geolocalizzazione è opzionale ma consigliata per audit
  • L'azione è IRREVERSIBILE: una consegna confermata non può essere riportata a uno stato precedente

Request​

Responses​

Consegna confermata correttamente