Aller au contenu principal

Create contact/support ticket

POST 
/company/contact/

Crée un nouveau ticket de contact/support dans le système pour que les entreprises et les transporteurs puissent signaler des problèmes ou poser des questions.

Objectif​

Permettre aux utilisateurs de signaler des incidents et de recevoir un support technique de l'équipe CargoOffer.

Cas d'utilisation​

  • Une entreprise ne peut pas accéder à son compte et a besoin d'aide
  • Un transporteur rencontre des problèmes avec une livraison spécifique
  • Un utilisateur nécessite la configuration de son compte
  • Signalement de bugs ou de problèmes techniques sur la plateforme
  • Questions générales non catégorisées

Flux de validation​

flowchart TD
  A[Reçoit la Demande] --> B{Auteur Valide ?}
  B -->|Non| C[400 Auteur Invalide]
  B -->|Oui| D{relatedTo Valide ?}
  D -->|Non| E[400 Catégorie Invalide]
  D -->|Oui| F{CheckUTC Valide ?}
  F -->|Non| G[400 Horodatage Invalide]
  F -->|Oui| H[Créer le Ticket - 200]

Notes​

  • Champ message : Optionnel dans le modèle (permet de créer des tickets vides), mais il est recommandé de fournir une description détaillée
  • Enum relatedTo : Le modèle accepte 12 valeurs : config, delivery, auction, messages, others, user, trucker, address, document, bid, contract, userRegister
  • Authentification : Ne nécessite pas d'authentification explicite (autorise author=anonymous)
  • Middleware : Valide les horodatages UTC via checkUTC
  • Codes internes : Chaque ticket reçoit un internal_code automatique (ex : 2025-12345)

Request​

Responses​

Ticket de contact créé avec succès

Response Headers