Ir al contenido

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
idinteger

Identificador del centro de costo.

codestring

Código del centro. Si no se envía al crear, se asigna el correlativo de 4 dígitos. Máximo 50 caracteres.

namestring

Nombre del centro de costo.

descriptionstring

Descripción.

cost_center_type_idinteger

Tipo de centro de costo (CostCenterType).

root_cost_center_type_idinteger

Tipo raíz asociado, si aplica.

parent_idinteger

Centro padre. Solo existen dos niveles: un centro con padre no admite sub-centros.

project_idinteger

Proyecto asociado.

coin_idinteger

Moneda en la que se lleva el presupuesto.

calendar_idinteger

Calendario asociado.

investment_idinteger

Inversión asociada.

company_area_idinteger

Área de la empresa.

human_resource_idinteger

Responsable del centro.

authorization_document_type_idinteger

Tipo del documento de autorización.

authorization_document_idinteger

Documento de autorización.

total_budgetnumber

Presupuesto total. En un centro con sub-centros vigentes es la suma del presupuesto de sus sub-centros.

spent_amountnumber

Gasto acumulado. Lo recalcula el sistema a partir de los movimientos.

available_amountnumber

Saldo disponible. Lo recalcula el sistema.

monthly_budgetnumber

Presupuesto mensual.

period_amountnumber

Monto por periodo.

periodnumber

Periodo.

durationinteger

Duración.

accumulated_expensenumber

Gasto acumulado histórico.

typestring

Clase de centro (CostCenterTypeEnum): fijo o variable.

subtypestring

Subtipo (CostCenterSubtypeEnum): recurrente obligatorio, presupuesto mensual o presupuesto total.

recurrent_typestring

Recurrencia (RecurrentTypeEnum): diario, semanal, mensual, bimestral, trimestral, semestral o anual.

asociate_modulestring

Módulo asociado (CostCenterAsociateModuleEnum): project, requirement, record_meeting o investment.

start_datedate

Fecha de inicio (Y-m-d).

end_datedate

Fecha de fin (Y-m-d). Es opcional.

payment_datedate

Fecha de pago (Y-m-d).

assigment_accounting_accountsarray

Cuentas contables asignadas.

is_mandatory_paymentboolean

Indica si es un pago obligatorio.

is_rollover_enabledboolean

Indica si el saldo se traspasa al siguiente periodo.

is_budget_adjustableboolean

Indica si el presupuesto se puede ajustar cuando ya hay movimientos.

alert_threshold_percentagenumber

Porcentaje de gasto a partir del cual se alerta.

is_over_budgetboolean

Indica si el gasto superó el presupuesto. Lo recalcula el sistema.

allow_over_budgetboolean

Permite gastar por encima del presupuesto.

is_borrow_from_next_enabledboolean

Permite tomar prestado del siguiente periodo.

is_lockedboolean

Bloqueo de imputación: el centro sigue vivo y consultable, pero no admite gasto nuevo.

locked_atdatetime

Fecha del bloqueo.

locked_reasonstring

Motivo del bloqueo. Máximo 255 caracteres.

prioritystring

Prioridad (PriorityEnum): baja, media, alta o critica.

priority_orderinteger

Orden dentro de la prioridad.

payment_categorystring

Categoría de pago (CostCenterPaymentCategoryEnum): obligatorio, operativo, proyecto o inversion.

auto_generate_paymentboolean

Indica si se generan los pagos automáticamente.

calendar_adjustment_typestring

Ajuste de calendario (CalendarAdjustmentTypeEnum): before, after o none.

alert_threshold_daysinteger

Días de anticipación de la alerta.

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 CostCenter200
{
"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
}
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.

La búsqueda de texto (search) compara con name, code y description, y también con esas columnas de los sub-centros.

  • Solo hay dos niveles: un centro con parent_id no 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.