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 |
El objeto CostCenterMovement
Sección titulada «El objeto CostCenterMovement»Atributos
Sección titulada «Atributos»idintegerIdentificador del movimiento.
cost_center_idintegerCentro de costo al que se imputa el gasto.
cashbox_movement_idintegerMovimiento de caja que originó el gasto.
amountnumberGasto en la moneda del centro de costo.
available_amountnumberDisponible del centro después de este gasto.
movement_datedateFecha del movimiento (Y-m-d).
conceptstringConcepto.
document_typestringTipo del documento de respaldo.
document_numberstringNúmero del documento de respaldo.
cashbox_movement_coin_idintegerMoneda del movimiento de caja.
cashbox_movement_coin_valuenumberTipo de cambio de la moneda del movimiento de caja.
cost_center_coin_valuenumberTipo de cambio de la moneda del centro de costo.
total_amount_cashbox_movementnumberTotal del movimiento de caja.
period_initintegerPeriodo inicial.
period_quantityintegerCantidad de periodos.
period_endintegerPeriodo final.
period_amount_estimatednumberMonto estimado por periodo.
period_amount_realnumberMonto real por periodo.
period_amount_differencenumberDiferencia entre el monto estimado y el real por periodo.
total_amount_estimatednumberMonto estimado total.
total_amount_realnumberMonto real total. Los registros históricos guardaban aquí el gasto.
total_amount_differencenumberDiferencia entre el monto estimado y el real total.
total_amount_difference_percentagenumberPorcentaje de la diferencia total.
statusstringEstado del registro (ModelStatusEnum). Se asigna al crear.
previous_statusstringEstado anterior. Lo llena el sistema al eliminar o restaurar.
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.
restored_atdatetimeFecha de la última restauración.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "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}Relaciones
Sección titulada «Relaciones»| 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.
Solo lectura
Sección titulada «Solo lectura»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.
