Cupo mensual de documentos agotado
Qué significa el error document-quota-exceeded, qué efecto tuvo la solicitud y cuándo volver a emitir.
La API devuelve este problema cuando el plan vigente no permite documentos adicionales y la ocupación del período ya alcanzó los documentos incluidos.
HTTP/1.1 403 Forbidden
Content-Type: application/problem+jsonIdentificá el error comparando el URI completo de type:
https://sifende.com.py/docs/solucion-problemas/document-quota-exceededNo uses title ni detail como identificadores: son textos para personas.
Respuesta de ejemplo
Este ejemplo corresponde a un plan sin documentos adicionales que ya ocupó su cupo. Las emisiones en DEV y SANDBOX no consumen cupo ni generan este bloqueo.
{
"type": "https://sifende.com.py/docs/solucion-problemas/document-quota-exceeded",
"title": "Cupo mensual de documentos agotado",
"status": 403,
"detail": "El plan A medida tiene ocupados los 20000 documentos incluidos del período actual.",
"codigoPlan": "A_MEDIDA",
"nombrePlan": "A medida",
"documentosIncluidos": 20000,
"consumoConfirmado": 19998,
"reservasActivas": 2,
"documentosDisponibles": 0,
"inicioPeriodo": "2026-08-10T04:00:00Z",
"finPeriodo": "2026-09-10T04:00:00Z",
"accion": "Esperá a que se libere capacidad o cambiá a un plan que permita documentos adicionales antes de volver a emitir.",
"traceId": "f2f0333f78bfb6a4184cb5a5374685a5"
}Campos
| Campo | Significado |
|---|---|
codigoPlan | Código estable del plan vigente |
nombrePlan | Nombre del plan para mostrar a una persona |
documentosIncluidos | Cupo efectivo del período |
consumoConfirmado | Documentos definitivos del período |
reservasActivas | Documentos en proceso, con resultado pendiente o todavía reintentables que conservan capacidad |
documentosDisponibles | Siempre 0 para este problema |
inicioPeriodo | Inicio inclusivo del período, en formato RFC 3339 |
finPeriodo | Fin exclusivo del período, en formato RFC 3339 |
accion | Próximo paso recomendado para una persona |
traceId | Identificador para correlacionar el error con soporte |
Las reservas activas no son consumo confirmado ni documentos adicionales cobrados. Solo mantienen un lugar mientras se conoce el resultado del documento.
Efecto de la solicitud bloqueada
La emisión bloqueada no se ejecutó: no creó documento ni CDC, no consumió numeración fiscal ni cupo. Si enviaste una Idempotency-Key, el 403 tampoco queda guardado como resultado terminal de esa intención.
Para revisar la alerta y las acciones del panel, consultá Si se agota el cupo.
Cómo recuperar capacidad
No reintentes inmediatamente en un loop y no esperes un header Retry-After: este error no representa un límite de frecuencia.
Si el plan tiene cupo de producción positivo, podés volver a enviar la misma intención cuando un documento reservado termine RECHAZADO y libere su lugar, comience un nuevo período con capacidad o pases a un plan que permita documentos adicionales.
Los planes mensuales con documentos adicionales permiten seguir emitiendo al agotar el cupo, con las tarifas de documentos adicionales. El plan gratuito no emite en producción: recibe plan-operation-not-allowed.
Con Idempotency-Key, conservá la misma clave y el mismo payload al reintentar la intención que fue bloqueada. Un replay exitoso ya existente conserva su respuesta original aunque el cupo actual esté lleno.
Para implementar la decisión en tu cliente, consultá Manejar Errores. Para entender el cálculo del cupo, consultá Planes y Precios.