Zum Hauptinhalt springen

Create contact/support ticket

POST 
/company/contact/

Erstelle ein neues Kontakt-/Support-Ticket im System, damit Unternehmen und Transportunternehmen Probleme oder Anfragen melden können.

Ziel​

Benutzern ermöglichen, Vorfälle zu melden und technischen Support vom CargoOffer-Team zu erhalten.

Anwendungsfälle​

  • Ein Unternehmen kann nicht auf sein Konto zugreifen und benötigt Hilfe
  • Ein Transportunternehmer hat Probleme mit einer bestimmten Lieferung
  • Benutzer benötigt Konfiguration seines Kontos
  • Meldung von Fehlern oder technischen Problemen auf der Plattform
  • Allgemeine Anfragen ohne Kategorie

Validierungsablauf​

flowchart TD
  A[Anfrage empfangen] --> B{Gültiger Autor?}
  B -->|Nein| C[400 Ungültiger Autor]
  B -->|Ja| D{Gültige relatedTo?}
  D -->|Nein| E[400 Ungültige Kategorie]
  D -->|Ja| F{CheckUTC gültig?}
  F -->|Nein| G[400 Ungültiger Zeitstempel]
  F -->|Ja| H[Ticket erstellen - 200]

Hinweise​

  • Feld message: Optional im Modell (kann leere Tickets erstellen), aber eine detaillierte Beschreibung wird empfohlen
  • relatedTo enum: Das Modell akzeptiert 12 Werte: config, delivery, auction, messages, others, user, trucker, address, document, bid, contract, userRegister
  • Authentifizierung: Erfordert keine explizite Authentifizierung (erlaubt author=anonymous)
  • Middleware: Validiert UTC-Zeitstempel über checkUTC
  • Interne Codes: Jedes Ticket erhält automatisch einen internal_code (z.B. 2025-12345)

Request​

Responses​

Kontaktticket erfolgreich erstellt.

Response Headers