Pular para o conteúdo principal

Send CMR document by email.

POST 
/company/cmr/send

Envia o documento CMR (Carta de Porte Digital) associado a um serviço de transporte para um ou vários destinatários por e-mail. O documento PDF é gerado e enviado como anexo.

Objetivo​

Permitir que as empresas distribuam o documento eCMR às partes interessadas (clientes, transportadoras, autoridades) sem necessidade de download manual. O serviço ecmr_back gere o envio assíncrono dos e-mails.

Casos de Uso​

  • Uma empresa precisa enviar o CMR ao seu cliente para contabilidade
  • É necessário enviar o CMR à transportadora para arquivo
  • As autoridades aduaneiras solicitam o documento CMR por e-mail
  • A empresa precisa distribuir o CMR a múltiplos departamentos internos

Validação de Pagamento​

Middleware: mPlan.isPaymentUpdate Este endpoint valida o estado de pagamento da empresa antes de processar o envio:

  • Verifica se o token JWT é válido
  • Verifica se a empresa tem permissões de pagamento atualizadas
  • Rejeita a solicitação se a empresa não tiver um pagamento ativo ou subscrição válida Se a validação de pagamento falhar, será retornado um erro 401/403 antes de processar o envio.

Comportamento​

  1. Valida os parâmetros service_code e emails
  2. Verifica se o utilizador está autenticado e tem empresa válida
  3. Valida o estado de pagamento (middleware isPaymentUpdate)
  4. Reenvia a solicitação ao serviço ecmr_back
  5. ecmr_back gera o PDF e envia os e-mails
  6. Retorna confirmação de envio (não confirmação de entrega)

Notas:

  • O envio de e-mails é assíncrono: confirma-se que foi enviado para a fila, não que foi entregue
  • Cada destinatário receberá o CMR como arquivo PDF anexado
  • Máximo 10 endereços de e-mail por solicitação
  • Não é realizado tracking de abertura ou entrega dos e-mails
  • O serviço pode demorar

Request​

Responses​

O CMR foi enviado com sucesso aos destinatários especificados. A resposta confirma que o e-mail foi enviado para a fila ecmr_back, mas NÃO confirma a entrega efetiva aos destinatários.