ISV接入流程
菜鸟 打印组件 技术白皮书
说明：
1、本文档主要体现接入的整体流程，并不对具体接口或协议做示例说明，如想了解请参考对应接口文档或协议文档。(参考)
2、详细的接入demo，可以参考（isv接入demo）
3、最新的打印组件可在此下载：菜鸟打印组件
流程交互图
这张图只是表明ISV(erp系统)、打印服务以及top接口的交互流程。
[返回页首](#header)
具体流程
1、和打印服务建立连接
- 通过java script、java、c/c++等语言建立与打印服务之间的websocket连接
2、获取模板列表
- 获取商家已配置的模板列表：调用TOP接口cainiao.cloudprint.mystdtemplates.get获取当前商家已配置的电子面单模板
- 获取全部标准模板列表：调用TOP接口cainiao.cloudprint.stdtemplates.get获取全部标准模板
3、获取自定义区列表
- 根据步骤2中返回的模板列表，商家选择某一模板，并将templateId作为入参调用TOP接口cainiao.cloudprint.customareas.get获取当前该模板的自定义区
4、获取电子面单
- 根据步骤2获取的模板url，作为入参调用TOP接口cainiao.waybill.ii.get获取电子面单数据
- 将获取到的面单数据拼装成指定的协议（参考）格式下发给打印服务
5、修改电子面单信息
- 当商家在未打印之前想更换模板或变更面单信息，需调用TOP接口cainiao.waybill.ii.update
6、获取打印机列表
- 发送getPrinters请求协议，获取终端打印机名字列表
7、选择打印机发送打印任务
- 拼装打印协议（参考）
- 向打印服务发送print协议请求，打印服务会返回两类响应消息：print和notifyPrintResult
- print：打印服务确认已经收到打印的数据
- notifyPrintResult：通知打印结果，成功还是失败
8、查询任务状态
- 根据taskID调用getPrintTaskStatus查询该任务的打印状态
- 根据documentID调用getWaybillPrintStatus查询面单的打印状态
9、设置打印机参数
- 弹窗模式：发送printerConfig协议唤起打印机参数配置界面进行配置
- API模式：发送setPrinterConfig协议设置打印机参数
© 2016 cainiao.com 版权所有。
未经允许，不得进行任何形式的修改、传播等行为。菜鸟网络保留修改权利。