一、系统

（一）库存报表零售报表重命名及顺序调整

业务背景：为了统一使用规范报表，方便使用，做了统一调整,后续会陆续对其它报表进行调整报表名称调整：

原报表名称	修改后名称
POS销售分析（含子商品）	POS销售查询（含子商品）
预售单跟踪报表	预售单查询报表
店铺秒杀库存	店铺秒杀库存查询
店铺缴款报表	店铺缴款查询报表
店铺收款汇总表	店铺收款汇总报表
全渠道销售查询	全渠道销售汇总查询
全渠道收款查询	全渠道收款汇总查询
促销商品明细查询	促销商品查询报表
销售\库存对照表	销售\库存对照报表
竞品销售分析	竞品日销售查询
POS运营分析报表	POS运营分析
POS收款分析报表	POS收款分析
商品销售统计与指标分析	商品销售趋势分析
商品价格分析表	商品价格分析
促销活动分析表	促销活动分析
库存查询报表	库存查询
可用库存占用报表	可用库存占用查询
虚拟库存报表	虚拟库存查询
组合商品库存报表	组合商品库存查询
库存预警查询报表	库存预警查询
云仓库存汇总表	云仓库存汇总查询
其它出入库报表	其它出入库汇总报表
商品储位报表	商品储位查询
后仓出入记录查询	后仓出入明细查询
调拨查询	调拨报表
店铺缺货率统计表	店铺缺货率统计报表
调拨有效性分析表	调拨有效性分析报表
调拨质量分析表	调拨质量分析报表
进销存	库存分析
商品售罄分析表	商品售罄分析

位置调整：

路径	报表名称	调整路径
库存>库存报表>库存概览	库存概览	移到库存分析 库存>库存分析>库存概览
库存>库存报表>库龄分析报表	库龄分析报表	移到库存分析 库存>库存分析>库龄分析
零售>零售报表>促销活动分析表	促销活动分析表	移到零售分析下面 零售>零售分析>促销活动分析报表

（二）我的工作台-增加【会员】、【配补调导图】导图

三、报表订阅

1、应用场景：

• 对于报表使用人员：希望报表的推送可以实现自主选择，预览某张报表，自己感兴趣或者有工作需求等情况，可以快速完成订阅推送，而不需要再反馈给报表管理人员，由管理人员再进行配置。对某个报表的推送需求期过了，也可以快速完成取消订阅，无需反馈给报表管理员。
• 对于报表开发人员：一些强制要求的报表推送，希望是不以使用者意愿为主导的，即使取消也是要进行反馈，有管理员进行同意的。一些常规项的报表推送，希望释放工作精力，由使用者自己完成。

2、功能描述：

此插件支持主要功能如下：

• 支持cpt和frm报表预览页面的添加订阅配置
• 订阅消息推送终端包括 邮箱、原生APP、企业微信、钉钉
• 订阅消息推送类型包含 报表快照链接、附件（pdf/word/excel03/excel07）

（四）POS收银-店务-增加入库单&出库单功能

1、业务背景：

门店日常需开展采购、批发等业务，涉及入库、出库、调拨等各类库存操作，但这些操作的入口分散在不同系统模块中，导致店铺人员操作路径繁琐、效率低下，需通过聚合操作入口优化操作体验。

2、解决方案：

核心通过新增聚合型工作台 + 优化现有菜单入口，将分散的出入库相关单据整合到统一界面，同时适配总部与店铺端的权限及操作差异，实现出入库操作的集中化、便捷化管理，具体方案如下：

1.库存模块新增【入库工作台】【出库工作台】，聚合所有类型的入库 / 出库单据；

3、操作层面的变化：

（1）核心工作台：入库 / 出库工作台操作规则

1.功能权限控制【入库工作台】：用户需具备「采购入库单、销售退货入库单、调拨入库单、其他入库单」中任意一张单据的【查看】权限，菜单才会显示，否则隐藏；【出库工作台】：用户需具备「采购退货出库单、销售出库单、调拨出库单、其他出库单」中任意一张单据的【查看】权限，菜单才会显示，否则隐藏。

2.查询条件配置（分总部 / 店铺端差异）表格

查询条件	总部端配置	店铺端配置
业务组织	必填、多选，默认当前用户所属组织	隐藏该字段，无需手动选择
仓库名称	必填、多选	隐藏该字段，锁定当前店铺对应的仓库，仅查询该仓库单据
单据类型	必填、多选，默认全部；仅显示用户有【查看】权限的单据类型	同总部端逻辑，仅显示有权限的单据类型
单号 / 手工单号 / 来源单号	非必填，支持左匹配查询	同总部端逻辑
商品编码	非必填，最少输入 3 位，匹配规则按参数 Sys0069（模糊 / 左匹配）控制	同总部端逻辑
单据状态	非必填、多选	同总部端逻辑
开单日期	必填，默认日期按参数 Sys0101 控制；调拨类单据按「调出日期」筛选	同总部端逻辑
生效日期	非必填，默认空	同总部端逻辑
业务状态	入库单：待入库（未审核 / 已送审 / 已审核）、已入库（已生效）、全部；出库单：待出库、已出库、全部	同总部端逻辑

3. 列表展示与核心操作

• 列表字段：统一展示单据类型、单号（超链接）、手工单号、开单日期、来源数量、实际数量、差异数量、结算金额、业务组织、仓库名称、往来单位等核心信息（店铺端隐藏组织、仓库字段）；
• 往来单位区分：采购类对应供应商、批发类对应客户、调拨类对应出入库仓库；
• 新增功能：点击「新增」可下拉选择有权限的单据类型，跳转至对应单据的新增详情页；
• 单据跳转：点击列表中「单号」，根据单据类型 + 单号跳转至对应单据详情页，可进行修改、保存、审核等操作（权限按用户功能权限控制）；
• 数据聚合逻辑：入库单聚合采购 / 销售退货 / 调拨 / 其他入库单数据，出库单聚合采购退货 / 销售 / 调拨 / 其他出库单数据，按对应仓库维度筛选。

二、资料

（一）客户资料-业务员改为多选

1、业务员数据权限管控需求：

• 客户&业务员数据权限管控
• 客户资料基础表新增字段：其它业务员。 下拉多选，字典取当前客户所属组织下的职员信息
• 角色资料-其它权限： 新增“按其他业务员过滤客户”权限控制复选框，角色权限按该权限与“按业务员过滤客户”权限的并集进行控制

2、解决方案：

• 1.客户资料-业务员字段 调整为：多选，默认第一条为默认业务员，用户可以再调整
  • 增加客户业务员表：客户ID、职员ID、默认业务员
  • 根据当前组织选取业务
  • 导入Execl，增加业务员编码字段，多个业务员以逗号隔开
  • 导出Execl，多个业务员以逗号隔开
  • 处理历史数据：根据当前营业员生成到客户业务员表，并为默认业务员
• 2.获取客户资料接口中业务员字段调整
  • 业务员调整取默认业务员字段
• 3.角色资料-其他权限- 按业务员过滤客户
  • 由等于改包括，即只要当前职员在业务员例表中就可以看到该客户
• 4.ERP同步到中台
  • 调整写入到业务员表并设置为默认业务员

（二）闭店申请 -店铺范围由所属组织改为管理组织

背景：闭店申请新增时，现只能选取用户所属组织店铺

目的：店铺范围 由所属组织下店铺调整为管理组织范围下店铺

调整：增加业务组织查询条件，默认所属组织，下拉管理组织

（三）客户资料-加盟店铺

背景： 加盟组织下面店铺向总部组织要货，加盟组织对于总部是内部客户，如何根据店铺确定客户

功能说明：

• 客户资料增加【加盟店铺】页签
  • 当客户性质包括【加盟客户】and 【内部核算单位】，则显示该页签，否则隐藏
  • 加盟客户表字段：店铺编码、店铺名称、组织名称(表字段：客户ID、店铺ID、组织ID

（四）打印模板-导入模板文件替换现有打印模板

背景： 想用已设计好的打印模板替换现有的，现可以导出，但不能导入

调整：

1、编辑模板时增加【导入本地模板】功能

2、导入后显示模板设置的打印字段，然后点立即设置进行设计界面（类新增模板导入）

（五）菜单管理增加其他上级菜单字段

目的： 同一菜单可以在多个位置显示，如采购入库单可以库存下面显示 ，同时可以在采购管理下面显示，但不管从那个位置打开显示同一单据

解决方案：

• 1、菜单管理 增加【其他上级菜单】字段
  • 选取的内容与现有的上级菜单一样
• 2、其他上级菜单与子系统不需要约束为同一子系统
• 3、功能权限设置
  • 两边都可以设置权限，设置权限互通
• 4、如菜单对应的子系统未开通，该子系统下面的菜单挂到其他目录的菜单也不显示
  • 如库存子系统未开通，那么在采购管理下面的采购入库单也不显示

效果如下：

（六）导入执行日志

调整调整前样式：

调整后样式：

三、商品企划

（一）客户配货方案增加店仓配货

业务背景：

客户核心业务为向二级加盟客户（店铺）供货，由仓库和直营店为多家加盟店统一完成配货工作。为满足多加盟店发起要货申请、仓库 + 直营店标准化统一配货的核心业务需求，特制定本要货 / 配货方案，同步完成系统功能的调整与优化，实现要货、配货全流程的线上化、规范化管控。

解决方案：

界面功能变化本次方案落地围绕客户资料、店铺要货单、客户配货方案、客户配货单四大核心模块，完成系统界面的功能新增、调整、优化，具体变化如下：

• （1）客户资料模块：新增加盟客户专属配置界面
  • 新增加盟店页签：客户性质为「加盟客户」且类型为「内部核算单位」时，界面显示该页签，支持选择对应财务组织下的店铺（调用店铺选择通用组件，支持多选）；
  • 新增校验提示界面：当内部核算单位选择的对应财务组织与所属组织一致时，保存失败并弹窗提示「对应财务组织不能与所属组织相同」；
  • 字段管控优化：核心关联字段（财务组织、店铺）增加启用状态过滤，仅显示可用组织 / 店铺。
• （2）店铺要货单模块（零售 POS 端 + 库存中心）：全界面功能新增与细化
• 为零售 POS 端封装店铺要货单入口，库存中心配套完成列表、详情、操作工具栏的全界面功能升级，核心变化：
  • 单据列表界面：
    • 新增多维度筛选控件：开单日期（默认 1 个月）、组织、店铺名称、单号 / 手工单号（支持模糊 + 多单号分隔查询）、单据状态、年份 / 季节 / 品牌 / 类目、审核人 / 修改人、审核 / 修改日期；
    • 新增核心列表字段：业务状态（未生成 / 已生成）、数量（整单合计）、修改 / 审核人及时间（含时分秒）、备注；
    • 新增表格设置功能：支持列表字段排序、冻结、导出配置。
  • 工具栏界面：
    • 新增批量操作按钮：批量送审 / 反送审 / 审核 / 反审核 / 取回，各按钮按权限管控并随单据状态亮显 / 置灰；
    • 新增三种导入方式按钮：按尺码横向、按尺码纵向、按尺码分组，各方式配套专属导入模板下载入口，界面显示导入格式 / 大小 / 版本要求；
    • 新增流转功能按钮：流转销售订单、查看流转进度，进度界面显示执行结果、任务名称、关联单号、创建人 / 时间、执行信息；
    • 优化作废 / 删除按钮：仅对「已生效未生成」「未送审」单据开放，按权限管控。
  • 单据详情界面：
    • 导航栏：新增复制按钮（支持复制其他单据生成新单，可调整组织 / 店铺等核心字段），优化审核 / 流转按钮亮显规则（流转按钮仅「已生效未生成」状态亮显）；
    • 基础信息区：新增必填 / 非必填标注，组织 / 店铺为必填下拉单选，仅显示创建用户有权限的组织、启用状态的店铺；
    • 明细详情区：新增商品过滤功能（按主表品牌 / 类目过滤），新增明细导入 / 导出按钮，列表新增尺码组、各尺码数量、合计字段。
• （3）客户配货方案模块：界面重构 + 多功能新增
• 核心完成「配货对象」拆分与界面重构，新增发货店铺、配货优先级管控、多配货模式界面配置，核心变化：
  • 配货对象界面：
    • 拆分为发货对象、收货对象两个独立页签，调整收货对象在界面中的展示位置；
  • 发货对象子界面：
  • 新增发货店铺配置区域：含新增 / 删除 / 导出 / 导入 / 搜索按钮，列表显示发货顺序、店铺编码 / 名称、预留商品可销天数，支持发货顺序数值排序（不允许重复）、预留天数≥0 数值管控；
  • 新增可配店铺数输入框（必填，1-5），界面显示提示语「发货仓库不满足各客户全部需求时，每个客户剩余未满足量最多可从 N 个店铺进行配货」；
  • 新增时间维度 / 计算维度选择控件：时间维度（近 7 天 / 15 天 / 1 月 / 2 月 / 3 月 / 自定义）、计算维度（商品匹配度高 / 指定顺序，支持拖动排序）；
  • 新增库存来源 / 配货模式下拉选项：库存来源可选「仓库可用库存 / 采购到货量」，配货模式可选「按库存量 / 按指定顺序 / 按尺码匹配度」。
• 配货优先级子界面：
  • 新增功能置灰管控：当发货对象设置发货店铺时，「新增」按钮置灰，不支持按商品结构设置客户优先级；
  • 新增启用弹窗提示：启用方案时若检测到发货店铺配置，弹窗提示「本方案设置了店铺库存进行配货，不支持按商品结构设置客户优先级，是否删除已有商品结构设置并启用方案」，提供「是 / 否」选项。
• （4）客户配货单模块：界面字段新增 + 导入导出优化 + 库存检核界面新增
• 核心完成多仓多店合并发货的界面适配，新增发货仓信息展示、库存检核界面，优化导入导出功能，核心变化：
  • 单据明细界面（多视图统一优化）
    • 商品维度视图：新增发货仓编码 / 名称字段，删除「仓库配前」字段，「商品概况」区新增发货仓名称、仓库配后库存字段，修改配货量时同步联动更新仓库配后库存数值；
    • 店铺维度视图（尺码组 / SKU 视图）：列表均新增发货仓编码 / 名称字段；
    • 单据流转详情列表：新增发货仓编码 / 名称字段，按参数 Sale0012 管控界面展示逻辑（一个 / 多个销售订单对应出货单）。
  • 新增库存检核专属界面
    • 展示多仓库 + 店仓库存合计、店铺需求量、差异数量，按商品条码 / 编码排序；
    • 新增导出方式选择控件（按尺码横向 / 按尺码分组），当配货仓库包含店仓时，自动调整按钮隐藏；
    • 界面显示「库存不足」醒目标识，提供更新库存、导出、关闭操作按钮。
  • 批量导出界面
    • 新增按条码导出选项，配套专属导出模板，导出字段含商品条码、发货仓编码 / 名称等核心信息；
    • 优化「按尺码横向 / 按尺码分组」导出：均新增发货仓编码 / 名称字段，各导出方式均明确排序规则（商品编码→客户编码→发货仓编码 / 商品编码→发货仓编码→客户编码）；
    • 新增导出信息选择项（导出未审核明细 / 导出全部明细）、导出提醒提示语（数量限制、报表保留 30 天）。
  • 批量导入界面
    • 新增按条码导入选项，适配按条码导出的模板，明确必填字段（商品编码、发货仓编码、客户编码、配货量）及字段管控规则；
    • 优化「按尺码横向」导入：新增发货仓编码必填管控，保留原有商品 / 客户编码、数量必填规则；
    • 新增数据处理选项：更新导入、覆盖导入、增量导入，供用户选择数据导入逻辑。

（二）调货单导入有数据检测不过的，能在原excel加一列【验证信息】显示不通过的具体原因

若有检测不通过，在源excel最后一栏后面新增【验证信息】，将检测不通过的具体信息写入进去，用户通过下图的下载，可将excel下载下来看，并修正。

修正后，excel无需要求用户删除【验证信息】列，忽略此列进行导入处理。

若再导入依然有异常，按当前导入的验证信息更新excel。

不包含尺码组、横向模式

下载的EXCEL增加【验证信息】列。把导入错误信息显示出来

四、采购

（一）采购单据列表字段默认排序调整、据筛选条件调整、零售金额、零售金额汇总根据参数零售金额小数位管控

需求：

默认字段也做了默认排序调整，筛选条件也做了变动，采购单据中的零售金额、零售金额汇总需根据参数Sys0005【 零售金额小数位】管控显示；

功能范围：

单据明细字段、明细打印单据范围：采购订单，采购到货单，采购入库单，采购退货单、采购退货出库单、受托代销结算单。

（二）【关联交易】- 关联交易单据生成单据税率取值调整，以及将销售出库单中的出库仓带入到采购单据的备注中

背景：目前关联交易生成的相关单据的税率均取来源单税率，需调整取值逻辑解决方案：

（1）销售生成采购/销售退生成采购退

1、 单据范围：销售生成采购、销售退生成采购退；

2、 现况：取来源单税率；

3、 调整：根据参数Sys0013设置值获取；

• 1.商品＞供应商＞系统参数，先获取商品税率，商品未设置则取供应商，供应商未设置取参数值；
• 2. 供应商＞商品＞系统参数，先获取供应商税率，供应商未设置则取商品，商品未设置取参数值；
• 3.获取税率后，需根据计税方式，按现有计算公式，重算单价、结算价、结算金额；
  • ① 当计税方式是含税：
    • A. 未税原币单价=含税原币单价÷（1+税率）；
    • B. 未税原币结算价=含税原币结算价÷（1+税率）；
    • C. 未税原币结算金额=含税原币结算金额÷（1+税率）；
  • ② 当计税方式=未税
    • A. 含税原币单价=未税原币单价×（1+税率）；
    • B. 含税原币结算价=未税原币结算价×（1+税率）；
    • C. 含税原币结算金额=未税原币结算金额×（1+税率）
    • D. 原币税额=未税原币结算金额×税率；
    • E. 本币税额=未税本币结算金额×税率；

（2）采购退生成销售退

1、 单据范围：采购退生成销售退；

2、 现况：取来源单税率；

3、 调整：根据参数Sys0014设置值获取；

• 1. 商品＞客户＞系统参数，先获取商品税率，商品未设置则取客户，客户未设置取参数值；
• 2.客户＞商品＞系统参数，先获取客户税率，客户未设置则取商品，商品未设置取参数值；
• 3.获取税率后，需根据计税方式，按现有计算公式，重算含税、未税情况下的单价、结算价、结算金额；

（3）关联交易单据备注

1、 销售生成采购：将销售出库单中的出库仓带入到采购单据的备注中；

2、 销售退生成采购退：

a) 如规则设置销售退货单生成采购退单据，则将销售退货单中的仓库带入到采购退货单据的备注中；

b) 如规则设置销售退货入库单生成采购退单据，则将销售退货入库单中的仓库带入到采购退货单据的备注中；

3、 采购退生成销售退：将采购退货出库单中的仓库带入到销售退货单据的备注中；

（一）增加参数管控采购单据取价取到原币单价或原币结算价

1、业务背景：

在采购业务流程中，需实现取价方式获取的价格存入原币结算价，原币单价默认取零售价，并通过结算价与零售价反算折扣的业务需求，而原有采购单据取价逻辑仅将取价结果存入原币单价，无灵活的字段配置管控能力，无法适配该个性化价格核算需求。为满足企业采购价格管理的定制化要求，特新增采购参数管控采购单据取价结果的存放字段，并同步调整全采购业务链路的单据操作、数据计算、导入导出等逻辑。

2、解决方案：

核心通过新增采购组织参数「采购单据取价字段」（默认值为「原币单价」，可选「原币结算价」），以该参数为核心管控依据，对供应商档案、销售转采购、全品类采购单据（订单 / 到货 / 入库 / 退货 / 退货出库）、采购订单变更全采购链路的取价方式、字段编辑权限、价格计算逻辑、导入导出规则进行适配调整，实现取价结果存放字段的灵活配置，同时满足零售价反填原币单价、折扣自动反算的业务要求。

3、核心操作层面的变化

本次调整围绕参数两种取值（原币单价 / 原币结算价），在基础档案、单据操作、数据导入导出三大维度产生核心操作变化，所有采购单据（采购订单、批量采购到货单、无来源采购入库单 / 退货单 / 退货出库单、采购订单变更）均遵循统一调整逻辑，具体如下：

• 1.基础档案：供应商资料取价方式选项管控
  • 参数为「原币单价」：取价方式枚举值保持现有逻辑，为「商品进货价、零售价、采购价格表、最后一次采购价」；
  • 参数为「原币结算价」：取价方式隐藏「零售价」选项，仅保留「商品进货价、采购价格表、最后一次采购价」，操作中无法选择零售价作为取价依据。
• 2.核心单据操作：全采购单据统一调整规则
  • 所有采购单据的主表取价方式、明细字段权限、商品新增 / 录入逻辑均按以下规则调整，采购订单变更同步遵循此逻辑：
  • 主表取价方式调整
    • 原币单价模式：取价方式选项不变，无额外字段管控；
    • 原币结算价模式：隐藏「零售价」选项，计税方式固定为「含税」、货币固定为「本位币」且不可编辑；若选择「最后一次采购价」，系统自动过滤历史单据中取价方式为零售价的单据，不纳入价格参考。
  • 明细字段编辑权限调整
    • 原币单价模式：「原币单价」可编辑，「原币结算价」按现有逻辑由系统计算；
    • 原币结算价模式：「原币单价」只读不可编辑（默认取商品零售价，优先级：组织零售价→商品档案零售价），「原币结算价」改为可编辑；折扣无需手动维护 / 获取供应商折扣，由系统自动按「折扣 = 原币结算价 / 原币单价」反算。
  • 商品新增 / 录入操作调整（含新增、商品二维录入、扫码）
    • 原币单价模式：按现有逻辑，取价方式获取的价格存入「原币单价」，其他字段正常计算；
    • 原币结算价模式：取价方式获取的价格直接存入「原币结算价」，「原币单价」自动填充零售价且只读，折扣按公式自动反算；所有计算方式（折扣 / 结算价 / 结算金额为准）下的价格计算公式保持不变，仅调整字段赋值来源。
• 3.销售转采购：
  • 专属操作校验与失败提示通过销售生成采购订单时，新增参数与供应商取价方式的双重校验，操作层面新增失败提示逻辑：
    • 原币单价模式：按现有逻辑生成单据，无额外校验；
    • 原币结算价模式：若供应商取价方式为「零售价」，系统直接判定生成失败并弹窗提示：「采购单据获取价格到结算价时，供应商的取价方式不能为零售价，请调整供应商的取价方式」；取价方式非零售价时，取价结果存入原币结算价，原币单价填零售价，折扣自动反算。
• 4.数据导入导出：条码 / 尺码导入 + 批量导入的规则调整
  • 所有采购单据的条码导入、尺码导入、批量条码 / 尺码导入均按参数值区分操作规则，核心差异在原币单价赋值、Excel 数据读取优先级，且原币结算价模式下新增固定字段管控，具体如下：
    • 原币单价模式：按现有逻辑操作，Excel 中原币单价为空时，系统自动按取价方式获取价格填充，其他字段正常计算；
    • 原币结算价模式：
      • 基础管控：计税方式默认含税、货币默认本位币，Excel 中对应值不导入；「原币单价」不读取 Excel 数据，统一默认填充商品零售价；
      • 数据读取优先级：按「以折扣为准 / 以结算价为准 / 以结算金额为准」三种计算方式区分 Excel 中折扣、结算价、结算金额的读取优先级（如折扣为准时「折扣＞结算价」，结算价为准时「结算价＞折扣」），未填写的字段由系统按取价方式 + 公式自动计算；
      • 批量导入专属：仅支持导入未审核的订单数据，提供「更新导入、覆盖导入、增量导入」三种数据处理方式，操作时需选择对应方式后再上传 Excel 文件。
• 5.采购单据批量生成：采购到货单专属操作调整
  • 批量生成采购订单 / 采购到货单时，操作逻辑与单据导入一致：
  • 原币单价模式：按现有逻辑批量生成，价格存入原币单价；
  • 原币结算价模式：批量生成时自动将原币单价赋值为零售价，取价结果存入原币结算价，折扣自动反算，且计税方式、货币固定为含税、本位币，不可手动调整。

五、批发

（一）批发单据支持商品编码和名称模糊查找，库存组织调整为只读

单据范围：

销售订单、销售出货单、销售出库单、销售退货单、销售退货入库单、销售变更单和销售出货/退货差异单

需要判断参数：

Sys0069 | 商品模糊查询方式 ：模糊查询/左匹配查询

解决方案：

批发单据支持商品编码和名称模糊查找，按参数Sys0069判断。

库存组织调整为只读，取值等于销售组织

（二）中台批发单据账户资料过滤掉支票账户类型的账户

业务背景：中台批发单据账户资料过滤掉支票账户类型的账户

功能说明：

由于账户资料增加属性：是否支票账户，此部分数据批发单据的账户和流水记录是与支票的账户余额表和流水记录表是分开的，所以，需要管控批发单据不能选择支票账户类型的账户。

送审的时候检查：当账户为支票类型，提示账户类型为支票账户，不能送审单据。

涉及的单据：销售订单、销售出货单、销售出库单、销售退货单和销售退货入库单、批量生成销售订单导入和批量生成销售退货单导入

（三）中台批发增加参数：委托代销的批发单据类型是否生成应收和其他入库单

需求描述：

中台批发增加参数：委托代销的批发单据类型是否生成应收和其他入库单

功能说明：

• 1.、系统参数–》批次参数：委托代销的批发单据是否生成应收单和其他入库单
• 2.销售出库单审核生效逻辑调整
  • 增加判断批发参数Sale0018，当参数=是时，销售出库单主表的单据类型=委托代销，单据生效时，同步生成应收单和暂估应收单，但不生成委托代销虚拟仓库的其他入库单。当参数=否时，销售出库单主表的单据类型=委托代销，单据生效时，不同步生成应收单和暂估应收单，但生成委托代销虚拟仓库的其他入库单！
• 3.销售退货入库单审核生效逻辑调整
  • 增加判断批发参数Sale0018，当参数=是时，销售退货入库单主表的单据类型=委托代销，单据生效时，同步生成应收单和暂估应收单，但不生成委托代销虚拟仓库的其他出库单。当参数=否时，销售退货入库单主表的单据类型=委托代销，单据生效时，不同步生成应收单和暂估应收单，但生成委托代销虚拟仓库的其他出库单！
• 4.关联交易生效的销售出库单和销售退货入库单触发单据生效逻辑同步调整–(参照第2和第3点)
• 5.奇门回传的销售出库单和销售退货入库单触发单据生效逻辑同步调整–(参照第2和第3点)
• 6.当Sale0018=是时，销售出库单和销售退货入库单需要同步到ERP，把单据同步erp的状态改为是；当Sale0018=否时，销售出库单和销售退货入库单不需要同步到ERP，把单据同步erp的状态改为否！

（四）现货、特价销售订单商品明细增加可用库存的显示

需求背景：

现货销售订单商品明细增加可用库存的显示

功能说明：

1.当销售订单新增和修改时，主表的销售类型=现货或特价时，商品明细表增加库存数量显示字段。显示的是库存中心返回的条码的可用库存数量。库存数量放的位置在数量和原订单数量之间。销售类型=期货，库存数量字段不显示。

注意：单据送审后，单据审核状态排除未送审和已退审两个状态，其他审核状态的库存数量字段不显示，此数据为临时显示数据，不保存到销售订单的商品明细表中。

2.在单据保存后，未送审时，单据主表的销售类型=现货或特价时，单据详情增加一个复选框查询按钮，名称叫“仅查库存不足”，点该按钮后，仅查询订单数量大于可用库存数量的明细商品。送审单据后，或销售类型=期货，该按钮不可见。

（五）中台委托代销结算调整-增加客户委托代销结算单

1、业务背景：

为规范委托代销业务的结算流程，满足企业对委托代销商品的周期性结算、手工导入清单结算等需求，实现结算数据的自动化汇总、价格精准核算及单据联动生成，特设计「客户委托代销结算单」功能，同步调整销售出库单相关规则，解决原有委托代销结算无统一线上流程、数据核算繁琐、单据关联不清晰等问题，保障结算业务的规范化、高效化开展。

2、解决方案：

核心构建「客户委托代销结算单」全流程功能，支持「按委托销售结算」「手工导入结算清单」两种模式，通过参数配置、数据联动、异步处理等技术手段，实现结算周期内委托代销出入库数据自动汇总、手工清单导入校验、价格金额精准计算，并联动生成销售出库单 / 销售退货入库单及暂估应收单，同时明确单据操作约束与数据处理规则，形成完整的委托代销结算闭环。

3、操作层面的变化

• 1.新增核心单据：客户委托代销结算单
  • ①单据列表操作
    • 筛选项优化：新增「销售组织」「客户」「代销结算模式」「单号」等多维度筛选条件，支持多选、模糊匹配，非集团版自动隐藏「销售组织」筛选项，默认显示当前登录组织相关数据；
    • 列表字段展示：明确展示销售组织、单号、客户、结算周期（开始 / 结束日期）、结算模式、结算金额、单据状态等核心信息，日期仅显示年月日，不展示时间。
  • ②单据详情操作
    • 主表字段配置：
      • 必选字段：销售组织（关联库存组织与委托代销虚拟仓库）、客户、开始日期、结束日期、代销结算模式、结算币种，其中结束日期需≥开始日期且＜当前日期；
      • 智能赋值：客户第一次开单可修改开始日期，后续开单默认取上一单据结束日期 + 1 天（只读）；结算币种默认销售组织本位币，变更后自动刷新汇率；
      • 约束规则：有结算明细后，仅手工单号、备注可修改，其他字段锁定。
    • 明细数据处理：
      • 自动获取数据（按委托销售结算模式）：点击「获取数据」异步拉取结算周期内生效的委托代销销售出库单 / 退货入库单，按 SKU 汇总结算数量，自动过滤启用批次 / 唯一码的商品并提示；支持重新获取时更新已有 SKU、新增缺失 SKU、删除无数据 SKU；
      • 手工导入数据（手工导入结算清单模式）：按计算方式区分导入模板（折扣为准 / 结算价为准 / 结算额为准），需上传含条码、出库数量的 Excel 文件，系统校验数据类型、范围（如折扣 0~1、出库数量非 0），异常数据在 Excel 新增「验证信息」列提示，全量校验不通过则不导入。
  • ③核心操作功能
    • 保存 / 删除：保存时校验必选字段完整性，按委托销售结算模式需检查同一客户同一货币的结算周期是否交叉；删除时需判断是否有后续结算单或已送审，有则禁止删除；
    • 送审 / 审核：送审前校验结算周期无交叉、明细与主表结算金额一致；审核时需检查生效日期不早于库存初始化月份且所在月份未月结，审核通过后自动生成销售出库单（结算数量正数）/ 销售退货入库单（结算数量负数），并扣减库存、生成暂估应收单；
    • 反送审 / 反审核：反送审无特殊约束；反审核需检查生效日期所在月份未月结，且关联的销售出入库单未生成应收单，反审核成功后同步删除关联单据；
    • 联查：单据生效后可联查生成的销售出库单、销售退货入库单；
    • 其他操作：支持单号一键复制、明细表格搜索与字段设置、列表导出。
• 2.销售出库单调整
  • 来源单类型为「客户委托代销结算单」的销售出库单，不产生关联交易单据，且无需填写物流相关字段（如收货人、运输方式），仅需配置核心价格与数量信息。
• 3.数据处理规则变化
  • 价格取数逻辑：零售价优先取组织价格表，再取商品资料；税率按「商品税率→客户税率→销项税率参数」优先级获取，按百分比显示；
  • 小数位处理：结算价、结算金额按客户配置或系统参数（Sys0006）四舍五入，币种有最小面值时（如泰铢 5），按最小面值倍数计算；
  • 权限与约束：分布式锁控制并发操作（默认 10 分钟，超时自动延长），避免重复处理；启用批次 / 唯一码的商品禁止添加到结算明细，操作时弹窗提示。

六、库存

（一）调拨单据扫码保存超时处理

需求背景：

用零售宝APP扫描商品，不会强制保存单据，每扫入商品也不会自动保存，期间会偶然发生扫入商品时卡住提示加载中，约10分钟还是加载不出来，最后无奈返回但是之前扫入的数据都丢失了。

解决方案：

1、扫描弹框组件增加属性【是否存储扫描数据】，如需储存扫描数据，传true，前端记录扫描的数据到浏览器（按单逐个扫描存储）

2、扫描完成后，点击【保存】或【保存并继续】，成功后需删除浏览器存储的扫描数据

3、如果浏览器奔溃或直接关闭扫描界面，再次打开扫描界面，【是否存储扫描数据】为true，如检测到浏览器有未保存的数据（当前单据的），前端弹出提醒“当前单据有未保存的数据，是否带出”，点击确认则带出数据到扫描界面，点击清空则删除浏览器存储的数据。

4、最多只保留3个单的扫描数据，如超过，只记录最新的3个单的数据。

单据范围：调拨申请单、调拨出库单、调拨入库单—-PC和APP同步处理

（二）库存单据未生成单号-录入商品触发保存

背景：

采购模块的单据，新增还未保存，单号为空，此时点击【商品录入】、【商品二维录入】、【扫码】时，前端会检查到当前页面数据必填项是否都已填写，都已填写会自动调用保存接口保存数据；未填写会提示哪些的必填项未填写，客户希望库存中心其它单据也要实现这样的逻辑；

解决方案：

1、库存单据新增时，如果当前还没拿到单号，就点击【商品录入】、【商品二维录入】、【扫码】、等按钮时，先要调用接口保存下当前内容，如必填项未填写，则提示相应的必填项必填，都已填写后，触发单据保存，再弹出相应的功能界面。

涉及单据：调拨申请单、调拨出库单、残次登记单、虚拟调拨单、其它入库申请单、其它入库单、盘盈入库单、其它出库申请单、其它出库单、盘亏出库单、串色串码调整单、库存冻结单、借出单、库存初始化单

（三）盘点单全盘加载商品调整

背景：

盘点单全盘加载商品，把服务商品也加载进去了，全盘加载的商品，界面又无法删除。

解决方案：

• 1.盘点单相关调整—服务商品
  • 盘点计划生成盘点单，过滤服务商品—全盘、抽盘、随机盘等
  • 手工新增盘点单，全盘/抽盘加载商品需过滤服务商品
  • 盘点单明细-更多按钮下点加载商品需过滤服务商品

• 2.盘点单相关调整—商品未启用批次管理，但是库存有批次信息
  • 盘点计划生成盘点单，过滤未启用批次管理商品（库存有批次信息）—全盘、抽盘、随机盘等
  • 手工新增盘点单，全盘/抽盘加载商品需过滤未启用批次管理商品（库存有批次信息）
  • 盘点单明细-更多按钮下点加载商品需过滤未启用批次管理商品（库存有批次信息）
• 3.涉及场景：
  • 场景1：系统参数Sys_batchmanagement设置是，商品启用批次，批次商品正常加载
  • 场景2：系统参数Sys_batchmanagement设置是，商品未启用批次，普通商品正常加载，批次商品不加载
  • 场景3：系统参数Sys_batchmanagement设置否，不论商品是否启用批次，都不加载批次商品

（四）库存单据撤销去掉仓储或第三方物流的判断

业务背景：

现在调拨申请单/其它入库申请单/调拨出库单/其它出库申请单，推送奇门，推送配置配置一般参数【不勾选仓储或第三方物流】，值填是，仓库不用勾选仓储或第三方物流，但是撤销单据的时候还是有判断，需调整。

解决方案：

• 1.现在调拨申请单/其它入库申请单/调拨出库单/其它出库申请单，推送奇门时，推送配置增加一般参数【不勾选仓储或第三方物流】，值填是：
  • 有配置该一般参数，值=是，则撤销单据时去掉对仓储或第三方物流的判断，还是需要判断仓库在推送配置的仓库范围内
  • 没有配置该一般参数，或配置了，值=否，则撤销单据还是需要仓储或第三方物流的判断，同时判断仓库在推送配置的仓库范围内
• 2.涉及应用服务：
  • 出库申请单推送奇门（其它，调拨）
  • 入库申请单推送奇门（其它）
  • 调拨出库单推送奇门
  • 调拨申请单推送奇门（仓内）

（五）调拨出库单库存检查调整

业务背景：

目前中台调拨出库单默认检查的是实际库存，客户希望可以跟ERP逻辑一样，有个参数管控检查的是实际库存还是可用库存

解决方案：

• 1.增加组织参数
  • 参数编码：KC0073 参数名称：调拨出库单库存检查依据
  • 参数值：下拉单选，0、实际库存；1、可用库存；默认0、实际库存
  • 参数说明：管控调拨出库单库存检查依据，设置0，检查实际库存；设置1，检查可用库存
    • 如设置1，要检查库存计算方案是否有配置[预计调出数量(调拨出库单未生效)]
• 2.调拨出库单保存时：
  • 如调出组织参数KC0073设置为0，则还是维持现有逻辑，判断的还是实际库存
  • 如调出组织参数KC0073设置为1，则判断的库存改成判断可用库存
  • 涉及场景：商品录入、商品二维录入、扫码、TXT导入，Excel导入（条码和尺码导入、列表批量导入）、复制单，拉取聚水潭调拨生成中台调拨（跨仓，仓内调拨）、奇门回执生成调拨出库单
• 注意：调账生成调拨出库单、ERP推送中台生成调拨出库单、网络订单发货产生调拨出库单、退货入库产生调拨出库单不受此参数管控，不检测库存。
• 3.调拨出库单送审/审核时；涉及列表批量送审/审核、条件审核、详情页的送审/审核
  • 如调出组织参数KC0073设置为0，则还是维持现有逻辑，判断的还是实际库存
  • 如调出组织参数KC0073设置为1，则判断的库存改成判断可用库存
  • 如调出组织参数KC0073设置为1，则判断的库存改成判断可用库存，保存/送审/审核需排除本单占用的数量

场景1：实际库存不足			场景5：可用库存不足
系统参数	设置值		系统参数	设置值
KC0073	0，实际库存		KC0073	1，可用库存
KC0053	未设置调拨出库单		KC0053	未设置调拨出库单
KC0054	未设置调拨出库单		KC0054	未设置调拨出库单
场景2：实际库存不足			场景6：可用库存不足
系统参数	设置值		系统参数	设置值
KC0073	0，实际库存		KC0073	1，可用库存
KC0053	设置调拨出库单		KC0053	设置调拨出库单
KC0054	未设置调拨出库单		KC0054	未设置调拨出库单
场景3：实际库存不足			场景7：可用库存不足
系统参数	设置值		系统参数	设置值
KC0073	0，实际库存		KC0073	1，可用库存
KC0053	未设置调拨出库单		KC0053	未设置调拨出库单
KC0054	设置调拨出库单		KC0054	设置调拨出库单
场景4：实际库存不足			场景8：可用库存不足
系统参数	设置值		系统参数	设置值
KC0073	0，实际库存		KC0073	1，可用库存
KC0053	设置调拨出库单		KC0053	设置调拨出库单
KC0054	设置调拨出库单		KC0054	设置调拨出库单

• 4.库存不足提示界面的库存数量需按参数KC0073设置显示，如设置实际库存，则显示实际库存;如设置可用库存，则显示可用库存

（六）调拨入库单明细增加复制功能

（七）【APP】- 采购入库单/采购退货出库单唯一码处理

需求背景：

APP采购入库单、采购退货出库单增加唯一码优化处理

需求说明：

• 1. 当参数SYS0025【启用唯一码管理】参数值为否，采购入库单、采购退货出库单商品中的SN标识隐藏不显示；
• 2. 当参数SYS0025【启用唯一码管理】参数值为是：
  • (1) 采购入库单、采购退货出库单启用唯一码管理的商品SN标识默认显示；
  • (2) 根据参数SYS0026【唯一码模式】管控唯一码是否必填：
    • ① 参数值为“全流程唯一码”，采购入库单、采购退货出库单必须录入唯一码，且数量需通过唯一码回写；
    • ② 参数值为“半流程唯一码”，采购入库单、采购退货出库单非必须录入唯一码，且数量允许编辑，如录入了唯一码，则累加数量，唯一码数量与单据数量不作强制绑定，唯一码只作为记录。
• 采购入库、采购退货管控说明：

需求说明：采购入库单唯一码调整。

• 1. 参数SYS0025【启用唯一码管理】参数值为否：
  • (1) 无论商品是否启用唯一码， 均不显示SN标识，数量可编辑；
  • (2) 扫码功能不支持唯一码录入。
• 2. 参数SYS0025【启用唯一码管理】参数值为是：
  • (1) 启用唯一码的商品显示SN图标（没启用的商品不显示）；
  • (2) 点击【SN】弹窗查看当前商品所有条码的唯一码，可删除唯一码，删除唯一码需同步减少对应条码的数量；
  • (3) 参数SYS0026【唯一码模式】参数值为全流程唯一码：
    • ① 启用唯一码商品各条码入库数量默认为0，增加减少按钮置灰，输入数量置灰，不允许编辑，由SKU的唯一码数量回写；
    • ② 启用唯一码商品批量设置数量功能置灰，增加减少按钮置灰，输入数量置灰，不允许编辑；
    • ③ 删除商品需同步删除唯一码；
  • (4) 参数SYS0026【唯一码模式】参数值为半流程唯一码：
    • ① 启用唯一码商品各条码入库数量默认为0，允许编辑，扫条码、唯一码均可增加数量，删除唯一码需同步删除数量；
    • ② 当入库数量由5（其中录入了2个唯一码）调整为1，需同步删除1个唯一码，调整为0则删除所有唯一码；
    • ③ 启用唯一码商品批量设置数量功能，允许编辑。
• 3. 单据送审、反审核时判断单据中的货品是否需要管控唯一码：

（八）盘盈入库单增加操作记录

（九）盘点单/复盘盘点单-分区编码过滤改为精准匹配

（十）分区打印设置-分区编码支持下拉和录入

（十一）库存查询-多维报表调整

库存报表—按明细查询。增加多维报表功能

七、零售

（一）POS使用次卡页面增加“次卡名称”显示

（二）POS当班查询根据SD0167设置管控列表的收款方式金额、退款金额、发票金额、净收现金、找零金额等所有金额项加密显示

（三）店铺日销售、月销售在“正向销售金额”字段后面增加“正向实际结算金额”字段

（四）POS销售分析报表 按POS明细增加【颜色、尺码】字段 ，多维报表增加商品属性、规格

（五）取单界面增加“营业员”字段

（六）【捆绑促销】、【整单促销】导出明细增加：业绩系数

需求描述：

目前【捆绑促销】、【整单促销】导出明细无法导出业绩系数字段，需要增加处理

【捆绑促销】、【整单促销】的“促销信息”、“换购促销”两个页签，按商品级别、按SKU级别、按SKC级别导出明细时，增加导出’业绩系数’的字段

（七）POS销售扫描条码框（编码/条码）选择弹窗记住最后一次选择不要切换到“其他销售类型”重置为条码

换货成功后默认选择仍然显示：编码

（八）维修单列表增加按供应商批量打印

业务背景：

需要按供应商打印维修单货品明细批量处理

功能说明：

• 增加供应商汇总打印按钮
  • 增加维修单循环体循环体
    • 打印字段：序号、供应商（商品供应商）、商品编码、条码、颜色、尺码、数量、维修部位、维修原因、维修权益、购买日期、登记日期、维修仓库、维修单号、店寄仓物流单号。
  • 增加非循环打印字段：打印时间、打印人。

十、会员

（一）活动报名调整

业务背景：

1、活动报名需要不同场次支持不同人员参加，支持不同活动设置；报名人数需要管控最少几人报名，需要填写多个参加活动人员信息。

2、活动报名增加批量选择报名记录批量核销

3、活动报名需要增加黑名单，手动添加黑名单用户手机号。

4、兑奖码核销PC端取消会员卡号录入。

5、需要单场次的活动说明，客户会有比赛类的活动，场次不一样，需要不同的说明。

功能说明：

1、 活动报名增加按场次限制规则

路径：CRM-活动报名

1.基于活动报名配置活动报名的场次信息的操作栏增加【场次限制】，用于以场次的维度限制以下规则：

• 年龄限制：
  • 非必填，限制本场次的报名人群的年龄段范围，控件类型=单选，选项有“不限制”、“指定年龄”，默认值“不限制”，当选择“指定年龄”时，出现区间输入框，分别输入最小年龄和最大年龄，仅支持录入数字，开始区间小于等于结束区间。
  • 选项说明：
    • ① 不限制：表示本场次没有年龄限制，任何年龄都可以报名。
    • ② 自定义设置：表示本场次使用自定义的年龄范围，用户需要输入最小年龄和最大年龄。
  • 增加提示：若限制年龄端，必须先在自定义字段启用“身份证号”字段的搜集，否则该限制失效。
• 每人每次最低报名人数（本场次）：
  • 即每人每次报名本场次的最低人数要求本，非必填，单选，选项有“不限制”、“限制最低”。默认值为“不限制”，选择“限制最低”时，输入具体人数。选项：
    • a. 不限制：表示本场次没有最低报名人数要求，即使只有1人报名也可以成行。
    • b. 限制最低：表示本场次有最低报名人数要求，需要输入具体数值。
  • 每人最大报名人数（本场次）：即本场次的最大报名人数，非必填，单选，选项有“继承活动设置”、“自定义设置”。选择“自定义设置”时，输入具体人数。选项：
    • a. 继承活动设置：表示本场次使用活动级别的每人最大报名人数设置。
    • b. 自定义设置：表示本场次使用自定义的每人最大报名人数。
• 活动详情（本场次）：
  • 非必填，单选，选项有“继承活动设置”、“自定义设置”。选择“自定义设置”时，显示富文本编辑器。选项：
    • a. 继承活动设置：表示本场次使用活动级别的详细描述。
    • b. 自定义设置：表示本场次使用自定义的详细描述。

2.增加【报名信息填写配置】，必填，0只填写一次， 1按报名数量填写，默认值为0，若设置为0，提交活动报名信息，不管选择多个报名数量，仅需填写一个报名人员的信息；若设置为1，则根据当前报名的人员数量填写，若报名数量为N个，则报名人员也需要填写N个人。

2、C端-活动报名调整

路径：C端小程序-活动报名-活动详情

• C端活动报名详情页，每个场次需要显示生效的配置。
  • 活动详情：显示场次自己的描述或活动描述。
  • 提交报名：显示场次的限制条件及报名人信息填写限制。
  • 年龄限制：若有限制才显示，显示“XX岁-XX岁”。
  • 每人每次最低报名人数： “最低报名XX人”。
  • 每人最大报名人数：显示“最多报名XX人”（注意，如果场次选择继承活动设置，则显示活动设置的人数）。

3、 报名校验逻辑调整

• C端用户在添加参与人信息时，增加以下校验：
  • 年龄：如果场次有年龄限制，则校验每个参与人的年龄，通过报名人录入的身份证号，截取年份年月日判断是否符合年龄段。
  • 具体实现方式：
    • ① 用户提交活动报名时，需要录入身份证号。
    • ② 在报名时，解析身份证号得到出生日期，然后计算的周岁年龄。
    • ③ 与场次设置的年龄限制（最小年龄和最大年龄）进行比较，判断是否在允许范围内。
  • 前端录入身份证号验证规则：(护照）
    • Ø 必须为18位（新版）
    • Ø 前17位必须为数字
    • Ø 最后一位可以是数字或X（大小写均可）
    • Ø 出生日期必须合法且不能是未来日期
  • 身份证号规则：
    • 18位：7-14位为出生年月日，格式为YYYYMMDD。
• 在提交报名时，增加以下验证：
  • 每人最大报名人数：校验当前用户在该场次已经报名的人数加上本次报名的人数是否超过限制。
  • 每人每次最低报名人数：验证当前用户本次报名的人数是否小于最低报名人数，如果未达到最低人数，则提示：该场次最低报名人数为2，请调整后重新提交。

4、 活动报名记录批量核销

路径：CRM-活动报名

活动报名记录增加批量核销功能。

• 1. 功能权限控制：只有开启【批量核销】功能的用户，才在前端显示【批量核销】按钮。
• 2. 按钮显示条件：在“全部”和“未使用”页签下，只有当报名凭证的状态为“未使用”时，操作栏才显示【核销】按钮。非未使用的状态的明细，该按钮不可见。
• 3. 核销方式：支持单个核销或勾选批量核销。
  • 单个核销：直接点击操作栏的【核销】按钮，弹出确认框，确认后调用核销接口，传入该报名凭证记录的ID。
  • 批量核销：首先需要勾选多条记录（只能勾选状态为“未使用”的记录），然后点击【批量核销】按钮，弹出确认框，确认后调用批量核销接口，传入选中的报名凭证记录ID数组。
• 4. 点击【核销】或【批量核销】按钮，弹出二次弹窗界面确认，内容如下：
  • 标题：核销确认
  • 内容：根据单个或批量显示不同的提示信息：
    • 批量核销提示信息：“确认核销选中的X条报名记录吗？此操作不可逆，请谨慎操作!”

• 单个核销提示信息：“核销后，该报名凭证（123423424）将变为已使用状态，此操作不可逆，请确认信息无误。”

操作按钮：【取消】、【确认核销】

• 5. 在弹窗页面点击【确认核销】按钮调用后端接口《核销报名凭证》接口，核销时候支持部分成功，接口返回后，根据返回结果，显示结果弹窗。结果弹窗显示成功和失败的数量，以及失败的具体原因（可展开）。
  • 场景：全部成功：提示“成功核销 X 条记录”

• 部分成功：提示“成功核销 X 条记录，Y 条记录失败”，并展示失败原因（查看失败详情）

• 全部失败：提示“核销失败”，并展示失败原因

5、 活动报名黑名单

路径：CRM-活动报名-黑名称设置

为活动报名增加黑名单管理功能，通过限制特定用户参与活动，有效防范恶意报名、违规行为等风险。

黑名单管理列表：

查询条件：

• 会员卡号：支持会员卡号查询
• 手机号码：支持手机号查询
• 会员姓名：支持会员姓名查询
• 拉黑时间：时间范围查询（开始-结束时间）

黑名单管理列表展示字段：

• 会员卡号
• 会员姓名
• 手机号码
• 拉黑时间
• 拉黑原因
• 操作人
• 创建时间
• 操作（删除）

黑名单功能说明：

1.添加黑名单（单个添加）：点击【添加黑名单】按钮，显示录入添加信息的弹窗页面；

• 拉黑用户：必填，支持搜索选择已有会员，通过录入会员卡号/手机号码查询会员
• 拉黑原因：非必填，可录入拉黑该用户的原因，最长字符数100字。
• 操作人：只读，默认当前操作的用户。

2.手工导入（批量添加，参考“CRM-门店预约-黑名单导入的方式实现”）

点击【手工导入】按钮，以EXCLE导入的方式添加黑名单记录

采用异步的方式导入，导入成功后，可以在导入记录中下载导入结果，提示导入的结果成功/失败（失败原因）

导入模板下载：【会员卡号（必填）】、【拉黑原因（非必填，最大长度10个字）】

3.删除：支持批量勾选多条记录批量删除 或 通过操作栏的删除按钮 单条删除

• 删除前弹出二次确认：
  • 批量删除提示：确认删除以下5条黑名单记录吗？ 删除后立即解除对这些用户的限制。
  • 单条删除提示：确认删除该用户（会员卡号：ASBGW）的黑名单记录吗？ 删除后立即解除对此用户的限制。

4.添加黑名单验证逻辑：

• 必填栏位不能为空；
• 同一个会员不能重复添加黑名单；
• 已删除的黑名单记录可以重新添加；
• 一旦拉黑，则会员对当前会员中心下所有的活动报名无法进行报名。

C端报名增加验证是否黑名单用户

在拉黑期间将被限制无法提交活动报名，在C端点击提交报名时，增加验证是否被加入黑名单，若该用户是黑名单，则返回提示：亲爱的用户，您的账号异常，当前暂无法报名此活动！

6、中台报名核销去掉会员验证

路径：CRM-日常管理-报名核销

优化报名核销流程，简化操作步骤，提升核销效率。取消核销前【选择会员】的验证步骤，直接基于报名凭证进行核销操作。

调整点：

1、 界面去掉【选择会员】模块

2、核销接口需相应调整为不需传入会员ID

（二）积分兑券

业务背景：

为提升用户活跃与健康参与度，用户可将每日运动步数按比例兑换为平台积分或成长值。

功能说明：

1、动态面额优惠券管理

路径：CRM-卡券营销-卡券库

创建/编辑卡券库时，券号生成方式=“发放自动生成“的 ，当卡券类型=代金券时，并且开启了“多次核销券”，优惠类型增加【动态面额】参数，用于设置“动态面额”的代金券。当优惠类型设置为“动态面额”，【卡券面额】字段设置项不可见。

CRM涉及发放优惠券的功能，在选择卡券定义时需要过滤“动态面额的代金券“的数据，不支持选择此类型的优惠券。

以下为中台CRM涉及发券的功能，需要过滤数据：

中台CRM涉及到选择卡券定义的活动：卡券发送、券包、兑换策略（兑换单券、兑换券包）、拼券、扫码领券、注册有礼、消费有礼、充值有礼、升级有礼、签到有礼、邀请有礼、问卷活动、生日有礼、活动报名、支付有礼、导购派券、礼品卡购卡有礼、大转盘、刮刮卡、老虎机、扭蛋机、抢红包、摇一摇、拆盲盒、娃娃机

2、积分兑券管理列表

路径：CRM-会员营销-积分兑券

积分兑券活动管理列表说明：

• 1、 新增【积分兑换券】功能菜单，支持权限管控：新增、编辑、删除、导出、作废
• 2、进入积分兑换券管理列表时，根据当前用户的角色资料管辖的组织范围与规则设置的【所属组织】匹配查询数据，只展示当前用户管辖的组织范围的数据。
• 3、积分兑换券活动列表页签：全部、未审核、未开始、进行中、已失效，以下是各个页签的查询条件：
  • 全部：所有数据
  • 未审核：审核状态=未审核
  • 未开始：审核状态=已生效 且 活动状态=未开始
  • 进行中：审核状态=已生效 且 活动状态=进行中
  • 已失效：会有2种场景，单据作废或活动结束 都为已失效
    • ①作废场景：审核状态=已作废 且 活动状态=已失效；
    • ②结束场景：审核状态=已生效 且 活动状态=已结束；
  • 列表明细页面审核状态及活动状态展示逻辑：
    • 未送审—》活动状态统一展示为“未开始”
    • 已退审—》活动状态统一展示为“未开始”
    • 已生效—》活动状态根据活动时间判断，有未开始、进行中、已结束
    • 已作废—》活动状态统一展示为“已失效”
• 4、筛选条件支持：活动编码、活动名称、所属组织（支持下拉多选，获取用户当前所管辖的组织范围）、活动时间（开始年月日-结束年月日）、创建人
• 5、积分兑换券列表明细字段包含：活动编码、活动名称、开始时间、结束时间、审核状态、活动状态、创建人、创建时间、操作（编辑、活动效果）
  • 点击编辑，进入活动详情页面
  • 点击活动效果，进入查询当前活动的兑换效果

3、活动设置

路径：CRM-积分兑券-活动设置

活动设置增加页面标题设置，支持定义C端活动页面的顶部标题，最大长度为10个字，默认值为“积分兑券”。

4、创建/编辑积分兑换券活动

路径：CRM-会员营销-积分兑换券

点击【新增】按钮，进入创建积分兑换券活动，具体规则如下：

• 基本活动设置：
  • 活动名称：必填，用于管理后台的活动标识名称，最多30字符；配置后，左侧的预览图跟随动态展示。
  • 活动时间：必填，控制活动可参与的时间范围，开始时间必须早于结束时间； 配置后，左侧的预览图跟随动态展示。
  • 兑换人群：必填，控制可参与活动的用户范围，二选一：0 全部会员；1. 指定会员等级（可多选），默认值为全部会员。配置后，左侧的预览图跟随动态展示。
  • 兑换比例：必填，积分与优惠券面额的换算比率，格式：X积分 = 1元，X为大于0的正整数，示例：100积分=1元。配置后，左侧的预览图跟随动态展示。
  • 开启积分基数：非必填，开启/关闭，默认为关闭，若开启后，开启后用户输入必须为指定倍数。如配置100积分=1元，则积分基数=100积分，则需要为100的整倍数，即100积分、200积分、或300积分等，以此类推。
  • 兑换卡券：必填，选择卡券，单选，查询条件：仅获取卡券库中卡券类型=代金券&支持多次核销&面额类型=动态面额&状态为审核生效的卡券定义列表。
• 兑换限制规则：
  • 兑换上限：必填，单笔兑换的积分上限。可选：0. 不限制 1. 自定义（1-999999之间的正整数），默认值为不限制，超过上限不可兑换，兑换上限要大于等于最低兑换
  • 最低兑换：必填，单次兑换的最低积分要求，低于此值无法触发兑换；可选：0. 不限制1. 自定义（1-999999之间的正整数）；默认值为不限制；最低兑换小于等于兑换上限。
  • 兑换次数上限：必填，单个用户每日可发起兑换的次数。可选：0. 不限制1. 自定义（1-100次），默认值为不限制；配置后，左侧的预览图跟随动态展示。
• 活动装修配置：
  • 背景图：非必填，不填时显示默认图片，支持上传自定义图片；配置后，左侧的预览图跟随动态展示。
  • 兑换规则：必填，用于填写积分兑换券活动的规则说明，最大长度3000个字符。配置兑换规则后，左侧的预览图跟随动态展示。
• 活动编码生成规则：
  • 保存单据时，自动生成唯一的活动编码，生成规则格式：业务类型(2位，积分兑券固定前缀EX) + 年月日(8) + 序列号(6)
  • 示例：EX20240315000001
  • 活动审核生效后，在进行期间允许编辑以下字段，其他字段限制在活动期间不允许修改：
    • 活动名称
    • 活动时间（该字段活动进行期间支持编辑，只允许延长）
    • 活动页面装修（页面标题、兑换规则）

5、C端-积分兑换券活动流程

路径：C端小程序-积分兑换券活动页面

1.C端-积分兑换券活动入口以及取值

入口：商城个人中心/会员中心小程序，增加【积分兑券】菜单入口，由后台装修个人中心的工具栏配置是否启用。同时支持从从公众号推文的小程序入口进入，或通过好友分享的小程序卡片、分享海报进入。

活动取值逻辑：

• ①活动筛选条件：
  • 活动的使用范围符合当前店铺
  • 活动审核生效
  • 活动结束时间大于当前时间
  • 若匹配到有多个活动同时满足时，返回多个活动，按开始时间升序排列展示。
• ②取值场景：
  • 当前时间匹配不到有效活动 → 显示缺省图“暂无活动，敬请期待”
  • 活动有效期内 → 显示该活动
  • 活动已结束/已作废 →显示缺省图“暂无活动，敬请期待”

2.会员中心装修增加“积分兑券”入口

路径：商城-商家中心-商家个人中心、会员中心装修

由CRM提供【积分兑券】页面路径给商城，在会员中心以及商城的个人中心装修进行配置【积分兑券】的工具入口。启用后前端才可展示该入口。

3. C端-积分兑换券流程

①活动列表页面展示

进入兑换列表页面时，判断用户是否有登录小程序，若没有登录需要弹出授权登录的页面，登录后才返回当前活动列表页面。

• 活动列表展示内容：
  • 显示用户当前积分
  • 兑换记录”入口，点击后跳转查询当前会员在该小程序参与的所有的兑换记录
  • 活动筛选标签：全部、进行中、即将开始
    • 全部：显示当前店铺所有符合条件的活动列表，按活动开始时间倒序显示；
    • 进行中：显示当前店铺可兑换的活动列表，按活动开始时间倒序显示；
    • 即将开始：显示当前店铺未开始的活动，按活动开始时间倒序显示；
• 活动卡片展示：
  • 活动图标、活动名称、活动状态（进行中/即将开始/已结束）、活动时间、兑换比例、“立即兑换”按钮
• 状态逻辑：
  • 进行中：按钮可点击，点击可跳转至兑换详情页
  • 即将开始：按钮置灰，点击可跳转至兑换详情页

②兑换详情页面展示内容

• 进入详情页时，判断用户是否有登录小程序，若没有登录需要弹出授权登录的页面，引导用户先完成登录再返回活动页面，登录后获取用户当前积分和兑换比例。
• 封面图：非必填，根据后台配置展示，若后台有上传背景图，则显示，否则该区域不可见。
• 活动信息：展示活动标题、活动时间
• 等级限制标识：根据后台规则中“兑换人群”配置显示，若配置为全部会员，则显示“全部等级”，若配置的指定等级，则显示“仅限XXX等级名称，XXX等级名称参与”；
• 兑换上限限制标识：根据后台规则中“兑换次数上限”配置显示，若开启了限制，则前端显示“每日限兑N次”的标识；
• 我的积分：获取当前用户剩余可用的积分，需扣减已占用的积分；
• 消耗积分：输入框，提示“请输入积分数”，最大不能超出当前可用积分。输入时验证当前活动是否有开启【倍数限制配置】，若开启了，当用户输入时，验证输入值是否为积分基数的整数倍，如果不是，则显示错误提示，并禁用兑换按钮。若没有开启，则可以自定义输入。
• “全部”按钮：点击可将输入框填充为当前可用积分（前端验证兑换规则，单笔最低以及单笔上限）
• 兑换金额：根据输入的积分和兑换比例实时计算显示，初始为0.00
• 立即兑换：初始为禁用状态（或正常状态，但点击后校验），点击后触发兑换流程
• 兑换规则：展示兑换规则说明

2. 输入积分流程

用户可以在输入框中手动输入数字，或点击“全部”按钮自动填充。当用户输入时，实时校验输入内容：

a. 只能输入数字。

b. 输入值不能超过当前积分余额。

c. 输入值必须满足兑换规则：不能低于最低积分数，且不超过上限值。在输入过程中，实时计算兑换金额并显示。根据输入值的有效性，控制“立即兑换”按钮的状态（有效时启用，无效时禁用）。

3. 点击“全部”按钮流程点击后，将当前用户积分余额填充到输入框，需判断兑换规则：

a. 如果用户积分余额小于需消耗的积分值，则提示“积分不足，无法兑换”。

b. 如果用户积分余额大于需消耗的积分值，则根据单笔上限填充。

c. 如果后台开启了【倍数限制配置】，若用户积分余额不是积分基数的整数倍，则向下取整到最近的整数倍（例如，积分基数=100，若用户积分余额为412则取400）。填充后，重新计算兑换金额，并启用“立即兑换”按钮。

4.优惠券展示初始状态显示“–元”，需要用户输入积分才可显示输入积分后实时显示对应面值优惠券详情（优惠券名称、有效期）

5. 点击“立即兑换”流程用户点击“立即兑换”按钮，弹出二次确认框，显示当前输入是消耗积分、以及将获得优惠券的面额。按钮：取消/确认兑换

在二次弹框界面中点击【确认兑换】按钮，则进行校验（活动状态、消耗积分是否足够、卡券库存）。校验通过后，弹出确认框，提示兑换成功，并显示兑换结果详情（获得代金券名称、面额、券码、有效期）。在弹窗中点击【查看我的优惠券】，跳转到个人中心查询我的优惠券记录。

兑换成功：显示成功提示，并更新用户积分余额，兑换金额清零，输入框清空。兑换失败：根据失败原因显示相应提示（如积分不足、活动已结束等）。详情页按钮不同场景提示1. 兑换记录页面：点击“兑换记录”进入查询当前会员在当前小程序店铺兑换的成功的记录，按兑换时间倒序展示，兑换记录包括：兑换优惠券金额、券名称、券号、兑换时间、变动积分。

6、中台CRM-生成积分兑换券记录

路径：CRM-卡券营销-兑换明细

用户在C端兑换成功优惠券后，在”CRM-卡券营销-兑换明细”生成兑换记录，增加“兑换类型”=积分兑券，用于记录通过积分兑换券活动产生的兑换明细。仅写入以下字段，其他字段为空：主表：

【兑换单号】：兑换成功后生成唯一的兑换单号；

【会员卡号】：参与兑换的会员的会员卡号；

【手机号码】：参与兑换的会员的手机号码；【会员姓名】：参与兑换的会员的会员姓名；

【会员等级】：参与兑换的会员的会员等级名称；

【兑换类型】：增加“积分兑动态面额券”类型

【变动类型】：减少，积分兑换券的场景只有积分减少的类型

【兑换名称】：兑换的优惠券的卡券名称

【兑换数量】：兑换优惠券的数量

【消耗积分】：兑换优惠券消耗的积分

【渠道类型名称】：发起兑换的店铺名称

【平台类型】：小程序发券的兑换行为标记“积分商城”

【规则名称】：存活动ID，根据类型获取当前兑换记录关联的积分兑换券的活动名称；

【兑换时间】：发起兑换的时间，格式：年月日时分秒 明细表

【卡券编码】：兑换成功的卡券编码；

【卡券名称】：兑换成功的卡券名称；

【卡券类型】：卡券类型

【面额/折扣】：本次使用积分兑换的优惠券的实际面额；

【卡状态】：当前卡券的状态

【有效开始时间】：卡券的有效开始日期，格式年月日时分秒

【有效结束时间】：卡券的有效结束日期，格式年月日时分秒若通过积分兑换券活动管理列表的操作栏的【兑换明细】点进进入，前端传入【兑换类型】=”积分兑换动态券”，且【规则名称】=“当前活动ID” ，查询当前活动的所有兑换明细。

7、中台CRM-写入积分流水

路径：CRM-积分流水

通过积分兑券活动触发的积分变动记录，需要写入 对应的积分流水，变动活动来源=积分兑动态面额券活动，变动活动名称记录该活动名称。

8、中台CRM-写入卡券发放明细表

路径：CRM-卡券营销-卡券发放明细表

1、用户在C端发起兑换，并扣减积分成功后，给当前用户发放优惠券时，该发券记录需要写入“卡券发放明细表”，并在【面额/折扣】字段中写入券定义面额上限，【多次核销券余额】记录当前兑换的实际券余额；

2、“活动来源类型”：通过该活动发放的动态面额优惠券，增加活动来源类型为“积分兑换动态面额券”；

3、“活动名称”：显示当前发券记录关联的积分兑换券的活动名称；

（三）礼品卡销售记录礼品卡销售记录新增备注字段

（四）礼品卡磁道内容及团购卡转移功能

业务背景：

每个实体卡生成唯一的加密磁道内容，用卡时需要出示实体礼品卡，仅支持通过刷卡识别磁道，解密后匹配礼品卡卡号。（不支持录入方式）

功能说明：

1、 中台CRM-礼品卡磁道加密

路径：CRM-礼品卡资料

1.CRM对于实体卡类型的礼品卡明细增加【加密磁道】字段，用于记录实体卡类型的加密磁道数据，该字段需要支持导出印卡。

涉及功能页面：

①CRM-储值管理-礼品卡资料-礼品卡详情-卡明细； 仅实体卡类型的才有值，电子卡类型的字段值显示为“-”；

②CRM-储值管理-礼品卡查询，以上路径的查询卡明细的地方都需要增加此字段，排序在【密码】字段之后，仅实体卡类型的才有值，电子卡类型的字段值显示为“-”；

2.创建/编辑礼品卡资料，针对类型=实体卡，生成礼品卡明细时增加按明细生成唯一的【加密磁道】数据。涉及以下场景需要生成加密磁道：创建实体卡类型，且生成方式=自动创建，在审核单据时触发生成礼品卡明细时

在礼品列表操作追加礼品卡明细时

3.【加密磁道】生成规则：32字符数，随机生成。由于仅支持刷卡，磁道数据必须符合ISO 7811/7813标准，采用第二磁道（Track 2）格式，长度生成32位字符数。

4.实体卡&手工导入类型，导入模版需增加导入【加密磁道】字段创建实体卡类型，生成方式=手工导入，导入礼品卡明细的模版需增加【加密磁道】字段，非必填，长度限制在20-100字符数之间，导入时验证合法性以及唯一性，加密磁道不允许重复。

5.涉及查询礼品卡的逻辑需要调整为 支持按 礼品卡卡号 或 磁道内容 查询

1) 对接POS结算-添加礼品卡收款方式-手工添加礼品卡时，可通过 刷卡/录入 查询礼品卡。（需要考虑卡号截取规则 从第二位开始）

对接场景：POS查询礼品卡时，可以通过刷卡/录入卡号，传入 礼品卡号 或 磁道内容，CRM根据POS传入的giftCardCode，优先根据礼品卡号匹配，没有再匹配磁道内容。

2) 中台/POS内嵌礼品卡销售 刷卡/录入卡号 查询礼品卡

路径：CRM-储值管理-礼品卡销售，POS-礼品卡销售

对接场景：礼品卡销售，在查询礼品卡时可以通过刷卡/录入卡号，传入 礼品卡号 或 磁道内容，后端根据传入的礼品卡卡号，优先根据礼品卡号匹配，没有再匹配磁道内容。

3) 中台/POS内嵌礼品卡退卡 刷卡/录入卡号 查询礼品卡

路径：CRM-储值管理-礼品卡退卡，POS-礼品卡退卡

对接场景：礼品卡退卡，在查询礼品卡时可以通过刷卡/录入卡号，传入 礼品卡号 或 磁道内容，后端根据传入的礼品卡卡号，优先根据礼品卡号匹配，没有再匹配磁道内容。

4) 中台礼品卡批发 刷卡/录入卡号 查询礼品卡

路径：CRM-储值管理-礼品卡批发

对接场景：礼品卡批发，在查询礼品卡时可以通过刷卡/录入卡号，传入 礼品卡号 或 磁道内容，后端根据传入的礼品卡卡号，优先根据礼品卡号匹配，没有再匹配磁道内容。

2、中台CRM-团购卡明细批量转移

对于团购卡，已制卡但未销售的礼品卡明细，需要调整【消费折扣】（如88折改为85折）

举例：礼品卡编码A ， 子类型=团购卡 ， 折扣0.8 —》卡号明细：A1-A2-A3

礼品卡卡号A1已销售—》不允许转移

礼品卡卡号A2\A3 未销售—》支持转移，子类型=团购卡， 礼品卡编码A02折扣0.7\A03折扣0.9

转移到新的礼品卡编码后，则按转移后的礼品卡的规则执行。

实现方式：基于礼品卡查询功能，针对礼品卡明细的类型=团购卡，并且状态=“待销售”的礼品卡明细增加【转移】功能，通过该功能可将未销售的礼品卡明细批量转移到同一礼品卡的子类型的其他礼品卡编码。

1.触发入口与条件

路径：中台CRM-礼品卡查询-列表页

按钮名称：【转移】

显示逻辑：礼品卡查询列表页的礼品卡明细的“子类型”=“团购卡”且“状态”=“待销售”且“正常”，则在明细的操作栏显示【转移】。

2.礼品卡明细转移操作流程

步骤1：选择团购卡明细 通过手动勾选，选择需要转移的礼品卡明细。

步骤2：发起转移 点击【转移】按钮，弹出“团购卡转移设置”弹窗。

步骤3：设置转移目标 弹窗内容：

显示已选择 的转出明细，展示：卡号、礼品卡名称、礼品卡编码、子类型、面额、售价、有效期。目标礼品卡编码（必选，只能选择一个礼品卡编码）：

• 新有效期设置：
  • 选项1：【沿用目标礼品卡默认规则】- 系统自动计算。
  • 选项2：【自定义统一有效期】- 用户需选择“开始日期”和“结束日期”。日期选择器需做逻辑校验（结束日期 > 开始日期），结束日期必须大于当天。
  • 注意：前端根据当前所选的目标礼品卡编码对应的礼品卡资料配置的有效期判断，若目标礼品卡的有效期配置为”动态有效期”，则该规则的选择值默认选中选项1，禁用选项2；若目标礼品卡的有效期配置为”固定有效期”，则显示2个选项，并判断为必填。
• 操作组织：必填，根据当前用户所管辖的组织范围选取其中一个组织；
• 操作店铺：必填，根据当前所选的业务组织获取店铺列表进行选取其中一个店铺；
• 操作员：只读，默认带出当前用户；
• 操作确认提示：“转移后，所选卡的折扣、规则将按新礼品卡策略执行，此操作不可逆。请确认！”

步骤4：确认执行 用户点击【确认转移】，系统执行更新操作。

步骤5：结果反馈成功：弹出成功提示“成功转移 Y 张卡”，关闭弹窗，刷新列表。部分或全部失败：弹出详细结果提示“操作完成：成功 Y 张，失败 Z 张。失败原因：[具体原因，如：卡XXX状态已变更，无法操作]”。

3.后台逻辑规则

增加二次校验：点击确认时，对所选的礼品卡明细重新校验“类型”和“状态”，防止在操作期间被修改。

• 校验通过的卡明细，原礼品卡卡号不变，需要更新以下字段：
  • 礼品卡ID / 礼品卡编码：变更为目标ID。
  • 礼品卡名称：变更为目标礼品卡的名称
  • 面额类型：变更为目标礼品卡的资料配置的面额类型。举例：若原卡类型是固定面额，目标礼品卡是动态面额，则需要重置为动态面额。
  • 面额：变更为目标礼品卡的资料配置的面额值。举例：若原卡是固定面额，目标礼品卡是动态面额，则需要重置面额字段为空值，售卡时再指定面额。
  • 售价：变更为目标礼品卡的资料配置的售价。举例：若原卡是固定面额，目标礼品卡是动态面额，则需要重置售价字段为空值。
  • 有效期开始时间 / 有效期结束时间：按用户选择的新规则更新。
  • 是否启用密码：变更为目标礼品卡资料配置的是否启用密码规则，若为启用，需要生成新的卡密。

记录本次操作日志：操作行为（转移），操作时间，操作人，新增一个备注字段记录（转移前后礼品卡编码）。

权限管控：增加对于明细的“礼品卡转移”功能权限管控，仅限拥有“礼品卡转移”的功能权限的用户才可操作。

3、 日常批量变更功能增加【礼品卡转移】

路径：CRM-日常管理-批量变更

1.基于现有的批量变更的类型，增加【礼品卡转移】的设置，采用后台作业任务的方式实现，如下图所示：

2.点击【礼品卡转移】并点击下一步按钮时，进入查询变更的页面，如下图：

点击【添加礼品卡】按钮，获取当前会员中心的礼品卡明细（查询条件：礼品类型=实体卡，卡子类型=团购卡 且状态=待销售 且 状态=正常），如下图所示：

说明：若操作的是“礼品卡转移”类型，添加礼品卡的弹窗界面中筛选条件需要锁定只查询 礼品卡子类型=团购卡、销售类型=未销售、状态=正常

查询并勾选对应礼品卡明细后，点击【确认】按钮，把所选的数据添加至待变更的列表，如下图所示：

3.当选择变更类型为【礼品卡转移】，则批量变更的内容需要设置 <目标礼品卡编码>，必填，控件类型=下拉带查询的多选。

4.设置完操作员的信息后， 点击【执行】则生成变更任务，异步执行变更作业。

• 礼品卡转移变更失败情况：
  • ① 新失效时间需要大于礼品卡的原有效结束日期，否则不允许变更；
  • ② 礼品卡状态为非正常状态的，即状态为：冻结、作废，不允许变更。

5.变更成功后，对应的礼品卡卡号的归属的礼品卡编码以及礼品卡明细的相关字段更新，同时需要写入<批量变更记录>，点击<批量变更列表-查询记录>中可查询具体的变更记录。

（五）优惠券叠加使用增加互斥规则

业务背景：

目前代金券与代金券是否一起使用根据卡券库的“可累计使用”管控，代金券与折扣券是否一起使用根据卡券库的“不同类型券同时使用”管控，兑换券只可以使用单张。按目前的逻辑，没办法管控某些具体的券不能一起使用，需要增加互斥规则进行管控。本次调整的券类型包括代金券与折扣券，不包括兑换券和商场券。券平台包括:恒康券、平台（抖音、美团）、品牌（李宁券、UA券）、三方会员（EZR券、南讯券、数云券），包括代金券面额、代金券赠品、折扣券。

功能说明：

1、CRM增加【优惠券互斥规则】

路径：CRM-卡券营销-优惠券互斥规则

• 1.新增【优惠券互斥规则】功能菜单，支持权限管控：新增、编辑、删除、导出、作废。
• 2.活动列表页签：全部、未审核、未开始、进行中、已失效，以下是各个页签的查询条件：
  • 全部：所有数据
  • 未审核：审核状态=未审核
  • 未开始：审核状态=已生效 且 活动状态=未开始
  • 进行中：审核状态=已生效 且 活动状态=进行中
  • 已失效：会有2种场景，单据作废或活动结束 都为已失效
    • ①作废场景：审核状态=已作废 且 活动状态=已失效；
    • ②结束场景：审核状态=已生效 且 活动状态=已结束；
  • 列表明细页面审核状态及活动状态展示逻辑：
    • 未送审—》活动状态统一展示为“未开始”
    • 已退审—》活动状态统一展示为“未开始”
    • 已生效—》活动状态根据活动时间判断，有未开始、进行中、已结束
    • 已作废—》活动状态统一展示为“已失效”
• 3.筛选条件支持：活动编码、活动名称、所属组织（支持下拉多选，获取用户当前所管辖的组织范围）、活动时间（开始年月日-结束年月日）、卡券编码、卡券名称、创建人
• 4.列表明细字段包含：活动编码、活动名称、所属组织、开始时间、结束时间、审核状态、活动状态、创建人、创建时间、操作（编辑）点击编辑，进入活动详情页面

2、CRM创建/编辑优惠券互斥规则

在管理列表中点击【新增】按钮，进入创建优惠券互斥规则

活动设置：活动名称：必填，用于管理后台的活动标识名称，最多30字符；

活动时间：必填，控制活动可参与的时间范围，开始时间必须早于结束时间；

活动编码：非必填，只读，创建时系统自动生成的唯一编码；保存单据时，自动生成唯一的活动编码，生成规则格式：业务类型(2位，此活动固定前缀HC) + 年月日(8) + 序列号(6) 。示例：HC20240315000001

所属组织：必填，下拉单选，根据当前用户所管辖的组织范围内选取一个业务组织；

优惠券：必填，添加参与互斥活动的优惠券，至少添加一个卡券编码。点击【新增】按钮弹窗获取当前可配置的优惠券数据进行添加：

卡券定义查询条件如下：

券号生成方式=发放自动生成&外部券号

卡券类型=代金券（包括 面额、赠品、动态面额类型，以及单次核销券、多次核销券）、折扣券；

卡券审核状态=已生效；

获取当前会员中心所有的卡券数据；

卡券库中勾选了【可累计使用】 或 勾选了【不同类型券同时使用】；（目前这个地方可能会修改，在没有发券之前可以修改的）

同一个卡券编码在”优惠券区域”与”互斥券区域”允许同时存在；

“优惠券区域”中同一个卡券编码不允许重复添加。

斥券：必填，至少添加一个卡券编码。配置后 优惠券与互斥券不能同时使用。

查询条件如下：

• 券号生成方式=发放自动生成&外部券号
  • 卡券类型=代金券（包括 面额、赠品、动态面额类型，以及单次核销券、多次核销券）、折扣券；
  • 卡券审核状态=已生效；
  • 卡券库中勾选了【可累计使用】 或 勾选了【不同类型券同时使用】；（目前这个地方可能会修改，在没有发券之前可以修改的）
• 券号生成方式=发放自动生成&外部券号
  • 卡券类型=代金券（包括 面额、赠品、动态面额类型，以及单次核销券、多次核销券）、折扣券；
  • 卡券审核状态=已生效；
  • 卡券库中勾选了【可累计使用】 或 勾选了【不同类型券同时使用】；（目前这个地方可能会修改，在没有发券之前可以修改的）

同一个卡券编码在“”优惠券区域”与“互斥券区域”允许同时存在。

“互斥券”区域中同一个卡券编码不允许重复添加。

“互斥券”允许跨会员中心选取卡券数据，根据系统参数（是否商场模式 系统参数：MemberIsShoppingMall）判断是否可以查询多个会员中心的卡券；若参数值=是，则根据当前用户的管理的会员中心组织，若当前管理的是有1个以上的会员中心，则需先弹窗选择其中一个会员中心，再选择卡券。如值管理1个会员中心，则不弹出选择会员中心，默认按当前会员中心查询卡券数据；若参数值=否，则维持现有的逻辑，不弹出选择会员中心的界面，直接进入选取当前会员中心的卡券。

场景1：参数值=否，选取方式

场景2：参数值=是，仅有1个会员中心的选取方式

场景3：参数值=是，并且有1个以上的会员中心的选取方式

当参数=是，可以支持添加其他会员中心的优惠券，根据当前用户的所管辖的会员中心，若会员中心大于1时，弹窗需选择其中一个会员中心，单选，选择后根据该会员中心获取优惠券进行添加；若会员中心就只有1个时，则不弹窗，直接进入添加卡券界面。

使用范围：限制哪些组织店铺范围支持参与此互斥规则，根据当前用户管辖的组织范围获取数据进行配置。

保存时校验规则的必填，对于“优惠券”、“互斥券”区域的优惠券条件的验证，验证通过后需要对单据进行审核，审核生效才执行此活动。活动审核生效后，在进行期间允许编辑以下字段，其他字段限制在活动期间不允许修改：活动名称活动时间（该字段活动进行期间支持编辑，只允许延长）

3、CRM对接POS查询优惠券接口逻辑调整

1.CRM增加【优惠券互斥规则】，用于设置优惠券之间不可用的卡券模板，模板可选择店铺范围、有效日期内，不可用的优惠券卡券模板。优惠券可选择代金券面额、代金券赠品、折扣券，规则中设置的优惠券，在对应的店铺日期范围内不可一起使用，超过活动日期后可一起使用。

2.如果同一个卡券模板在日期范围内有多个互斥规则，则互斥券模板按所有的规则汇总返回。

例如店铺天河城店，存在以下两个互斥规则：如果是在2025.11.21消费使用，则新人入会券不可一起使用的券包括：50元代金券、100元代金券、双十一狂欢券、双旦优惠券、新年赠送券

优惠券互斥规则名称	日期范围	优惠券	互斥券
天河城互斥规则1	2025.11.1~2026.3.12	新人入会券	50元代金券100元代金券双十一狂欢券

优惠券互斥规则名称	日期范围	优惠券	互斥券
天河城互斥规则2	2025.11.20~2026.5.12	新人入会券	50元代金券双旦优惠券新年赠送券

3.涉及对接恒康卡券库的券范围：

恒康券、平台（抖音、美团）、品牌（李宁券、UA券）、三方会员（EZR券、南讯券、数云券），包括代金券面额、代金券赠品、折扣券。

4、PC端POS销售根据互斥规则管控用券说明

1.POS销售，根据CRM设置的【优惠券互斥规则】管控用券，涉及的销售类型包括：正常销售、团购销售、预售单开立、预售单销售、次卡销售、缺货销售、B品销售；

2.涉及的优惠券类型包括：代金券面额、代金券赠品、折扣券；

3.恒康券、平台（抖音、美团）、品牌（李宁券、UA券）、三方会员（EZR券、南讯券、数云券）；

4.使用券判断互斥券场景

【会员优惠】界面使用券，包括手工选择券，在查询框中录入券使用。

购物车界面录入折扣券。

收款界面录入粉丝券，包括普通券、抖音券、美团券。

5.代金券与代金券是否可以一起使用，先根据“可累计使用”判断，如果勾选可累计使用，再判断券是否有互斥券。

券未勾选“可累计使用”：按目前规则判断，券不可一起使用。

券勾选“可累计使用”，且未设置互斥券规则：按目前规则判断，同时勾选可累计使用的券可一起使用。

券勾选“可累计使用”，且设置互斥券规则：设置互斥的券不可一起使用，不在互斥规则的券可一起使用。

例如新人入会券，设置了互斥券50元代金券、100元代金券、双十一狂欢券，则新人入会券在天河城店，在2025.11.1~2026.3.12期间不可与这些券一起使用。

优惠券互斥规则名称	日期范围	优惠券	互斥券
天河城互斥规则1	2025.11.1~2026.3.12	新人入会券(可累计使用)	50元代金券(可累计使用)100元代金券(可累计使用)双十一狂欢券(可累计使用)

6.代金券与折扣券是否可以一起使用，先根据“不同类型券同时使用”判断，如果勾选“不同类型券同时使用”，再判断券是否有互斥券。

券未勾选”不同类型券同时使用“：按目前规则判断，券不可一起使用。

券勾选”不同类型券同时使用“且未设置互斥券规则：按目前规则判断，同时勾选不同类型券同时使用的代金券和折扣券可以一起使用。

券勾选”不同类型券同时使用“且设置互斥券规则：设置互斥的券不可一起使用，不在互斥规则的券可一起使用。

7.判断是否可一起使用，根据整单判断，即不判断券只有部分商品使用的场景，需将所有已选择的券，与当前券进行判断，只要一张券与当前券不可一起使用，都不能添加。例如存在以下券：

券类型	券名称	可累计使用	不同类型券同时使用	互斥券
代金券	新人入会券	是	是
代金券	50元代金券	是	是	新人入会券
代金券	100元代金券	是	是
代金券	元旦券	否	是	100元代金券
折扣券	8折券		否
折扣券	7折券		是	50元代金券

例如先使用【新人入会券】、再使用【100元代金券】可用，再使用【元旦券】不可用，由于元旦券未勾选”可累计使用“。

例如先使用【新人入会券】、再使用【100元代金券】可用，再使用【8折券】不可用，由于8折券未勾选”不同类型券同时使用“。

例如先使用【新人入会券】、再使用【100元代金券】可用，再使用【50元代金券】不可用由于【新人入会券】和【100元代金券】都勾选”可累计使用“，并且没有互斥范围，所以两张券可用。再使用【50元代金券】，虽然【50元代金券】勾选”可累计使用“，但【50元代金券】与【新人入会券】互斥，不可用，提示：【已选择的”新人入会员券“与当前券不可一起使用】

例如先使用【50元代金券】、再使用【100元代金券】可用，再使用【7折券】不可用由于【50元代金券】和【100元代金券】都勾选”可累计使用“，并且没有设置对方为互斥范围，所以两张券可用。再使用【7折券】，虽然【7折券】勾选”不同类型券同时使用“，但【7折券】与【50元代金券】互斥，不可用，提示【已选择的”50元代金券“与当前券不可一起使用】

8.预售单销售单，需要同时判断预售单开立中已使用的优惠券。

9.退换货，不需要判断这些属性。

5、APP端和PAD端POS销售根据互斥规则管控用券说明

1.POS销售，根据CRM设置的【优惠券互斥规则】管控用券，涉及的销售类型包括：正常销售、团购销售、缺货销售。

2.涉及的优惠券类型包括：代金券面额、代金券赠品、折扣券；

3.涉及的平台包括：恒康券\品牌（李宁券、UA券）

4.使用券判断互斥券场景：【会员优惠】界面使用券，包括手工选择券，在查询框中录入券使用。收款界面录入粉丝券。

5.代金券与代金券是否可以一起使用，先根据“可累计使用”判断，如果勾选可累计使用，再判断券是否有互斥券。券未勾选“可累计使用”：按目前规则判断，券不可一起使用。券勾选“可累计使用”，且未设置互斥券规则：按目前规则判断，同时勾选可累计使用的券可一起使用。券勾选“可累计使用”，且设置互斥券规则：设置互斥的券不可一起使用，不在互斥规则的券可一起使用。例如新人入会券，设置了互斥券50元代金券、100元代金券、双十一狂欢券，则新人入会券在天河城店，在2025.11.1~2026.3.12期间不可与这些券一起使用。

优惠券互斥规则名称	日期范围	优惠券	互斥券
天河城互斥规则1	2025.11.1~2026.3.12	新人入会券(可累计使用)	50元代金券(可累计使用)100元代金券(可累计使用)双十一狂欢券(可累计使用)

6.代金券与折扣券是否可以一起使用，先根据“不同类型券同时使用”判断，如果勾选“不同类型券同时使用”，再判断券是否有互斥券。券未勾选”不同类型券同时使用“：按目前规则判断，券不可一起使用。券勾选”不同类型券同时使用“且未设置互斥券规则：按目前规则判断，同时勾选不同类型券同时使用的代金券和折扣券可以一起使用。券勾选”不同类型券同时使用“且设置互斥券规则：设置互斥的券不可一起使用，不在互斥规则的券可一起使用。

7.判断是否可一起使用，根据整单判断，即不判断券只有部分商品使用的场景，需将所有已选择的券，与当前券进行判断，只要一张券与当前券不可一起使用，都不能添加。例如存在以下券：

券类型	券名称	可累计使用	不同类型券同时使用	互斥券
代金券	新人入会券	是	是
代金券	50元代金券	是	是	新人入会券
代金券	100元代金券	是	是
代金券	元旦券	否	是	100元代金券
折扣券	8折券		否
折扣券	7折券		是	50元代金券

例如先使用【新人入会券】、再使用【100元代金券】可用，再使用【元旦券】不可用，由于元旦券未勾选“可累计使用”。

例如先使用【新人入会券】、再使用【100元代金券】可用，再使用【8折券】不可用，由于8折券未勾选“不同类型券同时使用”。

例如先使用【新人入会券】、再使用【100元代金券】可用，再使用【50元代金券】不可用由于【新人入会券】和【100元代金券】都勾选“可累计使用”，并且没有互斥范围，所以两张券可用。再使用【50元代金券】，虽然【50元代金券】勾选“可累计使用”，但【50元代金券】与【新人入会券】互斥，不可用，提示：【已选择的“新人入会员券”与当前券不可一起使用】

例如先使用【50元代金券】、再使用【100元代金券】可用，再使用【7折券】不可用由于【50元代金券】和【100元代金券】都勾选“可累计使用”，并且没有设置对方为互斥范围，所以两张券可用。再使用【7折券】，虽然【7折券】勾选“不同类型券同时使用”，但【7折券】与【50元代金券】互斥，不可用，提示【已选择的“50元代金券”与当前券不可一起使用】

6、次卡使用对账报表

背景：财务需要以次卡销售的角度查看次卡核销剩余次数以及核销明细。

九、订单

（一）售后单反审核后，手工修改延长时间处理

业务背景：

售后单自动审核通过后，客户需要修改售后单信息，操作人员便将该售后单手工反审核。但在修改信息的过程中，还没有修改完信息，审核策略又自动将该售后单重新生效了。

功能说明：

售后单主表后台增加【反审核时间】字段（注：这个字段前端是没有的），售后单每次手动反审核时，系统自动把当前时间记录到这个字段里。后续审核策略自动审核时，先做判断：

如果当前时间 > 反审核时间 + 3分钟，才允许自动审核；

如果还没满3分钟，则不允许自动审核，并将未审核原因记录为：“因售后单反审核，延迟3分钟生效”。

注：手动审核售后单不受延迟时间的控制

（二）网络订单中允许查看被合并的订单

业务背景：

目前已被合并的网络订单，在网络订单查询页面无法查询到，需求：在网络订单查询界面中，可正常展示、查询到已被合并的订单。

功能说明：

网络订单列表增加【被合并单】页签，点击后展示查询条件范围内的被合并的订单，订单只能查看，不允许编辑。 详情页只可以操作【返回】和【上下页切换】

（三）网络订单【缺】标签逻辑调整

业务背景：

订单已占用库存，导致可用库存为0，系统显示缺货状态标签，容易让操作人员误判该订单无法正常发货。

功能说明：

当可用库存仅剩1件时，若该库存已被当前单据占用，则当前单据不显示“缺”标签。

（四）有赞电子面单对接

业务背景：

为保障消费者及商家数据安全，防止因数据泄露造成商家和用户损失，有赞逐步将关键收货信息加密，并限制开发者解密的次数。基于这样的背景下，那有赞平台产生的订单又如何发货呢。所以这一套开放能力帮助ISV服务商在没有收货信息的明文数据下，来保证发货业务的正常。

功能说明：

商家在有赞可参考这个操作手册完成电子面单开通：https://help.youzan.com/displaylist/detail_4_4-2-85520

在电子面单增加物流平台类型增加【有赞微商城】

打印组件对接：有赞电子面单打印，调用的是菜鸟打印组件，在取号完成后，有赞会返回与菜鸟云打印机交互的报文，所以使用有赞电子面单打印需要安装菜鸟打印组件

（五）电子面单-使用仓库优化

背景：

客户现在设置电子面单是门店都是用同一个电子面单的，快递小哥同意上门取件并打印面单，不想每次增加店铺都要增加到明细。

解决方案：

1、新增/编辑电子面单，增加【应用范围】，使用仓库调整为【指定仓库】、【仓库条件】，默认【指定仓库】

指定仓库：就是现有的添加仓库的设置模式

仓库条件：新模式，需添加业务组织和选择相应的仓库条件；

（六）未启用中台零售，仅退款售后单反审核调整

背景：

有部分客户没用中台零售模块，发货后进退款的售后单生效后，系统参数DS0031设置是，中台没有生成单据，有生成了一代冲账POS，此时客户又去修改了仅提款售后单的金额，导致跟一代的冲账POS金额对不上。

解决方案：

1、中台未启用中台零售，如系统参数DS0031设置是，仅退款售后单生效后，不允许反审核。

2、中台未启用中台零售，如系统参数DS0031设置否，仅退款售后单生效后，还是允许反审核。

（七）销售申请换货后再申请仅退款冲账调整

背景：

销售单发货后申请换货，换货完成后再申请仅退款，无法审核和冲账。

解决方案：

查找来源单明细，用售后单号来源网单号+（来源子交易号或子交易号）作为条件查找，确保能找到来源单明细，来进行审核。

（八）仅退款售后单允许编辑明细金额

背景：

目前仅退款售后单，明细的结算金额是不允许编辑的，如想调整金额只能找开发后台处理。

解决方案：

• 1、退货类型=仅退款的售后单，退款类型=售后，单据状态=未送审/已退审时，
  • 明细的【结算金额】调整为可编辑状态，修改后要写操作日志。格式：条码XXX的结算金额由X改成X；
  • 退款类型=售后，修改后保存的【结算金额】不能大于来源单的可退金额；
  • 再次下载售后单，售后单类型发生变化，取最新的售后单的金额和数量
• 2、售后单保存更新已退金额计算逻辑说明，条件和计算方法如下：
  • 重算条件：退货类型=仅退款的售后单，退款类型=售后，状态不等于“作废”
  • 重算条件：退货类型=正常退货 的售后单，退款类型=售后，状态不等于“作废”
  • 计算逻辑：后端计算前端提交的明细金额与后端明细的金额比较差异（+-），判断已退金额+差异金额<=来源单金额，允许保存。当已退金额+差异金额>来源单金额需要返回提示信息给前端：来源单明细{xxx}条码的结算金额是{00.00}，已申请售后已退金额是{00.00}，本次修改已超过来源单的金额，请检查是否已开了多张售后单，或金额调小再保存。

（九）店铺自提收件人信息检测调整

背景：

手工新增的网络订单，物流方式选择“店铺自提”，保存的时候没有填写收件人和手机，保存成功，送审的时候提示“手机和座机不能同时为空”，填写了手机和收件人之后保存又无法保存成功。

解决方案：

手工新增网络订单，不论物流方式是哪种，收件人和手机都改为必填，不填不允许保存； 物流方式=店铺自提的，保存成功后，收件人和手机允许多次修改进行保存，同时店铺自提送货地址信息可以不用维护。

（十）刷单订单处理方案

背景：

现在平台有部分是刷单的订单，希望恒康可以标记此类订单，发货后不扣减库存。

解决方案：

• 1.标签库调整—-基础数据调整—-要执行脚本
  • 系统增加标签库字段优化及系统任务执行，对特殊网络订单进行标签维护。
• 2.标签策略和网络订单打标签可以选择到特殊单这个标签组和标签名称
  • 业务状态=已发货，订单不允许打特殊单标签
• 3.订单打上【特殊单】标签的处理逻辑：
  • 场景1：订单未生效，此时打上【特殊单】
    • 不占用库存（如已占用库存，则释放库存占用）—非全渠道释放发货仓可用库存；全渠道的释放云仓未派占用或云仓具体仓的库存
    • 订单生效（手工派单、单件派单、自动派单、订单改派、审核策略生效订单、手工审核（订单详情审核，列表批量审核））不调用ERP冻结释放接口，不处理库存释放和占用
    • 订单反审核、作废、终止、拒单、发货不调用ERP冻结释放接口，不处理库存释放和占用
    • 派单不判断库存，默认派单给开单店铺
    • WMS推送状态默认不推送，并且不允许推送WMS（奇门、电商仓储)
    • 发货时增加提示“特殊单不需要真实发货，请注意”，点击确认后继续发货—前端处理
      • 发货单详情页-发货
      • 发货单复核-复核完成后发货
    • 发货不生成POS订单和调拨出入库单，不写入台账。涉及系统作业。
    • 订单发货时，不用判断库存，不扣减库存。
    • 云仓方案-重算云仓未派占用，【特殊单】的订单不参与计算。
    • 库存重算-可用库存-网络订单，【特殊单】的订单不参与计算。
    • 售后单入库，如来源网络订单打上【特殊单】标签，则入库后不需要生成POS单和调拨出入库单，不写入台账。系统系统作业 RtoPushHKPosRepair PushErpPosForRto
    • 仅退款售后单审核生效后，当系统参数DS0031设置是，如来源网络订单打上【特殊单】标签，则不需要生成冲账POS。
  • 场景2：订单已生效，此时打上【特殊单】
    • 非全渠道订单，触发反审核网络订单 ，释放库存占用（调用一代冻结释放接口）；反审核失败，则弹框提示“打标签失败，失败原因XXX”
    • 全渠道订单，触发自动拒单；释放云仓未派占用或云仓具体仓的库存（调用一代冻结释放接口）；拒单失败，则弹框提示“打标签失败，失败原因XXX”
    • 订单已推送WMS，触发自动撤销WMS订单
      • 撤销失败，则返回提示“打标签失败，失败原因XXX”
      • 撤销成功，则订单的WMS状态变为“不推送”，单据状态变为已退审，-非全渠道释放发货仓可用库存；全渠道的释放云仓未派占用或云仓具体仓的库存（调用一代冻结释放接口）
    • 后续订单生效和发货走场景1的逻辑处理
• 4.订单删除【特殊单】标签时处理逻辑。
  • 重新占用库存：
    • 非全渠道订单，占用发货仓库可用;
    • 未生效全渠道订单，占用云仓未派占用；
  • WMS推送状态处理：如wms状态=不推送，则改为“未推送”，如WMS不等于“不推送”，则不用处理。
  • 订单业务状态=已发货，不允许添加和删除【特殊单】标签;
  • 订单状态=已生效，不允许删除【特殊单】标签
• 5.操作日志处理
  • 打上【特殊单】标签，网络订单操作日志写入一条日志“订单打上特殊单标签，不占用库存”
  • 删除【特殊单】标签，网络订单操作日志写入一条日志“订单删除特殊单标签，重新占用库存”
    • 解决方案：
    • 正向：未启用零售/启用零售，CK开头出库单号均不产生
    • 负向：检查售后单来源网单是否为特殊单，来源单为特殊单的自动审核，手动审核 条件审核均不给过，写入未审原因或操作记录 售后单生成时带入主表标签“特殊单”
    • 文字：特殊单不允许审核生效
  • 售后单关闭DS0063后，售后单允许入库，但是没有日志告诉客户这是特殊单来源，所以入库不产生pos
    • 解决方案：第二点处理了就可以不管
  • 拆分 合并 特殊单跟普通单 或者特殊单跟特殊单之间不允许合或者拆分
    • 解决方案：不允许合并跟拆分【拆单策略 合并策略 手动拆 手动合】
    • 测试注意事项： 订单打上特殊单标签，并推送WMS，此时退款触发撤销WMS订单，看下库存占用和释放是否正常，不要多释放。

（十一）淘宝平台订单发货风控拦截错误添加引导处理的方法

淘宝平台会管控订单快递单号不允许手工输入。必须通过面单获取快递单号。若手工输入或者不真实的快递单号就会被风控提示如下。

(十二） 拼多多赠品订单对接

背景：

拼多多平台赠品活动规则发生变更（详见拼多多商家后台「下单送赠品」页活动规则说明），平台将调整赠品订单管理模式——赠品将在商家端生成独立子订单，以实现赠品订单信息的精准同步与高效管理。

解决方案：

• (1) 本次调整覆盖3个核心订单接口，确保全链路获取赠品订单信息：
  • pdd.order.list.get：订单列表查询接口（根据成交时间）
  • pdd.order.number.list.increment.get：订单增量接口
  • pdd.order.information.get：订单详
• 网络订单增加字段：
  • gift_list 赠品列表 字段，新增 order_sn 赠品订单号；
  • 新增 related_order_list 关联的订单信息 字段，字段包含：· order_sn 订单号· relation_type 关联类型 4-赠品单关联的商品主单
  • 新增 gift_order_status 字段，支持商家识别赠品子单的创建状态· gift_order_status 赠品订单创建状态 0-待创建，1-创建成功，2-未创建/创建失败
• 赠品主子单分别对应上述字段说明：
  • 主商品订单：仅包含：gift_list 赠品列表、gift_order_status 字段；
  • 赠品子订单：· 仅包含：related_order_list 关联的订单信息 字段，其中 relation_type = 4，且order_sn 订单号 不为空；
• 解决方案：
  • 网络订单明细表增加字段【是否独立赠品】，【交易号2】
  • 网络订单主表增加【赠品订单创建状态】字段，0-无需创建 ，10-待创建，11-创建成功，12-未创建/创建失败
  • 拼多多平台订单在下载和转单时需对接【赠品订单创建状态】字段，拼多多平台字段为gift_order_status：0-待创建，1-创建成功，2-未创建/创建失败。

拼多多gift_order_status	恒康【赠品订单创建状态】
0-待创建	10-待创建
1-创建成功	11-创建成功
2-未创建/创建失败	12-未创建/创建失败（赠品和主品在一起）
null	0-无需创建

• Ø 当【gift_order_status】的值=null时，网络订单业务状态为“待审核”。
• Ø 当【gift_order_status】的值=0时，订单池不转单，备注写入异常原因—会有超卖风险
• Ø 当【gift_order_status】的值=1和2时，网络订单业务状态为“待审核”，这类订单可以走后续的处理。
• Ø 当【gift_order_status】的值=由0变为1时，重新下载，删除前一条数据，拿最新数据转单
• Ø 当【gift_order_status】的值=由0变为2时，重新下载，删除前一条数据，拿最新数据转单
• Ø 拼多多平台订单，当【gift_order_status】的值=1时，订单接口gift_list如有返回数据，这部分赠品数据不生成到网络订单明细中；—历史订单无法批量修复。
• Ø 拼多多平台订单，当【gift_order_status】的值=2/null时，订单接口gift_list如有返回数据，这部分赠品数据还是正常生成到网络订单明细中
• Ø 【交易号2字段写入】
  • ① 拼多多平台订单，当返回参数【gift_order_status】=1，gift_list 下的 order_sn的值写入网络订单拓展表的【trans_code2】字段和明细的【trans_code2】
  • ② 拼多多平台订单，当返回参数related_order_list 有返回：order_sn，并且relation_type=4-赠品单关联的商品主单，则把related_order_list下的order_sn的值写入网络订单拓展表的【trans_code2】字段和明细的【trans_code2】
• Ø 网络订单明细【是否独立赠品】写入逻辑：拼多多平台订单，当返回参数related_order_list 有返回：order_sn，并且relation_type=4-赠品单关联的商品主单，则订单明细写入【是否独立赠品】true；这个单如跟其它单据合并，需把明细的【是否独立赠品】状态也写到新单。

拼多多下单附带赠品场景，赠品单独生成一张订单，下图：

下载到中台网络订单对应2张

售后处理：如果拼多多有赠品订单发起售后，赠品的售后单也是等主品退完后，系统自动生成售后单推给中台的

（十三）淘宝退邮费问题处理

业务背景：

消费者已经退货退款，后续又申请了退邮费，由于没有可退金额了，生成了退款金额为0的仅退款售后单，但是又无法处理。

功能说明：

淘宝售后单接口返回的【dispute_type】=RETURN_GOODS_POSTAGE时，表示退邮费， 则生成仅退款售后单时，不需要判断来源单的可退金额，直接取接口返回的的金额

• 退款单主表的售后类型枚举增加【退邮费】
• 如果参数DS0031设置是，生成冲账POS时，退款单的售后类型=退邮费，不需要判断退款类型，改为判断来源网络订单是否有出库单号，有出库单号则允许生成冲账POS，没有出库单号则还是不允许生成冲账POS

（十四）翱象对接

背景：

翱象全渠道经营管理 SAAS 系统是用于协助商家面向多个即时零售渠道（饿了么、美团、京东到家 等）进行线上经营管理的工具，满足商家在门店管理、商品管理、订单管理等线上全渠道经营和门 店履约、线下进销存管理的一体化工具，帮助商家提升经营效率，助力线上业务增长。 恒康中台对接翱象，可以把多个即时零售渠道的订单拉回去给到POS端处理，不用恒康再对接各个即时零售渠道。

解决方案：

1、网店资料

(1) 网店资料中的网店平台增加【翱象】

(2) 翱象平台的网店信息显示【卖家昵称】字段

接口测试对接维护翱象网店资料，保存前不需要点击接口测试（点接口测试前需先维护门店信息，未维护不点击），维护好门店信息后点击后会调用翱象【saas批量查询门店商品】接口，接口返回数据则接口测试成功，允许保存；接口无数据返回，则接口测试失败。

下载平台物流公司调整由于翱象没有物流公司接口，业务也用不到物流公司，所以网店平台=翱象时，隐藏了【下载平台物流公司】按钮

(3) 参与即时零售的线下门店需在门店信息中添加进来，支持新增和导入，导入模版字段“店铺编码”

新增只能选择实体店类型的店铺，并且店铺状态=启用

导入模版：店铺编码，必填项，匹配店铺资料中启用的店铺，编码不存在或未启用不允许导入

导入DTO和导出DTO增加新的用于翱象

一个恒康店铺编码只能对应一个翱象网店。如有多个翱象网店，店铺编码不能存在多个网店中。

2、商品对应

Ø 点击下载翱象商品。

Ø 翱象商品对应到商品对应中的【商家编码】字段，商家编码与中台条码匹配上则关联成功，匹配不上则关联失败。

Ø 作业任务中的【商品列表下载作业】和【商品详情下载作业】支持获取翱象商品信息。—由于接口不支持增量下载，翱象平台的自动下载商品作业默认一天执行一次，不受作业执行频率管控

Ø 【商品对应作业】支持翱象商品自动关联。

3、库存策略

Ø 库存同步之前需确保网店已配置，商品对应已正常。

Ø 新增/编辑库存策略，当店铺的平台类型=翱象，则同步方式只显示“按实体仓同步”。

Ø 库存策略中点击【同步库存】按钮，当店铺的平台类型=翱象，同步库存给翱象。

Ø 【库存策略作业自动同步】支持同步库存给翱象。

4、消息对接

(1) 订阅翱象【SaaS订单创建通知】消息，接收到消息后，通过接口【查看SaaS订单详情】获取订单详情，报文生成到订单池中，并触发一次订单池自动转单。

(2) 订阅翱象【SaaS订单状态变更通知】消息，接收到消息后，通过接口【查看SaaS订单详情】获取订单详情，报文生成到订单池中，并触发一次订单池自动转单。

5、订单下载

(1) 网络订单列表点击【下载】，选择翱象店铺下载订单时，调用翱象接口【查看SaaS订单列表】

(2) 网络订单列表点击【下载】，选择翱象店铺，输入网店交易号下载，调用翱象接口【查看SaaS订单详情】获取订单信息生成到订单池中。

(3) 【订单池转单】翱象平台订单转单生成网络订单。

Ø 翱象订单状态与中台交易状态/业务状态匹配

翱象订单状态（status）	中台交易状态	中台业务状态
1（已支付）	等待发货	待审核
2（已接单）	等待发货	待审核
3（已拣货）	等待发货	待审核
4（已打包）	等待发货	待审核
5（已发货）	已发货	待审核
6（交易成功）	交易成功	待审核
-1（交易关闭）	交易关闭	已取消

6、转单生效

(1) 网络平台=翱象，订单转单后即生效，并占用发货店铺库存。

• 开单店铺：判断接口返回的外部门店编码在哪个网店，则取该网店作为开单店铺，匹配不到转单失败
• 发货店铺：接口返回的外部门店编码，匹配不到转单失败
• 网络平台=翱象的网络订单，生效后不允许反审核
• 网络平台=翱象的网络订单，不允许拆单（手工拆，自动拆，派单拆）
• 网络平台=翱象的网络订单，是否直派订单默认标记为true
• 网络平台=翱象的网络订单，生效后不调用一代接口生成库存冻结单

7、生成即时零售订单

• (1) 业务说明：OMS下载翱象平台的订单，转单生效后，零售生成“即时零售订单”，由零售完成后续业务的处理（语音提示、打印小票、拣货等）
• (2) 零售生成即时零售订单。更新【即时零售推送状态】为推送成功，调用失败更新为“推送失败”；未启用零售模块，则OMS不用调接口。
• (3) 增加补偿作业
  • 作业名称：即时零售订单推送补偿
  • 执行频率：默认10分钟，可编辑
  • 执行条件：查询网络订单表中，翱象平台的已生效网络订单，即时零售推送状态=推送失败
  • 处理逻辑：补偿推送失败的网络订单生效即时零售订单。注意不要重复生成。
• (4) 增加邮件提醒
• (5) 打包费处理
  • 增加集团参数
  • 参数编码：DS0103
  • 参数名称：打包费SKU
  • 参数值：关联商品档案（SKU），默认为空
  • 备注：生成中台即时零售订单时，参数未设置SKU，主表如有打包费，则取明细第一个条码作为打包费对应的条码；参数设置了具体的SKU，则以设置的SKU作为打包费对应的条码传个零售

8、网络订单调整

Ø 平台=翱象时，网络单详情页的【金额信息】显示打包费字段。

9、发货单调整

(1) 发货单列表隐藏翱象平台的订单

(2) 发货单复核如录入翱象平台订单，则弹框提示“翱象平台订单不支持该操作。”

(3) 工单复核如录入翱象平台订单，则弹框提示“翱象平台订单不支持该操作。”

10、 拣货完成通知翱象

(1) 业务说明：零售把翱象的即时零售订单拣货完成后，同步更新翱象平台的订单状态。

(2)更新翱象之前，先获取下最新的状态，如状态为交易关闭，则零售不能拣货完成。

异常情况：已调用接口通知拣货完成，此时线上又申请了退款，触发逆向订单消息发生，接送到消息后调用售后单详情接口获取信息，更新网络订单退款状态，并同步调用零售接口更新退款状态，门店要人员要关注，有退款状态的订单，不要给骑手拿走，系统无法干预。

11、更新即时零售订单状态

(1) 业务说明：OMS把翱象订单下载回来，转单生效推送到零售，后续翱象的订单状态发生变更，会发送消息给OMS，OMS订单状态更新的同时更新即时零售订单状态。

12 、生成POS订单/POS出库单

(1) 业务说明：当零售的即时零售订单的状态变为【交易成功】时，零售生成POS订单和POS出库单，并同步更新网络订单的业务状态。

(2) 零售监控即时零售订单的状态，当订单状态变为【交易成功】时，零售生成POS订单和POS出库单

(3) OMS更新业务状态和回写出库单号，并释放网单的库存占用。

13、消息对接

(1) 订阅翱象【SaaS逆向订单状态变更通知】消息，接收到消息后，获取售后单详情，报文生成到售后订单池中，并触发一次售后订单池自动转单。

14、退款单

• Ø 在退货单列表点击下载，选择翱象店铺下载，售后单号需必填，只需生成中台退款单，不生成售后单。
• Ø 退款单生成需满足条件：（仅退款）或（退货退款）
• Ø 生成退款单的同时，同步更新网络订单明细的退款状态。
• Ø 当订单明细的退款状态=退款成功时，释放当前明细商品的库存占用数量。所有明细的退款状态=退款成功时，作废网络订单，并释放已占用库存。
• Ø 退款单增加【打包费】、【地址变更费】字段，平台=翱象时，退款单详情页的【金额信息】页签显示这2个字段。

• Ø 售单后主表增加【打包费】、【地址变更费】字段，平台=翱象时，售后单详情页的【金额信息】页签显示这2个字段

15、售后单

• Ø 在退货单列表点击下载，选择翱象店铺下载，售后单号必填，获取售后单信息，对面为退货退款时，生成中台退款单的同时，生成售后单。
• Ø 售后单生成需满足条件：
  • 退货退款
  • 已同意退货等待发货/已收到货并同意退款
• Ø 生成退款单的同时，同步更新网络订单明细的退款状态，OMS更新零售即时零售订单的状态。未启用零售模块，则OMS不用更新零售。

16、退货入库调整

(1) 退货入库列表隐藏翱象平台的售后单

(2) 退货入库复核录入翱象平台售后单，则弹框提示“翱象平台售后单不支持该操作”

17、 生成POS退货入库单

(1) 业务说明：退货退款不更新零售状态，零售直接生成负向POS订单，库存生成POS退货入库单。

(2) 处理逻辑：售后转单，退款成功，退货入库单号为空，并且来源出库单号不为空，同时开启零售业务，则零售生成负向POS

补偿作业：翱象退货退款售后单，退款状态=退款成功，并且来源单已出库，零售生成负向POS单。

十二、结算

（一）同时存在多个佣金方案，计算佣金时需要一起计算

需求背景：

佣金方案为基础型的导购提层设置，一般设置后不会经常性变更，会有短期助销或第三方补贴的佣金活动。调整为叠加方式，无需变更现有方案，仅需要新增差异方案设置即可；也利于用户的方案的操作设置和理解。

调整方案：

1、增加 SC0017 系统参数，用于设置是否可以多方案叠加计算，如参数=1时，所有生效的方案都应参与计算佣金

2、一条消费记录会被多个佣金方案计算，现有消费记录表中佣金方案ID及相关字段移到佣金分摊表

3、佣金查询 ：

①佣金明细表：隐藏【变动前佣金、变更后佣金】字段

②按汇总、按店铺、按职员 如没有选取佣金类型，则显示【可提现佣金】字段（现选取佣金类型后才显示）

③样式调整，参考余立原型

④佣金补偿：+，如未手工计算佣金，小于60天单据系统会自动进行补偿—界面需显示该说明

4、佣金调整单调整

①主表增加【佣金日期】字段，必填，默认当前日期（位置放在备注前）

②主表显示【开单日期】，只读，位置放在手工单号

③列表增加【佣金日期】字段

④查询条件增加佣金日期字段（开始日期、结束日期），默认为空

⑤查询条件中创建日期 改为开单日期，根据参数Sys0101 默认开始、结束日期

⑥查询条件与例表改为左右结构

5、佣金提现明细表、职员佣金期间变动汇总表