CostCenter
Un centro de costo es la unidad contra la que se controla el presupuesto y el gasto. Se organiza en un árbol de dos niveles (centro y sub-centros) y se clasifica con un tipo de centro de costo.
| Modelo | App\Models\CostCenter |
| Tabla | cost_centers |
El objeto CostCenter
Sección titulada «El objeto CostCenter»Atributos
Sección titulada «Atributos»idintegerIdentificador del centro de costo.
codestringCódigo del centro. Si no se envía al crear, se asigna el correlativo de 4 dígitos. Máximo 50 caracteres.
namestringNombre del centro de costo.
descriptionstringDescripción.
cost_center_type_idintegerTipo de centro de costo (CostCenterType).
root_cost_center_type_idintegerTipo raíz asociado, si aplica.
parent_idintegerCentro padre. Solo existen dos niveles: un centro con padre no admite sub-centros.
project_idintegerProyecto asociado.
coin_idintegerMoneda en la que se lleva el presupuesto.
calendar_idintegerCalendario asociado.
investment_idintegerInversión asociada.
company_area_idintegerÁrea de la empresa.
human_resource_idintegerResponsable del centro.
authorization_document_type_idintegerTipo del documento de autorización.
authorization_document_idintegerDocumento de autorización.
total_budgetnumberPresupuesto total. En un centro con sub-centros vigentes es la suma del presupuesto de sus sub-centros.
spent_amountnumberGasto acumulado. Lo recalcula el sistema a partir de los movimientos.
available_amountnumberSaldo disponible. Lo recalcula el sistema.
monthly_budgetnumberPresupuesto mensual.
period_amountnumberMonto por periodo.
periodnumberPeriodo.
durationintegerDuración.
accumulated_expensenumberGasto acumulado histórico.
typestringClase de centro (CostCenterTypeEnum): fijo o variable.
subtypestringSubtipo (CostCenterSubtypeEnum): recurrente obligatorio, presupuesto mensual o presupuesto total.
recurrent_typestringRecurrencia (RecurrentTypeEnum): diario, semanal, mensual, bimestral, trimestral, semestral o anual.
asociate_modulestringMódulo asociado (CostCenterAsociateModuleEnum): project, requirement, record_meeting o investment.
start_datedateFecha de inicio (Y-m-d).
end_datedateFecha de fin (Y-m-d). Es opcional.
payment_datedateFecha de pago (Y-m-d).
assigment_accounting_accountsarrayCuentas contables asignadas.
is_mandatory_paymentbooleanIndica si es un pago obligatorio.
is_rollover_enabledbooleanIndica si el saldo se traspasa al siguiente periodo.
is_budget_adjustablebooleanIndica si el presupuesto se puede ajustar cuando ya hay movimientos.
alert_threshold_percentagenumberPorcentaje de gasto a partir del cual se alerta.
is_over_budgetbooleanIndica si el gasto superó el presupuesto. Lo recalcula el sistema.
allow_over_budgetbooleanPermite gastar por encima del presupuesto.
is_borrow_from_next_enabledbooleanPermite tomar prestado del siguiente periodo.
is_lockedbooleanBloqueo de imputación: el centro sigue vivo y consultable, pero no admite gasto nuevo.
locked_atdatetimeFecha del bloqueo.
locked_reasonstringMotivo del bloqueo. Máximo 255 caracteres.
prioritystringPrioridad (PriorityEnum): baja, media, alta o critica.
priority_orderintegerOrden dentro de la prioridad.
payment_categorystringCategoría de pago (CostCenterPaymentCategoryEnum): obligatorio, operativo, proyecto o inversion.
auto_generate_paymentbooleanIndica si se generan los pagos automáticamente.
calendar_adjustment_typestringAjuste de calendario (CalendarAdjustmentTypeEnum): before, after o none.
alert_threshold_daysintegerDías de anticipación de la alerta.
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": 7, "project_id": null, "cost_center_type_id": 3, "name": "Servicios generales", "description": "Gastos de operación de la sede", "total_budget": 12000, "period_amount": 0, "type": "fijo", "code": "0007", "start_date": "2026-01-01", "end_date": null, "parent_id": null, "coin_id": 1, "spent_amount": 3500, "available_amount": 8500, "is_over_budget": false, "allow_over_budget": false, "is_locked": false, "alert_threshold_percentage": 80, "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 |
|---|---|---|
parent |
belongsTo | CostCenter |
children |
hasMany | CostCenter |
childrenRecursive |
hasMany | CostCenter |
activeChildren |
hasMany | CostCenter |
costCenterType |
belongsTo | CostCenterType |
project |
belongsTo | Project |
calendar |
belongsTo | Calendar |
coin |
belongsTo | Coin |
investment |
belongsTo | Investment |
companyArea |
belongsTo | CompanyArea |
humanResource |
belongsTo | HumanResource |
costCenterMovements |
hasMany | CostCenterMovement |
latestCostCenterMovement |
hasOne | CostCenterMovement |
activeCashboxMovements |
hasMany | CostCenterMovement |
costCenterCashboxes |
hasMany | CostCenterCashbox |
authorizationDocument |
belongsTo | AuthorizationDocument |
authorizationDocumentType |
belongsTo | AuthorizationDocumentType |
El modelo no define allowedRelations, así que el parámetro relations acepta cualquiera de las anteriores. activeChildren deja fuera los sub-centros en estado anulado, anulada o eliminado.
| Scope | Parámetro de consulta | Efecto |
|---|---|---|
whenCostCenterTypeId |
cost_center_type_id |
Centros del tipo indicado o de cualquiera de sus tipos descendientes, por el tipo propio o por el de un sub-centro. |
whenCostCenterTypeIds |
cost_center_type_ids |
Igual que el anterior, con varios identificadores separados por coma. |
whenSingleFathers |
single_fathers |
Con true, solo centros sin padre. |
whenParentId |
parent_id |
Sub-centros del padre indicado. |
whenProjectNull |
project_null |
Con true, solo centros sin proyecto. |
filterByProjectOrWithout |
project_id, without_project |
Centros del proyecto, sin proyecto o ambos. |
whenCashboxIdOrWithout |
cashbox_id |
Centros sin cajas asociadas o asociados a esa caja. |
whenYear |
year |
Centros creados en ese año. |
roots |
Centros sin padre. Lo usan los endpoints de árbol. |
| Atributo | Enum | Valores |
|---|---|---|
type |
CostCenterTypeEnum |
fijo, variable |
subtype |
CostCenterSubtypeEnum |
recurrente obligatorio, presupuesto mensual, presupuesto total |
recurrent_type |
RecurrentTypeEnum |
diario, semanal, mensual, bimestral, trimestral, semestral, anual |
asociate_module |
CostCenterAsociateModuleEnum |
project, requirement, record_meeting, investment |
priority |
PriorityEnum |
baja, media, alta, critica |
payment_category |
CostCenterPaymentCategoryEnum |
obligatorio, operativo, proyecto, inversion |
calendar_adjustment_type |
CalendarAdjustmentTypeEnum |
before, after, none |
status |
ModelStatusEnum |
Un centro nuevo queda en activo; al eliminarlo pasa a eliminado. |
Campos permitidos para ordenar: id, name, created_at, updated_at y status. El orden por defecto es id|DESC.
Búsqueda
Sección titulada «Búsqueda»La búsqueda de texto (search) compara con name, code y description, y también con esas columnas de los sub-centros.
Reglas de negocio
Sección titulada «Reglas de negocio»- Solo hay dos niveles: un centro con
parent_idno admite sub-centros. - El presupuesto de un centro con sub-centros vigentes es siempre la suma del presupuesto de sus sub-centros.
- No se puede eliminar un centro que tiene movimientos asociados.
- Los movimientos de gasto nacen en Caja; ver CostCenterMovement.
