Guías

Límites de uso

Documentos incluidos por plan, qué cuenta para el uso, límites de solicitudes por minuto y cómo ampliar tu asignación con paquetes.

Cada plan tiene dos límites independientes: los documentos de producción por mes, que es lo que pagás, y las solicitudes por minuto, que protegen la plataforma de ráfagas. Esta página explica los dos, cómo seguirlos desde tu código y qué hacer cuando te acercás al límite.

Por plan

Plan	Documentos de producción por mes	Solicitudes por minuto	Emisores
Sandbox	Solo modo de prueba, sin límite mensual	30	1
Inicial	500	60	1
Crecimiento	3 000	300	10
Escala	10 000	600	50
Plataforma	25 000, compartidos entre todos los emisores	1 000	Sin límite
Empresa	Más de 50 000, a la medida	A la medida	A la medida

Precios y detalles de cada plan en precios. Archeion, el archivo de 5 años, viene incluido en Escala, Plataforma y Empresa, se suma por $5 por empresa al mes en Inicial y Crecimiento, y no cambia estos límites.

Qué cuenta

Operación	Cuenta como
Comprobante de producción (llave `aster_live_`) con veredicto final de Hacienda, aceptado o rechazado	1 documento
Mensaje Receptor de producción con veredicto final	0,5 documentos
Cualquier operación con una llave `aster_test_`	Nada: el modo de prueba es gratis
Solicitudes que no llegan a Hacienda: errores de validación (`422`), duplicados (`409`), reintentos idempotentes	Nada
Consultas, descargas, PDF, catálogos y tipos de cambio	Nada

El documento se cuenta cuando Hacienda da el veredicto final, no cuando lo enviás. Los reintentos internos de Aster ante una caída de Hacienda tampoco cuentan.

El mes de uso es tu ciclo de facturación.

Seguir el uso desde tu código

Cada respuesta de POST /electronic-documents y POST /receptor-messages incluye el uso del ciclo:

X-Usage-Month-Count: 412
X-Usage-Month-Limit: 500

X-Usage-Month-Limit incluye los documentos del plan más los paquetes vigentes.

Para el detalle, consultá el uso de la cuenta con tu llave de cuenta:

curl https://aster.astranexo.com/api/v1/account/usage \
  -H "Authorization: Bearer aster_live_3NhR7wPz5KcY2mQdXb8LfT4vJs9GqE1uWa6RyZ0o"

{
  "success": true,
  "data": {
    "plan": "inicial",
    "period_start": "2026-10-01T00:00:00-06:00",
    "period_end": "2026-10-31T23:59:59-06:00",
    "included": 500,
    "pack_credits": 0,
    "allowance": 500,
    "used": 412,
    "remaining": 88,
    "by_organization": [
      { "organization_id": "6f1c2a9e-4b7d-4e2a-9c31-0d8e5b7a2f14", "name": "Ferretería La Sabana S.A.", "used": 412 }
    ]
  }
}

También ves el uso en el portal, en Facturación.

Avisos por correo

Aster le escribe al correo de facturación de la cuenta dos veces por ciclo:

Al llegar al 80 % de la asignación.
Al llegar al 100 %.

Cada aviso se envía una sola vez por ciclo.

Al llegar al 100 %

Cuando el uso del ciclo alcanza la asignación (plan más paquetes), las solicitudes nuevas de comprobantes de producción responden 402 quota_exceeded:

{
  "success": false,
  "message": "Monthly document allowance reached.",
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly document allowance reached.",
    "upgrade_url": "https://aster.astranexo.com/app/billing/upgrade",
    "pack_url": "https://aster.astranexo.com/app/billing/packs"
  }
}

Esta respuesta llega antes de firmar: no se genera clave, no se consume consecutivo y nada llega a Hacienda. Podés reintentar la misma solicitud, con la misma llave de idempotencia, apenas amplíes la asignación.

Mejorá de plan o agregá un paquete en cualquier momento, desde el portal o con los enlaces upgrade_url y pack_url de la respuesta. La mejora de plan se cobra en forma prorrateada y el paquete se cobra a la tarjeta guardada; en ambos casos la asignación nueva se aplica en menos de un minuto.

Las llaves de prueba, las consultas y las descargas no dependen de la asignación.

Paquetes de documentos

Los paquetes suman documentos a tu asignación sin cambiar de plan. Son un pago único y valen para el ciclo en curso y el siguiente.

Paquete	Precio (USD, más IVA)
500 documentos	$20
2 500 documentos	$75
10 000 documentos	$200

Aster usa primero los documentos del plan y después los del paquete.

Solicitudes por minuto

Las solicitudes autenticadas se limitan por organización y por minuto, según el plan. Cada respuesta indica la ventana que aplica:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 298
X-RateLimit-Reset: 1791476460

X-RateLimit-Reset es el momento, en segundos Unix, en que la ventana se renueva.

Al pasar el límite, la respuesta es 429 rate_limited con Retry-After en segundos:

{
  "success": false,
  "message": "Too many requests.",
  "error": {
    "code": "rate_limited",
    "message": "Too many requests."
  }
}

Esperá los segundos de Retry-After y reintentá con la misma llave de idempotencia. Las solicitudes rechazadas por límite no cuentan para la ventana.

Si emitís en lotes (cierres de mes, migraciones), repartí las solicitudes en el tiempo según X-RateLimit-Remaining en vez de enviarlas todas juntas.

Las rutas públicas, como los catálogos de /reference, tienen su propio límite por dirección IP.