FISCALISTO / API
Límites de solicitudes
Cuántas solicitudes y cuántos timbres por segundo acepta la API, y qué hacer con un 429.
| Límite | Producción | Pruebas |
|---|---|---|
| Solicitudes por cuenta (todas sus llaves juntas) | 100 cada 10 segundos | 100 cada 10 segundos |
| Comprobantes timbrados por emisor | 20 cada 10 segundos | 5 cada 10 segundos |
| Comprobantes timbrados por cuenta al día | Sin tope (cada uno usa un timbre) | 1,000 |
| RFC revisados en las listas del SAT al día | 200,000 | 5,000 |
| Constancias consultadas en el SAT al día | 2,000 | 100 |
| Ligas para pedir datos fiscales al día | 20,000 | 200 |
| Ligas de alta de emisores al día | 20,000 | 200 |
| Descargas pedidas al SAT al día | 300 | 50 |
| Consultas de declaraciones al SAT al día | 2,000 | 100 |
| Opiniones, constancias y buzón del emisor pedidos al SAT al día | 2,000 | 100 |
| Tickets de autofactura registrados al día | 100,000 | 2,000 |
| Facturas recurrentes activas por emisor | 5,000 | 25 |
| Cotizaciones creadas al día | 20,000 | 200 |
| Depósitos mandados a conciliación al día | 100,000 | 5,000 |
| Reinicios de los datos de prueba al día | — | 20 |
| Avances de relojes de prueba al día | — | 50 |
| Entornos de prueba por cuenta | — | 25 |
| Endpoints de webhooks por modo | 16 | 16 |
| Tiendas conectadas por emisor | 10 | 10 |
| Facturas por lote | 1,000 | 1,000 |
| Emisores nuevos por cuenta | 500 en 24 horas | 20 en 24 horas |
| Tamaño del cuerpo de una solicitud | 10 MB | 10 MB |
Cada respuesta trae el límite de su cuenta en el encabezado RateLimit-Policy: 100;w=10 (100 solicitudes cada 10 segundos), en producción y en pruebas, para que su cliente reparta las solicitudes sin esperar un 429.
Al pasarse, la API responde 429 con el código rate_limit (por cuenta), stamp_rate_limit (por emisor) o daily_limit (los topes del día) y el encabezado Retry-After con los segundos que hay que esperar; en daily_limit, los que faltan para la medianoche de la Ciudad de México. Espere ese tiempo y repita la solicitud; si timbra, con la misma Idempotency-Key.
Lo que usa timbres sin timbrar
En producción, cinco cosas usan timbres de su cuenta, además de su tope del día:
| Qué | Timbres |
|---|---|
| RFC revisados en las listas del SAT | 1 por cada 10 |
| Constancias consultadas en el SAT | 1 por cada 10 |
| Descargas pedidas al SAT | 1 por cada 100 CFDI que traen (al menos 1) |
| Consultas de declaraciones al SAT | 1 por consulta (una vez cada 10 minutos por emisor) |
| Opinión de cumplimiento, constancia y buzón del emisor pedidos al SAT | 1 por consulta (cada uno una vez cada 10 minutos por emisor) |
Se cuentan por mes de la Ciudad de México y una parte cuenta como entera: el primer RFC del mes toma un timbre que cubre hasta el décimo. Sin timbres, la API responde 402 insufficient_balance y no cuenta la solicitud. Una constancia que ya consultó ese día, una descarga que el SAT rechaza y una consulta de declaraciones, opinión, constancia o buzón a la que el SAT no contesta no cuentan. Una descarga paga su primer timbre al pedirla y los demás cuando el SAT dice cuántos CFDI tiene, antes de descargarlos; sin timbres suficientes termina en failed. Lo que lleva el mes está en Desarrolladores › Timbres. En pruebas no se usan timbres.
Los topes del día cuidan lo que no se paga con timbres: en pruebas todo es gratis, y las consultas al SAT salen de nuestros servidores. En pruebas los correos de las facturas solo llegan a las personas de su cuenta API; en producción, a quien usted indique.
Repetir una solicitud que ya se timbró (idempotent-replayed: true) no cuenta contra el límite de timbres.
Muchas facturas a la vez
Para timbrar cientos o miles de facturas, como las cuotas de fin de mes, no las mande una por una: use un lote. Un lote acepta hasta 1,000 facturas en una solicitud, las revisa todas antes de empezar y las timbra en segundo plano a la velocidad que permite el PAC, sin que usted tenga que manejar los límites.
Si necesita más
Escríbanos a hola@fiscalisto.com con su volumen y su caso.