文档中心 > API类目 > 物流宝API

taobao.wlb.waybill.shengxian.get (商家获取生鲜电子面单号)

商家通过交易订单号获取电子面单接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
delivery_type String 必须 502
  • 最大长度:64
  • 物流服务类型。冷链:602,常温:502
    biz_code String 必须 YXSR
  • 最大长度:64
  • 物流服务方代码,生鲜配送:YXSR
    trade_id String 必须 123321123321
  • 最大长度:128
  • 交易号,传入交易号不能存在拆单场景。
    feature String 可选 123
  • 最大长度:512
  • 预留扩展字段
    service_code String 可选 123
  • 最大长度:128
  • 仓库的服务代码标示,代码一个仓库的实体。(可以通过taobao.wlb.stores.baseinfo.get接口查询)
    sender_address_id String 可选 10023
  • 最大长度:64
  • 商家淘宝地址信息ID
    order_channels_type String 必须 TB
  • 最大长度:64
  • 订单渠道: 淘宝平台订单:"TB"; 天猫平台订单:"TM"; 京东:"JD"; 拍拍:"PP"; 易迅平台订单:"YX"; 一号店平台订单:"YHD"; 当当网平台订单:"DD"; EBAY:"EBAY"; QQ网购:"QQ"; 苏宁:"SN"; 国美:"GM"; 唯品会:"WPH"; 聚美:"Jm"; 乐峰:"LF"; 蘑菇街:"MGJ"; 聚尚:"JS"; 银泰:"YT"; VANCL:"VANCL"; 邮乐:"YL"; 优购:"YG"; 拍鞋:"PX"; 1688平台:"1688";

    响应参数

    名称 类型 示例值 描述
    is_success Boolean true 生成是否成功
    fresh_waybill FreshWaybill 成功后返回的生鲜电子面单信息
    • └ time
    • String
    • 预计2014-07-31到达
    • 预计到达时间
    • └ alias
    • String
    • 万象
    • 简称
    • └ short_address
    • String
    • 浙江-杭州-西湖
    • 大头笔
    • └ trade_id
    • String
    • 123321123321
    • 交易号
    • └ feature
    • String
    • 123
    • 预留扩展字段
    • └ waybill_code
    • String
    • 1233455444
    • 获取的所有电子面单号,以“;”分隔

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    WlbWaybillShengxianGetRequest req = new WlbWaybillShengxianGetRequest();
    req.setDeliveryType("502");
    req.setBizCode("YXSR");
    req.setTradeId("123321123321");
    req.setFeature("123");
    req.setServiceCode("123");
    req.setSenderAddressId("10023");
    req.setOrderChannelsType("TB");
    WlbWaybillShengxianGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <wlb_waybill_shengxian_get_response>
        <is_success>true</is_success>
        <fresh_waybill>
            <time>预计2014-07-31到达</time>
            <alias>万象</alias>
            <short_address>浙江-杭州-西湖</short_address>
            <trade_id>123321123321</trade_id>
            <feature>123</feature>
            <waybill_code>1233455444</waybill_code>
        </fresh_waybill>
    </wlb_waybill_shengxian_get_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.waybill-shengxian-get-error:P001 参数非法,生成电子面单失败! 联系top开发人员
    isv.waybill-shengxian-get-error:P004 用户ID不存在,生成电子面单失败! 检查用户是否登录,或session过期
    isv.waybill-shengxian-get-error:P006 物流服务方代码错误,生成电子面单失败! 请检查输入参数,指定正确的物流服务方代码!
    isv.waybill-shengxian-get-error:P007 物流服务类型错误,生成电子面单失败! 请检查输入,指定正确的物流服务类型
    isv.waybill-shengxian-get-error:P008 没有交易号,生成电子面单失败! 请检查输入,交易号必须存在
    isv.waybill-shengxian-get-error:P009 没有订单来源,生成电子面单失败! 请检查输入,指定正确的订单来源
    isv.waybill-shengxian-get-error:B006 获取物流订单失败,生成电子面单失败! 请检查输入后重试
    isv.waybill-shengxian-get-error:B007 获取仓库信息失败,生成电子面单失败! 请检查输入,确定参数的正确性
    isv.waybill-shengxian-get-error:B008 路由失败,生成电子面单失败! 超出业务范围
    isv.waybill-shengxian-get-error:S001 系统异常,生成电子面单失败! 请稍后重试,如果一直失败请联系TOP开发人员
    isv.waybill-shengxian-get-error:B009 无法通过订单号获取物流单号,生成电子面单失败! 请检查是否登录过期或者参数错误,可能是未登录或者订单号输错
    isv.waybill-shengxian-get-error:B010 订单状态异常,生成电子面单失败! 请检查输入参数的正确性
    isv.waybill-shengxian-get-error:B011 订单渠道有误,生成电子面单失败! 请检查订单渠道和交易的匹配性

    API工具

    如何获得此API

    FAQ

    返回
    顶部