Get delivery information by QR token
GET/company/qr/:token
Recupera tutte le informazioni di una consegna a partire dal suo token QR univoco.
Il token QR viene generato alla creazione della consegna. Scansionando il QR con l'app mobile, questo endpoint restituisce i dettagli della consegna e nel processo ruota il token:
- Rimuove il
qr_tokendalla consegna - Genera un nuovo
confirm_token(usato inPUT /confirm)
Questo endpoint è PUBBLICO — non richiede autenticazione.
Flusso d'uso tipico
- Il corriere arriva a destinazione e scansiona il QR
- L'app chiama questo endpoint con il token del QR
- Vengono mostrati i dettagli della consegna al firmatario
- Il firmatario conferma tramite
PUT /company/qr/confirm
Campi restituiti
- Dati della spedizione (
service_code,status,cargo_type, ecc.) - Indirizzo di carico e scarico (
etl_address,etd_address) - Veicolo e conducente assegnati
- Date stimate e reali
confirm_tokenda usare per la conferma
Note tecniche
- Codice sorgente:
src/features/company/qr_delivery/controller.js→getDeliveryFromToken - Il
qr_tokenoriginale viene invalidato dopo la prima richiesta - Il
confirm_tokengenerato è necessario per completare la consegna
Request
Responses
- 200
- 404
- 500
Informazioni sulla consegna ottenute correttamente.
Consegna non trovata. Ciò può verificarsi quando:
- Il token QR non esiste, è già stato utilizzato o è scaduto
- La consegna è stata rimossa dal sistema
- Il formato del token non è corretto
Errore interno del server durante la consulta del database.