Ir al contenido

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
idinteger

Identificador del movimiento.

typestring

Tipo de movimiento (CashboxMovementTypeEnum): ingreso, egreso o conciliación.

codestring

Código del movimiento.

cashbox_idinteger

Caja a la que pertenece el movimiento.

cashbox_opening_idinteger

Apertura de caja en la que se registró.

account_idinteger

Cuenta que recibe o entrega el dinero.

payment_method_idinteger

Método de pago.

user_idinteger

Usuario asociado al movimiento.

payment_datedatetime

Fecha del pago.

conceptstring

Concepto del movimiento.

opcodestring

Código de operación.

observationstring

Observación.

segmentstring

Segmento del movimiento.

cashbox_income_segment_idinteger

Segmento de ingreso.

responsiblestring

Responsable del movimiento.

beneficiary_accountstring

Cuenta del beneficiario.

subtotal_amountnumber

Monto del movimiento sin comisión.

commission_amountnumber

Monto de la comisión.

total_amountnumber

Monto total del movimiento.

include_commissionboolean

Indica si el movimiento lleva comisión.

commission_type_idinteger

Tipo de comisión.

commission_opcodestring

Código de operación de la comisión.

voucher_typestring

Tipo de comprobante.

invoice_numberstring

Número del comprobante.

voucher_filestring

Archivo del comprobante.

link_filestring

Enlace al archivo.

third_party_typestring

Tipo de tercero (CashboxMovementThirdPartyTypeEnum): proveedor, cliente u otro.

customer_idinteger

Cliente.

customer_account_idinteger

Cuenta del cliente.

provider_idinteger

Proveedor.

provider_account_idinteger

Cuenta del proveedor.

is_payment_to_providerboolean

Indica si es un pago a un proveedor.

accounting_account_idinteger

Cuenta contable.

project_idinteger

Proyecto.

cost_center_idinteger

Centro de costo.

is_transferboolean

Indica si forma parte de una transferencia.

transfer_cashbox_movement_idinteger

En el ingreso de una transferencia, el egreso de origen con el que se enlaza.

origin_bank_idinteger

Banco de origen.

destination_bank_idinteger

Banco de destino.

is_exchange_rateboolean

Indica si forma parte de un cambio de moneda.

exchange_rate_valuenumber

Tasa directa del par de monedas.

coin_exchange_ratenumber

Tipo de cambio de la moneda de la cuenta.

exchange_rate_reference_coin_idinteger

Moneda de referencia del tipo de cambio.

conciliatedboolean

Indica si el movimiento está conciliado.

conciated_atdatetime

Fecha de conciliación.

conciliation_amountnumber

Monto conciliado.

account_conciliation_idinteger

Conciliación a la que pertenece.

statusstring

Estado del registro (ModelStatusEnum, por ejemplo activo o anulado).

previous_statusstring

Estado anterior.

status_update_commentstring

Motivo del último cambio de estado, por ejemplo el de una anulación.

create_user_idinteger

Usuario que creó el registro.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

El objeto CashboxMovement200
{
"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"
}
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, scopeWhenCashboxIncomeSegmentId
  • scopeWhenIsTransfers, scopeWhenTransferType, scopeExcludeInternalTransfers
  • scopeFilterForConciliation, 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.

Quién puede editarlo y anularlo está en Permisos y políticas. El CashboxMovementObserver reacciona a los cambios de este modelo.