Skip to main content
Todos los endpoints de lista en la API externa de SmartPyme devuelven resultados paginados. Tú controlas qué página obtener y cuántos registros incluir por página usando parámetros de consulta. La envoltura de la respuesta siempre incluye un objeto pagination para que tu integración pueda determinar si hay más páginas y navegar entre ellas de forma programática.

Parámetros

integer
predeterminado:"1"
El número de página a obtener. Debe ser 1 o mayor. Su valor por defecto es 1 si se omite.
integer
predeterminado:"100"
La cantidad de registros a incluir por página. Acepta valores de 1 a 200. Su valor por defecto es 100 si se omite.

Campos de respuesta de paginación

Cada respuesta de lista incluye un objeto pagination en el nivel superior de la envoltura de la respuesta con los siguientes campos:
integer
El número de página de los resultados que se devuelven actualmente.
integer
La cantidad de registros incluidos en esta página.
integer
La cantidad total de registros que coinciden con tu consulta en todas las páginas.
integer
La cantidad total de páginas disponibles según el valor actual de per_page.
boolean
true si hay una página después de la actual; false si esta es la última página.
boolean
true si hay una página antes de la actual; false si esta es la primera página.
integer
El índice del primer registro en la página actual (basado en 1, relativo al conjunto completo de resultados).
integer
El índice del último registro en la página actual (basado en 1, relativo al conjunto completo de resultados).

Ejemplo de solicitud

La siguiente solicitud obtiene la segunda página de resultados de ventas con 50 registros por página:

Iterar sobre todas las páginas

Para recuperar todos los registros de un conjunto de datos, recorre las páginas hasta que has_next sea false. El siguiente ejemplo obtiene todas las ventas de enero de 2025 usando el tamaño máximo de página para minimizar la cantidad de solicitudes:
Usa per_page=200 para minimizar la cantidad de solicitudes y mantenerte dentro de tu cupo de límite de uso.