供应链开放平台建设

75 页原型
供应链开放平台建设

一、产品架构#

供应链开放平台:开放平台业务架构、开放平台矩阵、鲜果业务与底层服务能力、能力封装、Open API,以及客户经营全流程
供应链开放平台:开放平台业务架构、开放平台矩阵、鲜果业务与底层服务能力、能力封装、Open API,以及客户经营全流程

二、商务样例#

四份对外方案:从合作汇报、合作方案到报价,按需切换查看,不展开成整页长图。

喜茶 × 鲜沐 合作汇报 第 1 页
1 / 34

三、对接方案#

乐乐茶 × 鲜沐 对接方案

总览

方案总览:两大阶段

OVERVIEW
短期 · 人工代下单
乐乐茶 → 鲜沐大客户系统,采用人工代下单完成直供、代仓服务
长期 · 接口对接
乐乐茶 ↔ SaaS & 开放平台,采用接口对接形式完成直供、代仓服务
基础数据
商品 / 门店 / 供应商
采购数据
入库 / 退货
销售数据
出库 / 退货
调拨数据
入库 / 出库
库存数据
盘点 / 报损
一

品牌接入

BRAND ONBOARDING

1.1 业务背景

合作要素内容
合作业务货品:直供 + 代仓;门店:直营 + 加盟
合作区域浙江外区 + 杭州送仓;江苏外区(不含南通、苏州等苏南区域)+ 南京送仓;重庆外区(年后暂定华东代仓业务及其他外区门店)
合作仓库嘉兴总仓、南京总仓、华西总仓、重庆总仓、长沙总仓(1月7日暂时终止合作),附件:《乐乐茶合作门店对应仓库信息0108.xlsx》
合作品类直供:目前仅鲜果(未来可能会有标品);代仓:鲜果、标品均有可能
交易履约门店下单后随平台配送周期履约;日配区域日期双号下单,非日配区域在配送日前下单,附件:《乐乐茶合作门店-配送周期.xlsx》

1.2 租户入驻

系统对接前,需先完成品牌租户入驻,才能支撑直供、代仓两大业务场景。
租户入驻流程
租户入驻流程(鲜沐 / BOSS / 前台)
入驻环节动作货权归属
新建品牌人工在 SaaS 线下建立,获取租户 ID、appKey、appSecret—
商品报价(直供)商品在 SaaS 进行报价,实现乐乐茶采购鲜沐
商品代仓货品在 SaaS 进行代仓申请/管理,实现乐乐茶采购/管理乐乐茶
二

数据对接

DATA INTEGRATION
共 5 类数据:基础数据、采购数据、销售数据、调拨数据、库存数据。除直供商品档案走线下映射外,其余均通过接口方案实现。

2.1 基础数据

基础数据包含:商品档案、门店档案、供应商档案。

档案覆盖范围实现方式
商品档案按直供/代仓分两类直供:线下商品映射;代仓:接口对接
门店档案与鲜沐合作的乐乐茶门店接口对接
供应商档案代仓商品的供应商信息接口对接

1.1 商品映射(直供)

直供商品货权在鲜沐,仓储、库存管理及定价权均在鲜沐,需满足乐乐茶线上采购。该类商品档案不需要接口创建/修改,由人工线下维护三方编码。

商品映射流程
商品映射流程(美团(乐乐茶)/ 鲜沐)
备注(余涛):根据实际情况,目前是否只需要新增/修改场景——删除场景可以通过线下完成,发生概率不高。

1.2 商品同步(代仓)

代仓商品货权在乐乐茶,仓储、库存管理及定价权均在乐乐茶,需满足乐乐茶线下管理仓储、库存及线上采购。该类商品档案通过接口创建/修改,系统维护三方编码。

商品下发流程
商品下发流程(美团(乐乐茶)/ 鲜沐)
序号字段规则
1商品编码需要以外部商品编码为准,不关注鲜沐商品编码
2规格单位满足美团多级规格及转换比例下发,即规格单位、换算比例支持多级;库存单位、售后单位均以最小规格单位为准

1.3 门店同步

直供/代仓商品均需支持乐乐茶合作门店下单,该类合作门店档案通过接口形式创建/修改,需要人工审核。

门店下发流程
门店下发流程(美团(乐乐茶)/ 鲜沐)
序号字段规则
1门店编码需要以外部门店编码为准,不关注鲜沐门店编码

1.4 供应商同步

代仓商品需要在鲜沐进行仓储、库存管理动作,需提供供应商信息,该类供应商档案通过接口形式创建/修改。

序号字段规则
1供应商编码需要以外部供应商编码为准,不关注鲜沐供应商编码

2.2 采购数据

采购数据包含:采购入库单据、采购出库(退货)单据,均含「下发 / 取消 / 回传」三类场景,通过接口方案实现。

2.2.1 采购入库

代仓商品货权在乐乐茶,乐乐茶完全把控采购入库环节,指定鲜沐某仓库完成相关动作,鲜沐跟随乐乐茶线上指令配合,并将收货入库结果进行部分回传。

采购入库流程
采购入库下发流程(美团(乐乐茶)/ 鲜沐)

采购入库下发

序号字段规则
1采购单号需要以外部采购单号为准,不关注鲜沐采购单号
2仓库编号所有合作仓库编码和名称,线下梳理后提供给美团
3商品编码需要以外部商品编码为准,不关注鲜沐商品编码
4规格单位需要对方按照最小规格单位进行
5供应商编码需要以外部供应商编码为准,不关注鲜沐供应商编码

采购入库回传

序号字段规则
1采购单号需要以外部采购单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团
3商品编码需要以外部商品编码为准
4规格单位按最小规格单位进行
5批次信息回传时要求回传批次(生产日期)、数量
6入库时间需要有明确的入库时间回传

采购入库取消

序号字段规则
1采购单号需要以外部采购单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团

2.2.2 采购出库(退货)

代仓商品货权在乐乐茶,乐乐茶完全把控采购出库环节,指定鲜沐某仓库完成相关动作,鲜沐跟随乐乐茶线上指令配合,并将退货出库结果进行回传。

采购退货下发

序号字段规则
1采购单号需要以外部采购单号为准,不关注鲜沐采购单号
2退货单号需要以外部采购退货单号为准,不关注鲜沐采购退货单号
3仓库编号合作仓库编码/名称,线下梳理后提供给美团,接口调用时需传参
4商品编码需要以外部商品编码为准
5规格单位按最小规格单位进行

采购退货回传

序号字段规则
1采购单号需要以外部采购单号为准
2退货单号需要以外部采购退货单号为准
3仓库编号合作仓库编码/名称,接口调用时需传参
4商品编码需要以外部商品编码为准
5规格单位按最小规格单位进行
6批次信息回传时要求回传批次(生产日期)、数量
7出库时间需要有明确的出库时间回传

采购退货取消

序号字段规则
1退货单号需要以外部采购退货单号为准
2仓库编号合作仓库编码/名称,接口调用时需传参

2.3 销售数据

销售数据包含:销售出库单据、销售入库(退货)单据,均含「下发 / 取消 / 回传」三类场景,通过接口方案实现。

2.3.1 销售出库

乐乐茶门店线上生成直供/代仓商品进货单,鲜沐负责接收(需进行库存、履约范围等校验,返回成功失败结果,美团同步进行订单响应)后进行履约反馈出库结果。整体履约周期遵循鲜沐规则、计划。

销售出库流程
销售出库下发 / 回传 / 取消流程(美团(乐乐茶)/ 鲜沐)

销售出库下发(进货单下发)

序号字段规则
1进货单号需要以外部进货单号为准,不关注鲜沐进货单号
2门店编码需要以外部门店编码为准,不关注鲜沐门店编码
3商品编码需要以外部商品编码为准
4规格单位按最小规格单位进行

销售出库回传(进货单发货回传)

序号字段规则
1进货单号需要以外部进货单号为准
2门店编码需要以外部门店编码为准
3仓库编号合作仓库编码/名称,线下梳理后提供给美团
4商品编码需要以外部商品编码为准
5规格单位按最小规格单位进行
6批次信息回传时要求回传批次(生产日期)、数量
7出库时间需要有明确的出库时间回传

销售出库取消(进货单取消)

序号字段规则
1进货单号需要以外部进货单号为准
2门店编码需要以外部门店编码为准
备注(余涛,2月2日讨论):
  • 销售出入库回传需要有批次信息 —— 已补充;
  • 需要指定仓库发货,否则会导致发货仓库不一致 —— 使用鲜沐规则,回传时告知仓库;
  • 销售出库(进货单)会包含多个商品,可能同时存在直供/代仓商品;
  • 乐乐茶期望:可以有销售出库的预计出库时间 —— 暂不支持。

2.3.2 销售入库(退货)

乐乐茶门店线上生成直供/代仓商品售后单,鲜沐负责接收(需进行售后审核,返回成功失败结果,美团同步进行订单响应)后进行回收反馈入库结果。整体售后规则遵循鲜沐规则、计划。

销售退货流程
销售退货下发 / 审核回传 / 退货回传 / 取消流程(美团(乐乐茶)/ 鲜沐)

销售退货下发(售后单下发)

序号字段规则
1进货单号需要以外部进货单号为准,不关注鲜沐进货单号
2售后单号需要以外部售后单号为准,不关注鲜沐售后单号
3门店编码需要以外部门店编码为准
4商品编码需要以外部商品编码为准
5规格单位按最小规格单位进行

销售退货审核回传(售后单结果回传)

序号字段规则
1售后单号需要以外部售后单号为准
2门店编码需要以外部门店编码为准
3商品编码需要以外部商品编码为准
4规格单位按最小规格单位进行

销售退货回传(售后退货回传)—— 仅代仓商品回传

序号字段规则
1进货单号需要以外部进货单号为准
2售后单号需要以外部售后单号为准
3仓库编号合作仓库编码/名称,线下梳理后提供给美团
4商品编码需要以外部商品编码为准
5规格单位按最小规格单位进行
6批次信息回传时要求回传批次(生产日期)、数量
7入库时间需要有明确的入库时间回传

销售退货取消(售后单取消)

序号字段规则
1售后单号需要以外部售后单号为准
2门店编码需要以外部门店编码为准

2.4 调拨数据

调拨数据包含:调拨入库单据、调拨出库单据,均含「下发 / 取消 / 回传」三类场景,通过接口方案实现。

2.4.1 调拨入库

代仓商品货权在乐乐茶,乐乐茶完全把控调拨(移库)入库环节,指定鲜沐某仓库完成相关动作,鲜沐跟随乐乐茶线上指令配合,并将收货入库结果进行部分回传。

调拨入库流程
调拨入库下发 / 回传 / 取消流程(美团(乐乐茶)/ 鲜沐)

调拨入库下发

序号字段规则
1调拨单号需要以外部调拨单号为准,不关注鲜沐调拨单号
2仓库编号合作仓库编码/名称,线下梳理后提供给美团
3商品编码需要以外部商品编码为准
4规格单位按最小规格单位进行

调拨入库回传

序号字段规则
1调拨单号需要以外部调拨单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团
3商品编码需要以外部商品编码为准
4规格单位按最小规格单位进行
5批次信息回传时要求回传批次(生产日期)、数量
6入库时间需要有明确的入库时间回传

调拨入库取消

序号字段规则
1调拨单号需要以外部调拨单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团

2.4.2 调拨出库

调拨出库流程
调拨出库下发 / 回传 / 取消流程(美团(乐乐茶)/ 鲜沐)

调拨出库下发

序号字段规则
1调拨单号需要以外部调拨单号为准,不关注鲜沐调拨单号
2仓库编号合作仓库编码/名称,线下梳理后提供给美团,接口调用时需传参
3商品编码需要以外部商品编码为准
4规格单位按最小规格单位进行

调拨出库回传

序号字段规则
1调拨单号需要以外部调拨单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团
3商品编码需要以外部商品编码为准
4规格单位按最小规格单位进行
5批次信息回传时要求回传批次(生产日期)、数量
6出库时间需要有明确的出库时间回传

调拨出库取消

序号字段规则
1调拨单号需要以外部调拨单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团

2.5 库存数据

库存数据包含:盘点单据、报损单据,通过接口方案实现。

2.5.1 盘点

代仓商品货权在乐乐茶。鲜沐仓内盘点有两类场景:① 乐乐茶线下告知鲜沐进行盘点;② 鲜沐日常盘点——均需将盘点结果回传至美团(区分盘盈、盘亏)。

盘点流程
盘点执行 / 结果回传流程(美团(乐乐茶)/ 鲜沐)

盘点结果回传

序号字段规则
1盘点单号以鲜沐盘点单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团
3商品编码需要以外部商品编码为准
4规格单位需要按照最小规格单位进行
5系统库存即当前系统盘点前的库存
6盘点库存即当前系统盘点后的库存
7批次信息回传时要求回传批次(生产日期)、数量
8时间字段需要有明确的时间回传(原文写「出库时间」)

2.5.2 货损(报损)

代仓商品货权在乐乐茶,乐乐茶有要求鲜沐可主动发起报损单,需鲜沐将报损结果回传至美团。

货损流程
货损出库执行 / 结果回传流程(美团(乐乐茶)/ 鲜沐)

货损结果回传

序号字段规则
1报损单号以鲜沐报损单号为准
2仓库编号合作仓库编码/名称,线下梳理后提供给美团
3商品编码需要以外部商品编码为准
4规格单位需要按照最小规格单位进行
5批次信息回传时要求回传批次(生产日期)、数量
6出库时间需要有明确的出库时间回传
三

接口目录(共 24 个)

API LIST
注:所有下发的单据,均支持撤销后,以同样的业务单据号进行推送。
序号模块具体接口接口方向备注
1基础数据商品下发美团→鲜沐
2基础数据门店下发美团→鲜沐
3基础数据供应商下发美团→鲜沐
4采购数据采购入库下发美团→鲜沐
5采购数据采购入库回传鲜沐→美团部分结果回传接口
6采购数据采购入库取消美团→鲜沐
7采购数据采购退货下发美团→鲜沐
8采购数据采购退货回传鲜沐→美团最终结果回传接口
9采购数据采购退货取消美团→鲜沐
10销售数据销售出库下发美团→鲜沐即「进货单下发」接口
11销售数据销售出库回传鲜沐→美团即「进货单发货回传」接口
12销售数据销售出库取消美团→鲜沐即「进货单取消」接口
13销售数据销售退货下发美团→鲜沐即「售后下发」接口;售后类型只有「配送后售后」,售后服务类型只有「退款录入账单」「退货退款录入账单」
14销售数据销售退货审核回传鲜沐→美团即「售后结果回传」接口
15销售数据销售退货回传鲜沐→美团新增接口
16销售数据销售退货取消美团→鲜沐新增接口
17调拨数据调拨入库下发美团→鲜沐新增接口
18调拨数据调拨入库回传鲜沐→美团新增接口
19调拨数据调拨入库取消美团→鲜沐新增接口
20调拨数据调拨出库下发美团→鲜沐新增接口
21调拨数据调拨出库回传鲜沐→美团新增接口
22调拨数据调拨出库取消美团→鲜沐新增接口
23库存数据盘点结果回传鲜沐→美团新增接口
24库存数据货损结果回传鲜沐→美团新增接口
接口方向汇总:下发 12 个(美团→鲜沐)+ 回传 7 个 + 取消随下发;其中 15~24 号共 10 个为新增接口。
附

统一接口规则速查

RULES
#通用规则适用范围
1单据编码一律以外部(乐乐茶/美团)编码为准,不关注鲜沐编码全部下发/回传
2规格单位一律按最小规格单位进行全部单据
3仓库编码/名称线下梳理后提供给美团,部分接口调用时需传参涉及仓库的单据
4回传需带批次(生产日期)+ 数量 + 明确出入库时间全部回传
5所有下发单据支持撤销后以同单号重推全部下发
6审核类动作(门店建档、代仓审核、售后审核)由鲜沐人工审核基础数据 / 销售退货

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!

文章目录