QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
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 nombre del 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.

En esta página