Crear un subcontrato de costo unitario
Agrega un subcontrato a un costo unitario. El servidor recalcula el costo del proveedor de subcontrato en la moneda del costo unitario y lo compara con cost: si difiere, responde 422 en cost (El precio del subcontrato ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.). Si el mismo subcontrato 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. Después calcula precio, totales y porcentaje de utilidad, y actualiza los totales del costo unitario, de su ítem de cotización y de la cotización. Al terminar actualiza updated_at del costo unitario. Responde 201 con el subcontrato.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»unit_cost_idintegerobligatorioCosto unitario al que se agrega. 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.
subcontract_provider_idintegerobligatorioProveedor de subcontrato. Debe existir.
descriptionstringDescripción. Máximo 500 caracteres.
quantitynumberobligatorioCantidad.
costnumberobligatorioCosto que el cliente vio. Debe coincidir con el recalculado por el servidor.
cost_utilitynumberobligatorioUtilidad por unidad, en monto. Entre 0 y 1000.
syncstringQué precio usar cuando el subcontrato 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 UnitCostSubcontractPolicy::create.
curl -X POST \ "https://servererp.allendostmen.app/api/unit-cost-subcontract" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "unit_cost_id": 12, "subcontract_provider_id": 15, "quantity": 2, "cost": 500, "cost_utility": 50}'const response = await fetch( "https://servererp.allendostmen.app/api/unit-cost-subcontract", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "unit_cost_id": 12, "subcontract_provider_id": 15, "quantity": 2, "cost": 500, "cost_utility": 50 }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/unit-cost-subcontract', [ 'unit_cost_id' => 12, 'subcontract_provider_id' => 15, 'quantity' => 2, 'cost' => 500, 'cost_utility' => 50, ]);{ "id": 8, "unit_cost_id": 12, "subcontract_provider_id": 15, "measurement_unit_id": 8, "subcontract_id": 6, "name": "SERVICIO DE ENCOFRADO", "description": null, "original_price": "500.00000000", "original_coin_id": 1, "original_coin_value": "1.00000000", "index": 1, "cost": 500.0, "cost_utility": 50.0, "cost_utility_percentage": 10.0, "price": 550.0, "quantity": 2.0, "total_cost": 1000.0, "total_cost_utility": 100.0, "total": 1100.0, "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": 480.0, "new_cost": 500.0, "coin_symbol": "S/", "can_use_new_price": true, "blocked_reason": null, "affected_unit_costs": 1, "affected_quotations": 1}{ "message": "El precio del subcontrato ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar.", "errors": { "cost": [ "El precio del subcontrato ha cambiado desde la última consulta. Por favor, actualice y verifique nuevamente antes de continuar." ] }}{ "message": "This action is unauthorized."}