Errores
CERTIFIER_ERROR (502)
El certificador SAT rechazó el DTE. Revisa error_message en la factura para el detalle exacto.
CERTIFIER_ERROR
HTTP 502 / Estado FAILED en la factura
El certificador (TOTALDOC u otro) recibió el DTE pero lo rechazó por una razón específica.
Este error no se devuelve en la respuesta del POST /v1/invoices (que siempre es 202).
Lo verás en el estado de la factura cuando consultas GET /v1/invoices/:id y el estado es FAILED.
Cómo leerlo
{
"id": "inv_01jxyz...",
"status": "FAILED",
"error_code": "CERTIFIER_ERROR",
"error_message": "NIT del emisor no encontrado en el padrón SAT"
}Causas comunes
error_message | Causa |
|---|---|
| NIT del emisor no encontrado | El NIT no está registrado ante la SAT como emisor FEL |
| XML mal formado | Error interno de QAPI — reportar a soporte |
| Establecimiento no habilitado | El codigo_establecimiento no está habilitado para FEL |
Cómo resolverlo
Lee el error_message en el objeto de la factura. Si el problema está en los datos del emisor,
verifica con tu contador que el NIT y establecimiento estén habilitados para FEL ante la SAT.
Una factura FAILED no es recuperable — crea una nueva con los datos corregidos.