Errores
VALIDATION_ERROR (422)
El request contiene uno o más campos con valores inválidos. Revisa invalid_params para ver exactamente qué falló.
VALIDATION_ERROR
HTTP 422 Unprocessable Entity
El request pasó el parsing JSON pero falló una o más de las 14 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
Lee 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 14 validaciones y recibiste 202 PROCESSING, las validaciones no volverán a fallar.
Los errores del certificador (CERTIFIER_ERROR) son distintos y se reflejan en el estado de la factura.
Ver la referencia completa de las 14 validaciones.