Errores
CERTIFIER_TIMEOUT (504)
La consulta de NIT/CUI al padrón del certificador no respondió a tiempo. Exclusivo de GET /v1/receptores.
HTTP 504 Gateway Timeout
Exclusivo de GET /v1/receptores/nit/{nit} y GET /v1/receptores/cui/{cui}: la consulta
al padrón SAT/RENAP del certificador (para pre-llenar datos del receptor) no respondió
dentro del tiempo límite.
No tiene relación con emitir o certificar una factura
La emisión (POST /v1/invoices) es asíncrona y nunca devuelve este código — siempre
responde 202, y un DTE nunca queda FAILED por un timeout de esta consulta (son
caminos de código completamente separados). Este error es solo de la consulta
opcional de NIT/CUI.
Ejemplo
{
"type": "https://docs.dtevia.com.gt/errors/certifier-timeout",
"title": "CERTIFIER_TIMEOUT",
"status": 504,
"detail": "El certificador no respondió a tiempo",
"instance": "/v1/receptores/nit/1514318"
}Cómo resolverlo
- Tratá la consulta como opcional: es una ayuda para pre-llenar el receptor, no un
requisito para emitir. Enviá el
nombredel receptor manualmente en el payload y seguí con la factura sin esperar a esta consulta. - Reintentá la consulta en unos segundos si igual la necesitás.
- Si es frecuente, reportá a soporte con el
X-Request-ID.