Ir al contenido

Crear un centro de costo

POST/api/cost-center

Crea un centro de costo. Hay dos modos según el cuerpo:

  • Centro raíz (sin parent_id): se guarda con estado activo, se le asigna el código correlativo si no se envía uno, se asocian las cajas de cashbox_ids y se calcula su resumen de gasto.
  • Sub-centro (con parent_id): solo se validan los campos de la sección «Cuerpo en modo sub-centro». El resto se hereda del padre y el presupuesto del padre pasa a ser la suma del de sus sub-centros.
cost_center_type_idintegerobligatorio

Tipo de centro de costo. Debe existir en cost_center_types.

namestringobligatorio

Nombre. Máximo 255 caracteres.

start_datedateobligatorio

Fecha de inicio.

coin_idintegerobligatorio

Moneda. Debe existir.

total_budgetnumberobligatorio

Presupuesto total. Mínimo 0.

codestring

Código. Máximo 50 caracteres y único entre los centros no eliminados. Si falta, se asigna el correlativo de 4 dígitos.

end_datedate

Fecha de fin. No puede ser anterior a start_date.

descriptionstring

Descripción. Máximo 500 caracteres.

cashbox_idsarray

Identificadores de las cajas que se asocian al centro.

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.

parent_idinteger

Si se envía, la solicitud crea un sub-centro; ver el modo sub-centro más abajo.

parent_idintegerobligatorio

Centro padre. Debe existir y no ser a su vez un sub-centro.

namestringobligatorio

Nombre del sub-centro. Máximo 255 caracteres.

total_budgetnumberobligatorio

Presupuesto del sub-centro. Mínimo 0.

descriptionstring

Descripción. Máximo 500 caracteres.

period_amountnumber

Monto por periodo. Mínimo 0.

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

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/cost-center" \
-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": 12000,
"cashbox_ids": [
1,
2
]
}'
Centro de costo creado201
{
"id": 7,
"cost_center_type_id": 3,
"code": "0007",
"name": "Servicios generales",
"description": "Gastos de operación de la sede",
"total_budget": 12000,
"spent_amount": 3500,
"available_amount": 8500,
"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": 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
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El tipo de centro de costo es requerido.",
"errors": {
"cost_center_type_id": [
"El tipo de centro de costo es requerido."
]
}
}
Datos no válidos422
{
"message": "El centro seleccionado ya no permite crear sub-niveles.",
"errors": {
"parent_id": [
"El centro seleccionado ya no permite crear sub-niveles."
]
}
}