Crear un material de costo unitario
Agrega un material a un costo unitario dentro de una transacción. El servidor recalcula el costo del producto del proveedor en la moneda del costo unitario y lo compara con cost: si difiere, responde 422 en cost (El precio del producto ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.). Si el mismo producto ya está en otro costo unitario de las cotizaciones de la oportunidad (en cotizando, revisando, aprobado, negociando o cerrado) con un costo distinto y no se envía sync, responde 409 con el detalle del conflicto. Si no hay conflicto, se calculan precio, totales y porcentaje de utilidad; si el precio resulta menor que el costo, responde 422 (El precio del producto no puede ser menor al costo.). Después actualiza los totales del costo unitario, de su ítem de cotización y de la cotización. Responde 201 con el material.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»unit_cost_idintegerobligatorioCosto unitario al que se agrega el material. Debe existir. La validación solo lo exige cuando falta quotation_item_id, pero store lo necesita siempre para ubicar el costo unitario.
quotation_item_idintegerSolo tiene efecto en la ruta de crear directo. Si se envía, debe existir en ítems de cotización; en esta ruta no se usa.
provider_product_idintegerobligatorioProducto del proveedor. Debe existir y no estar ya agregado (sin eliminar) al mismo costo unitario. Si ya está: El producto ya existe para este costo unitario.
descriptionstringDescripción. Máximo 500 caracteres.
quantitynumberobligatorioCantidad. Numérica, con máximo 1000000.
costnumberobligatorioCosto que el cliente vio al elegir el producto. El servidor lo recalcula y debe coincidir; si no, responde 422.
cost_utilitynumberobligatorioUtilidad por unidad, en monto. Mínimo 0. Si el costo unitario no usa utilidad individual, se recalcula con su porcentaje.
syncstringQué precio usar cuando el producto ya está en otra cotización de la oportunidad con un costo distinto: new adopta el precio nuevo y lo propaga a las demás cotizaciones en cotizando; old adopta el costo ya cotizado. Si falta y los costos difieren, la API responde 409.
Permiso
Sección titulada «Permiso»quotation.configuration.create, que se valida en UnitCostMaterialPolicy::create.
curl -X POST \ "https://servererp.allendostmen.app/api/unit-cost-material" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "unit_cost_id": 12, "provider_product_id": 88, "quantity": 10, "cost": 25.5, "cost_utility": 2.55}'const response = await fetch( "https://servererp.allendostmen.app/api/unit-cost-material", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "unit_cost_id": 12, "provider_product_id": 88, "quantity": 10, "cost": 25.5, "cost_utility": 2.55 }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/unit-cost-material', [ 'unit_cost_id' => 12, 'provider_product_id' => 88, 'quantity' => 10, 'cost' => 25.5, 'cost_utility' => 2.55, ]);{ "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": 10.0, "total_cost": 255.0, "total_cost_utility": 25.5, "total": 280.5, "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}{ "requires_sync": true, "message": "Este recurso ya está en la oportunidad a un precio distinto. Elegí qué precio usar.", "existing_cost": 24.8, "new_cost": 25.5, "coin_symbol": "S/", "can_use_new_price": true, "blocked_reason": null, "affected_unit_costs": 2, "affected_quotations": 1}{ "message": "El precio del producto ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.", "errors": { "cost": [ "El precio del producto ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar." ] }}{ "message": "This action is unauthorized."}