Aller au contenu principal

Confirm delivery via QR token

PUT 
/company/qr/confirm

Confirme la finalisation d'une livraison. Lors de la confirmation :

  • Le statut de l'expédition passe à delivered
  • La signature numérique du destinataire est enregistrée
  • Les photos de preuve de livraison sont sauvegardées (si jointes)
  • La géolocalisation de la confirmation est enregistrée
  • Le confirm_token est invalidé
  • Le paiement du service est traité (Stripe)
  • L'eCMR est signé numériquement
  • Des emails de confirmation sont envoyés à toutes les parties

Ce point de terminaison est PUBLIC — aucune authentification requise.

Flux d'utilisation​

  1. Obtenir le confirm_token via le point de terminaison GET /company/qr/{token}
  2. Récupérer la signature numérique du destinataire (canvas base64)
  3. Optionnellement, prendre des photos de la livraison
  4. Appeler ce point de terminaison avec toutes les données

Champ data​

Le champ data doit être envoyé en tant que chaîne JSON dans le formulaire multipart. Il contient les données du signataire et sa signature numérique :

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

Notes techniques​

  • Code source : src/features/company/qr_delivery/controller.js → confirmDelivery
  • Accepte jusqu'à 6 images jointes (champ images, téléversées sur S3)
  • La géolocalisation est optionnelle mais recommandée pour l'audit
  • L'action est irréversible : une livraison confirmée ne peut pas être ramenée à un état antérieur

Request​

Responses​

Livraison confirmée avec succès