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 |
| Account |
accounts |
Cuenta bancaria o de efectivo. |
| CashboxMovement |
cashbox_movements |
Cada ingreso, egreso, transferencia o cambio de moneda. |
Cashbox ─┬─ CashboxOpening ─┬─ CashboxOpeningAccount ── Account
│ └─ CashboxOpeningCoin ───── Coin
├─ Account ─┬─ CashboxMovement ─── (transferencia) ── CashboxMovement
│ ├─ AccountConciliation ─ AccountConciliationDetail ── CashboxMovement
│ └─ AccountClosureMonthly
- 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.