Zum Hauptinhalt springen

Digitally sign an awarded auction

POST 
/company/bid-auctions/:service_code/sign

Ermöglicht es dem gewinnenden Transportunternehmen, die Zuschlagserteilung einer Auktion digital zu unterzeichnen.
Die Unterschrift erfolgt mittels eines vom Benutzer hochgeladenen Bildes einer handschriftlichen Unterschrift.

Ziel​

Die rechtlich verbindliche Annahme des Transports durch das gewinnende Transportunternehmen formalisieren,
indem automatisch die erforderlichen Dokumente und Aufzeichnungen für den logistischen Prozess erzeugt werden.

Automatische Nebeneffekte ⚠️​

Dieser Endpunkt führt bei erfolgreicher Ausführung automatisch die folgenden Operationen aus:

  1. Erstellung der Lieferung (Delivery):

    • Ein Lieferungseintrag, der der Auktion zugeordnet ist, wird erstellt
    • Die Lieferung wird mit den Daten der Auktion initialisiert
    • Die Beziehung auction.delivery → delivery._id wird hergestellt

  2. Generierung des eCMR:

    • Das eCMR-Dokument (Digitale Frachtbrief) wird automatisch erzeugt
    • Das eCMR wird der neu erstellten Lieferung zugeordnet
    • Es wird mit den Transportdaten der Auktion initialisiert

  3. Aktualisierung der Status:

    • Die Auktion wird als unterzeichnet markiert
    • signed_by_trucker wird auf true gesetzt
    • Datum und Uhrzeit der Unterschrift werden erfasst

  4. Beziehungen zwischen Entitäten:

    Auktion → Lieferung → eCMR
    (auction._id) (delivery.auction) (ecmr.delivery)

Anforderungen an die Unterschriftsdatei​

  • Format: JPEG oder PNG
  • Maximale Größe: 5 MB
  • Minimale Auflösung: 300 x 100 Pixel
  • Inhalt: Lesbares Bild einer handschriftlichen Unterschrift

Anwendungsfälle​

  • Gewinnendes Transportunternehmen unterzeichnet die Annahme eines zugeschlagenen Auktionsergebnisses
  • System generiert automatisch Liefer

Request​

Responses​

Signatur erfolgreich registriert. Die Auktion wechselt in den Status 'completed' und die Lieferung wird erstellt.

Response Headers