VALIDATION_ERROR (422)
El request contiene uno o más campos con valores inválidos. Revisá invalid_params para ver exactamente qué falló.
HTTP 422 Unprocessable Entity
El request pasó el parsing JSON pero falló una o más de las 21 validaciones que QAPI aplica antes de enviar al certificador.
Estructura de la respuesta
{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12.00, recibido 10.00"
}
]
}Cómo resolverlo
Leé cada entrada en invalid_params:
field— el path exacto del campo que falló (notación de puntos, con índices para arrays)message— descripción de por qué falló y cuál era el valor esperado
Los errores más frecuentes:
| Campo | Causa habitual |
|---|---|
items.N.impuestos.N.monto_impuesto | precio_unitario enviado con IVA incluido — debe ser SIN IVA |
fecha_emision | Fecha mayor a 5 días en el pasado o en el futuro |
emisor.nit | Formato inválido — solo dígitos, opcionalmente terminando en K |
referencia_dte_origen | Campo ausente en una NCRE o NDEB |
Si el request pasó las 21 validaciones y recibiste 202 PROCESSING, las validaciones no
vuelven a fallar para ese request. Lo que puede fallar después es la certificación en sí
(firma o certificador) — eso no es un error HTTP: la factura queda status: "FAILED" con
su propio error_code (SIGN_FAILED o CERT_FAILED), un namespace distinto al de este
catálogo. Ver Estados de Factura.
Ver la referencia completa de las 21 validaciones.