Cambiar el modo de utilidad de un costo unitario
Define si cada ítem lleva su propia utilidad. Con items_utility_individual verdadero solo cambia esa bandera y devuelve el costo unitario con sus cuatro colecciones de ítems. Con falso, guarda utility_percentage como cost_utility_percentage, recalcula cost_utility del costo unitario y vuelve a actualizar cada ítem (material, mano de obra, equipo y subcontrato) con la utilidad cost * utility_percentage / 100, lo que dispara sus recálculos y sincronizaciones.
Parámetros de la ruta
Sección titulada «Parámetros de la ruta»idintegerobligatorioIdentificador de un costo unitario.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»items_utility_individualbooleanobligatoriotrue para utilidad individual por ítem; false para una utilidad común.
utility_percentagenumbercondicionalObligatorio si items_utility_individual es falso. Entre 0 y 100.
Permiso
Sección titulada «Permiso»Este método no valida ninguna política sobre el costo unitario. Si items_utility_individual es falso, cada ítem se actualiza con el método update de su controlador, que sí exige quotation.configuration.edit.
curl -X PUT \ "https://servererp.allendostmen.app/api/unit-cost/12/update-items-utility-individual" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "items_utility_individual": false, "utility_percentage": 10}'const response = await fetch( "https://servererp.allendostmen.app/api/unit-cost/12/update-items-utility-individual", { method: "PUT", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "items_utility_individual": false, "utility_percentage": 10 }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->put('https://servererp.allendostmen.app/api/unit-cost/12/update-items-utility-individual', [ 'items_utility_individual' => false, 'utility_percentage' => 10, ]);{ "id": 12, "name": "MURO DE LADRILLO KING KONG", "quotation_id": 7, "code": "0012", "description": "Muro de soga, asentado con mortero 1:5", "measurement_unit_id": 3, "yield": 12.0, "workday": 8, "coin_id": 1, "coin_value": "1.00000000", "limit_decimals": 4, "cost_materials": "35.20000000", "cost_workforces": "28.00000000", "cost_subcontracts": "0.00000000", "cost_equipment_tools": "1.40000000", "cost_utility_materials": "3.52000000", "cost_utility_workforces": "2.80000000", "cost_utility_subcontracts": "0.00000000", "cost_utility_equipment_tools": "0.14000000", "total_materials": "38.72000000", "total_workforces": "30.80000000", "total_subcontracts": "0.00000000", "total_equipment_tools": "1.54000000", "cost": "64.60000000", "cost_utility": "6.46000000", "cost_utility_percentage": "10.00000000", "price": "71.06000000", "period_amount": null, "total_budget": null, "items_utility_individual": false, "search_keywords": "muro de ladrillo king kong 0012", "status": "activo", "previous_status": null, "status_update_comment": null, "status_update_date": null, "status_update_user_id": null, "create_user_id": 1, "update_user_id": null, "delete_user_id": null, "restore_user_id": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z", "deleted_at": null, "unit_cost_materials": [], "unit_cost_workforces": [], "unit_cost_equipment_tools": [], "unit_cost_subcontracts": []}{ "message": "The utility percentage field is required when items utility individual is false.", "errors": { "utility_percentage": [ "The utility percentage field is required when items utility individual is false." ] }}