淘寶商城ERP对接技术规范规范白皮书.docxVIP

淘宝商城ERP对接技术规范规范白皮书Revision HistoryDateVersionDescriptionAuthor20整体框架，系统逻辑，接口逻辑，测试用例，沙箱使用蒋启帅2011-12-50.5.1增加沙箱绑定时候的登陆截图3-11蒋启帅　　　　　　　　　　　　　　　　目录第一章 前言前言淘宝商城，亚洲最大网上购物网站——淘宝网打造的在线B2C购物平台。自2008年4月10日建立淘宝商城以来，众多品牌包括联想、惠普、优衣库、迪士尼、Kappa、乐扣乐扣、JackJones、罗莱家纺在淘宝商城开设的官方旗舰店，受到了消费者的热烈欢迎。迄今为止，淘宝商城已经拥有超过1.8亿买家，15000个商户，20000个品牌。目前的淘宝商城处在飞速发展阶段，多种新型网络营销模式正在不断被开创。在淘宝商城业务飞速发展的过程中，商城商家产生了巨大的整体电子商务解决方案需求。物流宝通过整合各方资源为淘宝商城商家提供了包括物流服务、ERP服务在内的整体电子商务解决方案。为了方便ERP合作伙伴能快速了解淘宝商城的业务、物流宝业务、商城商家的作业流程，对接物流宝，加入物流宝体系，从而为商城商家提供更好的服务，我们推出了ERP接入物流宝白皮书。本文档的目标读者为有意向接入物流宝为淘宝商城商家服务的TMS合作伙伴。名词解释WLB: 物流宝B2C：Business to Customer TMS：Transportation Management System 物流管理系统 WMS: Warehouse Management System 仓库管理系统TP：淘拍档（Taobao Partner），即淘宝合作伙伴，是指加入淘宝合作伙伴计划的各类外包服务提供商，简称TP。TC: Transaction Center，交易中心，本文专指淘宝交易中心。LC: Logistics Center，物流中心，本文专指淘宝物流中心。第二章 对接流程业务接洽运营业务流程2. 垂直市场PD确认垂直市场PD3. 横向PD提供申请表横向PD4. 提交申请表 横向PD5. 提供白皮书，组织业务技术讲解TP技术人员技术支持，横向PD 6. 待TP开发完成接口后，提供沙箱账号TP技术人员技术支持7. 调用接口联调自测TP技术人员 技术支持8. 反馈联调结果TP技术人员技术支持9. 申请正式上线TP技术人员 技术支持技术流程具体的时效以及接入流程请参照：《TP接入具体流程.xlsx》，本文仅涉及技术流程第三章 系统与接口1.系统逻辑此处为实物流，非信息流图3-1 物流宝自动发货系统逻辑如上图所示，以物流宝自动发货的淘宝交易逻辑为例：买家拍下商品并付款后，TC中心生成交易订单并向外广播。物流宝和LC后台收到广播后，记录交易信息。物流宝判断卖家是否是物流宝用户（是否入驻过物流宝），商品是否是物流宝商品（商品是否在物流宝仓，并创建映射，后文会提到），是否设置流转规则（ERP调用WLB2.0接口设置，后文会提到）。确认订单满足3）中的判断条件，并且确定库存充足后，WLB生成WLB订单并自动下发给WMS。WMS返回仓内操作节点信息给WLB，商品出库后，TMS返回接单派送等节点信息给WLB，直到买家签收。WLB在收到WMS和TMS反馈后，主动推送订单状态给LC后台。LC后台推送订单状态给TC中心。买家在TC中心中可以看到当前订单状态。在此逻辑下，需要注意的是：首先，WLB任何时候都不会主动通知ERP，订单当前的状态。需要ERP调用WLB接口来获取。上图除WMS到TMS为实物流外，其他都是信息流。WLB相当于“信息调度中心”，在物流宝系统中，所有信息都是通过WLB来中转。一旦设置流转规则，并且符合WLB自动发货规则，WLB系统将自动完成下单发货等操作。在此处理逻辑中，ERP事先完成了添加物流宝商品，入库，创建映射关系，添加流转规则等操作，后文会具体提到这些操作。另一种更为常见的ERP控制物流宝发货的淘宝交易逻辑，如下图所示：图3-2 ERP控制物流宝发货系统逻辑ERP控制WLB发货的逻辑（ERP未设置流转规则）：买家拍下商品并付款后，TC中心生成交易订单并向外广播。物流宝和LC后台收到广播后，记录交易信息。在这里由于WLB中未设置流转规则，订单将不会自动流转到WMS。 商家ERP系统通过调用TOP平台的交易接口，主动抓取交易订单信息。（具体接口可以参照中的交易API）商家ERP系统判断订单是否需要由WLB发货（判断标准，ERP自己可以设置），并调用WLB创建订单接口(后文会提到)，创建并下发订单给WLB。WLB收到订单后的操作逻辑与前文的自动发货逻辑一致。这里不累述了。2. 接口用例注意：参数列表中，标注为必须的就是一定要传的参数。可选的根据具体应用场景决定是否传。如果接口所有参数都是可选，则