Guías
Paginación
Cómo pedir listas largas por partes.
Rendiciones
GET /rendiciones pagina con limite (de 1 a 500) y desplazamiento (cuántas saltar), de la más reciente a la más antigua. Sin limite vienen todas. Cuando una página trae menos que el límite, era la última.
// Todas las rendiciones aprobadas, de a 100.
const todas = [];
for (let desplazamiento = 0; ; desplazamiento += 100) {
const url = `https://simpligastos.cl/api/v1/rendiciones?estado=aprobada&limite=100&desplazamiento=${desplazamiento}`;
const respuesta = await fetch(url, { headers: { Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}` } });
if (!respuesta.ok) throw new Error((await respuesta.json()).error);
const { rendiciones } = await respuesta.json();
todas.push(...rendiciones);
if (rendiciones.length < 100) break;
}# Todas las rendiciones aprobadas, de a 100.
import os
import requests
todas = []
desplazamiento = 0
while True:
respuesta = requests.get(
"https://simpligastos.cl/api/v1/rendiciones",
params={"estado": "aprobada", "limite": 100, "desplazamiento": desplazamiento},
headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
rendiciones = respuesta.json()["rendiciones"]
todas.extend(rendiciones)
if len(rendiciones) < 100:
break
desplazamiento += 100Para no traer lo mismo cada vez, filtra: ?estado=aprobada&contabilizada=0 trae solo lo que tu ERP todavía no marcó. O escucha los webhooks y pide solo lo que cambió.
Registro de cambios
GET /registro trae hasta 200 eventos, del más nuevo al más antiguo. Para seguir, manda en antes el creadoEn del último que recibiste.
# La primera página: los 200 eventos más nuevos.
curl "https://simpligastos.cl/api/v1/registro" -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"
# La siguiente: los anteriores al creadoEn del último evento recibido.
curl "https://simpligastos.cl/api/v1/registro?antes=2026-10-12T00:28:01.573Z" -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"El resto de las listas
Las demás listas vienen completas: personas, categorías, fondos, pagos, tarjetas. Las que crecen con el tiempo se acotan por período: los reportes, la planilla, los documentos y los asientos piden desde y hasta (por omisión, el mes en curso en los reportes y la planilla).