Zum Hauptinhalt springen

Get CMR document in PDF format

GET 
/company/cmr/:service_code

Rufen Sie das CMR-Dokument (Digitales Frachtbrief / eCMR) im PDF-Format ab, das mit einem bestimmten Transportdienst verknüpft ist. Das CMR ist das gesetzlich vorgeschriebene Dokument für den internationalen Straßengüterverkehr gemäß dem CMR-Übereinkommen.

Ziel​

Unternehmen ermöglichen, das offizielle eCMR-Dokument im PDF-Format zum Archivieren, Drucken oder Teilen mit Kunden und Behörden herunterzuladen. Das Dokument wird vom spezialisierten Dienst ecmr_back generiert und als Binärdatei bereitgestellt.

Anwendungsfälle​

  • Ein Unternehmen muss das CMR für eine soeben abgeschlossene Sendung herunterladen.
  • Ein Kunde fordert das offizielle CMR-Dokument für seine Buchhaltung an.
  • Das CMR muss bei einer Transportkontrolle den Zollbehörden vorgelegt werden.
  • Das Unternehmen muss das CMR digital archivieren, um gesetzliche Anforderungen zu erfüllen.

Architekturhinweis​

Dieser Endpunkt fungiert als Proxy zum Dienst ecmr_back (Mikrodienst für die Verwaltung von eCMR-Dokumenten). Das PDF wird von ecmr_back generiert und bereitgestellt, dann als Binärdatenstrom an den Client weitergeleitet.

Voraussetzungen:

  • Der Benutzer muss authentifiziert und in der Datenbank vorhanden sein.
  • Der Benutzer muss zu einem gültigen Unternehmen gehören.
  • Für das Unternehmen muss eine Sendung mit dem angegebenen service_code existieren.
  • Die Sendung muss über ein zugehöriges eCMR-Dokument verfügen.

Fehlercodes:

  • USER_NOT_FOUND (401): Der authentifizierte Benutzer existiert nicht in der Datenbank.
  • AUTHORIZATION_TOKEN_REQUIRED (401): Token fehlt oder ist in den Anfrage-Headern ungültig.
  • COMPANY_NOT_FOUND (Intern): Dem Benutzer ist kein Unternehmen zugeordnet (wird vor der API-Antwort abgelehnt).
  • NOT_FOUND (404): Keine Sendung für

Request​

Responses​

CMR-Dokument im PDF-Format erfolgreich heruntergeladen. Die Datei wird als direkter Binärstrom vom ecmr_back-Dienst übertragen.

Response Headers
    Content-Type

    Dateityp

    Content-Disposition

    Gibt an, dass die Datei als Anhang mit dem angegebenen Dateinamen heruntergeladen werden soll. Format: attachment; filename={service_code}.pdf

    Content-Length

    PDF-Dateigröße in Bytes

    Content-Encoding

    Kodierungstyp (immer identity für diesen Endpunkt)

    Cache-Control

    Cache-Direktive zur Vermeidung von Transformationen