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.
Diferencia con la caja de la empresa
Sección titulada «Diferencia con 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_availablede suCustomerCashbox). Siempre apunta a un movimiento de la caja de la empresa mediantecashbox_movement_id. - Crear un movimiento de cliente crea también el movimiento de la empresa; anularlo anula ambos.
Observador
Sección titulada «Observador»CustomerCashboxMovementObserver ajusta amount_available de la caja de cliente:
- Al crear un movimiento
ingreso, suma el monto; si esegreso, lo resta. - Al actualizar un movimiento que queda en estado
anulado, revierte el efecto: uningresoresta el monto y unegresolo suma. - Eliminar el movimiento (
deleted) no ajusta el saldo.
| Modelo | App\Models\CustomerCashboxMovement |
| Tabla | customer_cashbox_movements |
El objeto CustomerCashboxMovement
Sección titulada «El objeto CustomerCashboxMovement»Atributos
Sección titulada «Atributos»idintegerIdentificador del movimiento.
customer_idintegerCliente al que pertenece el movimiento.
customer_cashbox_idintegerCaja de cliente afectada.
to_customer_cashbox_idintegerCaja de destino. Solo se llena en el egreso de una transferencia.
from_customer_cashbox_idintegerCaja de origen. Solo se llena en el ingreso de una transferencia.
transfer_customer_cashbox_movement_idintegerEn el ingreso de una transferencia, el movimiento de egreso que lo originó.
cashbox_movement_idintegerMovimiento de la caja de la empresa que respalda a este.
typestringTipo de movimiento (CashboxMovementTypeEnum): ingreso o egreso.
conceptstringConcepto del movimiento.
amountnumberMonto del movimiento.
untouchablebooleanMarca de movimiento intocable. Valor por defecto false.
delete_commentstringComentario de eliminación. Se envía al eliminar el movimiento.
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": 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}Relaciones
Sección titulada «Relaciones»| 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.
Búsqueda
Sección titulada «Búsqueda»La búsqueda de texto (search) compara con las columnas amount, concept y operation_code del movimiento de la caja de la empresa (cashboxMovement).
Estados
Sección titulada «Estados»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.
Endpoints
Sección titulada «Endpoints»No existe ruta para restaurar un movimiento.
