Planes y límites

Operaciones incluidas por plan, RUC permitidos y límite de peticiones.

Operaciones por plan

Plan	Operaciones	RUC
Gratis	50 en total durante 30 días	1
Básico	5 000 por mes	1
Pro	Ilimitadas	Ilimitados

La columna RUC cuenta solo los RUC de producción. Los RUC de prueba, que usan las claves asu_test_, no tienen cupo. Ver Emisores.

Consumen una operación:

Cada documento emitido con POST /documents (factura, boleta, nota o retención).
Cada guía emitida con POST /guides.
Cada documento anulado con POST /voids.

Si la emisión falla antes de llegar a SUNAT, la operación se devuelve. Las consultas, descargas, correos y validaciones del RUC no consumen operaciones. El mes se cuenta en hora de Lima.

Consulta tu consumo con GET /account:

json

{
  "workspace": { "id": "8a1f...", "slug": "mi-empresa", "name": "Mi Empresa" },
  "plan": "emprende",
  "subscriptionStatus": "active",
  "usage": { "used": 1250, "limit": 5000, "remaining": 3750, "period": "2026-10" },
  "limits": { "issuers": 1 }
}

limit y remaining son null en el plan Pro.

Errores de plan

Código	Cuándo
`TRIAL_EXPIRED`	La prueba gratuita de 30 días venció.
`TRIAL_EXHAUSTED`	La prueba gratuita usó sus 50 operaciones.
`PLAN_LIMIT_REACHED`	Se usaron las operaciones del mes.
`PLAN_REQUIRED`	La suscripción no está activa.
`ISSUER_LIMIT_REACHED`	El plan no permite registrar otro RUC de producción.
`ISSUER_SELECTION_REQUIRED`	Intentas activar un RUC y tu plan ya tiene el máximo de RUC activos. Desactiva el RUC activo con `PATCH /issuers/{ruc}` antes de activar otro.

Todos responden 402, salvo ISSUER_SELECTION_REQUIRED, que responde 409.

Si bajas a un plan que permite menos RUC (por ejemplo, de Profesional a Básico), no se bloquea la emisión: queda activo tu RUC predeterminado y los demás se desactivan, sin perder datos. Para cambiar cuál queda activo, desactiva el actual y activa el otro.

Límite de peticiones

120 peticiones por minuto por clave.
60 por minuto por IP para peticiones sin clave o con una clave inválida.

Al superar el límite la API responde 429 RATE_LIMITED con el header Retry-After en segundos. Espera ese tiempo antes de reintentar.

http

HTTP/1.1 429 Too Many Requests
Retry-After: 23