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

SANDBOX_LIMIT_REACHED (429)

Agotaste el cupo diario de pruebas para ese tipo de DTE. El contador se reinicia a las 00:00 de Guatemala.

HTTP 429 Too Many Requests

Agotaste el cupo de facturas de prueba que tu plan permite por tipo de DTE y por día. El día se calcula en hora de Guatemala (UTC-6), así que el contador vuelve a cero a las 00:00 GT.

PlanPruebas por tipo de DTE al día
Basic10
Starter30
Business50

El límite es por tipo, no un total: agotar FACT no te impide seguir probando FPEQ.

Ejemplo

{
  "type": "https://docs.dtevia.com.gt/errors/sandbox-limit-reached",
  "title": "SANDBOX_LIMIT_REACHED",
  "status": 429,
  "detail": "Límite diario de 30 pruebas por tipo DTE alcanzado. Reinicia mañana.",
  "context": { "limit": 30, "used": 30, "tipo_dte": "FACT" }
}

Un solo cupo, dos caminos

El contador es compartido entre las dos formas de emitir una factura de prueba:

  • POST /v1/sandbox/invoices — el Playground del dashboard.
  • POST /v1/invoices con una API key qapi_test_ — tu integración apuntando a pruebas.

Ambas certifican con MOCK y ambas descuentan del mismo cupo diario. El cupo no se duplica por endpoint: es uno por tipo de DTE, sin importar por dónde entraron.

Esto no consume tu cuota mensual

Las pruebas no gastan DTEs de tu plan ni llegan a la SAT. Este límite y la cuota mensual son contadores distintos.

Cómo resolverlo

  • Consultá cuánto llevás antes de chocar con el tope, con GET /v1/sandbox/usage:

    { "date": "2026-07-31", "usage": { "FACT": 30 }, "limit_per_type": 30, "total_today": 30 }
  • Esperá al reinicio. El cupo se libera solo, a las 00:00 hora de Guatemala.

  • Probá con otro tipo de DTE si lo que necesitás validar no depende de uno en concreto.

  • Reutilizá tus pruebas: para verificar el manejo de estados, webhooks o el detalle de una factura no hace falta emitir de nuevo — GET /v1/invoices/{id} sobre una prueba que ya creaste devuelve lo mismo.

Borrar facturas de prueba no libera cupo

Las facturas de prueba no se borran: quedan en tu historial con certificador: "MOCK". Y aunque desaparecieran, el cupo del día ya está consumido — la reserva se cuenta al momento de emitir. Para sacarlas de tus listados de producción usa GET /v1/invoices?exclude_mock=true.

Ver Entorno Sandbox para el detalle del entorno de pruebas.

En esta página