Ir al contenido

Límite de peticiones

Cada API key puede hacer hasta 120 peticiones por minuto. El límite se cuenta por clave: dos sistemas con claves distintas no se restan entre sí.

Cada respuesta de /v1 informa el límite y lo que te queda en el minuto en curso:

Cabecera Descripción
X-RateLimit-Limit Peticiones por minuto de tu clave (120).
X-RateLimit-Remaining Peticiones que te quedan en este minuto.

La API responde 429 Too Many Requests con la cabecera Retry-After, que indica los segundos que debes esperar antes de volver a intentar:

{ "reason": "TooManyRequests" }

Los enlaces públicos del PDF (links.public_pdf, links.public_ticket y links.public_ticket_58) no descuentan del límite de tu API key: tienen su propio límite de 60 descargas por minuto.

  • Respeta Retry-After y reintenta después de ese tiempo, no en un bucle inmediato.
  • Usa webhooks para saber cuándo SUNAT responde, en lugar de consultar cada comprobante una y otra vez. Si consultas, espera entre intentos como indica Estados y envío.
  • Consulta RUC en lote: hasta 1000 por llamada cuentan como una sola petición.
  • Reintenta una emisión con la misma Idempotency-Key (Idempotencia): no duplica el comprobante.