CustomerCashbox
Una caja de cliente lleva el saldo que la empresa mantiene a nombre de un cliente, en una moneda y con un tipo (detracción o recaudación). Sus saldos se mueven con los movimientos de la caja de cliente (CustomerCashboxMovement).
Diferencia con la caja de la empresa
Sección titulada «Diferencia con la caja de la empresa»- La caja de la empresa (
Cashbox) agrupa cuentas, aperturas y movimientos de la empresa. No pertenece a un cliente. - La caja de cliente (
CustomerCashbox) pertenece a un cliente (customer_id) y a una moneda (coin_id). No tiene cuentas ni aperturas propias: solo guarda los saldosamount_available,amount_enteredyamount_graduated. - Cada movimiento de una caja de cliente se respalda con un movimiento de la caja de la empresa (
cashbox_movement_id), de modo que el dinero entra o sale por una cuenta real de la empresa. - El saldo disponible lo mantiene el sistema: el observador del movimiento lo suma o resta, y no se actualiza desde la API de la caja de cliente.
| Modelo | App\Models\CustomerCashbox |
| Tabla | customer_cashboxes |
El objeto CustomerCashbox
Sección titulada «El objeto CustomerCashbox»Atributos
Sección titulada «Atributos»idintegerIdentificador de la caja de cliente.
customer_idintegerCliente dueño de la caja.
coin_idintegerMoneda de la caja.
namestringNombre de la caja.
typestringTipo de caja (AccountTypeEnum): detracción o recaudación.
amount_availablenumberSaldo disponible. Lo actualiza el sistema con cada movimiento.
amount_enterednumberMonto ingresado acumulado. Valor por defecto 0.
amount_graduatednumberMonto egresado acumulado. Valor por defecto 0.
statusstringEstado del registro (ModelStatusEnum). Se asigna al crear.
previous_statusstringEstado anterior. Lo llena el sistema al cambiar el estado o al eliminar.
status_update_commentstringComentario del último cambio de estado.
status_update_datedatetimeFecha del último cambio de estado.
create_user_idintegerUsuario que creó el registro. Se asigna automáticamente.
update_user_idintegerUsuario que hizo la última modificación.
delete_user_idintegerUsuario que eliminó el registro.
restore_user_idintegerUsuario que restauró el registro.
status_update_user_idintegerUsuario que hizo el último cambio de estado.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "id": 4, "customer_id": 12, "coin_id": 1, "name": "RECAUDACIÓN SOLES", "type": "recaudación", "amount_available": 1500.0, "amount_entered": 0.0, "amount_graduated": 0.0, "status": "activo", "previous_status": null, "status_update_comment": null, "status_update_date": null, "create_user_id": 1, "update_user_id": null, "delete_user_id": null, "restore_user_id": null, "status_update_user_id": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z", "deleted_at": null}Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
customer |
belongsTo | Customer |
coin |
belongsTo | Coin |
| Scope | Parámetro | Efecto |
|---|---|---|
customerId |
customer_id |
Filtra las cajas del cliente indicado. Si el valor viene vacío, no filtra. |
Se usan los campos de orden por defecto de BaseModelTrait: id, name, created_at, updated_at y status.
Búsqueda
Sección titulada «Búsqueda»El modelo no define columnas de búsqueda propias.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Una caja nueva queda en activo; al eliminarla pasa a eliminado.
Endpoints
Sección titulada «Endpoints»No existe ruta para restaurar una caja de cliente.
