Passa al contenuto principale

Send CMR document by email.

POST 
/company/cmr/send

Invia il documento CMR (Carta di Vettura Digitale) associato a un servizio di trasporto a uno o più destinatari via email. Il documento PDF viene generato e inviato come allegato.

Obiettivo​

Consentire alle aziende di distribuire il documento eCMR alle parti interessate (clienti, vettori, autorità) senza doverlo scaricare manualmente. Il servizio ecmr_back gestisce l'invio asincrono delle email.

Casi d'Uso​

  • Un'azienda deve inviare il CMR al proprio cliente per la contabilità
  • È necessario inviare il CMR al vettore per l'archiviazione
  • Le autorità doganali richiedono il documento CMR via email
  • L'azienda deve distribuire il CMR a più dipartimenti interni

Validazione Pagamento​

Middleware: mPlan.isPaymentUpdate Questo endpoint valida lo stato di pagamento dell'azienda prima di elaborare l'invio:

  • Verifica che il token JWT sia valido
  • Verifica che l'azienda abbia i permessi di pagamento aggiornati
  • Rifiuta la richiesta se l'azienda non ha un pagamento attivo o un abbonamento valido Se la validazione del pagamento fallisce, verrà restituito un errore 401/403 prima di elaborare l'invio.

Comportamento​

  1. Valida i parametri service_code e emails
  2. Verifica che l'utente sia autenticato e abbia un'azienda valida
  3. Valida lo stato di pagamento (middleware isPaymentUpdate)
  4. Inoltra la richiesta al servizio ecmr_back
  5. ecmr_back genera il PDF e invia le email
  6. Restituisce conferma di invio (non conferma di consegna)

Note:

  • L'invio delle email è asincrono: si conferma che è stato inviato alla coda, non che è stato consegnato
  • Ogni destinatario riceverà il CMR come file PDF allegato
  • Massimo 10

Request​

Responses​

Il CMR è stato inviato con successo ai destinatari specificati. La risposta conferma che l'email è stato inviato alla coda ecmr_back, ma NON conferma la consegna effettiva ai destinatari.