Send CMR document by email.
POST/company/cmr/send
Envoyez le document CMR (Lettre de Voiture Digitale) associé à un service de transport à un ou plusieurs destinataires par e-mail. Le document PDF est généré et envoyé en pièce jointe.
Objectif
Permettre aux entreprises de distribuer le document eCMR aux parties prenantes (clients, transporteurs, autorités) sans avoir à le télécharger manuellement. Le service ecmr_back gère l'envoi asynchrone des e-mails.
Cas d'utilisation
- Une entreprise a besoin d'envoyer le CMR à son client pour sa comptabilité
- Il est nécessaire d'envoyer le CMR au transporteur pour ses archives
- Les autorités douanières demandent le document CMR par e-mail
- L'entreprise a besoin de distribuer le CMR à plusieurs services internes
Validation du Paiement
Middleware : mPlan.isPaymentUpdate
Ce point de terminaison valide l'état de paiement de l'entreprise avant de traiter l'envoi :
- Vérifie que le jeton JWT est valide
- Vérifie que l'entreprise dispose des autorisations de paiement mises à jour
- Rejette la demande si l'entreprise n'a pas de paiement actif ou d'abonnement valide Si la validation du paiement échoue, une erreur 401/403 sera retournée avant le traitement de l'envoi.
Comportement
- Valide les paramètres
service_codeetemails - Vérifie que l'utilisateur est authentifié et a une entreprise valide
- Valide l'état du paiement (middleware
isPaymentUpdate) - Transmet la demande au service ecmr_back
- ecmr_back génère le PDF et envoie les e-mails
- Retourne une confirmation d'envoi (pas une confirmation de livraison)
Notes :
- L'envoi des e-mails est asynchrone : on confirme qu'il a été mis en file d'attente, pas qu'il a été livré
- Chaque destinataire recevra le CMR en pièce jointe PDF
- Maximum 10 adresses
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 503
Le CMR a été envoyé avec succès aux destinataires spécifiés. La réponse confirme que l'email a été envoyé à la file d'attente ecmr_back, mais NE confirme PAS la livraison effective aux destinataires.
Demande invalide - Paramètres manquants ou incorrects. Codes d'erreur :
SERVICE_CODE_REQUIRED: Le paramètreservice_codeest manquantEMAILS_REQUIRED: Le paramètreemailsest manquant ou vide (tableau de longueur 0)
Non autorisé - Problèmes d'authentification ou de paiement. Codes d'erreur :
USER_NOT_FOUND: L'utilisateur authentifié n'existe pas dans la base de donnéesAUTHORIZATION_TOKEN_REQUIRED: Le token est manquant dans les en-têtes- Payment validation failed (middleware
isPaymentUpdate) : L'entreprise n'a pas de statut de paiement valide
Interdit - La société ne dispose pas d'autorisations de paiement à jour.
Le middleware isPaymentUpdate a rejeté la demande en raison de l'absence de paiement actif.
Non trouvé - La livraison n'existe pas pour cette entreprise. Codes d'erreur :
NOT_FOUND: Aucune livraison avec ceservice_coden'existe pour cette entreprise
Service non disponible - Erreur de communication avec le service ecmr_back ou timeout lors de l'envoi. Causes possibles :
- Le service ecmr_back n'est pas disponible
- Timeout en attendant l'envoi des emails (10 secondes maximum)
- Erreur interne dans le service ecmr_back