Ir al contenido

Resumen

Resumen del módulo de Caja: sus 11 modelos, cómo se relacionan y los endpoints que expone.

Se agrupan en tres bloques.

Modelo Tabla Para qué sirve
Cashbox cashboxes La caja.
CashboxOpening cashbox_openings Apertura de una caja.
CashboxOpeningAccount cashbox_opening_accounts Saldo inicial por cuenta.
CashboxOpeningCoin cashbox_opening_coins Monto inicial por moneda.
CashboxIncomeSegment cashbox_income_segments Segmentos de ingreso.
CashboxLog cashbox_logs Bitácora.
Modelo Tabla Para qué sirve
Account accounts Cuenta bancaria o de efectivo.
CashboxMovement cashbox_movements Cada ingreso, egreso, transferencia o cambio de moneda.
Modelo Tabla Para qué sirve
AccountConciliation account_conciliations Lote de conciliación.
AccountConciliationDetail account_conciliation_details Movimientos de un lote.
AccountClosureMonthly account_closure_monthlies Cierre mensual de una cuenta.
Cashbox ─┬─ CashboxOpening ─┬─ CashboxOpeningAccount ── Account
│ └─ CashboxOpeningCoin ───── Coin
├─ Account ─┬─ CashboxMovement ─── (transferencia) ── CashboxMovement
│ ├─ AccountConciliation ─ AccountConciliationDetail ── CashboxMovement
│ └─ AccountClosureMonthly
└─ CashboxLog
  • Una caja tiene muchas cuentas y muchas aperturas.
  • Una cuenta tiene muchos movimientos, lotes de conciliación y cierres mensuales.
  • Un movimiento pertenece a una cuenta y puede enlazarse con otro movimiento (transferencia) o con un lote de conciliación.

Las rutas están en allendostmen-erp-server/routes/api.php. Todas requieren autenticación (Sanctum) y se autorizan con las políticas.

Método Ruta Acción
GET cashbox/dashboard Tablero general de todas las cajas.
GET cashbox/{id}/summary Resumen de una caja.
GET cashbox/{id}/profile Perfil de una caja.
Resource cashbox CRUD.
PUT cashbox/{cashbox}/restore Restaurar.
PUT cashbox/{cashbox}/update-status Cambiar estado.
Método Ruta Acción
Resource cashbox-opening CRUD de aperturas.
API resource cashbox-income-segment CRUD de segmentos de ingreso.
PUT cashbox-income-segment/{id}/restore Restaurar un segmento.
GET cashbox-log Bitácora (solo index).
Método Ruta Acción
Resource cashbox-movement CRUD de movimientos.
GET cashbox-movement/concept-suggestions Sugerencias de concepto.
GET cashbox-movement/get/available-years Años con movimientos.
POST cashbox-movement/commission Crear comisiones.
POST cashbox-movement/transfer Crear transferencia entre cuentas.
PUT cashbox-movement/{cashboxMovement}/transfer/update Editar una transferencia.
POST cashbox-movement/exchange-rate Crear cambio de moneda.
PUT cashbox-movement/{cashboxMovement}/anulate Anular un movimiento (usa AnnulPaymentUseCase).
PUT cashbox-movement/anulate/{cashboxMovement} Anular a partir de un movimiento de origen (anulateMovement).
Método Ruta Acción
GET account-conciliation/preview/{account} Vista previa de lo que se conciliaría.
POST account-conciliation/conciliate Conciliar.
POST account-conciliation/{accountConciliation}/unconciliate Deshacer la conciliación.
PUT account-conciliation/{accountConciliation}/revert Revertir.
GET account-conciliation/{accountConciliation}/statement-file Descargar el extracto adjunto.
Resource (store, index, show) account-conciliation Alta, listado y detalle.
GET .../conciliation-status y .../accounts-conciliation-status Estado de conciliación (en CashboxMovementController).

Los reportes se sirven bajo el prefijo report:

Formato Ruta
Excel report/excel/cashbox-movement/all
PDF report/pdf/cashbox-movement/all
Excel de una conciliación report/excel/account-conciliation/{conciliation}
PDF de una conciliación report/pdf/account-conciliation/{conciliation}
Excel del cierre mensual report/excel/account-closure-monthly/{year}/{month}
PDF del cierre mensual report/pdf/account-closure-monthly/{year}/{month}

Los parámetros del reporte de movimientos están en Exportación.