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).
Parámetros
Sección titulada «Parámetros»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.
Compatibilidad con parámetros antiguos
Sección titulada «Compatibilidad con parámetros antiguos»| 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).
Columnas
Sección titulada «Columnas»| 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.
Reglas de cálculo
Sección titulada «Reglas de cálculo»- 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 ANULADOSyTOTAL ANULADOS, por moneda.
Implementación
Sección titulada «Implementación»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.
