Errores y Validación
Entiende las respuestas de error y las reglas de validación.
Formato de Respuesta
Todos los endpoints devuelven la misma estructura de respuesta.
Respuesta Exitosa
{
"success": true,
"warnings": {
"customers": ["File does not have .csv extension"],
"contacts": []
}
}
Respuesta de Error de Validación
{
"success": false,
"errors": {
"customers": [
{
"rowIndex": 2,
"messages": [
"Field \"nit\" is required.",
"Field \"email\" must have a valid email format."
]
}
]
}
}
Códigos de Estado HTTP
| Código | Nombre | Descripción | Acción |
|---|---|---|---|
| 200 | OK | Solicitud procesada (verificar campo success) | Verificar cuerpo de la respuesta |
| 400 | Solicitud Incorrecta | Solicitud malformada | Verificar formato del archivo |
| 401 | No Autorizado | Autenticación fallida | Refrescar token JWT |
| 500 | Error Interno del Servidor | Error inesperado | Reintentar más tarde |
Reglas de Validación Comunes
| Regla | Descripción |
|---|---|
| Campos requeridos | El campo no puede estar vacío |
| Formato de email | Estructura de email válida |
| Formato de fecha | Debe ser YYYY-MM-DD |
| Números decimales | Formato float válido |
| Valores booleanos | Debe ser 1 o 0 |