Saltar al contenido principal

Create contact/support ticket

POST 
/company/contact/

Crea un nuevo ticket de contacto/soporte en el sistema para que empresas y transportistas puedan reportar problemas o consultas.

Objective​

Permitir que los usuarios reporten incidencias y reciban soporte técnico del equipo de CargoOffer.

Use Cases​

  • Una empresa no puede acceder a su cuenta y necesita ayuda
  • Un transportista tiene problemas con una entrega específica
  • Usuario requiere configuración de su cuenta
  • Reporte de bugs o problemas técnicos en la plataforma
  • Consultas generales no categorizadas

Validation Flow​

flowchart TD
  A[Receive Request] --> B{Valid Author?}
  B -->|No| C[400 Invalid Author]
  B -->|Yes| D{Valid relatedTo?}
  D -->|No| E[400 Invalid Category]
  D -->|Yes| F{CheckUTC Valid?}
  F -->|No| G[400 Invalid Timestamp]
  F -->|Yes| H[Create Issue - 200]

Notes​

  • Campo message: Opcional en el modelo (puede crear tickets vacíos), pero se recomienda proporcionar descripción detallada
  • relatedTo enum: El modelo acepta 12 valores: config, delivery, auction, messages, others, user, trucker, address, document, bid, contract, userRegister
  • Autenticación: No requiere autenticación explícita (permite author="anonymous")
  • Middleware: Valida timestamps UTC mediante checkUTC
  • Códigos internos: Cada ticket recibe un internal_code automático (ej: "2025-12345")

Request​

Responses​

Ticket de contacto creado exitosamente

Response Headers