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:
| Familia | Quién la detecta | Cuándo la ves |
|---|---|---|
| Reglas de forma y aritmética | QAPI, antes de firmar | 422 VALIDATION_ERROR, en el acto |
| Reglas contra el padrón de la SAT | El certificador | FAILED 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.
Catálogo
Qué hacer cuando aparece una
- Leé el código y el texto: los dos vienen en
error_message. - Buscalo acá arriba, o en las Reglas y Validaciones de FEL de la SAT si no está en la lista.
- Corregí el payload —o el dato del emisor, en
2.2.3.1— y volvé a enviarlo. El intento fallido no consumió cuota. - Si el código no está documentado y no te queda claro, escribinos con el
idde 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.