Ir al contenido

Exportación de movimientos

El reporte de movimientos se sirve en report/excel/cashbox-movement/all y report/pdf/cashbox-movement/all. Usa una sola plantilla Blade con $mode ('pdf' o 'excel'), según la regla del proyecto (docs/modules/exports-pdf-excel.md).

Validados y normalizados en ExportCashboxMovementsRequest. El formato lo define la ruta (excel o pdf), no un parámetro.

Parámetro Valores
payment_date_from, payment_date_to Obligatorios.
account_id Una cuenta; sin valor, todas las de la caja.
type Ingresos y egresos, solo ingresos o solo egresos.
transfers include, exclude_internal, exclude_all, only
annulled include, exclude, only, separate
columns[] Claves de columna (ver abajo). Sin valor, salen las de siempre.
sheets[] accounts, months, cost_centers, accounting_accounts, third_parties
running_balance Agrega la columna de saldo. Solo con una cuenta elegida.
order asc (por defecto) o desc por fecha de la operación.

También se aplican los filtros de la lista: search, customer_id, provider_id, project_id y segment.

Antiguo Equivale a
status=activo / status=anulado annulled=exclude / annulled=only
exclude_internal_transfers=true transfers=exclude_internal
show_transfers=true transfers=only

Sin columns[] salen las columnas de siempre, para no romper a quien ya llama al endpoint (la conciliación de cuentas).

Grupo Claves
Identificación code, opcode, date, datetime, account, cashbox
Detalle type, payment_method, concept, observation, bank, beneficiary_account
Comprobante voucher_type, voucher_number
Tercero third_party_type, third_party_document, third_party
Clasificación accounting_accounts, cost_center, project, segment
Montos subtotal, commission, exchange_rate
Control status, annulment_reason, annulment_date, conciliated, created_by, created_at

Los montos (abonos y cargos, por cada moneda) siempre salen. La columna de cuenta se omite si el reporte es de una sola cuenta.

  • Resúmenes y saldos usan solo movimientos vigentes; los anulados no suman.
  • Saldo: se calcula hacia atrás desde el saldo actual de la cuenta. Recorre todos los movimientos de la cuenta, aunque el detalle oculte algunos, y el encabezado lo avisa.
  • Totales del detalle: TOTAL GENERAL, TOTAL SIN ANULADOS y TOTAL ANULADOS, por moneda.

Rutas relativas a allendostmen-erp-server/:

Pieza Archivo
Validación y normalización app/Http/Requests/ExportCashboxMovementsRequest.php
Consulta, columnas, totales, saldo y resúmenes app/Services/CashboxMovementReportService.php
Vista única y parciales resources/views/reports/cashbox-movements.blade.php y reports/partials/cashbox-movements-{table,summary}.blade.php
Excel multi-hoja app/Exports/CashboxMovementsReportExport.php, CashboxMovementsReportSheet.php
Pruebas tests/Feature/Modules/CashboxMovementReportTest.php, tests/Unit/Exports/CashboxMovementsExportViewTest.php

En el frontend: cashbox-movements/components/cashbox-movement-export-dialog/ y cashbox-movements/utils/cashbox-movement-export.util.ts.