Saltar al contenido
Facturador

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.