文档中心 > 基础技术

电子面单常见问题

更新时间:2016/03/08 访问次数:21989

 

Q:哪些是直营型物流,哪些是加盟型物流?有什么区别?

A:直营型: EYB,EMS,ZJS,SF,FAST,POSTB

         加盟型: HTKY,YTO,ZTO,UC,GTO,TTKDEX,QFKD,STO,YUNDA

         直营型不需要充值,物流公司一般会按照包裹量一起结算;而加盟型物流需要商家找到网点充值,按充值量来结算。加盟型物流需要先调用search接口获取到发货地址,用发货地址来get面单,而直营型不需要。search接口返回值中type=1的为直营。

Q: get接口报错“发货地址没有匹配的电子面单服务”是什么原因?

A:是因为发货地址和申请面单服务时候注册的发货地址有不一致。排查方法:通过search接口查看该网点的发货地址和get接口填写的shippingAddress地址是否完全一致,包括空格,特殊字符等。直营型物流公司不会有这个报错。

 

Q: 同一笔订单可以获取多个电子面单号吗?

A:一个订单号如果配合ERP订单号(包裹号)是可以获取多个电子面单号。

 

Q:如何查询余额?

A:调用“taobao.wlb.waybill.search”接口。

 

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: 支持淘外和线下订单,只要符合接口规范,请使用淘外电商平台正规的订单号。

 

Q: 物流服务商发货地址如何获取?

A: 直营型物流发货地址不用通过search接口获取,商家后台设置即可。直营物流服务商包括:SF,EMS,EYB,ZJS,FAST,POSTB。加盟物流服务商必须调用search接口。直营物流服务商search接口返回的type字段为1。

 

Q:获取的电子面单号没有使用,怎么办?

A:可以将获取的电子面单号cancel,但是cancel有次数限制,建议不要随意cancel。取消总数不能超过获取总数的20%(获取总面单数量不超过50单的不做此限制)。也可以放任不管,快递公司过一段时间后(见单号回收规则)会将单号回收。

 

Q: 为什么明明开通了电子面单服务,并且有余额,但提醒我获取失败?(对加盟型快递而言)

A:加盟型快递申请面单时,会对发货地址做强较验。(该地址是卖家在开通时填写的)

先通过search 接口,获取到对应的发货地址;

取到发货地址后,作为入参 ,申请对应物流的面单;

注意search到的发货地址中的province,city,area,address_detail字段内容要完全一致。

 

Q:重新绑定面单号到另一个订单号上要如何更新?

A: 不能直接使用fullupdate,需要使用cancel+get接口组合,先取消关联,再重新获取。

 

Q:大头笔是空的,或者网点说大头笔不正确

A: 首先要保证get接口入参中的收货地址省市区和详细地址都按规则正确传入,get接口根据传入的收货地址信息自动从菜鸟系统中获取大头笔信息,菜鸟系统中的大头笔信息是物流公司在菜鸟系统中维护的,大头笔有没有或者取到的大头笔内容都是物流公司决定的,只要商家正确传入收货地址即可。相同的收货地址,不同的物流公司可能大头笔不一样。集包地(目的地中心)类似。

 

Q:是否提供一个打印任务加载多张面单功能?避免批量打印乱序问题。

A:提供了批量加载多张面单的接口NewPageA(),但需要注意的是该接口的便利性同时也将带来打印任务加大等问题,请ISV根据自己的具体情况来使用,具体参见最新白皮书。

 

Q:是否具有记录多台打印机,调用打印机等功能?

A:提供了打印机相关接口,具体参见最新白皮书。

 

Q:加载的打印任务比较大?

A:初步排查是由于模板中物流公司logo过大,正在优化中。优化后将直接通过打印组件的模板更新接口更新,ISV不需做任何技术改造。

 

Q:模板上的 “产品类型” 如何传值?和之前 get接口的产品类型有何不同?

A:目前物流公司关于产品类型一块还不是很规范,本次统一模板上需要打印的 “产品类型”主要用于统一商家与物流公司线下约定的产品类型,由商家选择后打印在面单上。

本次统一模板上的“产品类型” 区别 get接口的“产品类型”,ISV在模板改造时暂不要动get接口的“产品类型”的传值逻辑,否则会影响取号。在今年双11后,统一模板的使用趋于稳定,将会重新整理模板上“产品类型” 和 get接口的“产品类型”。

 

Q:风控改造中,get接口的卖家ID(使用者)和主订单列表是否必须上传?

A:是的,这两个参数除了与风控相关,还与双11的业务相关,请所有ISV务必上传,否则会影响商家的确认发货和双11业务。

 

Q:对于一台电脑连多台打印机大批量同时打印的场景的建议

A::当一台电脑连多台打印机,同时又是大批量提交任务时。

不推荐的做法为

用户先给打印机A选1000单,点开始打印,等任务提交完了再让用户给打印机B选1000单,开始打印。这样在提交A的任务的时候,B打印机并没有工作,效率比较低。

推荐的做法是

优化交互流程,提供一个类似购物车的概念,用户给打印机A选1000单,点击添加到待打印队列,此时并不提交任务,只保存信息。然后用户再给打印机B选1000单,点击添加到待打印队列。然后用户查看队列,有两个1000单的任务,然后点击开始打印。此时ISV程序将两个打印机的1000单任务拆分,先提交10个打印机A的任务,再提交10个打印机B的任务,如此往复,就可以让两台打印机同时工作,由于提交任务的速度大于打印速度,所以整个打印过程中,多台打印机并行打印,最终打印速度瓶颈变成打印机的物理打印速度。

 

Q:关于多店铺什么时候调用SET_IDENTIFY做身份设置?

A:多店铺只登陆一次的,不是在登录时设置身份信息,而是在切换店铺是设置

 

Q:关于连续点击打印预览窗口,模板设计窗口被清空的问题。

A:调用CNPrint.PREVIEW()生成预览窗口,预览窗口关闭时会清理打印信息,同时释放打印控件对象,预览前调用CNPrint.SET_PRINT_MODE("NOCLEAR_AFTER_PRINT",true); 则不会清理打印信息和释放控件对象。

 

Q:关于多店铺跨店铺的时候如何调用SET_IDENTIFY做身份设置?

A:多店铺只登陆一次的,不是在登录时设置身份信息,而是在切换店铺是设置。如果不存在切换店铺的场景时,可以将多个身份一次性设置完。

 

Q:内存溢出 access violation at address XXXXXX,write of address XXXX

A:重新启动打印服务或浏览器

 

Q:Chrome 45 和 WIN10的EDGE不兼容

A:建议使用IE内核的浏览器,腾讯浏览器,UC浏览器之类的。同样也支持Chrome 45以下的版本。

 

Q:Sellerid和real_user_id的区别?

A:sellerid是用来开通电子面单服务并取号的商家id,real_user_id是实际使用电子面单号的商家id。

举例说明:

一个商家有两个店铺,每个店铺分别有一个淘宝账号对应,分别为id-A和id-B。该商家用id-A来开通服务菜鸟电子面单服务,则在后续取号过程中只有id-A能取号,这个id-A就是本白皮书所指的sellerid。

但是商家用id-A获取了电子面单号,可能不是自己来用,而是给了id-B来用,这个时候就要求商家用id-A来get接口取号的时候声明下这个面单号是给id-B来用的,即get接口中的real_user_id要声明为id-B。这时,id-B即本白皮书所指的real_user_id。

 

Q:C/S结构如何内嵌模板设计器 (组建如何嵌入winform窗体),C#语言?

A:用VS IDE,引用cainiaoPrint,然后在工具集中拖出菜鸟控件。

 

Q:GET接口提示:Object {code: 15, sub_code: "trade order code too long", result: "", msg: "Remote service error", sub_msg: "商家请求参数非法,交易订单号太长"} ;请求订单号为:"trade_order_list":"1292244117869951,1300342244919951,1286098437249951"

A:trade_order_list的参数规则为

[“1292244117869951”,”1300342244919951”,”1286098437249951”] 类似这样

 

Q: 1、商家安装了打印控件后,打开软件后加载不了模板;

2、商家反应打印某个模板异常,其他模板是正常的;

3、模板只显示上联,不显示下联;

A: 以上问题都归于模板异常问题,可以依次用以下三步解决问题(一般第二步就能解决):

1、ping gw.api.taobao.com,如果不通,则查网络,首先看host是否绑定

2、在cmd中执行C:\CaiNiaoPrin\CaiNiaoPrintUpdate.exe http://gw.api.taobao.com/router 20

3、打开C:\CaiNiaoPrint\BugLogs.txt,把里面内容发给菜鸟技术同学进行排查

 

Q: 推荐的打印和打印环境是什么?

A: 操作系统:winxp、win7、win8、win10

浏览器:IE、firefox、360浏览器、淘宝浏览器、百度浏览器、QQ浏览器、UC浏览器、猎豹浏览器、搜狗

杀毒:360杀毒、360安全卫士、百度杀毒、小红帽杀毒、金山杀毒、金山卫士、腾讯电脑管家

打印机:快麦100、快麦200、启锐、小斑马、大斑马 

 

FAQ

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