Zum Hauptinhalt springen

Send CMR document by email.

POST 
/company/cmr/send

Senden Sie das CMR-Dokument (Digitale Frachtbrief), das mit einem Transportdienst verknüpft ist, per E-Mail an einen oder mehrere Empfänger. Das PDF-Dokument wird generiert und als Anhang versendet.

Ziel​

Ermöglichen Sie Unternehmen, das eCMR-Dokument an Interessengruppen (Kunden, Spediteure, Behörden) zu verteilen, ohne es manuell herunterladen zu müssen. Der Dienst ecmr_back verwaltet den asynchronen Versand der E-Mails.

Anwendungsfälle​

  • Ein Unternehmen muss das CMR zur Buchhaltung an seinen Kunden senden.
  • Das CMR muss zur Archivierung an den Spediteur gesendet werden.
  • Zollbehörden fordern das CMR-Dokument per E-Mail an.
  • Das Unternehmen muss das CMR an mehrere interne Abteilungen verteilen.

Zahlungsvalidierung​

Middleware: mPlan.isPaymentUpdate Dieser Endpunkt validiert den Zahlungsstatus des Unternehmens, bevor der Versand verarbeitet wird:

  • Überprüft, ob das JWT-Token gültig ist.
  • Überprüft, ob das Unternehmen aktualisierte Zahlungsberechtigungen hat.
  • Lehnt die Anfrage ab, wenn das Unternehmen keine aktive Zahlung oder gültiges Abonnement hat. Wenn die Zahlungsvalidierung fehlschlägt, wird vor der Verarbeitung des Versands ein Fehler 401/403 zurückgegeben.

Verhalten​

  1. Validiert die Parameter service_code und emails.
  2. Überprüft, ob der Benutzer authentifiziert ist und ein gültiges Unternehmen hat.
  3. Validiert den Zahlungsstatus (Middleware isPaymentUpdate).
  4. Leitet die Anfrage an den Dienst ecmr_back weiter.
  5. ecmr_back generiert das PDF und sendet die E-Mails.
  6. Gibt eine Versandbestätigung zurück (keine Zustellbestätigung).

Hinweise:

  • Der E-Mail-Versand ist asynchron: Es wird bestätigt, dass er in die Warteschlange gestellt wurde, nicht dass er zugestellt

Request​

Responses​

Der CMR wurde erfolgreich an die angegebenen Empfänger gesendet. Die Antwort bestätigt, dass die E-Mail an die Warteschlange ecmr_back gesendet wurde, bestätigt jedoch NICHT die tatsächliche Zustellung an die Empfänger.