Digitally sign an awarded auction
POST/company/bid-auctions/:service_code/sign
Permet au transporteur lauréat de signer numériquement l'attribution d'une enchère. La signature s'effectue via une image de signature manuscrite téléchargée par l'utilisateur.
Objectif
Formaliser légalement l'acceptation du transport par le transporteur lauréat, en générant automatiquement les documents et enregistrements nécessaires au processus logistique.
Effets Secondaires Automatiques ⚠️
Ce point de terminaison effectue automatiquement les opérations suivantes une fois complété :
-
Création du Delivery :
- Un enregistrement de delivery associé à l'enchère est créé
- Le delivery est initialisé avec les données de l'enchère
- La relation auction.delivery → delivery._id est établie
-
Génération de l'eCMR :
- Le document eCMR (Lettre de Voiture Digitale) est généré automatiquement
- L'eCMR est associé au delivery nouvellement créé
- Il est initialisé avec les données de transport de l'enchère
-
Mise à jour des États :
- L'enchère est marquée comme signée
- signed_by_trucker est défini sur true
- La date et l'heure de la signature sont enregistrées
-
Relations entre Entités :
Auction → Delivery → eCMR
(auction._id) (delivery.auction) (ecmr.delivery)
Exigences du Fichier de Signature
- Format : JPEG ou PNG
- Taille maximale : 5 Mo
- Résolution minimale : 300x100 px
- Contenu : Image de signature manuscrite lisible
Cas d'Utilisation
- Transporteur lauréat signant l'acceptation d'une enchère attribuée
- Système générant automatiquement le delivery et l'eCMR après la signature
- Intégration avec des flux automatisés de gestion de transport
Notes Importantes
- Seul le transporteur lauréat peut signer
- L'ench
Request
Responses
- 200
- 400
- 401
Signature enregistrée avec succès. L'enchère passe à l'état 'completed' et la livraison est créée.
Response Headers
Données de signature invalides. Causes possibles :
- INVALID_FILE : Le fichier n'est pas une image valide
- FILE_TOO_LARGE : La taille dépasse la limite de 5 Mo
- INVALID_FORMAT : Format non pris en charge (uniquement JPEG/PNG)
- AUCTION_NOT_SIGNED : L'enchère ne remplit pas les conditions requises pour la signature
Response Headers
Non autorisé. Causes possibles :
- NO_TOKEN : Jeton JWT invalide ou expiré
- L'utilisateur n'est pas le gagnant de l'enchère
- L'enchère n'est pas dans l'état 'awarded'