validation-error
HTTP 400 · Resoluble por el tenant.
Uno o más campos del payload no cumplen el contrato OpenAPI publicado en /api-reference. El campo detail contiene una lista JSON de errores específicos provistos por Pydantic:
{
"type": "https://errors.api.erply.pro/validation-error",
"title": "Validation error",
"status": 400,
"detail": "[{\"loc\":[\"buyer\",\"rnc\"],\"msg\":\"value is not a valid RNC\"}]"
}
Cómo resolverlo
- Ejecuta el payload contra el esquema OpenAPI usando
ajvojsonschema. - Revisa que los formatos de fecha sean ISO-8601 (
YYYY-MM-DD). - Las cantidades monetarias se envían como número (no string) con hasta 2 decimales.
- El RNC debe tener 9 u 11 dígitos, sólo numéricos.
Errores comunes
| Causa | Mensaje del campo detail |
|---|---|
Falta ecfType | field required en ecfType |
total negativo | ensure this value is greater than 0 |
| RNC con guiones | value is not a valid RNC |
| Fecha futura | issuanceDate cannot be in the future |