QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Errores

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:

CampoCausa habitual
items.N.impuestos.N.monto_impuestoprecio_unitario enviado con IVA incluido — debe ser SIN IVA
fecha_emisionFecha mayor a 5 días en el pasado o en el futuro
emisor.nitFormato inválido — solo dígitos, opcionalmente terminando en K
referencia_dte_origenCampo 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.

En esta página