Límites de peticiones y reintentos

1. Los límites son por credencial y por minuto: 120 lecturas, 30 escrituras y 10 operaciones de facturación electrónica.
2. El cupo de facturación electrónica cubre efactura/submit, submissions/{id}/refresh y efactura/inbox/sync.
3. Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset, incluida la 429.
4. Un 429 te da Retry-After en segundos; espera ese tiempo antes de reintentar.

http
HTTP/2 429
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1785312000
Retry-After: 17
Content-Type: application/json

{"error":{"type":"rate_limit_error","code":"rate_limit_exceeded",
 "message":"...","doc_url":"https://4invoices.net/ro/api-dezvoltatori#errors",
 "request_id":"req_..."}}

javascript
// Respeta Retry-After; no reintentes nunca un 4xx distinto de 429.
async function call(url, init, attempt = 0) {
  const res = await fetch(url, init);
  if (res.status === 429 || res.status >= 500) {
    if (attempt >= 5) return res;
    const retryAfter = Number(res.headers.get("Retry-After")) || 2 ** attempt;
    await new Promise((r) => setTimeout(r, retryAfter * 1000));
    return call(url, init, attempt + 1);
  }
  return res;
}

// Un reintento de escritura DEBE reutilizar el MISMO Idempotency-Key, o emitirás
// un segundo documento fiscal.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

• El cupo de 10 por minuto no es arbitrario: en Rumanía, la propia ANAF permite aproximadamente una llamada de listado de mensajes por minuto y por CIF.
• Al reintentar una escritura, reutiliza la MISMA Idempotency-Key; de lo contrario, emitirás un segundo documento.
• El endpoint de tokens tiene un límite por IP aparte. Guarda el token en caché durante toda su vida útil de una hora.
• GET /v1/me muestra los cupos actuales de la credencial: útil en una comprobación de salud de la integración.
• ¿Necesitas límites más altos? Escríbenos a través de la página de Contacto indicando tu volumen diario previsto.