Ir al contenido

Cambiar el modo de utilidad de un costo unitario

PUT/api/unit-cost/{id}/update-items-utility-individual

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.

idintegerobligatorio

Identificador de un costo unitario.

items_utility_individualbooleanobligatorio

true para utilidad individual por ítem; false para una utilidad común.

utility_percentagenumbercondicional

Obligatorio si items_utility_individual es falso. Entre 0 y 100.

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.

Ventana de terminal
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
}'
Costo unitario con sus ítems200
{
"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": []
}
Datos no válidos422
{
"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."
]
}
}