Ir al contenido

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).

  • 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 saldos amount_available, amount_entered y amount_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
idinteger

Identificador de la caja de cliente.

customer_idinteger

Cliente dueño de la caja.

coin_idinteger

Moneda de la caja.

namestring

Nombre de la caja.

typestring

Tipo de caja (AccountTypeEnum): detracción o recaudación.

amount_availablenumber

Saldo disponible. Lo actualiza el sistema con cada movimiento.

amount_enterednumber

Monto ingresado acumulado. Valor por defecto 0.

amount_graduatednumber

Monto egresado acumulado. Valor por defecto 0.

statusstring

Estado del registro (ModelStatusEnum). Se asigna al crear.

previous_statusstring

Estado anterior. Lo llena el sistema al cambiar el estado o al eliminar.

status_update_commentstring

Comentario del último cambio de estado.

status_update_datedatetime

Fecha del último cambio de estado.

create_user_idinteger

Usuario que creó el registro. Se asigna automáticamente.

update_user_idinteger

Usuario que hizo la última modificación.

delete_user_idinteger

Usuario que eliminó el registro.

restore_user_idinteger

Usuario que restauró el registro.

status_update_user_idinteger

Usuario que hizo el último cambio de estado.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

deleted_atdatetime

Fecha de eliminación lógica.

El objeto CustomerCashbox200
{
"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
}
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.

El modelo no define columnas de búsqueda propias.

El estado usa ModelStatusEnum. Una caja nueva queda en activo; al eliminarla pasa a eliminado.

No existe ruta para restaurar una caja de cliente.