Límites de Uso (Rate Limits)

Para garantizar la estabilidad del servicio y evitar abusos, la API de YoEmito implementa un sistema de control de tasa de peticiones (Rate Limiting):

Límite Estándar de la API

El límite por defecto para las peticiones autenticadas es de 60 peticiones por minuto por organización. Esta tasa se computa de forma agregada a través de todos los endpoints de la API.

Cabeceras de Control

Cada respuesta HTTP incluye información detallada sobre tu consumo actual:

X-RateLimit-Limit: El número total de peticiones permitidas por minuto (ej: 60).
X-RateLimit-Remaining: El número de peticiones que te quedan dentro de la ventana de tiempo actual.

Consultar tu Consumo en Tiempo Real

Las cabeceras X-RateLimit-* solo reflejan tu consumo en la última respuesta. Si necesitas saber cuánto llevas consumido sin hacer una petición contra otro endpoint (por ejemplo, para autolimitarte antes de una ráfaga), usa:

GET /v1/me/usage/realtime

Devuelve { limit, used, remaining, window_seconds, reset_in_seconds } leído directamente del contador — esta consulta no descuenta de tu propio límite.

Exceso de Límites (HTTP 429)

Si excedes la cuota permitida, la API responderá con un código de estado 429 Too Many Requests y la cabecera:

Retry-After: <segundos_de_espera>

Buenas prácticas: Para evitar el exceso de límites debido a la consulta recurrente de estados de documentos (polling), te recomendamos implementar Webhooks. De esta manera, YoEmito te notificará de forma activa en el instante en que cambie el estado de emisión ante la SUNAT.