Guías
Límites
Tamaños de archivo, de listas y de tiempo que conviene conocer.
Archivos
- Documentos de un gasto: JPG, PNG, WEBP o PDF, de hasta 15 MB. Otro formato responde 415 (también HEIC: manda la foto como JPG), más grande responde 413 y un archivo vacío, 400.
- Cartola de una tarjeta: Excel, CSV o PDF, de hasta 20 MB.
Listas
Lo que acepta cada pedido que recibe o devuelve muchos elementos:
GET /rendiciones- limite de 1 a 500 por página
GET /registro- 200 eventos por página; 5000 en CSV
POST /rendiciones y /rendiciones/{id}/gastos- hasta 500 gastos
POST /nominas- hasta 1000 pagos
POST /personas/importar- hasta 500 personas
POST /personas/sincronizar- hasta 5000 colaboradores
PUT /presupuestos- hasta 2000 presupuestos
POST /avisos- hasta 200 ids
Cómo pedir por partes: Paginación.
Webhooks
Tu servidor tiene 5 segundos para responder cada aviso. Se reintenta hasta 6 veces y por 24 horas como máximo.
Plan
El plan de la empresa no cambia lo que puede hacer la API: cambia cuántas personas caben y, en el plan gratis XS, cuántos documentos se suben al mes (30). Pasado ese cupo, subir un documento responde 402; con la suscripción vencida, también subir gastos e invitar. Leer sigue funcionando siempre.
Hoy no hay un límite publicado de pedidos por minuto. Si se agrega uno, va a aparecer aquí y en Cambios. Mientras tanto, prefiere los webhooks a preguntar cada pocos segundos.