Pular para o conteúdo principal

Create contact/support ticket

POST 
/company/contact/

Cria um novo ticket de contato/suporte no sistema para que empresas e transportadores possam relatar problemas ou consultas.

Objetivo​

Permitir que os usuários relatem incidentes e recebam suporte técnico da equipe da CargoOffer.

Casos de Uso​

  • Uma empresa não consegue acessar sua conta e precisa de ajuda
  • Um transportador tem problemas com uma entrega específica
  • Usuário requer configuração de sua conta
  • Relato de bugs ou problemas técnicos na plataforma
  • Consultas gerais não categorizadas

Fluxo de Validação​

flowchart TD
  A[Receber Solicitação] --> B{Autor Válido?}
  B -->|Não| C[400 Autor Inválido]
  B -->|Sim| D{relatedTo Válido?}
  D -->|Não| E[400 Categoria Inválida]
  D -->|Sim| F{checkUTC Válido?}
  F -->|Não| G[400 Timestamp Inválido]
  F -->|Sim| H[Criar Issue - 200]

Notas​

  • Campo message: Opcional no modelo (permite criar tickets vazios), mas recomenda-se fornecer descrição detalhada
  • relatedTo enum: O modelo aceita 12 valores: config, delivery, auction, messages, others, user, trucker, address, document, bid, contract, userRegister
  • Autenticação: Não requer autenticação explícita (permite author=anonymous)
  • Middleware: Valida timestamps UTC através de checkUTC
  • Códigos internos: Cada ticket recebe um internal_code automático (ex: 2025-12345)

Request​

Responses​

Ticket de contato criado com sucesso.

Response Headers