Aller au contenu principal

Get CMR document in PDF format

GET 
/company/cmr/:service_code

Récupère le document CMR (Lettre de Voiture Digitale / eCMR) au format PDF associé à un service de transport spécifique. Le CMR est le document légal obligatoire pour le transport international de marchandises par route selon la Convention CMR.

Objectif​

Permettre aux entreprises de télécharger le document eCMR officiel au format PDF pour archivage, impression ou partage avec les clients et les autorités. Le document est généré par le service spécialisé ecmr_back et livré en tant que fichier binaire.

Cas d'utilisation​

  • Une entreprise a besoin de télécharger le CMR pour un envoi qui vient d'être finalisé
  • Un client demande le document CMR officiel pour sa comptabilité
  • Il est nécessaire de présenter le CMR aux autorités douanières lors d'un contrôle de transport
  • L'entreprise a besoin d'archiver le CMR numériquement pour des obligations légales

Note d'architecture​

Ce point de terminaison agit comme un proxy vers le service ecmr_back (microservice spécialisé dans la gestion des documents eCMR). Le PDF est généré et livré par ecmr_back, puis transmis sous forme de flux binaire au client.

Préconditions :

  • L'utilisateur doit être authentifié et exister dans la base de données
  • L'utilisateur doit appartenir à une entreprise valide
  • Une livraison avec le service_code donné doit exister pour l'entreprise
  • La livraison doit avoir un document eCMR associé

Codes d'erreur :

  • USER_NOT_FOUND (401) : L'utilisateur authentifié n'existe pas dans la base de données
  • AUTHORIZATION_TOKEN_REQUIRED (401) : Token manquant ou invalide dans les en-têtes de la requête
  • COMPANY_NOT_FOUND (Interne) : L'utilisateur n'a pas d'entreprise associée (rejeté avant la réponse API)
  • NOT_FOUND (404) : Livraison non trouvée pour cette entreprise/service_code
  • FILE_NOT_AVAILABLE (404) : Fichier PDF C

Request​

Responses​

Document CMR au format PDF téléchargé avec succès. Le fichier est transmis en tant que flux binaire direct depuis le service ecmr_back.

Response Headers
    Content-Type

    Type de contenu du fichier

    Content-Disposition

    Indique que le fichier doit être téléchargé en tant que pièce jointe avec le nom du fichier. Format : attachment; filename={service_code}.pdf

    Content-Length

    Taille du fichier PDF en octets

    Content-Encoding

    Type d'encodage (toujours identity pour ce point de terminaison)

    Cache-Control

    Directive de cache pour éviter les transformations