二
数据对接
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 | 出库时间 | 需要有明确的出库时间回传 |