WMS菜鸟V4对接部署说明

1、菜鸟热敏说明

WMS中对菜鸟热敏集成到各支持的快递公司，把菜鸟热敏当作继现有快递公司热敏、自定义热敏之后的第三种热敏方式。
WMS用户在使用上和前面两种直接对接快递公司的热敏操作体验/过程一致。
菜鸟对接菜鸟方进行过多次升级，WMS从最开始的只进行接口数据对接升级到当前的打印组件对接。

菜鸟打印组件升级公告：
http://open.taobao.com/support/announcementDetail.htm?spm=a219a.7386793.0.0.tglOJX&id=25131

1.1、菜鸟云打印资源

https://open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.kzPHha&treeId=409&articleId=106976&docType=1
云打印编辑器：打印模板配置处；客户店铺账号登录配置打印模板。

https://page.cainiao.com/waybill/cloud_printing/home.html?spm=a262a.ap-detail.0.0.5aec3651pQobvi&wd=&eqid=8a29ce8600006c2b00000003647c1060
菜鸟打印组件：打印前打印客户端要先下载安装。

2、淘宝/天猫店铺服务

2.1、胜境WMS服务订购

订购地址：https://fuwu.m.taobao.com/wap/ser/index.htm?serviceCode=FW_GOODS-1000506100&tracelog=sp#/serviceDetail?serviceCode=FW_GOODS-1000506100

客户使用店铺账号登录订购。
订购后，联系胜境网络审核。

请记住进行订购的淘宝店铺账号；将用来进行店铺授权。(订购服务和店铺授权要用相同的店铺账号）

订购成功后如图：

请记住进行订购的店铺账号；将用来进行店铺授权。
注意：因新WMS应用截图不便，以上两张图为老应用（百胜iWMS）的截图。

2.1.1、老客户续订问题

为减少配置的修改，老客户订购到期后可以续订以前的老应用（如上图）。
老应用审核请联系：
百胜软件-服务中心-呼叫中心： 陈桃华

####2.2、店铺授权
获取授权地址：http://open.taobao.com/apitools/sessionPage.htm
胜境iWMS-App Key: 24602748

用前面订购的店铺登录，进行授权。
获取授权信息类似：
session: xxxx8754bdfa093c059e208f8eaa4619e05cxzzzzz
refresh_token: xxxx524ba101fc4265128cde2eb4af4f8268144b9dexzzzzz
授权session为关键信息。记录待用！
2.2.1、授权时报错

没订购WMS服务。请先订购，见本说明2.1。

####2.3、开通电子面单服务
到客户店铺后台，在物流管理电子面单平台，选择快递公司进行“开通服务”。

根据各快递公司提示要求进行开通，联系快递公司人员进行审核。
其他快递公司类似：

审核通过还要确保有可用单号：

申请通过，并有可用单号（如无可用单号请联系快递公司人员进行处理）。
店铺开通/配置结束。

###3、 WMS程序配置

####3.1、数据库脚本
WMS配置脚本请联系WMS支持人员获取。配置分项说明：

AppKey：24602748
AppSecret：bk4eZnxLLRKOBMfi/w0+ZsS2hyUQtIFgE+iccS75WF6GzkpNVFcl3w==
ServerAddr：http://gw.api.taobao.com/router/rest
SessionKey：店铺授权session；即为淘宝店铺对iWMS应用的授权
3.1.1、脚本注意事项*
CustomerCode：商家编码；不用维护，运行时会调用淘宝接口获取，自动写到配置表

####3.2、客户端
3.2.1、菜鸟打印组件客户端安装
参考本说明，菜鸟云打印资源处，下载安装打印组件客户端。

注意后面安装的版本不一样，请安装最新版本。
3.2.2、热敏配置
以圆通为例：

把圆通的热敏方式配置成：菜鸟云栈热敏
3.2.3、客户端使用
菜鸟V4部署成功，出来的热敏打印界面如下图所示

第一次使用，需要先选择模板

注意模板分两类：标准模板，用户模板
标准模板：快递下单时使用。主要确认打印面单的基础部分。如使用“用户模板”，标准模板可不设置。
用户模板：在标准模板基础上，添加商家自定义内容。如不需要自定义区域，请指定“标准模板”。
因用户模板基于标准模板，指定用户模板同时会配置上标准模板。

第一次部署菜鸟热敏可以先用标准模板进行部署可用性测试，通过上面的配置，正常应该可以进行快递下单，下单完成能打印出面单。
标准模板打印出来的面单不能满足客户个性需求，下面进行“用户模板”配置说明。

###4、用户模板配置
商家账号登录：http://cloudprint.cainiao.com/print/login.vm进行配置。
登录后，可以看到如下几个区域：
A. 我的模板：用户使用的快递模板
B. 模板：菜鸟标准快递模板
C. isv商家自定义区：在ISV中定义并发布的自定义快递模板

####4.1、设置我的模板

####4.2、添加自定区内容

目前提供如上打印项，如需要其他打印项，请与胜境联系。
若需要在自定义区打印商品明细的列表信息，则增加子表打印项（以“子表-”为前缀的）。
供选择的打印项类型：
a. 主表打印项：订单号、篮号、店铺等。无前缀项。
b. 子表打印项：命名以“子表-”开头的打印项：
子表项在实际打印时会合并实际明细多行记录。注意预留出适当打印位置。
c. 特殊打印项：命名以“必选-”开头的打印项：
目前只有“内详信息”，用来在实际明细记录条数 > 配置打印明细数（明细打印不全）时，提醒还有明细未打印。
配置好以后，发布。即可在用户模板配置界面看到。
请注意一定要发布。
发布，即可在用户模板配置界面看到。
如打印或预览有问题可以在菜鸟打印组件查看，类似：