注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 电子面单对接知识库

电子面单升级记录

更新时间:2016/12/20 访问次数:43566

2016-06-21变更

新对接接口

接口链接

批量接口顺序

电子面单并不保证出参的顺序和入参顺序一致,需要通过objectId 进行识别
针对批量接口,通过新的objectId模式,有效减少返回值对象的大小,并使一次获取多个面单号的返回值更容易和入参对应。

支持云打印服务

此接口与云打印组件合并推出,云打印帮助文档,需要将出参拼接传给菜鸟打印组件

服务信息重构

目前只保留标准服务和货到付款两种,传输格式见 链接

去除冗余信息

cainiao.waybill.ii.cancel接口和cainiao.waybill.ii.update接口中入参的冗余信息去除(订单,渠道,包裹id,使用者id)

入参结构化

由原来的平铺模式更改为结构化的发件人信息,包裹信息,订单信息,发件人信息等结构

联系方式增加

联系方式由原来的phone 扩展为phone和mobile。

发件人信息必填

发件人姓名和电话由可选更改为必传。

去除打印校验接口

在打印前,不再需要调用打印校验接口(print接口)。

新老接口的兼容

老接口生成的数据,需要调用新版cainiao.waybill.ii.update接口更新后(发件人联系方式、姓名、模板URL)即可得到新版本的返回值。
入参示例:

{
    "cp_code": "POSTB",
    "sender": {
        "mobile": "1352353325",
        "phone": "05714232523",
        "name": "123"
    },
    "template_url": "http://cloudprint.daily.taobao.net/cloudprint/template/getStandardTemplate.json?template_id=2901&version=6",
    "waybill_code": "9890000010291"
}

直营CP不再支持使用非订购地址获取电子面单号

  1. 现状。目前使用直营CP(如EMS、顺丰)的商家在获取电子面单号时,不限制一定要使用订购地址,这种做法对于CP网点揽件造成了一定的困扰,故在ISV端参照加盟形式,商家在获取电子面单号时只能选择订购地址。
  2. 具体需求。
    • ISV端调用search接口获取商家订购直营CP的所有地址,供商家进行选择,且只能选择订购成功的地址。【类似加盟形式】
    • 目前商家已经可以通过在淘宝卖家中心新增发货地址的形式来支持获取电子面单号时选择多个地址。
  3. 节奏要求。930之前ISV端完成改造,后续菜鸟端会进行切换,强制商家只能通过订购地址来获取电子面单号,否则取号失败。

FAQ

关于此文档暂时还没有FAQ
返回
顶部