解析阿里奇门API网关平台

文 新栋BOOK

我们从4个W出发来解析阿里奇门。WHERE在什么场景下使用？WHAT奇门是什么？WHY为什么要用奇门? HOW怎么使用？

一、WHERE在什么场景下使用

传统的做法：

我有一个“美丽服饰”的品牌工厂，顾客小G在我的网上店铺购买了一件衣服，现在客服小李查到有订单，然后通知小王从库房取货，当然同时有多个订单的时候一次取所有商品，小王再把要发给顾客的商品发到X通快递公司。如下图：

传统发货流程.png

新的做法：

我有一个“美丽服饰”的品牌工厂，我首先将一批货存在了X通快递公司的仓库。然后叫X通的工作人员清点好商品数量并录入WMS。顾客小G在网上店铺购买了一件衣服，当小G下单并成功支付后，商城系统利用奇门接口把订单信息和商品所在的仓库信息传递给奇门，奇门给对应编号的WMS系统发送订单信息，X通快递公司知道有新订单要发出，然后将对应商品进行打包发给小G，并在WMS填写好订单发货信息后传递给奇门，奇门再传递给商城系统。商城系对应的接口程序会修改小G的订单状态为已发货并修改快递单号和快递公司名称。如下图：

新发货流程.png

二、WHAT奇门是什么

在上面新的做法中提到了奇门，奇门是什么，我们看下官方定义：“奇门API网关是一个基于高可用分布式集群技术构建的云API服务。提供行业对接标准和API托管服务，帮助商家在新零售场景下打通内外异构系统，实现不同异构系统之间低成本、高效率地对接和安全、稳定地数据传输。” 是一个网关，一个API网关，解决了不同系统之家的数据对接传输问题。哪些系统呢，标准的场景就是 ERP 、WMS，正如上文一中提到的新做法里面的通过ERP直接对接到WMS实时传送订单信息同时回传给平台。

三、WHY为什么要用奇门

现在我们已经知道了奇门的作用，那么如果不使用奇门会是怎样的一种情形，那就是ERP和WMS双方沟通接口对接定义，自行研发，制定对接计划成本会很高。一个ERP需要和N多WMS系统对接，反过来一个WMS也会跟N多ERP对接。整个结构是一个网状结构，如下图所示：

ERP传统对接WMS.png

如果使用了奇门之后将ERP和WMS之间的场景对接的数据标准化，形成了一个数据总线的概念。这样ERP只需要跟奇门对接来实现跟任意的WMS打通，反过来WMS也可以跟任意的ERP打通。如下图所示：

ERP对接wms新做法.png

如果自己攒过电脑，对这个概念会比较有印象。比如电脑的主板上面的硬件接口都是行业统一制定的标准，这样不论你买任何品牌的内存、CPU、显卡都能够直接插上去使用。象德国工业一样，他们就擅长于制定标准，大家都按照这样的标准协议对接，随后大一统了。

四、HOW怎么使用

登录qimen.taobao.com,入驻奇门 -> 选择官方场景 -> API实现 -> API自测 -> 发布上线 -> 配置授权 -> 对方调用。具体参见https://open.taobao.com/doc.htm?docId=106849&docType=1。重点接口如下：

taobao.qimen.entryorder.create( 入库单创建接口 )

taobao.qimen.stockout.create( 出库单创建接口 )

taobao.qimen.entryorder.confirm( 入库单确认接口 )

taobao.qimen.deliveryorder.batchconfirm( 发货单确认接口 )

更多接口参看http://open.taobao.com/api.htm?docId=24690&docType=2。

五、小节

奇门好比一个扁担，肩挑两头，一头是ERP一头是WMS(标准场景)。它的实质是在订单流转，从拉单、转单到审单最终拣货，打包发货，一个全链路订单流程中充当了一个流转的角色。如下图：

全链路订单流转.png

(上图参照淘宝技术专家顾风胜在《大流量高并发互联网应用实践在线峰会》上的演讲整理)

订单处理的过程中涉及三个系统，平台(淘宝、天猫)、ERP/OMS(用来处理订单三方引用)、WMS(仓库内的打包、发货)。涵盖8个状态：拉单可以使用平台提供的订单API来完成，也可以通过聚石塔的数据推送产品，ERP/OMS进行转单、审单、打单，WMS提供拣货、打包、发货，最后要把状态进行回写。订单回写完成之后，订单状态就会在淘宝订单的物流详情中显示出来。奇门的位置在订单的全链路中则一目了然了。

参考文献：

1、https://open.taobao.com/doc.htm?docId=106850&docType=1 奇门官网

2、淘宝技术专家顾风胜在“大流量高并发互联网应用实践在线峰会”上的演讲文献

转载请注明作者及出处，并附上链接https://www.jianshu.com/p/eb33ff91cad3

文章首发于个人公众号 程序架道

程序架道