仓储费率标准

01 功能介绍：维护标准，核对使用结果

仓储费率标准用于维护月度和长期仓储费率配置，供预算估算、库存健康费用分析等链路读取。入口是「仓储物流 → WMS → 仓储费率标准」。页面默认打开「月度仓储费率」，可切换「长期仓储费率」。

这里的费率卡不是 FBA 实际账单。配置中的单价、适用条件与已发生费用是不同对象。查询实际来源费用请使用 FBA 月仓储费 或 FBA 长期仓储费。修改本页不会改写这些费用明细，也不能当作付款或账单调整凭据。

维护分为三步：编辑或导入保存到配置草稿；「校验」查看待发布差异；「发布」将启用行写成当前业务周的配置快照。下游何时采用新费率，还要核对具体计算入口和结果版本。

02 使用前确认：区域、期间、币种与单位

开始前准备费率来源、适用区域、金额币种、体积单位和季节／库龄条件。截图中的金额及汇率全部为虚构演示值，不是平台收费标准。

• 月度费率：核心字段包括「仓储利用率」「区域」「尺寸」「时间」「货币」「计价体积单位」、基本月度仓储费、仓储利用率附加费和月度仓储费总额。它不是按具体仓库、店铺或 SKU 建立的费率表。
• 长期费率：按区域保存币种、计价体积单位、汇率，提供 181–210、211–240、241–270、271–300、301–330、331–365、超过 365 天各档，以及 181–270、271–330 天汇总费率。汇总档是独立字段，不应自行把三个分档单价相加填入。
• 区域与尺寸：系统会把美国、英国、加拿大、欧洲规范为 US、UK、CA、EU，并归一部分 standard_size／oversize 别名。区域框仍是文本字段；其他文字能被保存不代表下游一定能匹配。没有国家／区域选择器或仓库筛选器。
• 期间：月度的「时间」是季节说明；「显示全部字段」可核对季节类型、开始月份、结束月份。长期的「费率标准期间」为资料字段，不能据此认定已配置日期到期机制。更新时间、发布业务周也不是适用日期。

计价体积单位支持 cuft（立方英尺）、cbm（立方米）、cuin（立方英寸）、cm3（立方厘米）。字段技术名即使带有 per_cuft，也应按该行声明的计价单位解释金额，不能默认所有数值都是每立方英尺。保存规范化不会自动改写原始金额；消费者按单位换算。例如演示的 28 CAD/cbm 换算为每 cuft 时是 28 × 0.028316846592 CAD，不能直接当成 28 CAD/cuft。

月度单价是每月、每计价体积单位；长期库龄天数是分档条件，不是把费率乘以天数的日单价。长期费率表没有可切换的日／月计费控件；库存健康相应计算用数量 × 单件体积 × 对应档费率 × 汇率估算。币种、汇率必须与来源一致；页面不提供自动汇率抓取或货币选择联动。

03 查询定位：切换费率卡与字段

1. 进入 仓储费率标准，确认当前是「月度仓储费率」还是「长期仓储费率」。两个页签的数据、历史和发布分别处理。
2. 在搜索框输入 US、币种或费率键等可编辑字段内容。输入变化即触发查询，不需要按 Enter。清除文字恢复范围；配置ID不是这个关键词搜索的业务字段。
3. 用状态选择器查看全部、启用或禁用记录。页面固定每页 50 行，通过「上一页」「下一页」翻页，没有表头排序按钮。行顺序按配置的「排序」、更新时间等决定，不等于下游费率匹配优先级。
4. 默认「核心业务字段」适合快速核对；切到「显示全部字段」查看全部非技术业务字段；「显示技术字段」还会展示内部版本月份、飞书记录ID等兼容字段。横向滚动查看右侧列和操作。
5. 点击「刷新」重新读取当前列表、统计和差异。它不发布配置、不拉取外部费率，也不重算下游费用。

计数范围要分开看：「总行数」随当前搜索和状态筛选变化；「启用行数」统计当前费率模块全部启用行；待发布摘要也是模块范围。不能把筛选后的一行当作本次发布只有一行。没有独立详情页，完整资料通过字段切换在表格查看。

04 新增、编辑与删除：先保存草稿

本节为有维护权限人员的操作说明；新增、保存、删除均未演示。

新增费率：先搜索现有规则，确认不是修改已有配置。点击「新增」产生 draft 行，选对字段模式后填写业务字段、启用状态和排序。月度新增应填写唯一「费率键」或有效来源标识；仅填核心金额而缺少来源键，统一保存可能提示 source key fields are missing。长期新增以规范化区域作为主要冲突键，应先确认该区域是否已有记录。点击「统一保存（数量）」后核对成功、失败数量；部分成功时已成功行进入列表，失败草稿保留错误，只处理剩余失败行。

编辑现有行：定位后横向滚动到「操作」，点击「编辑」，修改需要的值及启用状态，再点该行「保存」；「取消」放弃这次编辑。输入清空会提交空值，填 0 则是明确零费率。若提示该行已被其他人修改，先记录自己的待修改内容，再取消并刷新，重新核对后编辑，不能把冲突当作保存成功。

删除或停用：删除使用行尾「删除」并确认“确认删除该费率行？”，结果为草稿软删除。需保留草稿时可在编辑状态取消「启用」后保存。新草稿的「移除」仅移除未保存行。改变启用状态或删除后，应查看待发布差异再决定是否发布；不要推断所有下游已立即停用该费率。

「统一保存」针对新增 draft 行，不是保存勾选的既有行。表格虽有勾选框，当前工具栏没有批量编辑或批量删除入口。新增、单行编辑、文件导入的校验并不完全相同，保存成功不证明季节、数值或适用范围已完整通过业务审核。

05 校验、发布与历史：核对真正成功

发布和确认发布未演示；截图历史是预置记录，不代表本次执行了发布。

1. 完成并核对所有草稿后，使用有发布权限的账号点击「校验」。该按钮读取启用草稿相对最近成功发布的新增、更新、删除和不变数量，并检查重复发布键。
2. 核对差异；若启用范围或删除数量超出预期，回到列表检查。「校验通过」不代表已检查全部费率数值、季节重叠和单位；缺失／不支持的体积单位会在真正发布时拦截。
3. 点击「发布」打开「发布配置快照」，核对模块、上一批次、业务周及差异后，才可「确认发布」。发布范围是当前模块全部启用草稿，不受搜索、分页或勾选影响；禁用行跳过。同模块本业务周的旧 raw 快照会被替换，不能当作任意版本回滚入口。
4. 观察结果反馈，再点「历史」。核对批次ID、状态、业务周、发布行、跳过行、失败原因和开始／结束时间。只有 success 才是成功批次，failed 需要按失败原因排查；HTTP 请求返回成功不等于响应中的业务状态成功。

顶部「最近发布时间」取最新历史项的结束时间，并未只筛选成功批次；它不能单独证明最新费率已生效。发布前检查失败还可能没有生成新批次，因此同时保留页面错误信息。历史加载失败也可能呈现空列表，不能只凭“暂无发布记录”断言从未发布。

06 模板、导入与导出：明确文件范围

模板下载、导出、导入提交均未演示；只读演示不提供下载接口。

1. 先切到要维护的费率类型，点「模板」取得中文列头 CSV，或点「导出」取得现有配置 XLSX。导出包含当前模块全部未删除配置，含禁用行，不受关键词、页码、字段显示或勾选范围限制。
2. 按模板填写，不要同时放入映射到同一字段的中文、英文重复列。支持 CSV／XLSX；空业务内容行会跳过。新建记录和更新记录需区分「配置ID」：存在且可匹配的 ID 用于更新，空 ID 用于新增，不能把相同区域或名称当作导入去重保障。
3. 点「导入」打开「导入配置」，选择文件。默认不勾选「导入前清空当前草稿（软删除）」；该选项影响整个模块当前草稿，不是当前搜索结果，应先导出并核对完整替换范围。
4. 点「开始导入」直接提交。页面没有独立预览或预检步骤。列头冲突、无效配置ID、启用值和排序等错误会提示失败；按报错行号修正后再处理。不能把失败请求假定为完全没有写入，遇到执行异常先刷新／导出对账再决定重试。
5. 成功后核对“总计、成功、跳过”和实际行内容；导入是草稿维护，不是发布。重复导入无配置ID的文件可能增加重复记录，之后仍需检查发布键和业务适用范围。

07 权限与状态边界

• 读取权限：inventory_storage_fee_rate:read 用于进入、查询、模板、导出、发布历史及差异读取。本次账号只有读取权限。
• 维护权限：读取权限加 inventory_storage_fee_rate:write 才可新增、编辑、删除、导入。业务界面会禁用相应按钮。
• 发布权限：读取权限加 inventory_storage_fee_rate:publish；维护与发布是独立权限，不能从“能编辑”推断“能发布”。页面「发布」还要求先完成一次「校验」。
• 状态区别：draft 是尚未保存的新行；启用／禁用是配置行属性；待发布差异是草稿与最近成功批次的比较；历史中的 running、success、failed 是发布批次状态。它们不是审批状态，本页没有审批链或定时生效按钮。

保存或导入后重新校验，再核对发布历史。当前页没有按业务视图、仓库或店铺划分费率卡的入口；读取权限也不应理解成仅能导出当前屏幕内容。

08 核对下游结果：按消费者检查匹配

配置维护完成后，先核对草稿值、发布成功批次，再到实际消费页面检查所用来源与结果版本。以下是现行链路差异，不是新增操作；本次未演示下游计算或历史重算。

运营预算：读取月度最新成功发布批次，并在卡内选择最大的非空内部版本月份；全为空则采用无月份的当前卡。预算月份用于季节范围匹配，不要求为每个预算月复制一张卡。按区域、尺寸、月份匹配，具体区域优先通配区域，具体尺寸优先默认尺寸，有明确月份范围优先。这个消费者存在 ANY／空区域、any／default／空尺寸回退，但不能把它当成库存健康也支持的全局默认规则。单价依次尝试月度总额、系统计算总额、基本费加附加费等；明确 0 不会被当作缺失跳过。同等优先级重叠规则不应依赖行排序猜测结果。

普通预算中新品 N 的估算及简化预算路径使用这些月度费率；普通老品仓储费走利润来源。预算不是所有商品统一读取一个单价；还需核对自身预算模式、包装体积、汇率和计算结果。可关联 运营预算 继续检查。

库存健康及月初超龄预测：月度季节基础费从成功发布批次读取，仍要求内部版本月份等于计算月份，按区域和尺寸匹配。当前季节策略为 9–11 月旺季、其余淡季；而本页保存时从“旺季／淡季”文字补空字段采用 10–12／1–9 月。两条路径不能混为一谈：界面显示“唯一当前卡”不保证所有计算月都能命中，发生缺失应携带计算月份、费率字段与批次交给负责人核对，不能擅自靠复制或改月份修复。

库存健康比较实际来源费率与季节基础费时先核对币种和体积单位，币种一致才比较；相同区域、尺寸出现冲突季节基础费会标记异常。长期费率按规范化区域及来源周／时间选取，常规健康费用使用汇总库龄档，超龄预测使用细库龄档。长期币种及汇率参与人民币估算，不能只核对月度卡。

发布批次变化可影响库存健康当前结果的新鲜度和后续生成，已固化的历史费用证据不会因为编辑本页自动回填。部分旧记录可能没有完整计算证据，应明确保留缺失状态。到 库存健康 核对计算月份、费率批次、选中单价和异常原因，而不是把本页「刷新」当作费用重算。

09 常见异常处理

• 暂无费率数据：确认页签，清空关键词、恢复全部状态，检查读取请求是否失败。无匹配结果、无权限和来源未准备不是同一种空态。
• 单元格为“-”：可能是空值；数字 0 会显示为 0。禁用行表示不参加这次发布，不等于免费；“是否豁免”“是否适用附加费”也只是待核对字段，不能据此宣称所有下游必然免收。
• 统一保存失败：按失败行检查费率键／区域、排序、启用值及重复键；同批重复或与现有未删除配置冲突都可能失败。先核对成功数量，不要全批重复提交。
• 校验通过但发布失败：检查启用行的计价体积单位；仅接受可规范化的 cuft/cbm/cuin/cm3。发布重复键通常按月度内部月份加费率键（兼容来源ID），长期按规范化区域判定，不是完整的季节重叠检测。
• 费率合理但费用不符：逐一对比使用的消费者、月份、区域、尺寸、单价字段、币种、体积单位及结果版本。金额留空、缺汇率、缺体积和不匹配不应统一补 0。校验通过也不能证明所有下游采用同一个费率。
• 发布或导入中断：先刷新并核对列表、差异和历史批次；历史抽屉不是逐单元格编辑审计，也没有回滚按钮。保留错误文本、模块、配置ID和批次ID交管理员处理，避免盲目重复操作。

10 常见问题