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.