Ir al contenido

Actualizar un centro de costo

PUT/api/cost-center/{id}

Actualiza un centro de costo y devuelve el modelo actualizado. Recalcula el presupuesto del padre (si es un sub-centro) o el derivado de sus sub-centros (si es padre) y el resumen de gasto.

idintegerobligatorio

Identificador del centro de costo.

cost_center_type_idintegerobligatorio

Tipo de centro de costo. Debe existir.

namestringobligatorio

Nombre. Máximo 255 caracteres.

start_datedateobligatorio

Fecha de inicio.

coin_idintegerobligatorio

Moneda. Debe existir.

total_budgetnumberobligatorio

Presupuesto total. Mínimo 0. Ver las reglas de presupuesto más abajo.

codestring

Código. Si se envía vacío, se conserva el actual. Si cambia, no puede estar en uso por otro centro.

end_datedate

Fecha de fin. No puede ser anterior a start_date.

descriptionstring

Descripción. Máximo 500 caracteres.

cashbox_idsarray

Cajas asociadas. Si se envía, reemplaza las actuales (un arreglo vacío las desasocia todas); si se omite, quedan intactas.

project_idinteger

Proyecto asociado. Debe existir.

root_cost_center_type_idinteger

Tipo raíz. Debe existir en cost_center_types.

authorization_document_type_idinteger

Tipo del documento de autorización.

authorization_document_idinteger

Documento de autorización. Debe corresponder al tipo enviado.

asociate_modulestring

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

assigment_accounting_accountsarray

Cuentas contables asignadas.

is_mandatory_paymentboolean

Pago obligatorio.

is_rollover_enabledboolean

Traspaso de saldo al siguiente periodo.

is_budget_adjustableboolean

Presupuesto ajustable cuando ya hay movimientos.

alert_threshold_percentagenumber

Porcentaje de alerta.

is_over_budgetboolean

Indicador de sobregiro.

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.

locked_reasonstring

Motivo del bloqueo. Máximo 255 caracteres.

prioritystring

baja, media, alta o critica.

auto_generate_paymentboolean

Generación automática de pagos.

calendar_adjustment_typestring

before, after o none.

alert_threshold_daysinteger

Días de anticipación de la alerta.

  • En un centro con sub-centros vigentes, total_budget solo acepta el valor actual o la suma del presupuesto de sus sub-centros; otro monto devuelve 422.
  • En un centro con movimientos y sin sub-centros, el presupuesto solo cambia si is_budget_adjustable está activo y el nuevo monto no baja del gasto ya ejecutado (salvo que allow_over_budget esté activo).

cashbox.configuration.edit, que se valida en CostCenterPolicy::update. Ver Permisos y políticas.

Ventana de terminal
curl -X PUT \
"https://servererp.allendostmen.app/api/cost-center/7" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"cost_center_type_id": 3,
"name": "Servicios generales",
"start_date": "2026-01-01",
"coin_id": 1,
"total_budget": 15000
}'
Centro de costo actualizado200
{
"id": 7,
"cost_center_type_id": 3,
"code": "0007",
"name": "Servicios generales",
"description": "Gastos de operación de la sede",
"total_budget": 15000,
"spent_amount": 3500,
"available_amount": 11500,
"is_over_budget": false,
"is_locked": false,
"start_date": "2026-01-01",
"end_date": null,
"coin_id": 1,
"parent_id": null,
"project_id": null,
"status": "activo",
"previous_status": null,
"create_user_id": 1,
"update_user_id": 1,
"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
}
Sin permiso403
{
"message": "This action is unauthorized."
}
No existe404
{
"message": "No query results for model [App\\Models\\CostCenter] 99999"
}
Datos no válidos422
{
"message": "No se puede modificar el presupuesto total porque el centro de costo tiene movimientos asociados y su presupuesto no es ajustable.",
"errors": {
"total_budget": [
"No se puede modificar el presupuesto total porque el centro de costo tiene movimientos asociados y su presupuesto no es ajustable."
]
}
}