退货原因
退货原因是门店退货时可选的原因字典:把「口感/风味不佳」「商品变质」「顾客买错」这类退货理由提前编成一条条记录,收银端做退货时直接从这份字典里选,既规范了退货口径,也方便事后按原因统计退货。它是一张标准编码表,维护方式和其他编码档案一致。
一、功能概述
菜单位置:连锁管理 → 编码 → 退货原因(页面地址 /admin/PosRetail/posbackfoodcause/)

| 用途 | 说明 |
|---|---|
| 建原因字典 | 把常用退货理由编成带编号的记录,统一全公司口径 |
| 供收银端选择 | 门店退货时从字典里选原因,避免随手填写造成的混乱 |
| 按原因统计 | 退货记录带上原因编号,事后可按原因汇总分析 |
| 快速检索 | 编号、原因名称、助记码都能搜,助记码按名称拼音自动生成 |
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、回收站、打印(含「打印模板管理」) |
| 查询条 | 关键字搜索框(提示「搜索...」),按编号/原因/助记码匹配 |
| 列表 | 退货编号 / 退货原因 / 助记码 |
- 退货编号是进入编辑的链接,点它打开该条原因。
- 列表默认按退货编号升序排列,每页 20 条。
- 回收站里存放被逻辑删除的原因,可还原。
编辑弹窗
点「新增」或点列表里的退货编号,会在弹窗里打开编辑表单,字段集中在「退货原因信息」分组:
| 分组 | 字段 | 说明 |
|---|---|---|
| 退货原因信息 | 退货编号、退货原因、助记码 | 编号和原因必填,助记码自动生成 |
| 签核状态 | (折叠) | 系统签核标记,一般不用动 |
| 审计信息 | (折叠,只读) | 定义人/定义时间/修改人/修改时间,系统自动记录 |
弹窗顶部工具栏:返回 / 编辑 / 保存 / 取消 / 刷新 / 上一行 / 下一行 / 删除。「保存」右侧箭头还有「保存并继续编辑」「保存并新增下一个」「保存并返回列表」三个选项,连续录入时很方便。
三、业务操作步骤
步骤 1:打开功能入口
连锁管理 → 编码 → 退货原因,进入原因列表。
步骤 2:新增一条原因
点 新增,在弹窗里填:
- 退货编号:本条原因的唯一编号,只能包含字母、数字、下划线、中划线;
- 退货原因:原因名称,写清退货理由,必填;
- 助记码:不用手填,保存时系统按原因名称的拼音首字母自动生成(形如
/KGFW)。
步骤 3:保存
点 保存,弹窗关闭、列表刷新,新原因出现在列表里。校验不通过时弹窗顶部会列出错误(如「退货编号不能为空」「退货原因不能为空」),修正后重新保存。
步骤 4:编辑、删除与还原
- 编辑:点列表里的退货编号打开弹窗,改完保存;
- 删除:在弹窗里点「删除」,记录被逻辑删除并移入回收站,提示「已逻辑删除」;
- 还原:点工具栏 回收站,找到被删的原因还原,提示「记录已还原」,它重新回到正常列表。
四、字段详细说明
1)字段表
| 字段名 | 含义 |
|---|---|
| 退货编号 | 本条原因的唯一编号,必填,最长 30 字符;只能含字母、数字、下划线、中划线,不能与已有编号重复 |
| 退货原因 | 原因名称,必填,最长 200 字;收银端退货时显示的就是它 |
| 助记码 | 检索辅助码,最长 30 字符;保存时按原因名称拼音首字母自动生成,前缀 /、字母大写 |
| 原因ID | 系统内部主键,新增时自动取号,界面上不出现,不用填 |
2)编号规则要点
| 规则 | 说明 |
|---|---|
| 字符限制 | 退货编号只能包含字母、数字、下划线(_)、中划线(-) |
| 唯一性 | 编号不能重复;唯一性校验包含已逻辑删除的记录,删进回收站的编号槽位仍被占用 |
| 助记码自动生成 | 即使手工填了助记码,保存时也会按名称拼音重新生成,保证助记码始终与名称一致 |
五、典型使用场景
场景 1:上线前初始化退货原因字典
背景:新账套启用收银退货,需要先把常用退货理由建好。 操作:连锁管理 → 编码 → 退货原因 → 逐条「新增」,按统一规则编退货编号、填原因名称 → 保存。助记码自动生成,收银端即可按拼音快速检索。
场景 2:收银端退货选原因
背景:顾客退一件商品,收银员需要记录退货理由。 操作:收银端发起退货 → 在原因下拉里按名称或助记码选中对应原因 → 完成退货。退货记录带上该原因编号,总部可按原因汇总退货分布。
场景 3:停用某条原因但保留历史
背景:某条退货理由不再使用,但历史退货记录还引用着它。 操作:把该条原因删进回收站(逻辑删除),历史关联仍在;需要时再从回收站还原。注意删除后编号仍被占用,新建原因要换编号。
六、权限控制与前置条件
- 窗口与按钮权限:能否新增、修改、删除、还原取决于操作员对该窗口的按钮权限配置;无删除权限时弹窗里不显示删除按钮。
- 回收站还原:还原同样受权限控制,还原失败会提示「还原失败」。
- 前置条件:本表是独立字典,不依赖其他档案,建好即可被收银端退货引用。
七、常见问题
1. 保存提示「退货编号 [xxx] 已存在,请更换编号」
- 原因:编号重复,且唯一性校验包含已逻辑删除的记录;
- 处理:换一个编号;如果该编号在回收站里,先还原或改用其他编号,删除并不会释放编号槽位。
2. 保存提示「退货编号只能包含字母、数字、下划线、中划线」
- 原因:编号里含有空格、汉字或其他符号;
- 处理:只用字母、数字、下划线、中划线重新编号。
3. 助记码和自己填的不一样
- 原因:助记码在保存时按原因名称拼音首字母无条件重新生成;
- 处理:这是正常行为,助记码始终与名称保持一致,无需手工维护。
4. 删除后列表里找不到了
- 原因:删除是逻辑删除,记录移入了回收站;
- 处理:点工具栏「回收站」找到它并还原,提示「记录已还原」后回到正常列表。
5. 新增时看不到「原因ID」字段
- 原因:原因ID 是系统内部主键,新增态自动取号,不在表单里显示;
- 处理:无需填写,保存时系统自动生成。
