Crear un centro de costo
Crea un centro de costo. Hay dos modos según el cuerpo:
- Centro raíz (sin
parent_id): se guarda con estadoactivo, se le asigna el código correlativo si no se envía uno, se asocian las cajas decashbox_idsy 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.
Parámetros del cuerpo (centro raíz)
Sección titulada «Parámetros del cuerpo (centro raíz)»cost_center_type_idintegerobligatorioTipo de centro de costo. Debe existir en cost_center_types.
namestringobligatorioNombre. Máximo 255 caracteres.
start_datedateobligatorioFecha de inicio.
coin_idintegerobligatorioMoneda. Debe existir.
total_budgetnumberobligatorioPresupuesto total. Mínimo 0.
codestringCódigo. Máximo 50 caracteres y único entre los centros no eliminados. Si falta, se asigna el correlativo de 4 dígitos.
end_datedateFecha de fin. No puede ser anterior a start_date.
descriptionstringDescripción. Máximo 500 caracteres.
cashbox_idsarrayIdentificadores de las cajas que se asocian al centro.
project_idintegerProyecto asociado. Debe existir.
root_cost_center_type_idintegerTipo raíz. Debe existir en cost_center_types.
authorization_document_type_idintegerTipo del documento de autorización.
authorization_document_idintegerDocumento de autorización. Debe corresponder al tipo enviado.
asociate_modulestringMódulo asociado: project, requirement, record_meeting o investment.
assigment_accounting_accountsarrayCuentas contables asignadas.
is_mandatory_paymentbooleanPago obligatorio.
is_rollover_enabledbooleanTraspaso de saldo al siguiente periodo.
is_budget_adjustablebooleanPresupuesto ajustable cuando ya hay movimientos.
alert_threshold_percentagenumberPorcentaje de alerta.
is_over_budgetbooleanIndicador de sobregiro.
allow_over_budgetbooleanPermite gastar por encima del presupuesto.
is_borrow_from_next_enabledbooleanPermite tomar prestado del siguiente periodo.
is_lockedbooleanBloqueo de imputación.
locked_reasonstringMotivo del bloqueo. Máximo 255 caracteres.
prioritystringbaja, media, alta o critica.
auto_generate_paymentbooleanGeneración automática de pagos.
calendar_adjustment_typestringbefore, after o none.
alert_threshold_daysintegerDías de anticipación de la alerta.
parent_idintegerSi se envía, la solicitud crea un sub-centro; ver el modo sub-centro más abajo.
Cuerpo en modo sub-centro
Sección titulada «Cuerpo en modo sub-centro»parent_idintegerobligatorioCentro padre. Debe existir y no ser a su vez un sub-centro.
namestringobligatorioNombre del sub-centro. Máximo 255 caracteres.
total_budgetnumberobligatorioPresupuesto del sub-centro. Mínimo 0.
descriptionstringDescripción. Máximo 500 caracteres.
period_amountnumberMonto por periodo. Mínimo 0.
Permiso
Sección titulada «Permiso»cashbox.configuration.create, que se valida en CostCenterPolicy::create. Ver Permisos y políticas.
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 ]}'const response = await fetch( "https://servererp.allendostmen.app/api/cost-center", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "cost_center_type_id": 3, "name": "Servicios generales", "start_date": "2026-01-01", "coin_id": 1, "total_budget": 12000, "cashbox_ids": [ 1, 2 ] }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/cost-center', [ 'cost_center_type_id' => 3, 'name' => 'Servicios generales', 'start_date' => '2026-01-01', 'coin_id' => 1, 'total_budget' => 12000, 'cashbox_ids' => [ 1, 2, ], ]);{ "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}{ "message": "This action is unauthorized."}{ "message": "El tipo de centro de costo es requerido.", "errors": { "cost_center_type_id": [ "El tipo de centro de costo es requerido." ] }}{ "message": "El centro seleccionado ya no permite crear sub-niveles.", "errors": { "parent_id": [ "El centro seleccionado ya no permite crear sub-niveles." ] }}