Ir al contenido

CustomerCashboxMovement

Un movimiento de caja de cliente registra un ingreso o un egreso en una caja de cliente y lo enlaza con el movimiento real de la caja de la empresa.

  • El movimiento de la caja de la empresa (CashboxMovement) mueve el saldo de una cuenta de la empresa dentro de una apertura de caja.
  • El movimiento de caja de cliente (CustomerCashboxMovement) mueve el saldo atribuido a un cliente (amount_available de su CustomerCashbox). Siempre apunta a un movimiento de la caja de la empresa mediante cashbox_movement_id.
  • Crear un movimiento de cliente crea también el movimiento de la empresa; anularlo anula ambos.

CustomerCashboxMovementObserver ajusta amount_available de la caja de cliente:

  • Al crear un movimiento ingreso, suma el monto; si es egreso, lo resta.
  • Al actualizar un movimiento que queda en estado anulado, revierte el efecto: un ingreso resta el monto y un egreso lo suma.
  • Eliminar el movimiento (deleted) no ajusta el saldo.
Modelo App\Models\CustomerCashboxMovement
Tabla customer_cashbox_movements
idinteger

Identificador del movimiento.

customer_idinteger

Cliente al que pertenece el movimiento.

customer_cashbox_idinteger

Caja de cliente afectada.

to_customer_cashbox_idinteger

Caja de destino. Solo se llena en el egreso de una transferencia.

from_customer_cashbox_idinteger

Caja de origen. Solo se llena en el ingreso de una transferencia.

transfer_customer_cashbox_movement_idinteger

En el ingreso de una transferencia, el movimiento de egreso que lo originó.

cashbox_movement_idinteger

Movimiento de la caja de la empresa que respalda a este.

typestring

Tipo de movimiento (CashboxMovementTypeEnum): ingreso o egreso.

conceptstring

Concepto del movimiento.

amountnumber

Monto del movimiento.

untouchableboolean

Marca de movimiento intocable. Valor por defecto false.

delete_commentstring

Comentario de eliminación. Se envía al eliminar el movimiento.

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 CustomerCashboxMovement200
{
"id": 30,
"customer_id": 12,
"customer_cashbox_id": 4,
"to_customer_cashbox_id": null,
"from_customer_cashbox_id": null,
"transfer_customer_cashbox_movement_id": null,
"cashbox_movement_id": 879,
"type": "ingreso",
"concept": "PAGO DEL CLIENTE",
"amount": 1500.0,
"untouchable": false,
"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
cashboxMovement belongsTo CashboxMovement
customer belongsTo Customer (incluye eliminados)
customerCashbox belongsTo CustomerCashbox
toCustomerCashbox belongsTo CustomerCashbox
fromCustomerCashbox belongsTo CustomerCashbox
originCustomerCashboxMovement belongsTo CustomerCashboxMovement
destinationCustomerCashboxMovement hasOne CustomerCashboxMovement

Campos permitidos para ordenar: id, customer_id, cashbox_movement_id, status, created_at y updated_at.

La búsqueda de texto (search) compara con las columnas amount, concept y operation_code del movimiento de la caja de la empresa (cashboxMovement).

El estado usa ModelStatusEnum. Un movimiento nuevo queda en activo. El único cambio de estado permitido por la API es a anulado; al eliminarlo pasa a eliminado.

No existe ruta para restaurar un movimiento.