Ir al contenido

Actualizar un material de costo unitario

PUT/api/unit-cost-material/{id}

Actualiza nombre, descripción, cantidad y utilidad de un material dentro de una transacción y recalcula precio, totales y porcentaje de utilidad. Si cambia cost_utility, el cambio se propaga a los materiales del mismo producto en las cotizaciones de la oportunidad que estén en cotizando, y se recalculan los totales; si ese producto ya está en una cotización en revisando, aprobado, negociando o cerrado, responde 422 en unit_cost_material_id (No se puede actualizar la utilidad o el precio porque este material existe en una cotización cerrada de la misma oportunidad.). Si solo cambia quantity, recalcula los totales del costo unitario, de su ítem de cotización y de la cotización. Responde 200 con el material, que incluye count_existing_materials (cuántos materiales de otros costos se sincronizaron).

idintegerobligatorio

Identificador de un material de costo unitario.

namestringobligatorio

Nombre. Máximo 255 caracteres.

descriptionstring

Descripción. Máximo 500 caracteres.

quantitynumberobligatorio

Cantidad. Numérica, con máximo 1000000.

cost_utilitynumberobligatorio

Utilidad por unidad, en monto. Mínimo 0.

syncstring

Se valida (new u old), pero update no lo usa.

quotation.configuration.edit, que se valida en UnitCostMaterialPolicy::update.

Ventana de terminal
curl -X PUT \
"https://servererp.allendostmen.app/api/unit-cost-material/31" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "CEMENTO PORTLAND TIPO I 42.5 KG",
"description": null,
"quantity": 12,
"cost_utility": 2.55
}'
Material actualizado200
{
"id": 31,
"unit_cost_id": 12,
"provider_product_id": 88,
"product_id": 40,
"measurement_unit_id": 5,
"name": "CEMENTO PORTLAND TIPO I 42.5 KG",
"description": null,
"index": 1,
"original_price": "25.50000000",
"original_coin_id": 1,
"original_coin_value": "1.00000000",
"cost": 25.5,
"cost_utility": 2.55,
"cost_utility_percentage": 10.0,
"price": 28.05,
"quantity": 12.0,
"total_cost": 306.0,
"total_cost_utility": 30.6,
"total": 336.6,
"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": 1,
"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,
"count_existing_materials": 0
}
Material no encontrado404
{
"message": "No query results for model [App\\Models\\UnitCostMaterial] 99"
}
Datos no válidos422
{
"message": "La cantidad es obligatoria",
"errors": {
"quantity": [
"La cantidad es obligatoria"
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}