Demasiadas peticiones

429rate_limited

Qué significa

La llave hizo más peticiones por minuto de las que la API atiende. La petición no llegó a ejecutarse: no creó nada.

Reintenta más tarde: la misma petición puede funcionar sin cambiar nada.

Por qué ocurre

• Más de 600 peticiones por minuto con la misma llave.
• Más de 30 envíos de correo por minuto (POST /v1/documents/{id}/emails), que tienen su propio límite.
• Un bucle que consulta un comprobante sin pausa mientras espera a SUNAT.

Cómo resolverlo

1. Espera los segundos que indica la cabecera Retry-After y repite. El SDK lo hace solo.
2. Para saber el veredicto de SUNAT no consultes en bucle: usa webhooks, o documents.waitFor, que espacia sus consultas.
3. Las cabeceras RateLimit-Remaining y RateLimit-Reset de cada respuesta dicen cuánto queda antes de llegar al límite.

Cómo llega

La respuesta es application/problem+json con estado 429, y su campo type es la dirección de esta página.

{
  "type": "https://docs.emitay.com/errors/rate_limited",
  "title": "Demasiadas peticiones",
  "status": 429
}

Toda respuesta lleva además la cabecera Request-Id (req_…): cítala al pedir soporte.

Sigue con: Esperar el veredicto de SUNAT · todos los errores