日常开单、代签收及一键退转技术方案评审会议纪要
会议时间：2026-06-02
会议摘要：本次评审了日常开单、代签收、一键退货和一键转移等功能的技术方案，明确了三端（SFA、小智、智慧门店）的实现细节、数据互通规则、校验逻辑及报表字段扩展，以及激励发放策略的调整。
一、功能总览
┌──────────────────────────────────────────────────────┐
│ 核心功能矩阵 │
├──────────┬──────────┬───────────┬───────────────────┤
│ 日常开单 │ 代签收 │ 一键退货 │ 一键转移 │
├──────────┼──────────┼───────────┼───────────────────┤
│ 手动操作 │ 分享链接 │ 整单退货 │ 先退货 → 再出货 │
│ 批量导入 │ 身份校验 │ 状态校验 │ 单号变更 │
│ 动态入口 │ 距离控制 │ 失败原因 │ UI 展示方案 │
└──────────┴──────────┴───────────┴───────────────────┘二、各功能详细方案
2.1 日常开单与分享签收
前端展示：根据后端配置动态展示"日常开单"入口，支持两种操作方式：
| 操作方式 | 说明 |
|---|---|
| 手动操作 | 逐条创建出货单 |
| 批量导入 | 通过 Excel 模板批量导入 |
分享签收流程：
分享链接（含 order_id + store_id）
│
▼
接收方小程序打开
│
├──▶ 身份校验
├──▶ 门店距离控制
└──▶ 进入签收流程2.2 代签收流程
三端均支持代签收，核心流程一致但各自独立实现：
小智端 / 智慧门店端
用户点击分享链接 → 登录 → 校验链接参数(门店ID/经销商ID)
↓
与当前登录账号匹配？
/ \
YES NO
↓ ↓
进入签收流程 拒绝并提示原因统一校验规则：
| 校验项 | 规则 |
|---|---|
| 签收距离 | 引入统一的门店距离校验机制 |
| 产品状态 | 已售出/已退货不可签收 |
| 二维码有效期 | 过期链接不可使用 |
| 部分成功处理 | 部分成功部分失败时给出具体失败原因 |
2.3 门店待签收与数据互通
| 场景 | 行为 |
|---|---|
| 进店拜访 | 系统提示"有待签收的数据"，支持代签收操作 |
| 三端数据互通 | 同一出货单在 SFA、小智、智慧门店均可查询和查看 |
关键要求：三端数据必须保持一致性，确保同一笔出货在各端的可见性和状态同步。
2.4 一键退货
业务规则：允许经销商对已出货单进行整单退货。
退货前校验：
| 校验项 | 通过条件 | 失败时提示 |
|---|---|---|
| 单据状态 | 必须为已出货状态 | — |
| 码未被其他门店签收 | 所有码均为未签收状态 | "已售出" |
| 未重复退货 | 该单未执行过退货操作 | "重复退货" |
| 未过期 | 在有效期内 | "已过期" |
2.5 一键转移
业务规则：允许经销商变更出货单的目标门店和出货方式。
核心技术路径：采用 "先退后出"模式。
一键转移
│
├─ Step 1: 按原门店生成退货单 ──────────▶ 原出货单关闭
│
└─ Step 2: 按新门店 + 新方式生成新出货单 ─▶ 新出货单生效影响分析：
| 变更项 | 影响 |
|---|---|
| 出货单号结构 | 因先退后出的路径，单号会发生变化 |
| 二维码有效性 | 原二维码是否仍可访问需确认 |
| B端明细表记录 | 成功和失败的转移操作均需记录 |
2.6 报表字段与激励调整
新增报表字段
| 报表表名 | 新增字段 | 用途 |
|---|---|---|
| B 端出货明细表 | 退货方式 | 记录退货操作类型 |
| B 端出货明细表 | 退货状态 | 当前退货进度 |
| B 端出货明细表 | 退货失败原因 | 失败追溯 |
| 退货单明细表 | （同上） | 同步对齐 |
签收激励调整
| 调整前 | 调整后 |
|---|---|
| 多次签收可能多次发激励 | 仅对首个成功签收的门店发放激励 |
| 存在重复激励风险 | 避免重复激励 |
三、涉及变更范围
| 变更类型 | 具体内容 |
|---|---|
| 接口新增/改造 | 日常开单 CRUD、分享签收、一键退货、一键转移接口 |
| 前端变更 | SFA / 小智 / 智慧门店三端 UI 改造 |
| 数据层 | 出货单、退货单、签收记录表结构扩展；B 端明细表增加字段 |
| 枚举值扩展 | 增加"代门店签收"类型的签收类型、操作类型字典项 |
| 筛选功能 | "扫码查证"页面增加"代门店签收"筛选项 |
四、风险与关注点
| 风险项 | 描述 | 建议 |
|---|---|---|
| 三端一致性 | SFA / 小智 / 智慧门店的签收规则需严格对齐 | 陈德智与梁岩逐条确认 |
| 单号变更影响 | 一键转移后原出货单号失效，历史关联关系断裂 | 明确新旧单号的映射关系 |
| 退货级联风险 | 一键退货需确保码未被其他门店签收 | 强校验 + 明确失败提示文案 |
| 激励准确性 | 首签激励逻辑需与计费服务联动验证 | 联调测试重点覆盖 |
五、待办事项
| 序号 | 待办内容 | 责任人 | 分类 |
|---|---|---|---|
| 1 | 对齐三端（SFA、小智、智慧门店）的签收校验规则，确保一致性 | 陈德智、梁岩 | 技术方案 |
| 2 | 对齐"代门店签收"场景下的签收类型、操作类型等字典项，更新文档 | 陈德智、梁岩 | 字典对齐 |
| 3 | 对齐"一键转移"后出货单号结构变更带来的影响 | 陈德智、梁岩 | 影响评估 |
| 4 | 对齐三端"一键转移"的 UI 展示方案（原单/新单信息展示） | 梁岩、陈德智 | UI 方案 |
| 5 | 对齐"一键退货"场景下前端商品列表的操作历史展示 | 梁岩、陈德智 | UI 方案 |
| 6 | 接口中增加"代门店签收"类型枚举值，报表提供对应展示 | 陈德智 | 后端开发 |
| 7 | "扫码查证"页面增加"代门店签收"筛选选项 | 陈德智 | 功能开发 |
| 8 | 对齐"一键退货"失败原因的统一命名（如"重复退货"） | 梁岩、陈德智 | 命名规范 |
| 9 | 对齐"一键转移"后原二维码有效性及影响评估 | 梁岩、陈德智 | 影响评估 |
| 10 | 对齐"一键转移"后 B 端出货明细表的记录逻辑（成功/失败均记录） | 梁岩、陈德智 | 数据逻辑 |
六、结论
- 核心路径明确：一键转移采用"先退后出"模式。
- 三端协同是关键：SFA / 小智 / 智慧门店需严格保持签收规则一致。
- 激励防重机制：仅首签发放激励，避免重复发放。
- 待办密集：陈德智 + 梁岩共 10 项待办，需尽快安排专项对齐。