Pular para o conteúdo principal

Get CMR document in PDF format

GET 
/company/cmr/:service_code

Recupera o documento CMR (Carta de Porte Digital / eCMR) em formato PDF associado a um serviço de transporte específico. O CMR é o documento legal obrigatório para o transporte internacional de mercadorias por estrada, conforme a Convenção CMR.

Objetivo​

Permitir que as empresas façam o download do documento eCMR oficial em formato PDF para arquivamento, impressão ou partilha com clientes e autoridades. O documento é gerado pelo serviço especializado ecmr_back e entregue como ficheiro binário.

Casos de Uso​

  • Uma empresa precisa de descarregar o CMR para uma entrega que acabou de ser concluída
  • Um cliente solicita o documento CMR oficial para a sua contabilidade
  • É necessário apresentar o CMR às autoridades aduaneiras num controlo de transporte
  • A empresa precisa de arquivar o CMR digitalmente por requisitos legais

Nota de Arquitetura​

Este endpoint atua como proxy para o serviço ecmr_back (microsserviço especializado na gestão de documentos eCMR). O PDF é gerado e entregue pelo ecmr_back, sendo depois transmitido como um fluxo binário para o cliente.

Pré-condições:

  • O utilizador deve estar autenticado e existir na base de dados
  • O utilizador deve pertencer a uma empresa válida
  • Deve existir uma entrega com o service_code fornecido para a empresa
  • A entrega deve ter um documento eCMR associado

Códigos de Erro:

  • USER_NOT_FOUND (401): O utilizador autenticado não existe na base de dados
  • AUTHORIZATION_TOKEN_REQUIRED (401): Token em falta ou inválido nos cabeçalhos da requisição
  • COMPANY_NOT_FOUND (Internal): O utilizador não tem empresa associada (rejeitado antes da resposta da API)
  • NOT_FOUND (404): Entrega não encontrada para esta empresa/service_code
  • FILE_NOT_AVAILABLE (404): Ficheiro PDF do CMR não disponível no serviço ecmr_back
  • Erro de

Request​

Responses​

Documento CMR em formato PDF baixado com sucesso. O arquivo é transmitido como um fluxo binário direto do serviço ecmr_back.

Response Headers
    Content-Type

    Tipo de conteúdo do arquivo

    Content-Disposition

    Indica que o arquivo deve ser baixado como anexo com o nome do arquivo. Formato: attachment; filename={service_code}.pdf

    Content-Length

    Tamanho do arquivo PDF em bytes

    Content-Encoding

    Tipo de codificação (sempre identity para este endpoint)

    Cache-Control

    Diretiva de cache para evitar transformações