商品通标准化订单链路技术对接

更新时间：2016/11/22 访问次数：19210

版本记录

版本编号	修订日期	概要
V1.0	2016.8.8	新建
V1.1	2016.11.22	增加星盘分单的描述

背景

全渠道电商域的信息状态由星盘进行统一维护，由全渠道后台（全局）和千牛·店掌柜（单个门店）进行统一报表展示。官方提供了分单逻辑和门店作业（接单、发货等）的基础功能，并在此基础上开放给ISV共建，以适应更广泛的行业需求。

名词解释

天猫B2C：负责全部电商域交易生命周期维护和订单状态流转，并将这些信息实时通知到行业中台。负责电商域商品、交易、库存等的信息和状态维护。

全渠道行业中台（星盘）：作为电商域全渠道部分的信息系统中台，主要负责源自天猫B2C的全渠道订单,订单状态维护功能以及全渠道规则管理功能。具体来说：负责全渠道订单的生命周期管理。负责分单、分账（触发）、交易控制（分阶段、大额支付）等作业系统的控制和执行。负责静态主数据和动态业务数据的处理和维护。

商家中台：商家自有企业域和作业系统的中台，对接包括ERP、WMS、POS等在内的商家系统。

全渠道后台：为商家提供门店、分单策略、分账规则等全渠道基础信息的配置，以及电商域的全渠道报表功能。为商家提供全渠道分单逻辑服务商的选择配置，以及WMS和POS作业系统服务商的选择配置。全渠道后台依赖于商户中心、天猫库存中心和天猫货品中心。

SPI：是由淘宝制定接口标准，由ISV负责实现服务并将调用地址绑定到标准接口的API。在全渠道场景中，SPI主要应用于星盘调用商家系统完成启动分单、状态通知等操作，SPI规范具体参考这里。 SPI服务必须部署在聚石塔EWS平台上，接入文档。

主要框架

接入模式(部分接口还未开放)

根据分单逻辑和接单逻辑实现的不同，全渠道模型分为下表所示4种实现形式，表中同时给出了不同实现的商家参考依据：

参考实现	是否有线上分单系统	是否有门店作业系统	是否有行业定制需求	接入难度
星盘分单+店掌柜接单	否	否	否	容易
ISV 分单+店掌柜接单	是	否	是	中
星盘分单+POS接单	否	是	否	容易
ISV分单+POS接单	是	是	是	很容易

星盘分单+店掌柜接单：

星盘分单在订单链路上分为，截流分单以及不截流分单。具体方式请与阿里技术实施人员确认。

若使用截流方式，商家线上OMS系统不需调整。订单在消费者付完款时，会将状态截住。商家OMS系统会获取不到订单状态。只有当订单被门店已完成发货、或者订单被分到电商仓、或者产生退款。订单状态才会同步到商家OMS系统。

若不使用截流方案，那么商家OMS系统需要做相关的整改，防止门店在发货时，线上OMS同步也在进行发货的流程处理。具体如下：

商家OMS改造点主要为以下两点：

1、星盘分单结果为仓发货，需要ERP或OMS等系统根据订单状态标识，将这部份订单走普通电商仓流程。

2、星盘分单结果为门店发货，需要ERP或OMS等系统根据订单状态标识，将这部份订单冻结不要通过电商仓发货，防止出现门店及电商仓同时发货的情况。

星盘分单结果体现在接口trade.fullinfo.get 中返回值omnichannel_param。含义如下：

拼接格式如下：

"orderType:{value},allocationCode:{value},subOrderCode:{value},targetType:{value},targetCode:{value},orderState:{value}"

示例：

"orderType:STORE_DELIVER,allocationCode:68002,subOrderCode:194220750565000,targetType:WAREHOUSE,targetCode:toptest_015_warehouse01,orderState:X_SHOP_CANCEL; orderType:STORE_DELIVER,allocationCode:68003,subOrderCode:194220750565001,targetType:STORE,targetCode:toptest_015_warehouse02,orderState:X_SHOP_CANCEL"

其中门店发货orderState各状态值含义如下：

ISV分单+店掌柜接单：

接口	方向	接口名	描述
	星盘->分单	taobao.qimen.omniorder.allocate	启动分单
	分单->星盘	taobao.omniorder.allocatedinfo.sync	ISV同步派单结果到星盘
	星盘->分单	taobao.qimen.omniorder.allocatedinfo.get	派单状态查询
	分单->星盘	taobao.omniorder.allocate.cancel	ISV主动取消之前的派单
	星盘->分单	taobao.qimen.omniorder.store.accpeted	店掌柜接单，星盘通知ISV
	星盘->分单	taobao.qimen.omniorder.store.refused	店掌柜拒单，星盘通知ISV
	星盘->分单	taobao.qimen.omniorder.store.consigned	店掌柜发货成功，星盘通知ISV
	星盘->分单	taobao.qimen.omniorder.customer.refund	客户退款,通知isv
	星盘->分单	taobao.qimen.omniorder.customer.refused	客户拒收
	星盘->分单	taobao.qimen.omniorder.store.returned	门店收到退货

星盘分单+POS接单：

接口	方向	接口名	描述
	星盘->POS	taobao. qimen.omniorder.allocatedinfo.sync	星盘同步派单结果到POS(商家中台)
	POS->星盘	taobao.omniorder.store.accpeted	ISV Pos端门店接单，通知星盘
	POS->星盘	taobao.omniorder.store.refused	ISV Pos端门店拒单，通知星盘
	POS ->星盘	taobao.omniorder.store.consigned	ISV Pos端门店发货，通知星盘
	POS ->星盘	taobao.omniorder.customer.refused	ISV Pos端客户拒收，通知星盘
	POS ->星盘	taobao.omniorder.store. returned	门店发货拒收（ISV门店端）
	POS ->星盘	taobao.omniorder.store.transfer	SV Pos端门店无货调拨，通知星盘

ISV分单+POS接单：

接口	方向	接口名	描述
	星盘->商家	taobao.qimen.omniorder.allocate	启动分单
	商家->星盘	taobao.omniorder.allocatedinfo.sync	ISV分单完成，将分单结果同步给星盘
	星盘->商家	taobao.qimen.omniorder.allocatedinfo.get	星盘调用ISV接口，获取门店分单信息
	POS->星盘	taobao.omniorder.store.accpeted	ISV Pos端门店接单，通知星盘
	星盘->分单	taobao.qimen.omniorder.accpeted	星盘通知POS已接单状态
	POS ->星盘	taobao.omniorder.store.refused	ISV Pos端门店拒单，通知星盘
	星盘->分单	taobao.qimen.omniorder.store.refused	星盘通知POS已拒单状态
	POS->星盘	taobao.omniorder.store.consigned	ISV Pos端门店发货，通知星盘
	星盘->分单	taobao.qimen.omniorder.store.consigned	星盘通知POS发货状态
	POS ->星盘	taobao.omniorder.customer.refused	客户拒收（ISV门店端）
	星盘->分单	taobao.qimen.omniorder.customer.refused	门店发货拒收
	POS ->星盘	taobao.omniorder.store. returned	门店发货拒收（ISV门店端）
	星盘->分单	taobao.qimen.omniorder.store.returned	门店收到退货
	POS ->星盘	taobao.omniorder.store.transfer	门店收到退货（ISV门店端）
	星盘->分单	taobao.qimen.omniorder.store.transfer	门店无货调拨

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问