Crear una nueva incidencia
POST/issues/
Propósito
Crea una incidencia nueva asociada al usuario autenticado y a su compañía, con mensaje inicial y adjuntos opcionales.
Objetivo
Habilitar el registro estructurado de problemas operativos o técnicos desde el área privada del usuario.
Casos de uso
- Reportar un problema de entrega (
delivery). - Abrir una incidencia relacionada con documentación (
document). - Adjuntar evidencias iniciales (capturas, fotos, PDFs).
Detalles técnicos
- URL OpenAPI:
/issues/(creación de incidencia). - Recibe
multipart/form-data. titleymessageson obligatorios.filesacepta hasta 6 adjuntos.- Para cargar varios adjuntos en Swagger/UI, enviar el campo
filesrepetido en el form-data. - El backend asigna
internal_code,status=pendingy metadatos del autor.
Autenticación
Soporta JWT Bearer token y API Key.
Request
Responses
- 200
- 401
- 404
- 405
Incidencia creada correctamente
Response Headers
Token JWT ausente, expirado o API Key inválida
Response Headers
No se encontró la compañía asociada al usuario autenticado
Response Headers
El usuario no tiene rol autorizado (admin, gestor o driver) para crear incidencias