Errors & Validation

Understand error responses and validation rules.

Response Format

All endpoints return the same response structure.

Success Response

{
  "success": true,
  "warnings": {
    "customers": ["File does not have .csv extension"],
    "contacts": []
  }
}

Validation Error Response

{
  "success": false,
  "errors": {
    "customers": [
      {
        "rowIndex": 2,
        "messages": [
          "Field \"nit\" is required.",
          "Field \"email\" must have a valid email format."
        ]
      }
    ]
  }
}

HTTP Status Codes

Code	Name	Description	Action
200	OK	Request processed (check `success` field)	Check response body
400	Bad Request	Malformed request	Verify file format
401	Unauthorized	Authentication failed	Refresh JWT token
500	Internal Server Error	Unexpected error	Retry later

Common Validation Rules

Rule	Description
Required fields	Field cannot be empty
Email format	Valid email structure
Date format	Must be `YYYY-MM-DD`
Decimal numbers	Valid float format
Boolean values	Must be `1` or `0`