Movimientos de dinero
GET /api/finances/movements-scroll
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Lista unificada de entradas y salidas de dinero (cobros de ventas, notas de venta, ingresos, gastos, compras, transferencias...) con paginación por cursor (limit máx. 100, por defecto 20).
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Paginación por cursor: envía limit (1 a 100, por defecto 15). La respuesta trae pagination.next_cursor; para la página siguiente repite la misma consulta agregando cursor=<next_cursor>. Cuando pagination.has_more es false no hay más páginas.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
date_start |
query | sí | 2026-11-01 |
Desde esta fecha de pago (YYYY-MM-DD). Por defecto, inicio del mes actual. |
date_end |
query | sí | 2026-11-30 |
Hasta esta fecha de pago. Por defecto, fin del mes actual. |
type_movement |
query | no | input |
input (entradas de dinero) u output (salidas). |
instance_types[] |
query | no | income |
Origen del movimiento; puede repetirse. Valores: document, sale_note, quotation, contract, technical_service, income, cash_transaction, purchase, purchase_settlement, expense, bank_loan_payment, transfer_account. |
destination |
query | no | cash |
cash (cajas) o bank:{id} (una cuenta concreta, p. ej. bank:3). |
last_cash_opening |
query | no | 1 |
1 = solo los movimientos de la caja abierta del usuario. |
limit |
query | no | 20 |
Registros por página (máx. 100). |
cursor |
query | no | Valor de pagination.next_cursor de la respuesta anterior para obtener la página siguiente. |
Respuestas
200 — Movimientos
{
"success": true,
"data": [
{
"id": 9001,
"date_of_payment": "2026-11-07",
"time_of_payment": "11:20:00",
"type_movement": "input",
"instance_type": "income",
"instance_type_description": "Ingreso",
"document_type_description": "Ingreso",
"number_full": "ING-1",
"person_name": "CARLOS RAMIREZ",
"person_number": null,
"payment_method_type_description": "Efectivo",
"destination": {
"type": "cash",
"id": 4,
"name": "CAJA - JUAN PEREZ"
},
"currency_type_id": "PEN",
"amount": 120.0,
"amount_pen": 120.0,
"reference": null,
"user_name": "JUAN PEREZ"
}
],
"pagination": {
"next_cursor": "eyJpZCI6MTUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
"has_more": true
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.