文档中心 > API类目 > 隐私保护API

taobao.top.oaid.merge (OAID订单合并)

基于OAID(收件人ID, Open Addressee ID)做订单合并,确保相同收件人信息的订单合并到相同组。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
merge_list OrderMerge [] 必须
  • 最大列表长度:999
  • 合单请求列表,最多支持100个。
    • └ oaid
    • String
    • 必须
    • xxxxxx
    • 收件人ID (Open Addressee ID),长度在128个字符之内。
    • └ tid
    • String
    • 必须
    • 12345678
    • 订单ID

    响应参数

    名称 类型 示例值 描述
    tid_list String [] ["1111,2222","3333"] 合单结果。注意:一个字符串中的多笔订单可以合单,不同字符串间的订单不可合单!!!
    比如,["1111,2222"]表示订单1111和订单2222可合单,["1111","2222"]表示订单1111和订单2222不可以合单。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TopOaidMergeRequest req = new TopOaidMergeRequest();
    List<TopOaidMergeRequest.OrderMerge> list2 = new ArrayList<TopOaidMergeRequest.OrderMerge>();
    TopOaidMergeRequest.OrderMerge obj3 = new TopOaidMergeRequest.OrderMerge();
    list2.add(obj3);
    obj3.setOaid("xxxxxx");
    obj3.setTid("12345678");
    req.setMergeList(list2);
    TopOaidMergeResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <top_oaid_merge_response>
        <tid_list>
            <string>[&quot;1111</string>
            <string>2222&quot;</string>
            <string>&quot;3333&quot;]</string>
        </tid_list>
    </top_oaid_merge_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

    返回
    顶部