Get delivery information by QR token
GET/company/qr/:token
Récupère toutes les informations d’une livraison à partir de son jeton QR unique.
Le jeton QR est généré lors de la création de la livraison. En scannant le QR avec l’application mobile, cet endpoint renvoie les détails de la livraison et dans le processus fait tourner le jeton :
- Supprime le
qr_tokende la livraison - Génère un nouveau
confirm_token(utilisé dansPUT /confirm)
Cet endpoint est PUBLIC — aucune authentification requise.
Flux d’utilisation typique
- Le transporteur arrive à destination et scanne le QR
- L’application appelle cet endpoint avec le jeton du QR
- Les détails de la livraison sont affichés au signataire
- Le signataire confirme via
PUT /company/qr/confirm
Champs renvoyés
- Données de l’envoi (
service_code,status,cargo_type, etc.) - Adresse de chargement et de déchargement (
etl_address,etd_address) - Véhicule et conducteur assignés
- Dates estimées et réelles
confirm_tokenà utiliser pour la confirmation
Notes techniques
- Code source :
src/features/company/qr_delivery/controller.js→getDeliveryFromToken - Le
qr_tokenoriginal est invalidé après la première requête - Le
confirm_tokengénéré est nécessaire pour finaliser la livraison
Request
Responses
- 200
- 404
- 500
Informations de livraison obtenues avec succès
Livraison non trouvée. Cela peut se produire lorsque :
- Le jeton QR n'existe pas, a déjà été utilisé ou a expiré
- La livraison a été supprimée du système
- Le format du jeton est incorrect
Erreur interne du serveur lors de la consultation de la base de données