注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
（1）该白皮书主要描述的是ISV/自研ERP使用菜鸟电子面单的方案，适用该方案的ISV/自研ERP具备如下几个特点：
①ISV/自研ERP有对接菜鸟电子面单的需求；
②ISV/自研ERP无需从淘宝开放平台拉取订单。（link仅支持明文取号）
备注：若ISV/自研ERP需从淘宝开放平台拉取订单，请通过淘宝开放平台对接：https://open.taobao.com/doc.htm?docId=119471&docType=1#4；
（2）该方案为三方授权方案，需要注册一个ISV账号申请API并发布，然后重新注册一个商家账号对该ISV发布的应用进行授权，方可完成对接。
| 用户角色 |
用户描述 |
| LINK |
Logistics Integration Network，物流集成网络 |
| CP |
Cainiao Partner 菜鸟合作伙伴 |
| CN |
菜鸟 |
| ISV |
Independent Software Vendors，独立软件开发商 |
| 物流云平台 |
|
| 电子面单管理中心 |
https://miandan.cainiao.com/login.htm?userType=cainiao#/ 菜鸟账号订购入口 https://miandan.cainiao.com/login.htm?userType=taobao#/ 淘宝账号订购入口 |
（1）注册地址：https://cloud.cainiao.com/service/serviceDetail.do?serviceId=35&showBtn=true
（2）点击 “免费注册” 进行菜鸟企业账号注册
点击 “同意协议”
填写信息，完成企业账号注册（注册过程中遇到问题，点击页面右侧机器人按钮进行咨询）
（1）登录菜鸟物流云
地址：https://cloud.cainiao.com/service/serviceDetail.do?serviceId=35&showBtn=true
（2）申请开通服务
（3）确认信息
备注：菜鸟电子面单永久免费，无需付款。
（1）在“应用管理”点击“创建应用”
（2）在“我的订购”菜单中进行API配置
（3）选择对应的应用
（4）点击下一步（无需任何操作，请不要添加绑定任何资源！）
（5）配置参数。备注：若不使用SDK报文不做限制，若使用菜鸟提供的SDK，请按照如下规则配置：
仅支持下图中的10个开放api接口，多了少了都无法审核
字符编码：utf-8; 请求报文格式：xml；响应报文格式：xml
（6）保存
资质认证的原因：ISV进行资质认证以后，才能将对应的应用暴露给用户进行订购。（请入驻ISV，不要入驻物流云！！！否则重新注册账号）
（1）选择“ISV（第三方软件提供商）”填写对应的信息
（2）填写企业资质信息
若三证合一，上传同一个证件即可。大小限制在1Ｍ以内。
（3）等待菜鸟审核
完整公司名称请提供到钉钉群人工支持，直接发出来公司名称，不要截图，确认资料无误，请等待审核，一般当天会审核通过，扫码入群：
（4）重新登录即可查看是否审核通过
备注：该域名用于三方授权交互，若不配置，不能使用自动授权集成方式。（填写示例：taobao.com）
点击“申请发布”按钮，发布对应的应用
（2）申请发布。钉钉群人工支持，提交appkey，确认资料无误的，请等待审核，无特殊情况当天会审核通过。
PS：必须先入驻isv，再审核应用，否则应用无法授权
扫码入群：
（3）审核通过后即完成API发布。
API发布完成后，请参照1.10中的代码示例进行联调测试。
下载地址：
备注：首先调用订购关系查询接口获取发货地址，再用查到的发货地址调用取号接口来获取单号
使用SDK的代码示例：
不使用SDK的代码示例：
C#语言签名示例：
可使用菜鸟云打印组件进行打印。
（1）客户端下载链接。https://support-cnkuaidi.taobao.com/doc.htm#?docId=108934&docType=1
（2）云打印接入说明文档链接（可参考其中的物流云对接章节）。https://support-cnkuaidi.taobao.com/doc.htm#?docId=108595&docType=1
（3）主流快递公司模板列表。请对接https://support-cnkuaidi.taobao.com/doc.htm#?docId=108594&docType=1的CLOUDPRINT_STANDARD_TEMPLATES接口
商家授权存在两种方式，ISV可选择商家手动授权，同时也可选择集成授权方式。
商家账号类型：淘宝账号、菜鸟账号；
商家账号要求：必须是主账号，不支持子账号授权。
（1）在电子面单管理中心注册菜鸟账号，注册账号链接https://miandan.cainiao.com/login.htm?userType=cainiao#/
备注：若您是一个ISV，同时也是一个商家身份，请在https://miandan.cainiao.com/login.htm?userType=cainiao#/注册一个商家账号，不能使用在物流云注册的ISV账号进行登录。
（2）注册菜鸟账号。
（1）使用注册的商家菜鸟账号登录到物流云平台对ISV进行授权。
物流云平台链接：https://cloud.cainiao.com/permission/index
（2）根据ISV名称或者appkey搜索到对应的记录
（3）点击“确认授权”，完成授权动作
授权完成后，商家将TOKEN复制给到ISV进行绑定。【请一定要点击“复制”按钮哦】
非常重要！！
（1）在系统中存储商家授权Token，在获取运单号时传给菜鸟，以便能够解析出商家与ISV之间的绑定关系；
（2）获取方式：商家在物流云系统中对ISV进行授权后，商家可复制Token给到ISV。
（3）备注：Token的有效期为一年，Token到期后需商家对ISV进行重新授权。
商家使用的是淘宝账号，需要用到物流云平台的一些能力等情况
（1）物流云平台链接：https://cloud.cainiao.com/permission/index
登录时必须选择淘宝标，进入登录页面
（2）输入商家自己的淘宝账号名和密码，点击"确认授权"按钮
（3）进入三方授权管理页面，选择对应的应用，点击"授权"操作；授权确认时，请选择身份为"淘宝账号"，点击"确认授权"，完成授权动作。
（4）其他token回填， 配置token等步骤同上
（1）使用注册的商家菜鸟账号登录电子面单管理中心
https://miandan.cainiao.com/login.htm?userType=cainiao#/
（2）在“创建订购关系”模块下申请电子面单服务：
（3）提交完成后，联系快递公司网点进行审批。
在“订购关系列表”中，管理订购关系。
在“电子面单”账户中，可查看电子面单账户的余额情况。
备注：直营快递公司无电子面单余额，只有加盟快递公司才有电子面单余额。
如果有问题，请加钉钉群咨询，钉钉扫码入群：
如没有钉钉，请下载安装。
