一、背景说明

1.1 适用对象 本文档为天猫大电供应链业务的对接说明，适用于大电商家ERP/WMS的产品与技术同学。

1.2 业务目标与概述

1）产/进销存s&Op协同 从进销存协同升级为产销存协同，建立月度s&op协同平台&机制，通过大数据赋能商家进行产能规划、预测备料、以及生产排产。

2）全链路库存可售 基于双方ERP对接，打通生产端和渠道端库存，帮助商家实现一盘货的管理和全链路库存最优化配置，并且实现匹配不同消费者诉求、货品特性、营销玩法的可售。

3）端到端的订单履行管理 通过订单端到端的履约管理，实现消费者订单全流程的可视化，缩短订单时效，降低订单履约成本，提升用户订单满意率

1.3 名词解释
CN: CaiNiao 菜鸟简称

WMS: Warehouse Management System 仓库管理系统

LINK：Logistics Integration NetworK，即物流集成网络，是菜鸟与合作伙伴数据交换的统一对接平台(网关)

CP： Cainiao Partner 菜鸟合作伙伴，是指加入菜鸟合作伙伴计划的各类外包服务提供商，简称CP

ERP单号：大电系统内的唯一标示，从采购订单一直到出库贯穿整个供应链体系

二、业务说明
2.1 功能综述
2.1.1 大电ERP供应链中台业务对接流程

大电预约计划入库流程：

1). 大电的业务提交销量预测给大电ERP系统，接口（2.3.6）

2). 大电业务提交根据销量预测数据生成补货计划，天猫小二审核通过之后，发送给大电ERP系统，接口（2.3.7）

3). 大电ERP系统根据补货计划生成对应的体系内的生产计划，并回推天猫，接口（2.3.10）

4). 大电erp系统将补货计划对应的生产计划下线信息回推天猫，接口（2.3.10）；

5). 天猫根据大电ERP系统回推的生产计划的下线信息，生成对应的天猫中天的补货单回传ERP，接口（2.3.7）；

6). 大电erp系统将确认的补货单的数据回推天猫，天猫根据补货单自动生成仓储入库单，接口（2.3.8）

7). 天猫回推大电erp通过（2.3.9，新增补货单的回推接口）获取lbx号；

8). 天猫确认入库单没有问题的情况下，下发给菜鸟仓系统；

9). 大电系统根据LBX和ERP单号，通知天猫“基地仓”出库（2.3.3），菜鸟生成“出库单”

10). 天猫系统将确认后的物流“出库单”，下发给大电ERP系统（2.4.3）

11). 大电ERP系统下发ERP和lbx单号给物流进行出库操作；

12). 物流回传大电ERP基地仓出库状态信息

13). 大电ERP使用（2.4.4）回传出库单信息给天猫

14). 物流装车人通过菜鸟系统车辆预约信息

15). 菜鸟仓系统完成入库作业之后，回传给天猫入库单作业数据；

16). 天猫接收数据成功后，同步数据到中台，大电获取天猫接收成功数据（2.3.2），LBX入库时间入库数量等信息

17). 大电ERP推送SAP入库数量入库时间LBX单号

说明：大电基地仓的出库单和菜鸟仓的入库单用匹配用ERP单号进行匹配

大电基地仓入库流程：

1). 大电ERP（2.3.1）创建基地仓入库单

2). 天猫系统根据（2.4.1）下发基地仓入库单

3). 大电ERP(基地仓)回传入库信息给天猫系统（2.4.2）

4). 天猫系统同步增加库存，回传大电ERP入库单信息（2.3.2）

大电基地仓出库流程： 1). 大电ERP（2.3.3）创建基地仓出库单

2). 天猫系统根据（2.4.3）下发基地仓出库单

3). 大电ERP(基地仓)回传出库信息给天猫系统（2.4.4）

4). 天猫系统同步增加库存，回传大电ERP出库单信息（2.3.4）

大电基地仓货品管理流程

1). 大电业务人员在BMS管理大电基地仓货品信息

2). 大电ERP（基地仓）获取货品变更以及货品新增信息

2.1.2 流程说明

基地仓大电与天猫供应链中台需要对接的数据信息与说明如下：

1). 货品数据通过供应链中台的体系下发到基地仓

2). 大电ERP和供应链中台的库存数据必须保证一致

3). 基地仓的出入库单记录由大电的ERP经过供应链中台与基地仓互通(淘系和非淘系的模式一样)

4). 基地仓的库存盘点单据需要由基地仓的系统经过天猫中台的体系回传大电ERP

2.1.3 功能管控说明 大电这个货主名下的仓库中，只有基地仓类型的仓库可以由大电的系统来进行出入库的指令下发，3W体系的仓库大电ERP是无法下达出入库指令的。

2.2 对接体系说明
2.2.1 对接方式

1） ERP/WMS—>CN调用方向

针对ERP/WMS调用CN的链路方向，全部采用HTTP API方式对接，ERP/WMS按照LINK接入规范进行接口对接，接口开发详见第3章。

2） ERP/WMS<—CN调用方向

针对CN调用ERP/WMS的链路方向，全部采用DPS方式对接，ERP/WMS侧安装DPS环境（包含安装DPS Client虚拟机+MySQL数据表），由DPS将数据推送到MySQL表当中，ERP/WMS直接从MySQL表中消费数据即可。

DPS架构示意图.png

使用DPS的优势： DPS特点.png

2.2.2 对接流程

1）ERP/WMS的产品与技术同学先消化整体方案、准备DPS环境、 物流云账号 、完成代码开发，最后再做线上环境配置、联调、上线

2）API字段意义、业务含义与业务接入相关问题请联系 @毅石

3）DPS部署与开发的问题联系 @破牙

2.3 大电ERP侧API列表
目前包含10个API,列表如下：

序号 api名称 描述 调用方向 对接方式
2.3.1 ERP_STOCK_IN_ORDER_NOTIFY 入库单创建接口 供应链中台<–LINK<–ERP HTTP API
2.3.2 ERP_CONSIGN_ORDER_CONFIRM 入库单确认 供应链中台–>LINK–>ERP DPS
2.3.3 ERP_STOCK_OUT_ORDER_NOTIFY 出库单创建接口 供应链中台<–LINK<–ERP HTTP API
2.3.4 ERP_STOCK_OUT_ORDER_CONFIRM 出库单确认 供应链中台–>LINK–>ERP DPS
2.3.5 ERP_CONSIGN_ORDER_CONFIRM 销售发货库单确认 供应链中台–>LINK–>ERP DPS
2.3.6 REPORT_TRANSFER_ORDER 调拨单计划信息 供应链中台–>LINK–>ERP DPS
2.3.7 ASCP_PUSH_SALESPLAN 销售预测数据 供应链中台–>LINK–>ERP DPS
2.3.8 ASCP_PUSH_REPLENISHMENT_ORDER 补货单推送数据 供应链中台–>LINK–>ERP DPS
2.3.9 ASCP_PUSH_REPLENISHMENT_ORDER_CALLBACK 补货单确认回传 供应链中台<–LINK<–ERP HTTP API
2.3.10 STOCK_IN_ORDER_NOTIFY_ERP 入库单创建回推 供应链中台–>LINK–>ERP DPS
2.3.11 ERP_PRODUCE_PLAN_IN_ORDER_NOTIFY 大电生产计划回推 供应链中台<–LINK<–ERP HTTP API
2.4 大电WMS侧API列表
目前包含5个API,列表如下：

序号 api名称 描述 调用方向 对接方式
2.4.1 WMS_STOCK_IN_ORDER_NOTIFY WMS入库单接收 供应链中台–>LINK–>ERP DPS
2.4.2 WMS_STOCK_IN_ORDER_CONFIRM WMS入库单确认 供应链中台<–LINK<–ERP HTTP API
2.4.3 WMS_STOCK_OUT_ORDER_NOTIFY WMS出库单接收 供应链中台–>LINK–>ERP DPS
2.4.4 WMS_STOCK_OUT_ORDER_CONFIRM WMS出库单确认 供应链中台<–LINK<–ERP HTTP API
2.4.5 WMS_SKU_INFO_NOTIFY WMS货品信息接收接口 供应链中台<–LINK<–ERP HTTP API

三、开发说明

菜鸟系统与EPR/WMS系统间采用HTTP方式进行相互调用，开发方式有两种：

1）采用LINK SDK方式

CP可以使用LINK提供的 JAVA SDK 调用LINK的接口，SDK封装了报文组装过程，使用SDK进行开发能够提升开发效率；

2）不使用LINK SDK方式 CP也可以自己组装HTTP报文，针对CP调用LINK的报文参数，以下简要说明，详细说明和报文样例 请看链接

参数名称 说明
logistics_interface 请求报文内容（API对应的XML或JSON格式的报文，详见每个接口的请求示例）
logistic_provider_id 来源CP编号(即CP在物流云控制台上APPKEY绑定的资源)
msg_type 消息类型(即API名称，如CN_WMS_DELIVERYORDER_CREATE)
data_digest 请求签名（通过控制台产生的签名秘钥、报文内容计算得到， 计算方法 ）
to_code 目的方编码（即菜鸟服务提供方的编码，本业务可以不填写）
3）关于调用日志

LINK会保存最近20天的所有调用日志，因此CP在接入过程中和业务上线后，都可以通过查询调用日志来自助排查相关问题；

日志查询地址： [ https://global.link.cainiao.com/manager?spm=a2d6n.doc.0.0.47dd48c7Ve7Xy9#/log/log-list?_k=8kag7r)

四、环境配置

4.1账号注册与登录
详细操作流程 物流云账号注册与登录 。

说明：

1）ERP角色的账号请使用已经关联了店铺的淘系账号（如果向导提示升级到菜鸟账号，此时请使用主账号来做升级操作）。

4.2 应用管理
4.2.1 创建APPKEY

登录物流云控制台， https://cloud.cainiao.com/ ，进入菜单“物流云业务组件”—>“应用管理”

130.png

（建议不同业务使用不同的APPKEY，方便业务隔离，可以单独为大电供应链业务创建一个新的APPKEY）

4.2.2 订阅API

13.png 将所有ERP调用菜鸟LINK的接口全部添加到 “订阅API” 列表当中，“字符编码”和“报文格式”可以根据ERR的需要自由选择。

4.2.3 注册API

14.png 将所有菜鸟推送给ERP的接口添加到 “注册API”列表当中，“字符编码”和“报文格式”可以根据ERR的需要自由选择，下发地址保持默认（由于采用DPS来推送，ERP不需要提供有效地址url，下发地址不为空即可）

4.2.4 绑定资源

15.png 绑定到本业务使用的商家ID； 如果待选框中没有可选项，是由于本账号没有关联到有效店铺，请使用关联到有效店铺的账号来操作以上配置流程；

4.2.5 联调测试 ERP在完成代码开发后，联系@毅石 预约业务联调时间（由于菜鸟侧小二同时处理多个项目，任务繁重，建议提前3到5天预约联调时间）。

4.2.6 申请发布

16.png ERP与菜鸟业务同学日常环境联调完毕，并且完成线上环境部署后，提交申请发布；然后联系@毅石 在小二工作台完成APPKEY审核，审核通过后，线上环境生效。

4.3 DPS配置
4.3.1 DPS配置 登陆物流云首页（ https://cloud.cainiao.com/ ），选择“产品与服务”–>“业务组件”–>“数据推送服务”–>“供应链订单数据服务” 1.png

按照向导开通数据服务 2.png

该数据服务免费，不会产生费用 3.png

进入控制台的“服务管理”–》“我的订购”–》“供应链订单数据服务” 4.png

针对“供应链订单数据服务”记录，点击“配置通道” 5.png

点击“创建数据接收通道”，在点击“编辑” 6.png

7.png

“推送数据内容”中选择“供应链订单数据服务”后（如果下拉框中没有这个选项，是由于没有操作前面几步的服务订购流程），再保存并下一步 8.png

应用管理项选择4.2.1节已经创建的APPKEY，如图中的 574644 9.png

“配置前置机”这一步选择以APPKEY开头的前置机（前置机号生成规则是 ： APPKEY6位数字+3为随机数字） 10.png

配置DPS Client使用的mysql连接信息（由于DPS Client和mysql位于一个局域网，mysql的主机地址请使用局域网IP，不要用mysql的公网IP） 11.png

完成上面这一步之后，再去虚拟机上下载和安装DPS Client（参照4.3.2节），并使用刚刚创建的前置机号来启动，如果mysql连接信息配置正确、DPS Client启动正常，此处的校验项会全部显示 true 12.png

4.3.2 DPS Client安装与启动 DPS Client的安装与启动参照 《 DPS使用手册V1.8.pdf》的第2.2.3.2节

4.3.3 表结构 DPS Client使用的mysql表结构与规格参照《 DPS使用手册V1.8.pdf》的第2.2.3.3节介绍

1） 表结构

表.png

2） 建表脚本

CREATE TABLE data_direct_push ( id BIGINT PRIMARY KEY NOT NULL AUTO_INCREMENT COMMENT ‘id’, status INT DEFAULT 0 COMMENT ‘状态，0:初始’, data MediumText NOT NULL COMMENT ‘数据内容’, data_pack_metas VARCHAR(256) COMMENT ‘数据包元信息’, gmt_create DATETIME NOT NULL COMMENT ‘创建时间’, gmt_modified DATETIME NOT NULL COMMENT ‘修改时间’, unique_id VARCHAR(128) COMMENT ‘数据唯一id’, data_id VARCHAR(64) COMMENT ‘数据id’, data_type VARCHAR(128) NOT NULL COMMENT ’数据类型’, param1 VARCHAR(255) COMMENT ‘拓展参数1’, param2 VARCHAR(255) COMMENT ‘拓展参数2’ ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

LINK平台
关于菜鸟菜鸟品牌新闻/动态廉政举报法律政策
淘宝网|天猫|聚划算|全球速卖通|阿里巴巴国际交易市场|1688|阿里妈妈|阿里云计算|YunOS|飞猪|UC|高德地图|阿里通信|钉钉|友盟|虾米|阿里星球|一淘|蚂蚁金服|支付宝|网商银行|口碑|阿里健康|阿里游戏|
?2015-2018菜鸟网络版权所有增值电信业务经营许可证：浙B2-20160216备案图标浙公网安备33010002000117号

FAQ

关于此文档暂时还没有FAQ