Crear contacto/tiquete de soporte
POST/company/contact/
Crea un novo ticket de contacto/soporte no sistema para que empresas e transportistas poidan reportar problemas ou consultas.
Obxectivo
Permitir que os usuarios reporten incidencias e reciban soporte técnico do equipo de CargoOffer.
Casos de Uso
- Unha empresa non pode acceder á súa conta e precisa axuda
- Un transportista ten problemas cunha entrega específica
- Usuario require configuración da súa conta
- Reporte de erros ou problemas técnicos na plataforma
- Consultas xerais non categorizadas
Fluxo de Validación
flowchart TD
A[Recibir Solicitude] --> B{Autor Válido?}
B -->|Non| C[400 Autor Inválido]
B -->|Si| D{relatedTo Válido?}
D -->|Non| E[400 Categoría Inválida]
D -->|Si| F{checkUTC Válido?}
F -->|Non| G[400 Carimbo Temporal Inválido]
F -->|Si| H[Cear Incidencia - 200]
Notas
- Campo message: Opcional no modelo (pode crear tickets baleiros), pero recoméndase proporcionar descrición detallada
- relatedTo enum: O modelo acepta 12 valores: config, delivery, auction, messages, others, user, trucker, address, document, bid, contract, userRegister
- Autenticación: Non require autenticación explícita (permite author=anonymous)
- Middleware: Valida carimbos temporais UTC mediante checkUTC
- Códigos internos: Cada ticket recibe un internal_code automático (ex: 2025-12345)
Request
Responses
- 200
- 400
- 401
- 500
Ticket de contacto creado exitosamente
Response Headers
Solicitude non válida. Posibles causas:
- CAN_NOT_CREATE: Erro xeral ao crear o ticket
- Tipo de autor non válido (author debe ser: anonymous, company, ou trucker)
- Categoría non recoñecida (relatedTo inválido)
- Timestamp UTC inválido (middleware checkUTC)
Response Headers
Non autorizado. Token JWT non válido ou caducado (para usuarios autenticados)
Response Headers
Erro interno do servidor ao procesar a solicitude