Reintentos exponenciales

Las llamadas a la API pueden fallar por causas transitorias: timeout de red, rate limit (429) o un 5xx puntual de upstream. La estrategia recomendada es reintentar con backoff exponencial + jitter, reutilizando siempre la misma Idempotency-Key para que un reintento que sí llegó al servidor no genere un comprobante duplicado.

Implementación completa para Node.js con axios. Notá que los errores 4xx distintos de 429 no se reintentan: indican un problema del request que ningún retry va a arreglar.


import axios from 'axios';
 
async function emitirRobusta(facturaData) {
  const idempotencyKey = crypto.randomUUID();
  const maxReintentos = 5;
 
  for (let intento = 0; intento < maxReintentos; intento++) {
    try {
      const { data } = await axios.post(
        'https://api.lxsyscr.com/api/v1/facturas',
        facturaData,
        {
          headers: {
            'X-Api-Key': process.env.LXS_API_KEY,
            'Content-Type': 'application/json',
            'Idempotency-Key': idempotencyKey
          },
          timeout: 30000
        }
      );
      return data;
    } catch (err) {
      const status = err.response?.status;
 
      // Errores definitivos: no reintentar
      if (status >= 400 && status < 500 && status !== 429) {
        throw err;
      }
 
      // Último intento
      if (intento === maxReintentos - 1) throw err;
 
      // Backoff
      const retryAfter = err.response?.headers['retry-after'];
      const waitMs = retryAfter
        ? parseInt(retryAfter) * 1000
        : Math.min(1000 * Math.pow(2, intento), 30000) + Math.random() * 1000;
 
      await new Promise(r => setTimeout(r, waitMs));
    }
  }
}

Si el servidor te devuelve el header Retry-After, respetalo siempre: tiene prioridad sobre tu cálculo de backoff. Ver también códigos de error e idempotencia.