cainiao.guoguo.courier.taskorder.got (综合站扫码揽收接口)

综合站扫码揽收接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mail_cp_code String 可选 YUNDA cp code
execute_user_list ExecuteUserDto [] 可选
  • 最大列表长度:20
  • 账号ID+type数据
    • └ execute_user_id
    • Number
    • 可选
    • 43980
    • ID
    • └ execute_user_type
    • String
    • 可选
    • CP,FWD,PERSON
    • 类型
    mail_no String 可选 111000333 运单号
    personal_session String 可选 aaabbb 个人账号session
    personal_user_id Number 可选 43980 个人账号ID

    响应参数

    名称 类型 示例值 描述
    data GotTaskOrderDto 1234 data
    • └ got_status
    • String
    • ok
    • ok 揽收成功, fail 揽收失败, list 一号多单,
    • got_task_error
    • GotTaskErrorDto
    • 揽收错误
    • └ code
    • String
    • 400
    • 错误码
    • └ description
    • String
    • 运单已被 氢一 揽收
    • 描述
    • └ title
    • String
    • 该运单不属于你
    • 错误原因
    • task_cp_list
    • GotTaskCpdto []
    • taskCpList
    • └ cp_code
    • String
    • TTKDEX
    • cpCode
    • └ cp_name
    • String
    • 天天快递
    • 公司名字
    • └ mail_no
    • String
    • 110
    • 运单号
    • task_info
    • GotTaskInfoDto
    • taskInfo
    • └ area_name
    • String
    • A区柜子
    • 区域名字
    • └ fulfil_desc
    • String
    • 9号楼
    • 履行描述
    • └ fulfil_type
    • String
    • 上门
    • 履行方式
    • └ is_tb_order
    • Boolean
    • true
    • 是否淘系订单
    • └ mail_no
    • String
    • 0002
    • 运单号
    • └ receiver_address
    • String
    • 收件人地址
    • 收件人地址
    • └ receiver_name
    • String
    • 氢一
    • 收件人名字
    • └ receiver_phone
    • String
    • 156
    • 收件人号码
    • └ station_order_type
    • String
    • station_general
    • 驿站2.0:staion_2_0,综合站: station_general
    • └ require_order_id
    • Number
    • 110
    • 需求单号
    • └ task_id
    • Number
    • 220
    • 任务单号
    • └ fulfil_type_id
    • String
    • 11
    • 履行方式编号
    status_code String 200 statusCode
    status_message String OK statusMessage
    is_success Boolean false success
    trace_id String 2222 traceId

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoGuoguoCourierTaskorderGotRequest req = new CainiaoGuoguoCourierTaskorderGotRequest();
    req.setMailCpCode("YUNDA");
    List<CainiaoGuoguoCourierTaskorderGotRequest.ExecuteUserDto> list2 = new ArrayList<CainiaoGuoguoCourierTaskorderGotRequest.ExecuteUserDto>();
    CainiaoGuoguoCourierTaskorderGotRequest.ExecuteUserDto obj3 = new CainiaoGuoguoCourierTaskorderGotRequest.ExecuteUserDto();
    list2.add(obj3);
    obj3.setExecuteUserId(43980L);
    obj3.setExecuteUserType("CP,FWD,PERSON");
    req.setExecuteUserList(list2);
    req.setMailNo("111000333");
    req.setPersonalSession("aaabbb");
    req.setPersonalUserId(43980L);
    CainiaoGuoguoCourierTaskorderGotResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_guoguo_courier_taskorder_got_response>
        <data>
            <got_status>ok</got_status>
            <got_task_error>
                <code>400</code>
                <description>运单已被 氢一 揽收</description>
                <title>该运单不属于你</title>
            </got_task_error>
            <task_cp_list>
                <got_task_cpdto>
                    <cp_code>TTKDEX</cp_code>
                    <cp_name>天天快递</cp_name>
                    <mail_no>110</mail_no>
                </got_task_cpdto>
            </task_cp_list>
            <task_info>
                <area_name>A区柜子</area_name>
                <fulfil_desc>9号楼</fulfil_desc>
                <fulfil_type>上门</fulfil_type>
                <is_tb_order>true</is_tb_order>
                <mail_no>0002</mail_no>
                <receiver_address>收件人地址</receiver_address>
                <receiver_name>氢一</receiver_name>
                <receiver_phone>156</receiver_phone>
                <station_order_type>station_general</station_order_type>
                <require_order_id>110</require_order_id>
                <task_id>220</task_id>
                <fulfil_type_id>11</fulfil_type_id>
            </task_info>
        </data>
        <status_code>200</status_code>
        <status_message>OK</status_message>
        <is_success>false</is_success>
        <trace_id>2222</trace_id>
    </cainiao_guoguo_courier_taskorder_got_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

    返回
    顶部