Saltar al contenido
Facturador

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.