奇门ISV接入白皮书
6.22.1 6.22.2 6.22.3 6.23
接口介绍 .................................................................................................. 84 入参规范 .................................................................................................. 84 出参规范 .................................................................................................. 85
库存盘点通知接口 ................................................................................. 88 接口介绍 .................................................................................................. 88 入参规范 .................................................................................................. 88 出参规范 .................................................................................................. 89
6.23.1 6.23.2 6.23.3 6.24
库存盘点查询接口 ................................................................................. 89 接口介绍 .................................................................................................. 89 入参规范 .................................................................................................. 89 出参规范 .................................................................................................. 89
6.24.1 6.24.2 6.24.3 6.25
仓内加工单创建接口 ............................................................................. 90 接口介绍 .................................................................................................. 90 入参规范 .................................................................................................. 91 出参规范 .................................................................................................. 92
6.25.1 6.25.2 6.25.3 6.26
仓内加工单确认接口 ............................................................................. 92 接口介绍 .................................................................................................. 92 入参规范 .................................................................................................. 92 出参规范 .................................................................................................. 94
6.26.1 6.26.2 6.26.3 6.27
库存异动通知接口 ................................................................................. 94 接口介绍 .................................................................................................. 94 入参规范 .................................................................................................. 94 出参规范 .................................................................................................. 95
6.27.1 6.27.2 6.27.3 6.28
菜鸟自动流转查询接口（扩展） ........................................................... 96 接口介绍 .................................................................................................. 96 入参规范 .................................................................................................. 96 出参规范 .................................................................................................. 96
6.28.1 6.28.2 6.28.3 6.29
心跳接口 ................................................................................................ 98
11
奇门ISV接入白皮书
6.29.1 6.29.2 6.29.3
接口介绍 .................................................................................................. 98 入参规范 .................................................................................................. 98 出参规范 .................................................................................................. 98
7 附录 ................................................................................................... 103
sign签名算法： ...................................................................................... 103
输入参数为 .............................................................................................. 103 按首字母升序排列 .................................................................................. 104 连接字符串 .............................................................................................. 104 生成签名 sign........................................................................................... 104 拼装URL请求 ......................................................................................... 104
7.1
7.1.1 7.1.2 7.1.3 7.1.4 7.1.5
12
奇门ISV接入白皮书
3 前言
3.1
业务背景
随着电子商务发展，商家所使用到的各类软件越来越多，各个软件之间没有相互打通，形成一个个信息孤岛，给商家的使用带来种种不便，商家要求各个系统之间的对接需求已经越来越迫切；
目前在行业内已经有部分系统直接由服务商之间完成了系统软件的对接，但是由于没有统一的接入标准，导致接入较混乱，对接接口的版本也参差不齐，往往这样的系统对接不具有可复制性，多个系统之间的对接，需要多次开发，给商家的使用和功能迭代升级带来了诸多的不便，同时也给服务商带来额外的维护、开发成本；为了满足商家需求，让商家能够突破各个业务系统之间的信息孤岛，提升商家在各个系统之间的操作效率，解决各个系统之间标准化对接的痛点，我们推出了奇门项目；
奇门项目一期支持ERP、WMS之间的系统标准化对接，通过构建ERP、WMS系统之间标准通信协议来实现不同系统之间的打通；对商家来说，省去了更换系统软件所带来的额外开发成本；对ISV来说，省去了与多家ERP、WMS系统对接难的问题，ERP通过一次对接奇门项目，打通与所有WMS之间的通信，WMS通过一次对接奇门项目，可以适配所有ERP软件；后期我们也将加入更多系统的支持，例如CRM与ERP的标准化对接，CRM与在线订购类营销工具的标准化对接；敬请期待！
3.2
序号 1 2 3 4 5 6 7 名词解释
名词 奇门项目 OMS TMS WMS ERP 正向调用 反向调用 解释 阿里巴巴商家业务系统标准化对接平台 Order Management System 订单管理系统 Transportation Management System 物流管理系统 Warehouse Management System 仓库管理系统 ERP Enterprise Resource Planning 企业资源计划 由ERP发起调用到奇门，奇门处理后将请求转发至WMS端 由WMS发起调用到奇门，奇门处理后将请求转发至ERP端 13
奇门ISV接入白皮书
4 奇门对接方案
4.1
奇门对接方式
目前商家使用的各个业务系统之间依靠ISV帮助实现ERP到WMS的对接，如果有多仓需求的商家还需要使用到2套以上的第三方仓储服务所提供的WMS软件，ERP、WMS各自对接，对接的总工作量为N*N倍，不但给ISV的开发带来了极大的成本，对于后期维护，也将是一项艰巨的任务，如下图所示：
通过奇门项目后可使原有的网状对接结构变为一对一的对接方式，ERP、WMS只需要与奇门数据总线对接一次即可完成所有系统的适配（特殊场景可能采用扩展字段的方式给与支持），如下图：
14
奇门ISV接入白皮书
奇门项目后继接口升级方式将采用字段升级方式，在原有基础上加入更多的业务字段，同时业务接口向下兼容，开发过一次，后继如需更多的业务字段只需在原有接口层面加入业务字段即可，无需重新开发业务逻辑；
4.2 奇门标准化对接构架
前端ERP系统通过TOP平台与奇门应用进行对接，ERP系统通过标准化通信协议、字段访问奇门系统，ERP在此需要进行改造；
奇门应用主要提供字段映射、数据翻译、数据路由、账号权限、流控、数据打点等功能，能够让双方的请求通过奇门进行正常的传输，奇门还提供商家自定义扩展字段，通过奇门项目的通用数据通道进行传输，在标准协议不能完全支持的情况下，可以采用扩展字段的方式进行补充；
后端WMS系统通过TOP平台与奇门应用进行对接，WMS系统通过标准化通信协议、字段调用奇门系统，WMS在此也需要进行改造；
（可选）WMS系统需要提供出能够在系统中新建用户、查询用户的API，以供奇门项目应用调用，新商家接入时，奇门项目可以直接调用该API创建新的用户；
15