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

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

电子面单FAQ

更新时间:2019/01/22 访问次数:93252

1. 哪些是直营型物流,哪些是加盟型物流?有什么区别?
2. get接口报错“发货地址没有匹配的电子面单服务”是什么原因?
3. get接口的 product_code和 logistics_services 怎么填写?
4. 同一笔订单可以获取多个电子面单号吗?
5. EMS面单号,扫描不出来?
6. objectId是什么?
6. 淘外用户可以使用菜鸟电子面单么?
8. 如何查询余额?
9. 申请的面单号发货是报错,“运单号不符合规则或已经被使用”?
10. 订单1申请了物流公司A的面单号,后来发现订单1只能通过物流公司B到, 而A无法到,怎么办?
11. 面单申请接口,一次性批量最大能申请多少?
12. 大头笔是从接口获取的,但快递却反馈大头笔信息不对
13. 支持淘外订单吗?线下订单呢?
14. 物流服务商发货地址如何获取?
15. 获取的电子面单号没有使用,怎么办?
16. 为什么明明开通了电子面单服务,并且有余额,但提醒我获取失败?(对加盟型快递而言)
17. 重新绑定面单号到另一个订单号上要如何更新?
18. 大头笔是空的,或者网点说大头笔不正确
19. 风控改造中,get接口的卖家ID(使用者)和主订单列表是否必须上传?
20. Sellerid和user_id的区别?
21. Object {code: 15, sub_code: “trade order code too long”, result: "“, msg: ”Remote service error“, sub_msg: ”商家请求参数非法,交易订单号太长"}
22. 取号超时:connect timed out
23. 取号报:面单订购服务不存在。{“error_response”:{“code”:15,“msg”:“Remote service error”,“sub_code”:“subscribe service not found”,“sub_msg”:“面单订购服务不存在”,“request_id”:“5rg70h7jgc1i”}}
24. 圆通网点扫描面单号,查不出目的地
25. 使用云打印接口,但是不使用云打印组件

Q:哪些是直营型物流,哪些是加盟型物流?有什么区别?
A:直营型: EYB,EMS,ZJS,SF,FAST,POSTB
加盟型: HTKY,YTO,ZTO,UC,GTO,TTKDEX,QFKD,STO,YUNDA
直营型快递公司商家只需要订购总部的服务,加盟型快递公司商家需要订购网点的服务。某些加盟型快递公司在审批通过后还需要网点给商家充值单号数量后,才可以获取单号。
Q: get接口报错“发货地址没有匹配的电子面单服务”是什么原因?
A:是因为发货地址和申请面单服务时候注册的发货地址有不一致。排查方法:通过search接口查看该网点的发货地址和get接口填写的sender.address地址是否完全一致,包括空格,特殊字符等。直营型物流公司不会有这个报错。

Q: get接口的logistics_services 怎么填写?
A: 传值方式具体见电子面单物流服务接入指南

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

Q: EMS面单号,扫描不出来?
A:EMS是根据订购发货地址来将下发的面单信息转交到具体网点的(根据省市县匹配),如果订购的是山东的地址,申请面单时发货地址写的江苏,这时候EMS下发信息仍是山东的网点,商家在揽收扫描时发现找不到单号感到困扰。这种情况下,需要商家重新订购江苏的地址。这样信息会下发到江苏

Q: objectId是什么?
A:与业务字段无关,在批量调用时,需要保证每个对象的objectid不同,在获取到返回值后,可以通过比对出参中的objectId,可以得到与入参的对应关系。
objectId由字母、数字和下划线组成,长度不超过40,只需要在一次请求中保证不同即可。建议用列表索引下标代替

Q: 淘外用户可以使用菜鸟电子面单么?
A:可以使用菜鸟电子面单。
只要有淘宝账号就可以申请电子面单(不需有店铺)。
ISV申请“1688电子面单” 标签类目,此标签不需要发布服务,也不需要用户订购。账号对ISV授权后即可使用。
淘外订单在使用申请电子面单接口时,需要注意以下几点
1. 渠道需要传对,京东、一号店、蘑菇街等
2. 订单号需要传对应平台的订单号
3. userId 传申请电子面单的账号id即可。

Q:如何查询余额?
A:调用“cainiao.waybill.ii.search”接口。

Q:申请的面单号发货是报错,“运单号不符合规则或已经被使用”?
A:首先通过cainiao.waybill.ii.query.by.waybillcode 查看电子面的状态,如果错误码是“面单号已失效”则说明,此面单已经取消或者回收。不允许发货。
如果面单状态为合法(2,3,4,5),则面单号被其他人非法使用,需要商家进行投诉。

Q: 订单1申请了物流公司A的面单号,后来发现订单1只能通过物流公司B到, 而A无法到,怎么办?
A:建议筛单完成后再获取面单号。并且要换物流公司必须先cancel。

Q: 面单申请接口,一次性批量最大能申请多少?
A: 10个。必须是相同的发货地址sender.address,cp_code,配上多个并列的TradeOrderInfoDto。

Q:大头笔是从接口获取的,但快递却反馈大头笔信息不对
A: 拿相关面单号,用收货地址1,获取了大头笔A。 用户在ERP中将收货地址修改为2, (这个时候要调用下update接口,更新下大头笔等信息);若未调用更新接口,打印面单的时候, 就变成了,收货地址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,district,address_detail字段内容要完全一致。

Q:重新绑定面单号到另一个订单号上要如何更新?
A: 不能直接使用update,需要使用cancel+get接口组合,先取消关联,再重新获取。

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

Q:风控改造中,get接口的卖家ID(使用者)和主订单列表是否必须上传?
A:是的,这两个参数除了与风控相关,还与双11的业务相关,请所有ISV务必上传,否则会影响商家的确认发货和双11业务。

Q:Sellerid和user_id的区别?
A:sellerid是用来开通电子面单服务并取号的商家id,user_id是实际使用电子面单号的商家id。
举例说明:
一个商家有两个店铺,每个店铺分别有一个淘宝账号对应,分别为id-A和id-B。该商家用id-A来开通服务菜鸟电子面单服务,则在后续取号过程中只有id-A能取号,这个id-A就是本白皮书所指的sellerid。
但是商家用id-A获取了电子面单号,可能不是自己来用,而是给了id-B来用,这个时候就要求商家用id-A来get接口取号的时候声明下这个面单号是给id-B来用的,即get接口中的user_id要声明为id-B。这时,id-B即本白皮书所指的user_id。

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:取号超时:connect timed out
A: 排查isv查到top的阻塞情况,命令:sudo /usr/sbin/mtr -r -c 100 -s 1024 gw.api.taobao.com
tcp抓包,抓超时时候的tcp包,抓包时间段要包含超时请求。命令:tcpdump tcp -i eth0 -t -s 0 -c 100 and dst port TOP端口 -w ./target.cap 出现大量重传说明网络是有阻塞的。有网络阻塞说明是网络问题。可先要网管进行排查。如果还不能解决可以调大连接top的超时时间或者进行重试。

Q:取号报:面单订购服务不存在。{“error_response”:{“code”:15,“msg”:“Remote service error”,“sub_code”:“subscribe service not found”,“sub_msg”:“面单订购服务不存在”,“request_id”:“5rg70h7jgc1i”}}
A:测试环境需要用沙箱账号。在取号之前先调用cainiao.waybill.ii.search查询订购关系。正式环境上需要商家在卖家中心订购CP,并且网点审核通过。

Q:圆通网点扫描面单号,查不出目的地
A: 圆通网点扫描的数据来自圆通本地系统,与电子面单的系统回推数据无关。网点本地需要维护最新的集包地数据。 解决方式为,让圆通网点联系圆通总部,更新本地基础数据,联系电话 021-69773588

Q:使用云打印接口,但是不使用云打印组件
A: 云打印接口仍然兼容完整的普通接口的取号功能,返回所有打印面单所需要的信息。但是云打印接口的路由信息是单独给出的,不再自动拼接大头笔和三段码信息,因此如果想只使用云打印接口取号,需要自己拼接大头笔和三段码,具体的拼接逻辑请参考 云打印接口大头笔和三段码拼接 , 如果没有特殊的原因,建议升级使用云打印组件。

FAQ

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