Las 14 Validaciones
Reglas de validación que QAPI aplica a cada factura antes de enviarla al certificador.
Las 14 Validaciones
Antes de construir el XML y enviarlo al certificador, QAPI aplica 14 reglas de validación.
Si alguna falla, la factura nunca llega al certificador — recibes un 422 VALIDATION_ERROR
inmediatamente con el detalle exacto de qué campo falló.
Las validaciones se ejecutan síncronamente antes del 202 PROCESSING. Si recibes 202,
tu factura pasó las 14 reglas y ya está en el pipeline de certificación.
Todas las validaciones
Identidad y formato (1–5)
Cálculos y montos (6–10)
Restricciones fiscales especiales (11–14)
Respuesta de error
Estructura RFC 7807
Cuando una o más validaciones fallan, QAPI responde con 422 VALIDATION_ERROR en formato RFC 7807:
{
"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"
}
]
}Campo invalid_params
Cada entrada incluye el path exacto del campo (field) y la razón del fallo (message).
Usa notación de puntos, incluidos los índices de array: items.0.impuestos.0.monto_impuesto.