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.
| Plan | Pruebas por tipo de DTE al día |
|---|---|
| Basic | 10 |
| Starter | 30 |
| Business | 50 |
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/invoicescon una API keyqapi_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.