Listados y filtros

Las operaciones que listan registros reciben sus filtros en la consulta y devuelven una página de resultados con el total.

Paginación

Parámetro	Qué hace	Por defecto
page	Número de página, desde 1.	1
pageSize	Cuántos registros por página, de 1 a 100.	50 en casi todos; la referencia de cada listado dice el suyo.

La respuesta trae los registros de la página y el total de lo que cumple los filtros. Para recorrer todo, pedí páginas hasta que la cantidad leída llegue al total:

let page = 1;
const todos = [];
while (true) {
  const r = await fetch(`${process.env.ERP_URL}/api/v1/customers/list?page=${page}&pageSize=100`, { headers });
  const { customers, total } = await r.json();
  todos.push(...customers);
  if (todos.length >= total || customers.length === 0) break;
  page += 1;
}

Búsqueda, filtros y orden

• search busca por texto en los campos que indica cada operación (nombre, código, número, documento).
• Cada listado tiene sus filtros propios, con sus valores posibles en la referencia: por ejemplo status (active, inactive o all).
• sort elige el orden, entre los valores que admite cada listado.

Algunos listados chicos, como los datos de referencia, devuelven todo de una vez y no paginan. La referencia de cada operación dice qué parámetros acepta.