Ir al contenido

CostCenterMovement

Un movimiento de centro de costo es el gasto imputado a un centro. Lo genera Caja al registrar un egreso con centro de costo y la API solo permite consultarlo.

Modelo App\Models\CostCenterMovement
Tabla cost_center_movements
idinteger

Identificador del movimiento.

cost_center_idinteger

Centro de costo al que se imputa el gasto.

cashbox_movement_idinteger

Movimiento de caja que originó el gasto.

amountnumber

Gasto en la moneda del centro de costo.

available_amountnumber

Disponible del centro después de este gasto.

movement_datedate

Fecha del movimiento (Y-m-d).

conceptstring

Concepto.

document_typestring

Tipo del documento de respaldo.

document_numberstring

Número del documento de respaldo.

cashbox_movement_coin_idinteger

Moneda del movimiento de caja.

cashbox_movement_coin_valuenumber

Tipo de cambio de la moneda del movimiento de caja.

cost_center_coin_valuenumber

Tipo de cambio de la moneda del centro de costo.

total_amount_cashbox_movementnumber

Total del movimiento de caja.

period_initinteger

Periodo inicial.

period_quantityinteger

Cantidad de periodos.

period_endinteger

Periodo final.

period_amount_estimatednumber

Monto estimado por periodo.

period_amount_realnumber

Monto real por periodo.

period_amount_differencenumber

Diferencia entre el monto estimado y el real por periodo.

total_amount_estimatednumber

Monto estimado total.

total_amount_realnumber

Monto real total. Los registros históricos guardaban aquí el gasto.

total_amount_differencenumber

Diferencia entre el monto estimado y el real total.

total_amount_difference_percentagenumber

Porcentaje de la diferencia total.

statusstring

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

previous_statusstring

Estado anterior. Lo llena el sistema al eliminar o restaurar.

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.

restored_atdatetime

Fecha de la última restauración.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

deleted_atdatetime

Fecha de eliminación lógica.

El objeto CostCenterMovement200
{
"id": 31,
"cost_center_id": 7,
"cashbox_movement_id": 1520,
"amount": 900,
"available_amount": 8500,
"total_amount_real": 900,
"total_amount_cashbox_movement": 900,
"cashbox_movement_coin_id": 1,
"movement_date": "2026-10-02",
"concept": "Pago de servicio",
"document_type": "factura",
"document_number": "F001-123",
"status": "activo",
"previous_status": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"restored_at": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Relación Tipo Modelo
costCenter belongsTo CostCenter
cashboxMovement belongsTo CashboxMovement
surrenderBoxMovement belongsTo SurrenderBoxMovement
cashboxMovementCoin belongsTo Coin

El modelo no define allowedRelations, así que relations acepta cualquiera de las anteriores.

Scope Parámetro de consulta Efecto
costCenterId cost_center_id Movimientos de ese centro. Sin valor no filtra.
whenCostCenterTreeId cost_center_tree_id Movimientos del centro y de todos sus descendientes.

Campos permitidos para ordenar: id, name, created_at, updated_at y status. El orden por defecto es id|DESC. La tabla no tiene la columna name.

El controlador solo expone listar y obtener. Cada gasto nace, se edita y se anula desde Caja (egreso con centro de costo), que valida el disponible y recalcula el resumen del centro.