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

cainiao.guoguo.courier.queryorderdetailinfobymailno (驿站派件通过运单号查询订单详情)

驿站派件通过运单号查询订单详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mail_no String 可选 1235614231 运单号
user_id Number 可选 12345 小件员id
session_code String 可选 be98a74d6fa945549c2ac2a3dd64cf07 sessioncode

响应参数

名称 类型 示例值 描述
status_code String PARAMS_CANNOT_BE_NULL 失败原因
data ProcessingOrderInfoDto data
  • └ order_id
  • Number
  • 12345678
  • 订单id
  • sender
  • CustomInfoDto
  • demo
  • 寄件人信息
  • └ name
  • String
  • 张三
  • 用户名称
  • └ avatar_url
  • String
  • http://
  • avatarUrl
  • └ phone
  • String
  • 189
  • 电话
  • └ address
  • String
  • 1
  • 地址
  • └ prov_name
  • String
  • 浙江
  • └ city_name
  • String
  • 杭州
  • └ area_name
  • String
  • 余杭
  • └ area_id
  • String
  • 1234
  • 区id
  • └ zip_code
  • String
  • 305000
  • 行政编码
  • └ latitude
  • String
  • 123.1
  • 经度
  • └ longitude
  • String
  • 12.1
  • 纬度
  • └ poi_name
  • String
  • 余杭街道
  • poi名称
  • └ poi_address
  • String
  • 余杭街道
  • poi地址
  • └ alicom_tiny_phone_no
  • String
  • 1231
  • 阿里小号
  • └ tiny_phone_no_valid
  • Boolean
  • false
  • 阿里小号是否有效
  • └ box_address
  • String
  • 乐嘉国际
  • 柜子地址
  • └ full_address
  • String
  • 乐嘉国际1号楼
  • 详细地址
  • └ is_show_icon
  • Boolean
  • true
  • 是否展示拨打电话图标
  • └ province_id
  • Number
  • 1312
  • 省份id
  • └ city_id
  • Number
  • 1
  • 市id
  • receiver
  • CustomInfoDto
  • 收件人信息
  • 收件人信息
  • └ name
  • String
  • 李**
  • 名称(脱敏)
  • └ avatar_url
  • String
  • http://
  • avatarUrl
  • └ phone
  • String
  • 189****0000
  • 电话(脱敏)
  • └ address
  • String
  • 余杭
  • 地址
  • └ prov_name
  • String
  • 浙江
  • └ city_name
  • String
  • 杭州
  • └ area_name
  • String
  • 杭州
  • 区域名称
  • └ area_id
  • String
  • 12
  • 区域Id
  • └ zip_code
  • String
  • 100010
  • 行政编码
  • └ latitude
  • String
  • 13.1
  • 经度
  • └ longitude
  • String
  • 123.1
  • 纬度
  • └ poi_name
  • String
  • demo
  • poi名称
  • └ poi_address
  • String
  • demo
  • poi地址
  • └ alicom_tiny_phone_no
  • String
  • 123
  • 阿里小号
  • └ tiny_phone_no_valid
  • Boolean
  • true
  • 阿里小号是否有效
  • └ box_address
  • String
  • 杭州
  • 柜子地址
  • └ full_address
  • String
  • 杭州
  • 详细地址
  • └ is_show_icon
  • Boolean
  • true
  • 是否显示图标
  • └ province_id
  • Number
  • 省份Id
  • 省份Id
  • └ city_id
  • Number
  • 市Id
  • 市Id
  • └ take_package_spend_time
  • Number
  • 41234
  • 小件员取件耗时
  • └ apply_order_time
  • String
  • 2017-11-11
  • 抢单时间
  • └ take_package_time
  • String
  • 2017-11-11
  • 揽件时间
  • └ mail_no
  • String
  • 1234567
  • 运单号
  • └ pay_money
  • String
  • 10
  • 支付金额
  • └ pay_status
  • Number
  • 1
  • 支付状态
  • └ is_open_order_bill
  • Boolean
  • true
  • 是否开启账单
  • └ show_print_mail_no
  • Boolean
  • true
  • 是否可以显示电子面单
  • └ show_update_mail_cp
  • Boolean
  • true
  • 是否可以修改快递公司
  • └ carryout_start_time
  • Number
  • 12314435
  • 取件开始时间
  • └ carryout_end_time
  • Number
  • 23421241
  • 取件结束时间
  • └ appointment_start_time
  • Number
  • 321331
  • 预约开始时间
  • └ appointment_end_time
  • Number
  • 432421
  • 预约结束时间
  • └ sign_time
  • Date
  • 5127862891347
  • 订单签收时间
  • └ sign_flag
  • Number
  • 2
  • 订单签收结果标记
  • └ refuse_sign_reason
  • String
  • 联系不到消费者
  • 拒绝签收原因
  • └ order_status
  • String
  • 1
  • 订单状态
  • └ status_code
  • String
  • INVALID
  • 状态编码
  • └ status_desc
  • String
  • 0
  • 状态描述
  • └ package_type
  • String
  • 1
  • 包裹类型
  • └ order_total_price
  • String
  • 2
  • 账单应付价格(元)
  • └ adjust_fee
  • String
  • 3
  • 调价(元)
  • └ insurance_fee
  • String
  • 10
  • 申明价(元)
  • └ goods_weight
  • String
  • 4
  • 货物重量(千克
  • └ user_message_labels
  • String
  • 备注
  • └ order_insured_value
  • String
  • 30
  • 保价费(元)
  • └ cp_icon_url
  • String
  • http://
  • cp公司logo图片链接
  • └ package_cp_code
  • String
  • DWD
  • 运输cp编码
  • └ package_cp_name_new
  • String
  • 点我达
  • 运输cp名称
  • └ selected_mail_cp_code
  • String
  • DWD
  • 默认干线 cp编码
  • └ selected_mail_cp_code_name
  • String
  • 点我达
  • 默认干线 cp名称
  • └ power_template_id
  • Number
  • 1123
  • 电子配置表id
  • └ selected_mail_cp_code_icon
  • String
  • 111
  • 默认干线 cp图标
  • └ can_update_address
  • Boolean
  • true
  • 是否可以修改地址
  • └ show_crash_pay
  • Boolean
  • false
  • 是否显示现金支付按钮
  • └ start_weight
  • String
  • 12
  • 首重重量(千克)
  • └ start_price
  • String
  • 2.5
  • 首重价格(元)
  • └ goods_continued_heavy
  • String
  • 2
  • 货物续重重量(kg)
  • └ goods_continued_price
  • String
  • 10.00
  • 货物续重价格(元)
  • └ continued_heavy
  • String
  • 50
  • 续重重量(千克)(计算公式)
  • └ continued_price
  • String
  • 3.5
  • 货物续重价格(元)
  • └ print_status
  • Number
  • 1
  • 打印状态 0-未打印。1-已打印
  • └ timeout_warning_interval
  • Number
  • 6459832497
  • 即将超时警告时间,毫秒数,如30分钟订单对应15分钟超时时间 15 * 60 * 1000
  • └ time_type_desc
  • String
  • 待抢单
  • 时间类型描述(待抢单列表的“抢”按钮上展示),如 30分钟订单是"30分钟"
  • └ time_type_tag_desc
  • String
  • WAIT_ACCEPT_ORDER
  • 时间描述
  • └ taking_immediately_desc
  • String
  • 预约
  • 是否立刻上门取件,非立刻上门显示”预约“
  • └ time_type
  • Number
  • 0
  • 时间类型 0 代表承诺半小时, 1代表承诺两小时
  • └ predict_got_date
  • Number
  • 1
  • 预计取件时长
  • └ source_tag
  • String
  • 12
  • 订单来源
  • └ real_price
  • String
  • 11
  • 订单真实价格
  • └ added_price
  • String
  • 11
  • 用户加价
  • └ total_income
  • String
  • 15
  • 总收益(元)
  • └ ungot_order_reason
  • String
  • 有事情去不了了
  • 未取件原因
  • └ feedback_reason_status
  • Number
  • 1
  • 订单超时反馈状态
  • └ cancel_reason
  • String
  • 联系不到消费者
  • 取消原因
  • └ cancel_order_time
  • String
  • 2017-11-11 09:00:00
  • 取消时间
  • └ show_reward
  • Boolean
  • true
  • 是否显示补贴信息
  • └ have_reward
  • Boolean
  • true
  • 是否有补贴
  • └ amount
  • String
  • 12
  • 补贴金额
  • └ deduct_amount
  • String
  • 15
  • 扣回补贴金额(元)
  • └ deduct_coupon_amount
  • String
  • 10
  • 扣回优惠券补贴金额(元)
  • └ description
  • String
  • 补贴xxx
  • 补贴文案描述
  • └ reward
  • String
  • 5
  • 菜鸟补贴
  • └ coupon_actrual_price
  • String
  • 10
  • 优惠券实际抵扣金额
  • └ put_in_box_deadline
  • Number
  • 1
  • 拒单时放入柜子超时时间
  • └ reject_package_time
  • Date
  • 2017-01-01
  • 订单拒收时间
  • └ reject_reason
  • String
  • 包裹破损
  • 拒绝原因
  • └ reject_img_url
  • String
  • http://
  • 拒收实物图片链接
  • └ box_open_code
  • String
  • 1
  • 自提柜开柜码
  • └ send_type_code
  • Number
  • 12345
  • 寄件类型编码
  • └ send_type_desc
  • String
  • 1
  • 寄件类型描述
  • └ sop_point_gained
  • String
  • 1
  • 贡献值
  • └ payment_q_r_code
  • String
  • http://xxx.cc?id=1
  • 扫码支付二维码
  • └ sender_address
  • String
  • 123
  • 寄件人地址
  • └ receiver_address
  • String
  • 213
  • 接收人地址
  • └ buyer_id
  • String
  • 123456
  • 用户id
  • └ sender_id
  • String
  • 11234
  • 寄件人id
  • └ validate_status_code
  • String
  • INVALID
  • 验证状态
  • └ validate_status_desc
  • String
  • 0
  • 验证状态描述
  • └ mail_no_type
  • String
  • 1
  • 电子面单类型 1: 电子面单 2: 纸质面单
  • └ source_address
  • String
  • 乐嘉国际
  • 寄件人地址
  • └ check_page_code
  • String
  • 331351
  • 对货码
  • └ pay_with_hode_desc
  • String
  • 1
  • 代扣显示文案
  • └ is_need_image
  • Boolean
  • false
  • 是否必须开箱验视
  • └ is_support_image
  • Boolean
  • false
  • 是否支持开箱验视
  • └ has_watched
  • Boolean
  • false
  • 是否已经完成验视
  • └ weight_exception
  • Boolean
  • false
  • 重量异常文案
  • └ image_max_num
  • Number
  • 12
  • 图片上限
  • └ product_code
  • String
  • STA_DISPATCH
  • 能力产品编码
  • └ real_name_auth_status
  • String
  • 0
  • 0 实名认证状态,-1(无需认证),0(待认证),1(已确认实名信息),2(已报备)
  • image_url_list
  • Imageurl []
  • demo
  • 图片链接集合
  • └ url
  • String
  • http://
  • 图片链接
  • └ exception_reason
  • String
  • 无法联系消费者
  • 异常上报原因
  • └ exception_time
  • Date
  • 124234
  • 异常上报时间
  • order_tags
  • Ordertags []
  • demo
  • 订单标记集
  • └ argb_color
  • Number
  • 11
  • 标签颜色
  • └ name
  • String
  • 往日单
  • 标签名称
  • └ type
  • Number
  • 1
  • 标签类型
  • └ sub_name
  • String
  • 自选
  • 标签子名称
  • └ transfer_courier_name
  • String
  • 1234567
  • 转单小件员名称
status_message String 参数不能为空 失败原因
is_success Boolean true 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoGuoguoCourierQueryorderdetailinfobymailnoRequest req = new CainiaoGuoguoCourierQueryorderdetailinfobymailnoRequest();
req.setMailNo("1235614231");
req.setUserId(12345L);
req.setSessionCode("be98a74d6fa945549c2ac2a3dd64cf07");
CainiaoGuoguoCourierQueryorderdetailinfobymailnoResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_guoguo_courier_queryorderdetailinfobymailno_response>
    <status_code>PARAMS_CANNOT_BE_NULL</status_code>
    <data>
        <order_id>12345678</order_id>
        <sender>
            <name>张三</name>
            <avatar_url>http://</avatar_url>
            <phone>189</phone>
            <address>1</address>
            <prov_name>浙江</prov_name>
            <city_name>杭州</city_name>
            <area_name>余杭</area_name>
            <area_id>1234</area_id>
            <zip_code>305000</zip_code>
            <latitude>123.1</latitude>
            <longitude>12.1</longitude>
            <poi_name>余杭街道</poi_name>
            <poi_address>余杭街道</poi_address>
            <alicom_tiny_phone_no>1231</alicom_tiny_phone_no>
            <tiny_phone_no_valid>false</tiny_phone_no_valid>
            <box_address>乐嘉国际</box_address>
            <full_address>乐嘉国际1号楼</full_address>
            <is_show_icon>true</is_show_icon>
            <province_id>1312</province_id>
            <city_id>1</city_id>
        </sender>
        <receiver>
            <name>李**</name>
            <avatar_url>http://</avatar_url>
            <phone>189****0000</phone>
            <address>余杭</address>
            <prov_name>浙江</prov_name>
            <city_name>杭州</city_name>
            <area_name>杭州</area_name>
            <area_id>12</area_id>
            <zip_code>100010</zip_code>
            <latitude>13.1</latitude>
            <longitude>123.1</longitude>
            <poi_name>demo</poi_name>
            <poi_address>demo</poi_address>
            <alicom_tiny_phone_no>123</alicom_tiny_phone_no>
            <tiny_phone_no_valid>true</tiny_phone_no_valid>
            <box_address>杭州</box_address>
            <full_address>杭州</full_address>
            <is_show_icon>true</is_show_icon>
            <province_id>省份Id</province_id>
            <city_id>市Id</city_id>
        </receiver>
        <take_package_spend_time>41234</take_package_spend_time>
        <apply_order_time>2017-11-11</apply_order_time>
        <take_package_time>2017-11-11</take_package_time>
        <mail_no>1234567</mail_no>
        <pay_money>10</pay_money>
        <pay_status>1</pay_status>
        <is_open_order_bill>true</is_open_order_bill>
        <show_print_mail_no>true</show_print_mail_no>
        <show_update_mail_cp>true</show_update_mail_cp>
        <carryout_start_time>12314435</carryout_start_time>
        <carryout_end_time>23421241</carryout_end_time>
        <appointment_start_time>321331</appointment_start_time>
        <appointment_end_time>432421</appointment_end_time>
        <sign_time>5127862891347</sign_time>
        <sign_flag>2</sign_flag>
        <refuse_sign_reason>联系不到消费者</refuse_sign_reason>
        <order_status>1</order_status>
        <status_code>INVALID</status_code>
        <status_desc>0</status_desc>
        <package_type>1</package_type>
        <order_total_price>2</order_total_price>
        <adjust_fee>3</adjust_fee>
        <insurance_fee>10</insurance_fee>
        <goods_weight>4</goods_weight>
        <user_message_labels>无</user_message_labels>
        <order_insured_value>30</order_insured_value>
        <cp_icon_url>http://</cp_icon_url>
        <package_cp_code>DWD</package_cp_code>
        <package_cp_name_new>点我达</package_cp_name_new>
        <selected_mail_cp_code>DWD</selected_mail_cp_code>
        <selected_mail_cp_code_name>点我达</selected_mail_cp_code_name>
        <power_template_id>1123</power_template_id>
        <selected_mail_cp_code_icon>111</selected_mail_cp_code_icon>
        <can_update_address>true</can_update_address>
        <show_crash_pay>false</show_crash_pay>
        <start_weight>12</start_weight>
        <start_price>2.5</start_price>
        <goods_continued_heavy>2</goods_continued_heavy>
        <goods_continued_price>10.00</goods_continued_price>
        <continued_heavy>50</continued_heavy>
        <continued_price>3.5</continued_price>
        <print_status>1</print_status>
        <timeout_warning_interval>6459832497</timeout_warning_interval>
        <time_type_desc>待抢单</time_type_desc>
        <time_type_tag_desc>WAIT_ACCEPT_ORDER</time_type_tag_desc>
        <taking_immediately_desc>预约</taking_immediately_desc>
        <time_type>0</time_type>
        <predict_got_date>1</predict_got_date>
        <source_tag>12</source_tag>
        <real_price>11</real_price>
        <added_price>11</added_price>
        <total_income>15</total_income>
        <ungot_order_reason>有事情去不了了</ungot_order_reason>
        <feedback_reason_status>1</feedback_reason_status>
        <cancel_reason>联系不到消费者</cancel_reason>
        <cancel_order_time>2017-11-11 09:00:00</cancel_order_time>
        <show_reward>true</show_reward>
        <have_reward>true</have_reward>
        <amount>12</amount>
        <deduct_amount>15</deduct_amount>
        <deduct_coupon_amount>10</deduct_coupon_amount>
        <description>补贴xxx</description>
        <reward>5</reward>
        <coupon_actrual_price>10</coupon_actrual_price>
        <put_in_box_deadline>1</put_in_box_deadline>
        <reject_package_time>2017-01-01</reject_package_time>
        <reject_reason>包裹破损</reject_reason>
        <reject_img_url>http://</reject_img_url>
        <box_open_code>1</box_open_code>
        <send_type_code>12345</send_type_code>
        <send_type_desc>1</send_type_desc>
        <sop_point_gained>1</sop_point_gained>
        <payment_q_r_code>http://xxx.cc?id=1</payment_q_r_code>
        <sender_address>123</sender_address>
        <receiver_address>213</receiver_address>
        <buyer_id>123456</buyer_id>
        <sender_id>11234</sender_id>
        <validate_status_code>INVALID</validate_status_code>
        <validate_status_desc>0</validate_status_desc>
        <mail_no_type>1</mail_no_type>
        <source_address>乐嘉国际</source_address>
        <check_page_code>331351</check_page_code>
        <pay_with_hode_desc>1</pay_with_hode_desc>
        <is_need_image>false</is_need_image>
        <is_support_image>false</is_support_image>
        <has_watched>false</has_watched>
        <weight_exception>false</weight_exception>
        <image_max_num>12</image_max_num>
        <product_code>STA_DISPATCH</product_code>
        <real_name_auth_status>0</real_name_auth_status>
        <image_url_list>
            <imageurl>
                <url>http://</url>
            </imageurl>
        </image_url_list>
        <exception_reason>无法联系消费者</exception_reason>
        <exception_time>124234</exception_time>
        <order_tags>
            <ordertags>
                <argb_color>11</argb_color>
                <name>往日单</name>
                <type>1</type>
                <sub_name>自选</sub_name>
            </ordertags>
        </order_tags>
        <transfer_courier_name>1234567</transfer_courier_name>
    </data>
    <status_message>参数不能为空</status_message>
    <is_success>true</is_success>
</cainiao_guoguo_courier_queryorderdetailinfobymailno_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

返回
顶部