注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 采购宝API

taobao.pc.bargain.create (提交议价)

提交议价

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param BargainCreateParam 可选 议价创建请求参数
  • └ out_bargain_id
  • String
  • 必须
  • BARGAIN_20260401_001
  • 外部议价ID,用于议价主单幂等
  • └ idempotent_id
  • String
  • 必须
  • ROUND_IDEM_20260401_001
  • 轮次幂等键,用于第一条轮次记录的幂等
  • └ title
  • String
  • 可选
  • 采购议价申请
  • 议价标题
  • items
  • BargainItemParam []
  • 必须
  • 议价商品列表
  • └ ego_item_id
  • Number
  • 必须
  • 123456789
  • 企业购商品ID
  • └ ego_sku_id
  • Number
  • 必须
  • 987654321
  • 企业购SKU ID
  • └ origin_price
  • Number
  • 可选
  • 10000
  • 初始单价,单位:分
  • └ origin_quantity
  • Number
  • 可选
  • 10
  • 初始数量
  • └ expected_price
  • Number
  • 必须
  • 9000
  • 客户最新期望单价,单位:分
  • └ expected_quantity
  • Number
  • 必须
  • 10
  • 客户最新期望数量
  • └ client_id
  • String
  • 必须
  • 10000001
  • 客户ID
  • └ service_id
  • Number
  • 可选
  • 20000001
  • 服务商ID
  • └ service_nick
  • String
  • 可选
  • 测试服务商1
  • 服务商名称

响应参数

名称 类型 示例值 描述
result Result result
  • └ success
  • Boolean
  • true
  • 操作是否成功
  • └ error_code
  • String
  • 200
  • 结果码
  • └ error_msg
  • String
  • 参数错误
  • 结果描述
  • bargain_create_result_d_t_o
  • BargainCreateResultDto
  • 结果
  • └ bargain_id
  • Number
  • 100001
  • 系统生成议价ID
  • └ out_bargain_id
  • String
  • BARGAIN_20260401_001
  • 外部议价ID,原样回传
  • └ bargain_round_id
  • Number
  • 200001
  • 第一轮次ID
  • └ idempotent
  • Boolean
  • false
  • 是否命中幂等

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PcBargainCreateRequest req = new PcBargainCreateRequest();
PcBargainCreateRequest.BargainCreateParam obj1 = new PcBargainCreateRequest.BargainCreateParam();
obj1.setOutBargainId("BARGAIN_20260401_001");
obj1.setIdempotentId("ROUND_IDEM_20260401_001");
obj1.setTitle("采购议价申请");
List<PcBargainCreateRequest.BargainItemParam> list3 = new ArrayList<PcBargainCreateRequest.BargainItemParam>();
PcBargainCreateRequest.BargainItemParam obj4 = new PcBargainCreateRequest.BargainItemParam();
list3.add(obj4);
obj4.setEgoItemId(123456789L);
obj4.setEgoSkuId(987654321L);
obj4.setOriginPrice(10000L);
obj4.setOriginQuantity(10L);
obj4.setExpectedPrice(9000L);
obj4.setExpectedQuantity(10L);
obj1.setItems(list3);
obj1.setClientId("10000001");
obj1.setServiceId(20000001L);
obj1.setServiceNick("测试服务商1");
req.setParam(obj1);
PcBargainCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<pc_bargain_create_response>
    <result>
        <success>true</success>
        <error_code>200</error_code>
        <error_msg>参数错误</error_msg>
        <bargain_create_result_d_t_o>
            <bargain_id>100001</bargain_id>
            <out_bargain_id>BARGAIN_20260401_001</out_bargain_id>
            <bargain_round_id>200001</bargain_round_id>
            <idempotent>false</idempotent>
        </bargain_create_result_d_t_o>
    </result>
</pc_bargain_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部