文档中心 > API类目 > 淘宝交易API

taobao.fulfillment.order.assemble (拆合单结果回传接口)

拆合单结果回传接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
assemble_orders AssembleOrder 必须 批量回传集合,一次接口最多40
  • └ group_id
  • String
  • 必须
  • 123456
  • 组合id,服务商内部的合单操作id,取消合单会根据group_id进行删除操作。
  • order_list
  • OrderGroup []
  • 可选
  • 合单订单列表,一个列表最多200
  • └ taobao_sub_order_id
  • String
  • 可选
  • 123456
  • 淘宝交易子订单id
  • └ order_type
  • Number
  • 可选
  • 0
  • order_id的类型,0:淘宝交易订单,1: 换货单,2:分销单,3:补货单,4:代发单
  • └ item_type
  • Number
  • 可选
  • 0
  • 商品类型, 0:下单货品,1:赠品,2:其他
  • └ order_id
  • String
  • 可选
  • 123456
  • 淘宝单号可以是交易订单、换货单、补货单、代发单或分销单等,当 order_type=0时,order_id = taobao_parent_order_id。
  • └ erp_order_id
  • String
  • 可选
  • 123456
  • erp系统内的订单id
  • └ taobao_parent_order_id
  • String
  • 可选
  • 123456
  • 淘宝交易主订单id
type String 必须 MERGE 操作类型,支持参数为MERGE、CANCEL_MERGE。当进行CANCEL_MERGE操作时,只需要传入groupId即可,order_list可以为空

响应参数

名称 类型 示例值 描述
result Boolean true 调用结果
call_error_code String INVALID_PARAM 错误码
call_error_msg String 参数非法 错误信息描述
model OrderAssembleResponse 回传结果
  • order_group_responses
  • OrderGroupResponse []
  • 回传结果List
  • └ group_id
  • String
  • 123456
  • 入参中的groupId
  • └ result
  • Boolean
  • true
  • 回传结果
  • └ error_code
  • String
  • INVALID_PARAM
  • 错误码
  • └ error_msg
  • String
  • 参数非法
  • 错误信息描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FulfillmentOrderAssembleRequest req = new FulfillmentOrderAssembleRequest();
FulfillmentOrderAssembleRequest.AssembleOrder obj1 = new FulfillmentOrderAssembleRequest.AssembleOrder();
obj1.setGroupId("123456");
List<FulfillmentOrderAssembleRequest.OrderGroup> list3 = new ArrayList<FulfillmentOrderAssembleRequest.OrderGroup>();
FulfillmentOrderAssembleRequest.OrderGroup obj4 = new FulfillmentOrderAssembleRequest.OrderGroup();
list3.add(obj4);
obj4.setTaobaoSubOrderId("123456");
obj4.setOrderType(0L);
obj4.setItemType(0L);
obj4.setOrderId("123456");
obj4.setErpOrderId("123456");
obj4.setTaobaoParentOrderId("123456");
obj1.setOrderList(list3);
req.setAssembleOrders(obj1);
req.setType("MERGE");
FulfillmentOrderAssembleResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fulfillment_order_assemble_response>
    <result>true</result>
    <call_error_code>INVALID_PARAM</call_error_code>
    <call_error_msg>参数非法</call_error_msg>
    <model>
        <order_group_responses>
            <order_group_response>
                <group_id>123456</group_id>
                <result>true</result>
                <error_code>INVALID_PARAM</error_code>
                <error_msg>参数非法</error_msg>
            </order_group_response>
        </order_group_responses>
    </model>
</fulfillment_order_assemble_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

返回
顶部