Límites de uso
La emisión fiscal es legítimamente rafagosa, pero una integración desbocada no debe saturar ni la plataforma ni al SRI o la SUNAT. Los límites son por minuto: 300 solicitudes por llave y 600 por IP de origen.
Cabeceras#
-
x-ratelimit-limityx-ratelimit-remainingacompañan cada respuesta: el techo de la ventana y lo que te queda de ella. -
Al exceder el límite:
429conRetry-After: 60y el sobrerate_limited.
En la práctica#
Respeta
Retry-After
con retroceso exponencial y aprovecha la idempotencia: reintentar un
POST
con el mismo
external_ref
es siempre seguro. Para sincronizar volúmenes grandes usa
page[limit]
alto y
fields[…]
en lugar de más solicitudes.
HTTP/1.1 200 OK
x-ratelimit-limit: 300
x-ratelimit-remaining: 287
HTTP/1.1 429 Too Many Requests
retry-after: 60
{"error": {"code": "rate_limited", "message": "Demasiadas solicitudes."}}