QR Code dépôt & livraison
ColisMove utilise des QR codes pour valider de manière sécurisée les remises de colis à deux moments critiques : le dépôt (expéditeur → transporteur) et la livraison (transporteur → destinataire).
Fonctionnement
Flux de dépôt
Flux de livraison
Endpoints API
Générer un QR Code
GET /v1/api/qrcode/generate?reservationId=123&type=DEPOT
Renvoie une image PNG contenant le QR code. Le paramètre type peut valoir DEPOT ou LIVRAISON.
Valider un QR Code
POST /v1/api/qrcode/validate
{
"reservationId": 123,
"code": "ABC123"
}
Valide le code sans déclencher de transition. Utile pour une pré-validation.
Traiter le dépôt
POST /v1/api/qrcode/process-depot
{
"reservationId": 123,
"code": "ABC123"
}
Valide le code et fait passer la réservation à EN_COURS_DE_LIVRAISON.
Traiter la livraison
POST /v1/api/qrcode/process-livraison
{
"reservationId": 123,
"code": "XYZ789"
}
Valide le code et fait passer la réservation à LIVREE, déclenchant le paiement du transporteur.
Page destinataire
Pour les destinataires qui ne disposent pas de l’application, une page web est disponible :
GET /v1/api/destinataire/page/{reservationId}
Elle renvoie une page HTML contenant les informations de livraison et un scanner de QR code, permettant aux destinataires de confirmer la livraison depuis le navigateur de leur téléphone.
Chaque QR code est à usage unique. Une fois traité, il ne peut pas être réutilisé. Un nouveau code doit être généré si nécessaire.