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

MONTHLY_QUOTA_EXCEEDED (429)

El proyecto agotó su cuota mensual de DTEs asignada. Reasigna cuota desde otro proyecto o mejora tu plan.

MONTHLY_QUOTA_EXCEEDED

HTTP 429 Too Many Requests

El proyecto con el que intentas emitir ya consumió todos los DTEs que tiene asignados este mes. Solo aplica a emisiones live — las pruebas (MOCK/sandbox) no consumen cuota.

Ejemplo

{
  "type": "https://docs.dtevia.com.gt/errors/monthly-quota-exceeded",
  "title": "MONTHLY_QUOTA_EXCEEDED",
  "status": 429,
  "detail": "El proyecto 'Cliente A' agotó su cuota mensual (800/800 DTEs). Reasigná cuota o mejorá tu plan.",
  "invalid_params": [{ "project_id": "…", "used": 800, "quota": 800 }]
}

Cómo resolverlo

  • Reasigna cuota: en el dashboard → Proyectos, baja la cuota de un proyecto con DTEs libres y súbesela a este. El cambio aplica de inmediato.
  • Usa la reserva: si dejaste DTEs sin asignar, asígnalos a este proyecto.
  • Mejora tu plan si la cuota total del plan ya no alcanza.
  • La cuota se reinicia automáticamente al iniciar el mes (hora de Guatemala).

Si el detail dice que el proyecto "no tiene DTEs asignados", su cuota es 0 — asígnale DTEs en el dashboard antes de emitir en live.

Ver Proyectos para cómo funciona la asignación.

On this page