.jpeg)
一、功能概述
批发商贸积分是批发管理后台面向客户的积分运营体系，核心思路为"消费得积分、积分可抵现"：
● 积分获取：客户下达的批发销售单审核通过后自动获得积分；支持按销售金额积分和按单品积分两种模式。
● 积分扣减：批发退货单审核时按对应规则扣回积分；销售/退货单反审核时自动冲抵已产生的积分记录。
● 积分使用：下单时积分可按比例抵扣货款（X 积分抵 1 元），也可由客服手动调增/调减，或通过 Excel 批量导入调整。
● 积分账户：客户积分余额按积分流水累计维护，每一笔变动都留痕（来源单据、变动前后余额、操作人），可追溯。
整个功能由三层构成：规则配置（积分规则与商品积分设置）→ 自动计算（销售/退货单据审核与反审核时自动加减积分）→ 积分账户（所有变动记录成流水，余额实时累计）。
二、功能入口
功能位于批发管理后台"客户管理 → 积分"菜单，包含两个页面：
页面 | 菜单权限 |
客户积分设置（积分规则） | 批发 - 客户管理 - 积分 - 客户积分设置 - 查询 / 编辑；客户运营 - 客户积分 - 积分规则 -* |
商品积分设置（单品积分） | 批发 - 客户管理 - 积分 - 商品积分设置 - 新增 / 编辑 / 删除 / 导入 / 导出 |
积分总开关位于"业务设置"。两个积分页面进入时系统都会自动校验积分开关状态，若未开启则提示先前往开启。
三、开启积分功能
积分总开关与规则配置项统一维护在"业务设置"中，主要配置项如下：
配置项 | 说明 |
是否开启积分 | 积分功能总开关，关闭后销售 / 退货单据不再产生积分 |
积分方式 | 按销售金额积分 / 按单品积分 |
积分比例 | 按金额积分时： 1 元 = X 积分 |
抵扣比例 | 下单时： X 积分抵 1 元 |
促销活动商品可积分 | 按单品积分时，促销 / 秒杀 / 赠品 / 超额赠送商品是否参与积分 |
优惠商品可积分 | 按单品积分时，使用优惠券的商品是否参与积分 |
开启路径：批发管理后台 → 业务设置 → 找到"积分"相关开关 → 开启后保存。两个积分页面（客户积分设置 / 商品积分设置）会实时校验开关，未开启时引导先开启。
四、客户积分设置（积分规则）
客户积分设置页配置积分方式与比例等全局规则，关键配置项如下：
1. 积分方式：二选一。
2. 按销售金额积分：按销售单金额 × 积分比例计算，1 元 = X 积分。
3. 按单品积分：按商品积分设置中的"每常用单位积 X 分"逐项累加。
4. 积分比例（仅按金额模式有效）：如设为 10，则每消费 1 元获得 10 积分。
5. 抵扣比例：如设为 100，则每 100 积分可抵 1 元货款。
6. 促销活动商品可积分（仅按单品模式有效）：控制参与促销/秒杀/赠品/超额赠送的商品是否积分。
7. 优惠商品可积分（仅按单品模式有效）：控制使用优惠券的商品是否积分。
五、商品积分设置（单品积分）
按单品模式需在商品积分设置页为每个商品规格维护积分值：
● 维护维度：门店 + 商品 + 规格，每个规格维护"每常用单位积 X 分"。
● 操作：支持新增、编辑、删除，以及 Excel 批量导入/导出，方便大批量维护。
● 修改留痕：每次修改都会记录修改前后的积分值、操作人与时间，可在页面查看修改历史，责任可追溯。
六、积分计算逻辑
积分计算围绕销售/退货单据的审核与反审核动作展开，统一受积分总开关控制，以下按场景说明。
6.1 批发销售单审核（加积分）
销售单审核通过时自动计算积分，触发条件：积分功能已开启、该单据未勾选"不参与积分"、该客户未被禁用积分。
● 按销售金额：积分 = 销售单总额 ÷ 积分比例，结果取整；正常金额加积分，负金额（红冲）扣减积分。
● 按单品：积分 = 各商品规格积分值 × 销售常用数量后逐项累加，并排除以下商品：
● 促销活动商品、秒杀商品
● 赠品/超量赠送/超额赠送商品
● 使用优惠券的商品（取决于"优惠商品可积分"开关）
● 参加了活动的商品规格
6.2 批发退货单审核（扣积分）
退货单审核通过时，按退货金额或单品积分规则自动扣回相应积分。
6.3 反审核冲抵
销售单/退货单反审核时，系统自动生成一条方向相反的冲抵记录（原加积分则冲减、原扣积分则冲回），保证积分余额与单据状态始终一致。
6.4 其他积分场景
场景 | 说明 |
手动调增 / 调减 | 客服在页面手工增减客户积分，或通过 Excel 批量导入调整 |
预收单抵扣 | 客户使用积分抵扣预收款，按 " 抵扣比例 " 换算 |
签到积分 | 微信商城签到赠送积分 |
6.5 余额维护机制
系统保存积分流水时，会先读取该客户当前积分余额（由历史流水累计得出），再加上本次变动值（加分为正、扣减为负），得到变动后的余额并一并记录。即客户积分余额始终由流水实时累计，无需手工维护余额。
七、积分记录与统计
查询功能 | 说明 |
客户积分记录 | 按客户 / 时间 / 来源查询积分变动流水 |
积分汇总 | 按客户汇总当前积分余额 |
积分使用记录 | 查询积分使用明细，可按来源单据下钻 |
商品积分设置 | 商品规格积分值列表与批量导入导出 |
商品积分修改历史 | 查看商品积分修改留痕 |
八、数据存储与留痕
积分相关数据按以下表存储，便于问题排查与数据核对：
数据表 | 用途 |
客户积分流水表 | 核心表 。记录每一笔积分变动：客户、加 / 扣标志、变动分值、变动前后余额、来源单据类型（批发销售单 / 批发退货单 / 手动调整 / 批量导入 / 预收单 / 签到）、反审核冲抵关联、备注、操作人、时间、门店 |
商品积分设置表 | 商品规格积分值，按 " 门店 + 商品 + 规格 " 唯一维护 |
商品积分修改记录表 | 商品积分每次修改的留痕：修改前后积分值、操作人、时间 |
旧积分账户表 | 早期版本的积分余额账户，仅作兼容保留 |
积分与单据关联表 | 积分记录与来源单据的关联关系 |
九、常见问题与排查
以下为积分功能的高频问题与排查路径：
1. 销售单审核后客户没有积分
2. 检查"业务设置"中积分总开关是否开启。
3. 检查该商品是否属于促销活动/秒杀/赠品/优惠券商品（按单品模式默认排除，需开启"促销活动商品可积分/优惠商品可积分"开关）。
4. 检查单据是否勾选了"不参与积分"，或该客户是否被禁用积分。
5. 核查客户积分记录中是否有该单据对应的加积分流水。
6. 积分余额与预期不符
7. 积分余额由流水实时累计，先核查该客户所有积分流水是否完整（含反审核冲抵记录）。
8. 检查是否存在手动调增/调减与签到积分记录。
9. 退货后积分未扣回
10. 确认退货单审核时是否满足积分扣减条件；核查客户积分记录中是否有"批发退货单"来源、扣减标志的流水。
11. 反审核后积分没恢复
12. 反审核会自动生成方向相反的冲抵流水，核查是否存在；若无则说明反审核时未触发积分冲抵，需检查单据状态。
13. 按单品模式商品积分值为 0
14. 检查商品积分设置页是否维护了该"门店+商品+规格"维度的积分值，商品积分设置页支持导入批量维护。
