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ódigoNombreDescripciónAcción
200OKSolicitud procesada (verificar campo success)Verificar cuerpo de la respuesta
400Solicitud IncorrectaSolicitud malformadaVerificar formato del archivo
401No AutorizadoAutenticación fallidaRefrescar token JWT
500Error Interno del ServidorError inesperadoReintentar más tarde

Reglas de Validación Comunes

ReglaDescripción
Campos requeridosEl campo no puede estar vacío
Formato de emailEstructura de email válida
Formato de fechaDebe ser YYYY-MM-DD
Números decimalesFormato float válido
Valores booleanosDebe ser 1 o 0