Passa al contenuto principale

Get CMR document in PDF format

GET 
/company/cmr/:service_code

Recupera il documento CMR (Carta di Trasporto Digitale / eCMR) in formato PDF associato a un servizio di trasporto specifico. Il CMR è il documento legale obbligatorio per il trasporto internazionale di merci su strada secondo la Convenzione CMR.

Obiettivo​

Consentire alle aziende di scaricare il documento eCMR ufficiale in formato PDF per archiviazione, stampa o condivisione con clienti e autorità. Il documento è generato dal servizio specializzato ecmr_back e fornito come file binario.

Casi d'Uso​

  • Un'azienda deve scaricare il CMR per una spedizione appena completata
  • Un cliente richiede il documento CMR ufficiale per la propria contabilità
  • È necessario presentare il CMR alle autorità doganali durante un controllo di trasporto
  • L'azienda deve archiviare digitalmente il CMR per requisiti legali

Nota Architetturale​

Questo endpoint funge da proxy verso il servizio ecmr_back (microservizio specializzato nella gestione di documenti eCMR). Il PDF è generato e fornito da ecmr_back, poi trasmesso come stream binario al cliente.

Precondizioni:

  • L'utente deve essere autenticato ed esistere nel database
  • L'utente deve appartenere a un'azienda valida
  • Deve esistere una consegna con il service_code specificato per l'azienda
  • La consegna deve avere un documento eCMR associato

Codici di Errore:

  • USER_NOT_FOUND (401): L'utente autenticato non esiste nel database
  • AUTHORIZATION_TOKEN_REQUIRED (401): Token mancante o non valido negli header della richiesta
  • COMPANY_NOT_FOUND (Internal): L'utente non ha un'azienda associata (respinto prima della risposta API)
  • NOT_FOUND (404): Consegna non trovata per questa azienda/service_code
  • FILE_NOT_AVAILABLE (404): File PDF CMR non disponibile nel

Request​

Responses​

Documento CMR in formato PDF scaricato con successo. Il file viene trasmesso come stream binario diretto dal servizio ecmr_back.

Response Headers
    Content-Type

    Tipo di contenuto del file

    Content-Disposition

    Indica che il file deve essere scaricato come allegato con il nome del file. Formato: attachment; filename={service_code}.pdf

    Content-Length

    Dimensione del file PDF in byte

    Content-Encoding

    Tipo di codifica (sempre identity per questo endpoint)

    Cache-Control

    Direttiva di cache per evitare trasformazioni