Skip to main content

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.