文档中心 > API类目 > 代发管理

taobao.daifa.order.distribute (代发管理-分销商分单接口)

本接口支持分销商将淘宝订单分配给供货商。 DistributeOrderRequest.biz_order_id 为淘宝主订单 scpOrderModels为一个List结构,支持传入一个主订单下的子订单进行分单,其中有如下几个协议需要遵守: 1、biz_order_id 为子订单 2、parent_id 为主订单ID,等同于DistributeOrderRequest.biz_order_id 3、quality为待分配商品数量,如果不传的话就默认等于子订单上的购买数量。 4、同一子订单下多次分配的quality必须相等。 5、多次分单的quality总和不允许超过子订单上的购买数量。 6、复杂情况下同一笔子订单在一次分单过程中可以分配给多个供货商,此时quality只会计算一次。 比如如下JSON结构:[{"biz_order_id":"123456","parent_id":"111111","supplier_id":16,"product_id":"123456","product_sku_id":"123456","distributor_id":14,"product_sku_spec":"鞋子,红色","remark":"remarkabc","product_count":1,"product_name":"鞋子","product_pic_url":"xxx.png","product_type":"0","quality":1},{"biz_order_id":"123456","parent_id":"111111","supplier_id":35,"product_id":"123456","product_sku_id":"123456","distributor_id":14,"product_sku_spec":"鞋子,红色","remark":"remarkabc","product_count":1,"product_name":"鞋子","product_pic_url":"xxx.png","product_type":"0","quality":1}]

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_order_id Number 必须 123 主单ID
scp_order_models DaifaScpOrderModel 必须 分单模型
  • └ product_sku_id
  • String
  • 可选
  • 123456
  • 货品SKU ID
  • └ supplier_id
  • Number
  • 必须
  • 123456
  • 供货商ID
  • └ product_id
  • String
  • 必须
  • 123456
  • 货品ID
  • └ distributor_id
  • Number
  • 必须
  • 123456
  • 分销商ID
  • └ product_sku_spec
  • String
  • 可选
  • 鞋子,红色
  • 货品规格
  • └ remark
  • String
  • 可选
  • 123456
  • 订单备注,此字段不为空的话则会取淘宝订单上的卖家备注,即sellerMemo字段替代
  • └ product_count
  • Number
  • 必须
  • 1
  • 代发数量
  • └ parent_id
  • String
  • 必须
  • 123456
  • 淘宝主订单ID,主子一体订单 bizOrderId = parentId
  • └ product_name
  • String
  • 可选
  • 鞋子
  • 货品名称
  • └ biz_order_id
  • String
  • 必须
  • 123456
  • 订单ID
  • └ product_pic_url
  • String
  • 可选
  • xxx.png
  • 货品图片url
  • └ product_type
  • Number
  • 必须
  • 0
  • 货品类型,用于校验防止重发之类;当传值为0时会校验所有代发订单产品数量和不超过订单的 buyAmount 0 - 主货品 1 - 赠品
  • └ quality
  • Number
  • 可选
  • 1
  • 本次分单的商品数量,此参数默认值0,当此参数为0时会设置为对应淘宝子订单的buyAmount,举例:消费者购买了一箱可乐,供货商按12瓶发货,则这种情况下淘宝订单的购买数量为1,quality传递1,productType为0-主品,productCount=12,表示发12瓶可乐;如果是赠品情况下quality默认设置为1

响应参数

名称 类型 示例值 描述
call_result String true 调用结果
call_err_code String SYSTEM_ERROR 错误code
call_err_msg String 系统异常 错误信息
model DistributeOrderResult 业务对象
  • └ biz_order_id
  • Number
  • 123456
  • 主订单id
  • daifa_scp_order_models
  • DaifaScpOrderModel []
  • 业务对象
  • └ scp_order_id
  • Number
  • 123456
  • 代发单据ID
  • └ parent_id
  • String
  • 123456
  • 淘宝主订单ID,主子一体订单 bizOrderId = parentId
  • └ biz_order_id
  • String
  • 123456
  • 订单ID
  • └ product_id
  • String
  • 123456
  • 货品id
  • └ product_sku_id
  • String
  • 123456
  • 货品skuid

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
DaifaOrderDistributeRequest req = new DaifaOrderDistributeRequest();
req.setBizOrderId(123L);
DaifaOrderDistributeRequest.DaifaScpOrderModel obj1 = new DaifaOrderDistributeRequest.DaifaScpOrderModel();
obj1.setProductSkuId("123456");
obj1.setSupplierId(123456L);
obj1.setProductId("123456");
obj1.setDistributorId(123456L);
obj1.setProductSkuSpec("鞋子,红色");
obj1.setRemark("123456");
obj1.setProductCount(1L);
obj1.setParentId("123456");
obj1.setProductName("鞋子");
obj1.setBizOrderId("123456");
obj1.setProductPicUrl("xxx.png");
obj1.setProductType(0L);
obj1.setQuality(1L);
req.setScpOrderModels(obj1);
DaifaOrderDistributeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<daifa_order_distribute_response>
    <call_result>true</call_result>
    <call_err_code>SYSTEM_ERROR</call_err_code>
    <call_err_msg>系统异常</call_err_msg>
    <model>
        <biz_order_id>123456</biz_order_id>
        <daifa_scp_order_models>
            <daifa_scp_order_model>
                <scp_order_id>123456</scp_order_id>
                <parent_id>123456</parent_id>
                <biz_order_id>123456</biz_order_id>
                <product_id>123456</product_id>
                <product_sku_id>123456</product_sku_id>
            </daifa_scp_order_model>
        </daifa_scp_order_models>
    </model>
</daifa_order_distribute_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

返回
顶部