Límites, idempotencia, paginación y versiones

<?php
// Reintento seguro: la misma Idempotency-Key en cada intento.
function emitir(array $comprobante, string $idempotencia): array
{
    for ($intento = 1; $intento <= 4; $intento++) {
        $ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes');
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST => true,
            CURLOPT_TIMEOUT => 90,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . getenv('SFP_API_KEY'),
                'Content-Type: application/json',
                'Idempotency-Key: ' . $idempotencia,
            ],
            CURLOPT_POSTFIELDS => json_encode($comprobante),
        ]);
        $cuerpo = curl_exec($ch);
        $estado = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        $json = $cuerpo !== false ? json_decode($cuerpo, true) : null;
        $enProceso = $estado === 409 && ($json['code'] ?? '') === 'idempotencia_en_proceso';
        if ($json !== null && $estado < 500 && $estado !== 429 && !$enProceso) {
            return $json;                        // 201, o un error que hay que corregir (4xx)
        }
        sleep(min(2 ** $intento, 30));          // red caída, 5xx, 429 o «en proceso»: espera y reintenta
    }
    throw new RuntimeException('No se pudo emitir: reintenta más tarde con la misma Idempotency-Key.');
}

// Reintento seguro: la misma Idempotency-Key en cada intento.
async function emitir(comprobante, idempotencia) {
  for (let intento = 1; intento <= 4; intento++) {
    try {
      const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes', {
        method: 'POST',
        headers: {
          Authorization: `Bearer ${process.env.SFP_API_KEY}`,
          'Content-Type': 'application/json',
          'Idempotency-Key': idempotencia,
        },
        body: JSON.stringify(comprobante),
        signal: AbortSignal.timeout(90_000),
      });
      const json = await res.json().catch(() => null);
      const enProceso = res.status === 409 && json?.code === 'idempotencia_en_proceso';
      if (json && res.status < 500 && res.status !== 429 && !enProceso) return json; // 201, o un 4xx que hay que corregir
      const espera = Number(res.headers.get('Retry-After')) || 2 ** intento;
      await new Promise((r) => setTimeout(r, Math.min(espera, 30) * 1000));
    } catch {
      await new Promise((r) => setTimeout(r, Math.min(2 ** intento, 30) * 1000)); // red caída
    }
  }
  throw new Error('No se pudo emitir: reintenta más tarde con la misma Idempotency-Key.');
}

import os, time, requests

def emitir(comprobante: dict, idempotencia: str) -> dict:
    """Reintento seguro: la misma Idempotency-Key en cada intento."""
    for intento in range(1, 5):
        try:
            r = requests.post(
                "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes",
                json=comprobante,
                headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": idempotencia},
                timeout=90,
            )
            en_proceso = r.status_code == 409 and r.json().get("code") == "idempotencia_en_proceso"
            if r.status_code < 500 and r.status_code != 429 and not en_proceso:
                return r.json()  # 201, o un 4xx que hay que corregir
            espera = int(r.headers.get("Retry-After", 2 ** intento))
        except requests.RequestException:
            espera = 2 ** intento  # red caída
        time.sleep(min(espera, 30))
    raise RuntimeError("No se pudo emitir: reintenta más tarde con la misma Idempotency-Key.")