相关API
接口的详细说明（白皮书）以及快递公司电子面单模版：http://yunpan.taobao.com/s/17EkwPYdX79 (提取码：1e1gZz) 一、前言1. 业务背景随着电子商务平台和物流服务信息化飞速发展，面单号(或称之为运单号)成为物流服务商串联快递单、订单、商家、商品等各种信息的枢纽。相比之下，传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。 近一年来，电子面单的普及已是大势所趋。究其原因，是因为电子面单具备的独特优势： a. 效率更高 n 提升打印效率：电子面单的打印效率是普通纸质面单的4-6倍，平均每单打印只需花费1-2秒钟，高效率的打单大大缓解电商等客户的大批量打单压力，轻松应对大促； n 提高发货效率：电子面单不需要把快递单和定单信息逐一匹配操作，在订单信息申请快递单号的时候就已完成了定单匹配；卖家无需再安排人员专门抽取“发货联”，操作效率进一步提升；减少了手写“大头笔”等动作，提高了分拣效率；提高了分拣的准确性； n 支持多种电商增值业务，无需人肉绑定面单（例如：货到付款，预约配送）。 b. 成本更低 n 电子面单的纸张是0.1元/张，成本比传统纸质面单0.2-0.3元降低了一大半； n 降低快递公司作业成本，如取消抽单和手写大头笔，单位时间内的揽货可以提升一倍以上； c. 数据信息完整实效 n 在申请电子面单运单号的时候，就匹配到具体的“大头笔”信息，既减少人工操作的成本并又可以提高准确率和效率； 商家在使用电子面单的时候就会自动将数据同步给快递公司，可以在申请面单的时候就拿到第一手数据，更加真实并且提高速度。 2. 名词解释
3. 特殊说明3.1 云栈平台所用到编码参考规范a. 物流服务商(cp_code) : 顺丰(SF)、EMS(标准快递：EMS；经济快件：EYB)、宅急送(ZJS)、圆通(YTO)、中通(ZTO)、百世汇通(HTKY)、优速(UC)、申通(STO)、天天快递 (TTKDEX)、全峰 (QFKD)、快捷(FAST)、邮政小包(POSTB)、国通(GTO)、韵达(YUNDA) b. 订单来源：订单产生的电商平台 淘宝(TB)、天猫(TM)、京东(JD)、当当(DD)、拍拍(PP)、易讯(YX)、ebay(EBAY)、QQ网购(QQ)、亚马逊(AMAZON)、苏宁(SN)、国美(GM)、唯品会(WPH)、聚美(JM)、乐蜂(LF)、蘑菇街(MGJ)、聚尚(JS)、拍鞋(PX)、银泰(YT)、1号店(YHD)、凡客(VANCL)、邮乐(YL)、优购(YG)、阿里巴巴(1688)、其他(OTHERS) 3.2 电子面单接入流程1.申请开通电子面单接口权限包. 技术问题交流群：250835836 2.沙箱环境开发接口，测试。沙箱账号使用sandbox_b_01，密码：taobao1234 3.编辑模板，模板开发好后发给物流公司审核 4.正式环境测试通过 5.联系运营苏珩报备 6.应用上线 3.3 服务开通说明商家需要在下图所示的页面开通电子面单服务。新的页面添加了tab页面切换，包含“服务商配置”、“充值及使用记录”、“服务介绍”。其中服务商配置页面用来配置网点和发货地址，充值与使用记录页面可以查看各个网点的面单充值情况和使用情况，也包括取消的单量。
开通直营物流服务商(下图以EMS为例)；需要填入EMS的月结账号，如果没有可以不填。 开通加盟物流服务商，至少填入一个网点信息。网点选择现在支持模糊搜索功能，可以通过网店名称和网点编码进行模糊搜索。但是网点名称搜索和网点编码的搜索是独立的并优先匹配网点名称，即先匹配网点名称，网点名称有匹配到的会标红，如果没有匹配到则搜索网点编号。 加盟型物流服务允许添加对应网点的发货地址，网点信息会默认关联。 面单充值及使用记录查询页面：
二、电子面单方案2.1 打单流程设计综合前置和后置两种打印流程，建议ERP及其他软件打单流程如下：
前置打单流程
后置打单流程 2.2 电子面单业务基础流程图
2.3 系统设计注意点1、因为电子面单是用热感敏打印机打印的。为了防止用户混淆。 传统面单模版与电子面单模版最好有区分。一般通过先选模版，再获取单号打印的方式会比较好。 2、修改了面单号对应的收货地址信息，务必要调用更新接口，进行信息更新。举例如：用收货地址1，获取了大头笔A。 用户在ERP中将收货地址修改为2， （这个时候要调用下fullupdate接口更新下，大头笔、集包地等信息会跟着更新）；若未调用更新接口，打印面单的时候， 就变成了，收货地址2，跟大头笔A。出现大头不匹配或者其它信息不匹配的情况。特别注意：修改了收货地址如果不调用更新接口将导致收货地、大头笔的错误，包裹会发错地方，轻则物流时间变长，重则包裹丢失，引起纠纷。 3、申请下来的面单号码，ERP在系统中不能编辑。防止错误单号的产生。 4、打印模板需要严格按格式要求来设计，不然会出现快递揽件无法扫描入库，或者送货关键信息被上下联分开的情况。 5、申请面单时，直营型快递的发货地址可以自己填写。加盟型快递必须与申请时填写的发货地址保持一致（这个地方要特别注意，不然会报服务不存在、发货地址不匹配等错误）。通过接口taobao.wlb.waybill.i.search 获取(type=1的为直营)，直营型的发货地址不需要调用。 6、发货操作时，与申请面单时，这两个环节的面单号务必保持一致，不然会造成物流流转信息的错乱。 7、商家打印很多电子面单号之后，有时需要取消某几张面单，由于现在获取的电子面单号不是流水号，有可能会查找起来很困难，建议ISV在打印电子面单的时候，考虑为每个电子面单添加一个流水单号，ERP系统中做好面单号和流水单号的对应，便于后期查找面单。 8、商家登陆卖家中心后台申请开通电子面单服务的卖家user_id，必须与在ERP中执行申请电子面单等数据交互过程sessionkey中的user_id保持一致。对于多店铺，有可能申请面单号用的sessionkey中的user_id和实际使用这个面单号real_user_id不一致，比如申请时候是用主店铺的去申请（多店铺只需要一家主店铺去申请面单就可以，也便于结算），real_user_id填的是使用这个面单号的子店铺的user_id。打印或取消的时候有时候报错“用户id不匹配”，就是因为real_user_id错了，用querydetail接口去查一下申请的时候用的是哪个real_user_id。 三、常用场景说明3.1 拆合单 三期接口添加了package_id的字段，支持了包裹的拆合单操作。关于拆合单的应用场景使用说明，可以参看上一小节的ERP订单/包裹号的使用。此处不再赘述。 3.2 交接单与对账在包裹出仓之后与物流揽收员交接的环节经常会出问题，比如有些快递揽收员把该店铺的所有包裹先收集起来，然后再依次扫码揽收，揽收信息录入物流公司的系统中之后发现会有包裹丢失的情况，店铺会说包裹已经给了揽收员，但揽收小二说没有给他们，因此很容易引起纠纷。电子面单不像传统的面单有多联，商家可以留有底单，鉴于这种情况，在包裹交接的过程中ISV可以考虑为店铺卖家提供一份纸质的交接单，有包裹明细与包裹量，可以让揽收小二确认包裹已经揽收的时候签字，同时ERP系统中也有交接单明细记录，该记录不仅可以作为交接过程的凭证，同时也可以在最后结算的时候留有发货的明细记录，便于对账。 另外，对于对账功能，可以将面单的使用记录明细保留在ERP系统中，结算的时候使用了多少，取消了多少（卖家中心新上线功能可以支持查询）有明细可以提供核查。 3.3 打印打印场景有几个特别需要注意的地方。 1. 一定要用print接口校验成功之后再打印。如果不使用print校验接口，常常会出现商家打印的面单纸上的信息和菜鸟系统中的面单信息不一致的情况，很有可能会有发错包裹，或者出现重复单号的情况。 2. print校验接口支持批量操作，对于部分订单出现问题的，所有入参的面单信息都不做已打印操作，直到全部通过校验。如果出现打印校验不通过的情况，要给出提示，引导商家去查到具体失败的面单信息，并做更新修改。比如收货地和面单号不一致，那很有可能是商家修改了ERP系统订单收货地但是没有调用fullupdate接口。 3. 打单过程中，一些重复单号的打印。需要弹框提醒用户，该单号已打印。并且系统会提示已打印次数。 4. print校验成功之后，方可启动打印机打印纸质面单。 5. 因为电子面单是用热感敏打印机打印的。为了防止用户混淆。 传统面单模版与电子面单模版最好有区分。一般通过先选模版，再获取单号打印的方式会比较好。 6. 打印的时候，如果存在不同的物流公司的模板面单纸大小一致（比如模板基本一致，只有LOGO换一下），并且模板通过了不同网点的审核，则可以考虑使用不换纸打印，这样可以提高打印的效率。 3.4 更新与取消什么情况下是要调用fullupdate，什么情况下可以使用cancel，ISV要做好限制，避免商家有意或无意的错误操作。 fullupdate使用场景：对于修改所有关于订单号与面单号的关联关系的操作、换物流公司、换发货地址等信息的操作，不能使用fullupdate接口。而如果是要修改面单上打印的信息的时候是可以调用fullupdate的，比如修改收货地址、收货人联系方式、物流服务信息、商品列表、重量体积等无关订单和面单关系的信息。注意：商品列表要真实填写，物流公司要备案；物流服务信息可以通过product接口获取，允许商家根据发货的具体情况选择该物流公司支持的服务信息。 Cancel使用场景：如果要修改发货地址，修改面单号与对应的订单号的关联关系的（包括拆合单），都是需要先取消再获取的（cancel+get），不允许直接通过fullupdate接口变更关联关系，接口也会报错的。关于取消的面单回补问题，现行解决方案是允许商家查询充值记录，使用记录和取消记录，取消量会同步给商家和物流公司，由商家和物流公司协商回补。 包裹如果已经被揽收了的情况下，是不允许再做cancel和fullupdate操作的。 3.5 发货对于淘系电子面单的发货，可以调用物流发货接口，发货的时候ERP系统要确保订单号与物流单号是正确的关联关系，菜鸟系统考虑将乱传订单号与物流单号的发货操作做强校验限制。
三、电子面单模板各快递公司的单号生成条码要用128码方式生成，具体CODE规则如下：
必须严格按照此条码生成规则生成条码，否则快递公司巴枪可能无法扫描。 五、FAQ1.哪些是直营型物流，哪些是加盟型物流？有什么区别？ 答：直营型： EYB,EMS,ZJS,SF,FAST,POSTB 加盟型： HTKY,YTO,ZTO,UC,GTO,TTKDEX,QFKD,STO,YUNDA 直营型不需要充值，物流公司一般会按照包裹量一起结算；而加盟型物流需要商家找到网点充值，按充值量来结算。加盟型物流需要先调用search接口获取到发货地址，用发货地址来get面单，而直营型不需要。search接口返回值中type=1的为直营。 2.get接口报错“发货地址没有匹配的电子面单服务”是什么原因？ 答：是因为发货地址和申请面单服务时候注册的发货地址有不一致。排查方法：通过search接口查看该网点的发货地址和get接口填写的shippingAddress地址是否完全一致，包括空格，特殊字符等。直营型物流公司不会有这个报错。
Q: 商家如何才能使用电子面单服务？ A: 商家需要登录：淘宝->卖家中心->物流服务->，选择物流服务商，申请开通服务。申请通过后即可在ERP中使用(前提是使用的ERP软件已对接云栈的电子面单平台。)
Q: 现在开通了哪些物流公司的电子面单服务？ A: 目前上线优速、申通、中通、百世汇通、天天、顺丰、EMS、EMS经济快递、全峰快递、宅急送、快捷、国通、韵达、圆通
Q: 支持淘外订单吗？线下订单呢？ A: 支持淘外和线下订单，只要符合接口规范，请使用淘外电商平台正规的订单号。
Q: 物流服务商发货地址如何获取？ A: 直营型物流发货地址不用通过search接口获取，商家后台设置即可。直营物流服务商包括：SF，EMS，EYB，ZJS，FAST，POSTB。加盟物流服务商必须调用search接口。直营物流服务商search接口返回的type字段为1。
Q: 同一笔订单可以获取多个电子面单号吗？ A:一个订单号如果配合ERP订单号（包裹号）是可以获取多个电子面单号。
Q：获取的电子面单号没有使用，怎么办？ A：可以将获取的电子面单号cancel，但是cancel有次数限制，建议不要随意cancel。取消总数不能超过获取总数的20%（获取总面单数量不超过50单的不做此限制）。
Q：如何查询余额？ A：调用“taobao.wlb.waybill.search”接口。
Q: 为什么明明开通了电子面单服务，并且有余额，但提醒我获取失败？(对加盟型快递而言) A:加盟型快递申请面单时，会对发货地址做强较验。（该地址是卖家在开通时填写的） 1、先通过search 接口，获取到对应的发货地址； 2、取到发货地址后，作为入参 ，申请对应物流的面单；注意search到的发货地址中的province,city,area,address_detail字段内容要完全一致。
Q:重新绑定面单号到另一个订单号上要如何更新？ A: 不能直接使用fullupdate，需要使用cancel+get接口组合，先取消关联，再重新获取。
Q: 订单1申请了物流公司A的面单号，发现订单1只能通过物流公司B到， 而A无法到，怎么办？ A：建议筛单完成后再获取面单号。并且要换物流公司必须先cancel。
Q: 面单申请接口，一次性批量最大能申请多少？ A: 10个。必须是相同的发货地址shipping_address，cp_code，配上多个并列的trade_order_info_cols。
Q:大头笔是从接口获取的，但快递却反馈大头笔信息不对 A: 拿相关面单号，用收货地址1，获取了大头笔A。 用户在ERP中将收货地址修改为2， （这个时候要调用下fullupdate接口，更新下大头笔等信息）；若未调用更新接口，打印面单的时候， 就变成了，收货地址2，跟大头笔A。出现大头不匹配的情况.
Q:大头笔是空的，或者网点说大头笔不正确 A: 首先要保证get接口入参中的收货地址省市区和详细地址都按规则正确传入，get接口根据传入的收货地址信息自动从菜鸟系统中获取大头笔信息，菜鸟系统中的大头笔信息是物流公司在菜鸟系统中维护的，大头笔有没有或者取到的大头笔内容都是物流公司决定的，只要商家正确传入收货地址即可。相同的收货地址，不同的物流公司可能大头笔不一样。集包地（目的地中心）类似。 |
|
|
