标准价格调整单
标准价格调整单用来成批改物料档案上的标准售价与标准进价——这是整套价格的地基，改完之后所有「以标准售价为因子」的策略公式价都会跟着变。单据可以立即生效，也可以指定未来时间由定时任务自动生效；生效后直接写进物料档案，不回改任何历史单据。
什么时候用本单，而不是直接在物料档案里改？ 只改一两个商品、价格由一个人统管时，直接在物料档案里改标准售价更省事；需要成批调价、由第二个人复核、指定未来某天生效或事后追溯时，用本单。两种做法的取舍见 价格管理。
功能路径：销售 → 价格管理 → 标准价格调整单
一、功能概述
菜单位置：销售 → 价格管理 → 标准价格调整单（页面地址 /admin/Sales/sctrlstdpriceadjusthead/）
| 用途 | 说明 |
|---|---|
| 成批调基准价 | 一张单调整多个物料的标准售价 / 标准进价 |
| 定时生效 | 不勾「立即生效」时，填生效时间，到点自动执行 |
| 留档 | 每次调价留一张单据，谁在什么时候把哪些物料调成了什么价 |
二、界面布局说明
1. 列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、刷新 |
| 查询条 | 单据号、单据状态、单据日期 |
| 列表 | 单据号 / 单据日期 / 单据状态 / 生效时间 / 立即生效 / 单据金额 / 制单人 / 单据摘要 |
| 分页 | 默认 20 条/页 |
单据号自动生成（形如 Ssa261027000001）。「立即生效」列显示 True/False，一眼能看出这张单是即时执行还是挂到未来。
2. 新增与编辑态
| 部位 | 内容 |
|---|---|
| 工具栏 | 返回、保存、复制、删除；已保存草稿另出 审核 |
| 基本信息 | 单据日期*、生效时间、新售价合计（只读）、立即生效（默认勾选） |
| 明细页签 | 商品明细 / 备注 |
| 明细工具条 | + 添加行、选择商品、删除选中、清零、清空、导出、隐藏辅助面板 |
3. 明细列
| 列名 | 可编辑 | 说明 |
|---|---|---|
| 物料编号 | 是 | 必填，带出名称与单位 |
| 物料名称 / 单位 | 否 | 随物料带出 |
| 原标准售价 | 否 | 物料档案当前的标准售价 |
| 新标准售价 | 是 | 必填且必须大于 0 |
| 原标准进价 | 否 | 物料档案当前的标准进价 |
| 新标准进价 | 是 | 必填且必须大于 0 |
底部「单据金额」= 各行新标准售价之和，不是「数量 × 价格」——本单没有数量概念。
三、业务操作步骤
步骤 1：新增并决定生效方式
- 立即生效（默认勾上）：审核那一刻就写进物料档案；
- 指定时间生效：取消勾选，填 生效时间，审核后单据停在「待生效」状态，到点由系统自动执行。
不勾立即生效却没填生效时间，保存或审核时提示「非立即生效时必须填写生效时间」；填了早于当前时间会提示「生效时间必须晚于当前时间」。
步骤 2：加明细
选择商品批量挑物料，逐行填 新标准售价 与 新标准进价。两列都是必填且必须大于 0——只调售价不动进价也要把原进价抄一遍填进来，否则审核拦下。同一物料在一张单里不能出现两次，重复会提示「明细中物料重复：…」。
步骤 3：保存与审核
- 【保存】后为草稿；
- 【审核】先跑完整性校验（明细不能为空、必须选物料、两个新价都要大于 0），再按生效方式执行：
- 立即生效：更新全部明细物料的档案价格 → 回写单据状态为「已生效」→ 回执「生效成功，共调整 N 个物料的标准价格」；
- 定时生效：状态置为「待生效」→ 回执「审核成功，单据将在生效时间由定时任务自动生效」。
- 更新物料档案的同一个事务里，会把这些商品在「进价变动待确认」清单里的记录标记为已处理，避免它与手工调价重复确认。
步骤 4：撤回（仅待生效单）
待生效的单据，工具栏的【反审核】位置会变成 撤回。撤回后回到草稿，回执「撤回成功，单据已回到草稿状态」，可以改价、改时间或删除。
已生效的单不能撤回：按钮不可用，提示「单据已生效，价格已写入物料档案，不可撤回」；要改回去只能再开一张反向调价单。
四、校验与提示
| 提示 | 触发条件 |
|---|---|
| 非立即生效时必须填写生效时间 | 未勾立即生效且生效时间为空 |
| 生效时间必须晚于当前时间 | 生效时间早于当前时间 |
| 明细中物料重复：… | 同一物料在一张单里出现多次 |
| 单据明细不能为空，请至少添加一行商品 | 明细没有行 |
| 明细行必须选择物料 | 行内没有物料 |
| 明细行新标准售价必须大于0 | 新售价为空、0 或负数 |
| 明细行新标准进价必须大于0 | 新进价为空、0 或负数 |
| 生效成功，共调整 N 个物料的标准价格 | 立即生效成功 |
| 审核成功，单据将在生效时间由定时任务自动生效 | 定时生效审核成功 |
| 撤回成功，单据已回到草稿状态 | 待生效单撤回 |
| 单据已生效，价格已写入物料档案，不可撤回 | 对已生效单点撤回 |
| 只有已审核状态可以撤回(当前状态=…) | 对草稿点撤回 |
| 单据状态已变化，生效中止 | 生效瞬间单据状态被其他操作改动，整批回滚 |
| 单据没有明细行，无法生效 | 生效时明细为空 |
定时任务还有一条保护：单据标着「立即生效」却停在待生效状态时，自动任务拒绝处理，提示「单据标记为立即生效但处于待生效状态，禁止定时任务生效，请撤回后人工处理」。遇到这条就撤回重开。
五、口径与影响面
| 项目 | 口径 |
|---|---|
| 改的是什么 | 物料档案的标准售价与标准进价（基准价） |
| 影响谁 | 之后开单的取价；以「标准售价 / 标准进价」为价格因子的策略公式价 |
| 不回改什么 | 历史单据的单价快照、客户专属价、策略手工价 |
| 生效窗口 | 定时任务只处理「生效时间在 2 天内」的单据，超过 2 天的过期单不会被自动执行，需人工撤回重开 |
| 单据状态 | 草稿 / 待生效（列表显示为「已审核」）/ 已生效 |
六、常见问题
问：只想调售价，不想改进价，为什么保存不了？ 答：本单要求新标准售价与新标准进价两列同时大于 0。把原进价照抄到「新标准进价」即可，不会造成任何变化。
问：审核后状态显示「已审核」，但价格没变？ 答：「已审核」在这里就是待生效：没勾立即生效，系统在等到生效时间。看列表的「生效时间」列，到点由定时任务执行；如果时间已过还没生效，检查定时任务是否在运行。
问：已生效的单填错了怎么改回来？ 答：不能撤回。开一张新单，把原价填成新价再审核，价格就回去了——这也是留档调价历史的方式。
问：调完标准售价，客户看到的价变了吗？ 答：看他挂在哪条策略上：策略以标准售价为因子时，公式价会跟着变；该商品有手工价、或客户有专属价的，不受影响。
问：同一批物料能不能分两张单调？ 答：可以，但同一物料不能在同一张单里重复。分两张单会产生两条调价记录，注意生效时间别交叉。