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

Reglas SAT

Qué significan los códigos "Regla SAT" con los que el certificador rechaza un DTE, por qué QAPI no puede anticiparlos todos y cómo corregir cada uno.

Cuando una factura queda en FAILED con error_code: "CERT_FAILED", su error_message arranca con Regla SAT <código>:

{
  "status": "FAILED",
  "error_code": "CERT_FAILED",
  "error_message": "Regla SAT 2.7.2.2: El Código de Unidad Gravable 2 del IVA debe estar presente para una exportación."
}

Ese código es el de las Reglas y Validaciones de FEL de la SAT — el mismo documento público que aplica cualquier certificador del régimen. Esta página traduce los que vas a ver en la práctica: qué significan, por qué aparecen y qué corregir.

Una factura FAILED no consume tu cuota mensual

El DTE nunca llegó a emitirse. Corregí el payload y volvé a enviarlo: el intento fallido no te cuesta nada. Una factura anulada sí consume: 1 DTE por su emisión y 1 DTE más por la anulación, que se descuenta del mes en que anulás.

Por qué QAPI no las corta todas antes

Las 21 validaciones cortan con 422 todo lo que se puede comprobar mirando el payload. Estas reglas son distintas: dependen de datos que sólo la SAT tiene — si tu establecimiento está activo, si el receptor existe en el RTU, si el documento que querés ajustar existe y sigue vigente.

Por eso conviene leerlas como dos familias:

FamiliaQuién la detectaCuándo la ves
Reglas de forma y aritméticaQAPI, antes de firmar422 VALIDATION_ERROR, en el acto
Reglas contra el padrón de la SATEl certificadorFAILED con CERT_FAILED, unos segundos después

Varias de las reglas de abajo aparecen en las dos columnas: cuando descubrimos que el certificador rechaza algo que se puede anticipar desde el payload, lo agregamos como validación para que te llegue como 422 inmediato en vez de un DTE perdido.

Qué hacer cuando aparece una

  1. Leé el código y el texto: los dos vienen en error_message.
  2. Buscalo acá arriba, o en las Reglas y Validaciones de FEL de la SAT si no está en la lista.
  3. Corregí el payload —o el dato del emisor, en 2.2.3.1— y volvé a enviarlo. El intento fallido no consumió cuota.
  4. Si el código no está documentado y no te queda claro, escribinos con el id de la factura: lo agregamos a esta página.

¿Trabajás con webhooks? El rechazo también llega ahí, en el evento invoice.failed, con los mismos error_code y error_message. Ver Webhooks.

En esta página