Resumen de movimientos
GET /api/finances/movements-summary
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Totales del periodo con los mismos filtros que Movimientos de dinero: cantidad, total de entradas, total de salidas y saldo. Montos en soles (los movimientos en dólares se convierten con su tipo de cambio). Las transferencias entre cuentas no afectan el saldo.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
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. |
Respuestas
200 — Resumen
{
"success": true,
"data": {
"count": 42,
"total_input": 3580.5,
"total_output": 1240.0,
"balance": 2340.5
}
}
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.