Límites y uso justo

Los límites protegen la estabilidad fiscal y se aplican por credencial, integración, organización, contribuyente, ambiente o endpoint según el contrato.

Límites contractuales de v1

Recurso	Límite vigente
Cuerpo JSON de creación	1 MiB (`1,048,576` bytes), con o sin `Content-Length`
Líneas por factura	Entre 1 y 1,000
Impuestos por línea	Hasta 12
`external_id`	Entre 1 y 200 caracteres
`Idempotency-Key`	Entre 1 y 200 caracteres
Página de listado	Entre 1 y 100 resultados
XML o PDF descargado con el SDK TypeScript	25 MiB por artefacto, como defensa del cliente

Los límites de cada campo y operación también forman parte de OpenAPI. Una solicitud de creación debe usar Content-Type: application/json; el servidor verifica los bytes recibidos aunque el cliente no declare Content-Length.

Respuesta ante límites

Cuando una solicitud supera un límite:

conserva la intención y su idempotencia;
respeta Retry-After cuando esté presente;
aplica backoff con jitter;
reduce concurrencia;
no distribuyas carga entre credenciales para eludir la cuota.

Las respuestas autenticadas exponen RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset. Una respuesta 429 puede añadir Retry-After; usa esos valores en lugar de asumir una cuota fija.

Capacidad del cliente

Controla:

concurrencia máxima;
tamaño de cola;
timeout por operación;
intentos totales;
circuit breaker;
tasa de reconciliación;
retención de eventos procesados.

Uso justo

No está permitido:

compartir una credencial entre contribuyentes o ambientes;
usar polling agresivo en lugar de webhooks y reconciliación;
repetir validaciones idénticas sin necesidad;
descargar artefactos en bucle;
usar el sandbox como almacenamiento o carga de producción;
intentar descubrir datos de otro contribuyente.

Solicitar capacidad adicional

Entrega estimaciones de:

operaciones diarias y pico por minuto;
tipos e-CF;
tamaño promedio;
horario y zona;
estrategia de webhook;
recuperación ante degradación.

La ampliación se valida primero en sandbox y no cambia por sí misma la habilitación fiscal.

Configurar soporte y monitoreo →