Zum Hauptinhalt springen

Send message to delivery

POST 
/company/delivery/msg/:id

Senden Sie eine Nachricht an den Chat einer Sendung, mit der Möglichkeit, Dateien anzuhängen.

Ziel​

Direkte Kommunikation zwischen Unternehmen und Transporteur im Kontext einer bestimmten Sendung erleichtern.

Anwendungsfälle​

  • Koordinieren von Details zum Be-/Entladen
  • Dringende Änderungen im Betrieb mitteilen
  • Relevante Fotos oder Dokumente teilen
  • Vorfälle während des Transports klären

Validierungsablauf​

flowchart TD
  A[Nachricht empfangen] --> B{Enthält Nachrichtentext?}
  B -->|Nein/Leer| C[400 NOT_MESSAGE]
  B -->|Ja| D{Ist Sendung aktiv?}
  D -->|Nein| E[403 NOT_ALLOWED]
  D -->|Ja| F{Ist Nutzer authentifiziert?}
  F -->|Nein| G[404 USER_NOT_FOUND]
  F -->|Ja| H[Nachrichtenobjekt erstellen]
  H --> I{Enthält Dateien?}
  I -->|Ja| J[S3-Schlüssel zur Nachricht hinzufügen]
  I -->|Nein| K[Fortfahren]
  J --> K
  K --> L[Zum Nachrichten-Array hinzufügen]
  L --> M[Sendung speichern]
  M -->|Fehler| N[503 Error]
  M -->|Erfolg| O[Alle Nachrichten DESC zurückgeben]

Hinweise​

  • Der Parameter {id} kann service_code oder MongoDB _id sein
  • Akzeptiert bis zu 6 Dateien (multipart/form-data)
  • Dateien werden in S3 mit dem S3-Schlüssel gespeichert
  • Nur aktive Sendungen können Nachrichten empfangen (isActive-Prüfung)
  • Gibt alle Nachrichten sortiert nach createdAt DESC zurück
  • Dateien werden mit dem vollständigen Pfad /images?file= zurückgegeben

Request​

Responses​

Nachricht erfolgreich gesendet