Resumen
Un movimiento de caja es cada ingreso o egreso de dinero de una cuenta. Las transferencias y los cambios de moneda se representan con dos movimientos enlazados: un egreso en el origen y un ingreso en el destino.
| Modelo | App\Models\CashboxMovement |
| Tabla | cashbox_movements |
El objeto CashboxMovement
Sección titulada «El objeto CashboxMovement»Atributos
Sección titulada «Atributos»idintegerIdentificador del movimiento.
typestringTipo de movimiento (CashboxMovementTypeEnum): ingreso, egreso o conciliación.
codestringCódigo del movimiento.
cashbox_idintegerCaja a la que pertenece el movimiento.
cashbox_opening_idintegerApertura de caja en la que se registró.
account_idintegerCuenta que recibe o entrega el dinero.
payment_method_idintegerMétodo de pago.
user_idintegerUsuario asociado al movimiento.
payment_datedatetimeFecha del pago.
conceptstringConcepto del movimiento.
opcodestringCódigo de operación.
observationstringObservación.
segmentstringSegmento del movimiento.
cashbox_income_segment_idintegerSegmento de ingreso.
responsiblestringResponsable del movimiento.
beneficiary_accountstringCuenta del beneficiario.
subtotal_amountnumberMonto del movimiento sin comisión.
commission_amountnumberMonto de la comisión.
total_amountnumberMonto total del movimiento.
include_commissionbooleanIndica si el movimiento lleva comisión.
commission_type_idintegerTipo de comisión.
commission_opcodestringCódigo de operación de la comisión.
voucher_typestringTipo de comprobante.
invoice_numberstringNúmero del comprobante.
voucher_filestringArchivo del comprobante.
link_filestringEnlace al archivo.
third_party_typestringTipo de tercero (CashboxMovementThirdPartyTypeEnum): proveedor, cliente u otro.
customer_idintegerCliente.
customer_account_idintegerCuenta del cliente.
provider_idintegerProveedor.
provider_account_idintegerCuenta del proveedor.
is_payment_to_providerbooleanIndica si es un pago a un proveedor.
accounting_account_idintegerCuenta contable.
project_idintegerProyecto.
cost_center_idintegerCentro de costo.
is_transferbooleanIndica si forma parte de una transferencia.
transfer_cashbox_movement_idintegerEn el ingreso de una transferencia, el egreso de origen con el que se enlaza.
origin_bank_idintegerBanco de origen.
destination_bank_idintegerBanco de destino.
is_exchange_ratebooleanIndica si forma parte de un cambio de moneda.
exchange_rate_valuenumberTasa directa del par de monedas.
coin_exchange_ratenumberTipo de cambio de la moneda de la cuenta.
exchange_rate_reference_coin_idintegerMoneda de referencia del tipo de cambio.
conciliatedbooleanIndica si el movimiento está conciliado.
conciated_atdatetimeFecha de conciliación.
conciliation_amountnumberMonto conciliado.
account_conciliation_idintegerConciliación a la que pertenece.
statusstringEstado del registro (ModelStatusEnum, por ejemplo activo o anulado).
previous_statusstringEstado anterior.
status_update_commentstringMotivo del último cambio de estado, por ejemplo el de una anulación.
create_user_idintegerUsuario que creó el registro.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
{ "id": 1520, "type": "egreso", "cashbox_id": 1, "cashbox_opening_id": 8, "account_id": 1, "payment_method_id": 2, "payment_date": "2026-11-19T10:30:00.000000Z", "concept": "Pago de servicio", "opcode": "884512", "subtotal_amount": 150.5, "commission_amount": null, "total_amount": 150.5, "include_commission": false, "third_party_type": "proveedor", "provider_id": 12, "is_transfer": false, "is_exchange_rate": false, "conciliated": false, "status": "activo", "previous_status": null, "create_user_id": 1, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z"}Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
cashbox |
belongsTo | Cashbox |
cashboxOpening |
belongsTo | CashboxOpening |
account |
belongsTo | Account |
user |
belongsTo | User |
paymentMethod |
belongsTo | PaymentMethod |
bank |
belongsTo | Bank |
originBank / destinationBank |
belongsTo | Bank |
project |
belongsTo | Project |
accountingAccount |
belongsTo | AccountingAccount |
accountingAccountMovements |
hasMany | AccountingAccountMovement |
costCenter |
belongsTo | CostCenter |
costCenterMovement / costCenterMovements |
hasOne / hasMany | CostCenterMovement |
provider |
belongsTo | Provider |
providerAccount |
belongsTo | ProviderAccount |
customer |
belongsTo | Customer |
customerAccount |
belongsTo | CustomerAccount |
cashboxIncomeSegment |
belongsTo | CashboxIncomeSegment |
commissionType |
belongsTo | CommissionType |
commission |
belongsTo | Commission |
exchangeRateReferenceCoin |
belongsTo | Coin |
originCashboxMovement |
belongsTo | CashboxMovement |
destinationCashboxMovement |
hasOne | CashboxMovement |
investmentWithdrawals |
hasMany | InvestmentWithdrawal |
paymentOrderMovements |
hasMany | PaymentOrderMovement |
Se encadenan en el callback de index():
scopeWhenType,scopeWhenAccountId,scopeWhenCashboxId,scopeWhenProjectId,scopeWhenCashboxIncomeSegmentIdscopeWhenIsTransfers,scopeWhenTransferType,scopeExcludeInternalTransfersscopeFilterForConciliation,scopeExcludeConciliationItems
| Enum | Valores |
|---|---|
CashboxMovementTypeEnum |
ingreso, egreso, conciliación |
CashboxMovementThirdPartyTypeEnum |
proveedor, cliente, otro |
Campos permitidos: id, concept, code, payment_date, total_amount, created_at, updated_at, status. La búsqueda de texto usa concept, opcode y responsible.
Reglas de edición
Sección titulada «Reglas de edición»Quién puede editarlo y anularlo está en Permisos y políticas. El CashboxMovementObserver reacciona a los cambios de este modelo.
