文档中心 > API类目 > 菜鸟无线API

cainiao.guoguo.courier.done.querytasklist (查询已完成任务列表)

包裹侠查询已完成历史订单列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_cursor String 可选 {\"currentTimeStamp\":1542161247000,\"startOrderId\":638435648} 当前分页JSON
execute_user_list ExecuteUserDto [] 可选
  • 最大列表长度:20
  • 执行人账号list
    • └ execute_user_id
    • Number
    • 可选
    • 4398050052418
    • 执行人账号id
    • └ execute_user_type
    • String
    • 可选
    • FWD
    • 执行人账号类型
    page_size Number 可选 20 每页数
    personal_session String 可选 123 个人账号id
    personal_user_id Number 可选 123 个人账号session
    op_type String 可选 collect 列表操作类型.collect:揽, delivery:派

    响应参数

    名称 类型 示例值 描述
    data BgxDoneTaskListDataVO 1234 data
    • └ next_page
    • String
    • {\"currentTimeStamp\":1542161247000,\"startOrderId\":638435648}
    • 下个分页JSON
    • datas
    • BgxDoneTaskListItemVO []
    • data
    • └ delivery_type
    • Number
    • 1
    • 交割类型(1. 展示起点信息,2.展示终点信息)
    • └ end_address
    • String
    • 乐嘉国际
    • 终点地址
    • └ end_name
    • String
    • 林**
    • 终点姓名(脱敏)
    • └ end_phone
    • String
    • 13800000000
    • 终点手机号(阿里小号)
    • └ finished_time
    • String
    • 2018-09-01 10:10:10
    • 完成时间
    • └ goods_type
    • String
    • 易碎品
    • 货物类型
    • └ mail_no
    • String
    • 1530158683137
    • 运单号
    • └ require_order_id
    • Number
    • 1001540001
    • 需求单id
    • └ start_address
    • String
    • 乐嘉国际
    • 起点地址
    • └ start_name
    • String
    • 林**
    • 起点名称(脱敏)
    • └ start_phone
    • String
    • 13800000000
    • 起点手机号(阿里小号
    • └ task_status_desc
    • String
    • 已投柜
    • 状态描述
    • └ task_id
    • Number
    • 1001730004
    • 任务id
    • └ task_type
    • String
    • COMPOSIT_STA_DISPATCH_HOME
    • 任务类型
    • └ task_type_name
    • String
    • 驿站投柜
    • 任务描述
    • └ send_type
    • Number
    • 0
    • 运送类型
    • └ task_status
    • Number
    • 40
    • 任务状态
    • └ start_prov_name
    • String
    • 浙江省
    • 起点省份
    • └ end_prov_name
    • String
    • 浙江省
    • 终点省份
    • └ create_user_id
    • Number
    • createUserId
    • └ area_name
    • String
    • areaName
    • └ is_new_task
    • Boolean
    • 1
    • isNewTask
    • └ min_weex_version
    • String
    • 支持服务商品的最低客户端weex版本号
    • └ total_num
    • Number
    • 100
    • 总数
    msg_code String "isv.invalid-parameter" errorCode
    error_message String errorMessage
    status_code String statusCode
    status_message String statusMessage
    is_success Boolean false success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoGuoguoCourierDoneQuerytasklistRequest req = new CainiaoGuoguoCourierDoneQuerytasklistRequest();
    req.setPageCursor("{\\"currentTimeStamp\\":1542161247000,\\"startOrderId\\":638435648}");
    List<CainiaoGuoguoCourierDoneQuerytasklistRequest.ExecuteUserDto> list2 = new ArrayList<CainiaoGuoguoCourierDoneQuerytasklistRequest.ExecuteUserDto>();
    CainiaoGuoguoCourierDoneQuerytasklistRequest.ExecuteUserDto obj3 = new CainiaoGuoguoCourierDoneQuerytasklistRequest.ExecuteUserDto();
    list2.add(obj3);
    obj3.setExecuteUserId(4398050052418L);
    obj3.setExecuteUserType("FWD");
    req.setExecuteUserList(list2);
    req.setPageSize(20L);
    req.setPersonalSession("123");
    req.setPersonalUserId(123L);
    req.setOpType("collect");
    CainiaoGuoguoCourierDoneQuerytasklistResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_guoguo_courier_done_querytasklist_response>
        <data>
            <next_page>{\&quot;currentTimeStamp\&quot;:1542161247000,\&quot;startOrderId\&quot;:638435648}</next_page>
            <datas>
                <bgx_done_task_list_item_v_o>
                    <delivery_type>1</delivery_type>
                    <end_address>乐嘉国际</end_address>
                    <end_name>林**</end_name>
                    <end_phone>13800000000</end_phone>
                    <finished_time>2018-09-01 10:10:10</finished_time>
                    <goods_type>易碎品</goods_type>
                    <mail_no>1530158683137</mail_no>
                    <require_order_id>1001540001</require_order_id>
                    <start_address>乐嘉国际</start_address>
                    <start_name>林**</start_name>
                    <start_phone>13800000000</start_phone>
                    <task_status_desc>已投柜</task_status_desc>
                    <task_id>1001730004</task_id>
                    <task_type>COMPOSIT_STA_DISPATCH_HOME</task_type>
                    <task_type_name>驿站投柜</task_type_name>
                    <send_type>0</send_type>
                    <task_status>40</task_status>
                    <start_prov_name>浙江省</start_prov_name>
                    <end_prov_name>浙江省</end_prov_name>
                    <create_user_id></create_user_id>
                    <area_name></area_name>
                    <is_new_task>1</is_new_task>
                    <min_weex_version></min_weex_version>
                </bgx_done_task_list_item_v_o>
            </datas>
            <total_num>100</total_num>
        </data>
        <msg_code>&quot;isv.invalid-parameter&quot;</msg_code>
        <error_message></error_message>
        <status_code></status_code>
        <status_message></status_message>
        <is_success>false</is_success>
    </cainiao_guoguo_courier_done_querytasklist_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

    返回
    顶部