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í.
Cabeceras
Sección titulada «Cabeceras»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. |
Al superar el límite
Sección titulada «Al superar el límite»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.
Cómo no llegar al límite
Sección titulada «Cómo no llegar al límite»- Respeta
Retry-Aftery 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.