Passa al contenuto principale

Create contact/support ticket

POST 
/company/contact/

Crea un nuovo ticket di contatto/supporto nel sistema affinché aziende e trasportatori possano segnalare problemi o richiedere informazioni.

Obiettivo​

Consentire agli utenti di segnalare problemi e ricevere supporto tecnico dal team di CargoOffer.

Casi d'Uso​

  • Un'azienda non riesce ad accedere al proprio account e necessita assistenza
  • Un trasportatore riscontra problemi con una consegna specifica
  • Utente richiede configurazione del proprio account
  • Segnalazione di bug o problemi tecnici sulla piattaforma
  • Richieste generali non categorizzate

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta] --> B{Autore Valido?}
  B -->|No| C[400 Autore Non Valido]
  B -->|Sì| D{relatedTo Valido?}
  D -->|No| E[400 Categoria Non Valida]
  D -->|Sì| F{CheckUTC Valido?}
  F -->|No| G[400 Timestamp Non Valido]
  F -->|Sì| H[Crea Segnalazione - 200]

Note​

  • Campo message: Opzionale nel modello (consente di creare ticket vuoti), ma si raccomanda di fornire una descrizione dettagliata
  • relatedTo enum: Il modello accetta 12 valori: config, delivery, auction, messages, others, user, trucker, address, document, bid, contract, userRegister
  • Autenticazione: Non richiede autenticazione esplicita (consente author=anonymous)
  • Middleware: Convalida i timestamp UTC tramite checkUTC
  • Codici interni: Ogni ticket riceve automaticamente un internal_code (es: 2025-12345)

Request​

Responses​

Ticket di contatto creato con successo

Response Headers