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

MONTHLY_QUOTA_EXCEEDED (429)

El proyecto agotó su cuota mensual de DTEs asignada. Reasigná cuota desde otro proyecto o mejorá tu plan.

HTTP 429 Too Many Requests

Se agotaron los DTEs disponibles para emitir este mes. Solo aplica a emisiones live — las pruebas (MOCK/sandbox) no consumen cuota.

Cada emisión consume 1 DTE y cada anulación consume 1 DTE más. Lo único que no consume es un intento que falló. Anular nunca se bloquea por cuota: siempre podés anular una factura mal emitida, aunque eso deje el mes por encima del límite; lo que se frena es la emisión siguiente.

Toda emisión live sale de un proyecto —también la del NIT de tu cuenta—, así que lo que se agota es la cuota asignada a ese proyecto.

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.",
  "context": { "project_id": "…", "used": 800, "quota": 800 }
}

Qué dice el detail

El mensaje te dice qué hacer según cómo está tu cuenta:

  • "Tenés N DTEs libres sin asignar" — son DTEs del plan que no le asignaste a ningún proyecto: asignáselos a este desde el dashboard (context.account_free). Si además dice "otros proyectos tienen M asignados sin emitir", son DTEs que otros proyectos todavía no usaron (context.account_idle_assigned).

  • "No tenés DTEs libres, pero otros proyectos tienen M asignados sin emitir" — bajale la cuota a alguno de esos proyectos y asignásela a este.

    En estos dos casos no se cobra excedente aunque lo tengas activado: mientras te queden DTEs del plan sin usar, nunca pagás DTEs extra.

  • "Ya usaste todo el saldo del plan" — activá los excedentes para seguir emitiendo o mejorá tu plan.

Cómo resolverlo

  • Reasigná cuota: en el dashboard → Proyectos & API Keys, bajá la cuota de un proyecto con DTEs libres y subísela a este. El cambio aplica de inmediato.
  • Usá la reserva: si dejaste DTEs sin asignar, asignalos a este proyecto.
  • Mejorá 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 — asignale DTEs en el dashboard antes de emitir en live.

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

En esta página