Planes y límites

Los planes determinan cuánto puedes consumir, qué capacidades tienes habilitadas y qué flujos conviene diseñar desde el inicio.

Planes disponibles

Plan	Cuota mensual	Frecuencia por minuto	Tamaño máximo de lote	Claves API activas
Free	10 000	200	10	1
Starter	100 000	600	50	3
Pro	500 000	1 800	200	10
Business	2 000 000	6 000	500	Ilimitadas
Enterprise	10 000 000	6 000	500	Ilimitadas

Consejo

El plan Free es suficiente para validar tu integración (~333 consultas/día) y para casos personales o de prototipo. El cap de 200 req/min cubre incluso bursts moderados — solo si tu producto crece a >10 000 consultas/mes necesitas Starter.

Qué cambia según el plan

• Cuota mensual disponible
• Tamaño máximo de lotes
• Acceso a capacidades específicas
• Límites de frecuencia por minuto

Antes de integrar en producción

• Revisa cuántas consultas directas harás por día
• Identifica si usarás flujos en lote
• Verifica si necesitas capacidades adicionales como webhooks
• Define qué harás cuando recibas 429

Recomendaciones de diseño

• No asumas que todos los entornos consumirán al mismo ritmo
• Separa validaciones críticas de consultas accesorias
• Usa reintentos prudentes en vez de disparar solicitudes en paralelo sin control
• Monitorea el consumo desde tu lado cuando la integración sea sensible al volumen

Cómo cuentan tus solicitudes

Cada request autenticado se descuenta de dos contadores independientes:

Contador	Ventana	Aplica a
RPM (requests por minuto)	últimos 60 segundos rodantes	tope de frecuencia por plan
Cuota mensual	mes calendario (UTC)	total de consultas del mes

Operación	Descuento RPM	Descuento cuota mensual
GET (RUC, ubigeo, tipo-cambio, etc.)	1	1
POST /v1/ruc/batch con N RUCs	1	N (uno por RUC)
HEAD	1	1 (igual que GET — el server hace el mismo trabajo)
OPTIONS (preflight CORS)	0	0
Respuesta 304 Not Modified (con tu If-None-Match)	1	1

Nota

Las respuestas 304 SÍ consumen cuota porque el server ejecuta el trabajo completo (auth + lookup + hash ETag) y solo omite el body. Misma convención que Stripe y GitHub. Si tu integración cachea agresivamente, el ahorro está en el ancho de banda, no en el contador mensual.

Headers que respondemos en cada request autenticado:

x-ratelimit-limit:     200      // tope rpm del plan
x-ratelimit-remaining: 194      // disponible en este minuto
x-ratelimit-reset:     60       // segundos hasta que el bucket se actualice

Cuando excedes el límite recibes 429 con Retry-After. Si excedes la cuota mensual, recibes 429 con el detalle Cuota mensual alcanzada.

Cómo usar esta información

Usa esta guía para dimensionar tu integración, ordenar prioridades y definir qué volumen necesitas antes de activar un plan.

Nota

Los límites y capacidades comerciales pueden evolucionar con el producto. Toma la documentación vigente como base antes de cerrar una integración de alto volumen.