Rate limits

Cada endpoint tiene un límite de solicitudes por minuto para proteger el sistema ante errores en origen (loops accidentales, reintentos descontrolados). Los límites se miden por IP y son configurables por Hosana sin necesidad de avisar, aunque los valores por defecto son los siguientes.

Límites por endpoint

Endpoint	Límite por defecto	Por qué ese valor
`POST /facturas/insertar`	5 / min	Es el endpoint más pesado: procesa miles de facturas por llamada. En operación normal Jaremar envía 5–10 batches al día. Si se supera 5/min, algo anda mal en origen.
`GET /devoluciones/listar`	10 / min	En cierre de mes Jaremar puede hacer hasta ~40 llamadas; 10/min permite ráfagas sin saturar.
`GET /manifiestos/{numero}/estado`	60 / min	Límite general.
`GET /ping`	60 / min	Límite general.

Qué pasa al superar el límite

El servidor responde HTTP 429 Too Many Requests. La respuesta puede incluir el header Retry-After con los segundos a esperar antes de reintentar.

Cómo manejarlo

No reintentes inmediatamente. Respeta Retry-After si está presente; de lo contrario, espera al menos 60 segundos.
Usa backoff exponencial para reintentos automáticos (p. ej. 10s, 30s, 60s).
Agrupa. En lugar de muchas llamadas pequeñas a insertar, envía lotes grandes: una sola llamada acepta miles de facturas de varios manifiestos.