¶ 承运商官网燃油率与燃油率维护
系统每天自动去 UPS、DHL、FedEx、TNT 四家官网抓取燃油附加费率并长期存档；燃油率页面同时管理公司自己维护的燃油率记录。算费时优先用公司自己维护的记录，没有维护过的，可以选择是否按官网当天费率计算。
入口：菜单 → 报价 → 燃油附加费（需要「燃油附加费」查看权限；新建、修改、立即失效、删除需要写权限）
¶ 一、这个页面能做什么
页面分三个页签：
| 页签 | 用途 |
|---|---|
| 燃油率 | 公司自己维护的燃油率记录（应收 / 应付 / 销售成本三类），算费优先用这里 |
| 官网费率 | 系统从四家承运商官网抓回来的费率存档，只读，用来核对和参考 |
| 变更记录 | 谁在什么时候改了什么，长期保留 |
¶ 二、燃油率（公司自己维护的记录）
¶ 按状态分三段查看
记录按当前时间分成三段，点上方按钮切换，默认看「生效中」：
| 段 | 含义 | 可做的操作 |
|---|---|---|
| 生效中 | 现在正在用的 | 新建、立即失效 |
| 将生效 | 生效时间还没到 | 新建、删除 |
| 已失效 | 已经过了失效时间 | 只能查看 |
「已经生效过」的记录不能删除，只能「立即失效」——因为它可能已经参与过费用计算，删掉就查不到当时按什么费率算的了。想停用请用「立即失效」。
¶ 新建一条燃油率
填承运商、燃油率、类型（应收 / 应付 / 销售成本）、生效时间；失效时间可以留空，表示一直有效。
「↓官网」按钮：填燃油率时，旁边会出现取官网当前费率的按钮，点一下直接填进来，不用手抄：
- UPS 出两个按钮：↓中国大陆站、↓香港站（UPS 官网分两套费率）
- DHL / FedEx / TNT 各出一个：↓官网
- 其他承运商没有官网数据，不显示按钮
¶ 时间段重叠时系统会自动让路
同一个承运商 + 同一个类型下，任何一个时间点只会有一条记录生效。新建的记录和已有记录时间段重叠时，系统按下面的规则自动处理旧记录，并在「变更记录」里留痕：
| 重叠情形 | 系统怎么处理旧记录 |
|---|---|
| 新记录压住旧记录的后半段 | 旧记录的失效时间提前到新记录生效前一秒 |
| 新记录压住旧记录的前半段 | 旧记录的生效时间推后到新记录失效后一秒 |
| 新记录整段包住旧记录，且旧记录已经生效过 | 旧记录自动失效（保留历史，不删） |
| 新记录整段包住旧记录，且旧记录还没开始生效 | 旧记录直接删除（从没算过费用，留着只会变成一条永远不会生效的幽灵记录） |
| 旧记录整段包住新记录 | 旧记录被拆成前后两段，中间让给新记录 |
这些调整都会自动完成，不需要手工去改旧记录；每一次调整都能在「变更记录」里查到改前改后。
¶ 立即失效
在「生效中」段勾选一条或多条，点「立即失效」并确认，这些记录从现在起失效，之后的费用不再按它们计算；已经算好的费用不变。
¶ 三、官网费率（系统自动抓的）
¶ 抓的是什么、什么时候抓
- 每天早上 5:00 自动去四家官网抓一次；当天没抓成功的，7:00 到 21:00 每两小时重试一次，成功了当天就不再重试。
- 一次抓回官网公布的最近一段时间的每周费率（通常十来周），长期存档，所以几个月前的账单也能对到当时的费率。
- 也可以点「立即更新」手动抓一次。正在抓的时候再点会提示「正在更新，请稍后再试」，不会重复抓。
| 来源 | 说明 |
|---|---|
| UPS · 中国大陆站 | UPS 中国大陆官网费率 |
| UPS · 香港站 | UPS 香港官网费率（和大陆站是两套） |
| DHL | DHL 香港站费率 |
| FedEx | FedEx 亚太/中国费率 |
| TNT | TNT 亚太费率 |
¶ 页面上能看到什么
上方五个来源各是一块，显示该来源当前生效的费率和生效起始日；点一块切换下面的明细表。明细表每行是官网的一周：
| 列 | 说明 |
|---|---|
| 生效开始 / 生效结束 | 官网公布的这一周区间，最新一期显示「至今」 |
| 燃油率 | 当期费率会高亮 |
| 官网更正 | 官网事后改过这一周的费率时显示「有更正」，点开可以看历史版本；没改过显示「—」 |
| 更新时间 | 最近一次抓到这条的时间 |
| 官网页面 | 点「查看」跳到承运商官网对应页面，可以自己核对 |
还可以按生效日期区间筛选，以及把当前来源、当前筛选范围内的记录导出。
右上角的状态图标显示最近一次抓取是否成功。抓失败时鼠标停上去能看到失败原因和下次重试时间。抓取失败不会影响已存档的费率，页面照常可用。
¶ 四、没有维护过的燃油率，要不要按官网算？
「燃油率」页签上方有一个开关：没有手动记录时，使用官网费率。
| 开关 | 算费时怎么取燃油率 |
|---|---|
| 关（默认，与以前一致） | 有手动维护的记录就用它；没有维护过的按 0 计算燃油 |
| 开 | 有手动维护的记录仍然优先用它；只有没维护过的，才按官网当天的费率计算 |
一点即保存、立即生效，并写入变更记录。已经生成的费用不会变，只影响之后新算的费用。
开关打开后，页面上会列出当前正在使用官网费率的承运商和类型，例如「DHL 应付、销售成本 · FedEx 应付、应收、销售成本 · UPS 应付、应收、销售成本」——列在这里的，就是没有手动记录、正在走官网费率的组合。给对应承运商和类型加一条手动记录，它就会从这个列表里消失。
几点要注意：
- 手动记录永远优先，开关只决定"没有手动记录时怎么办"。
- UPS 分中国大陆站 / 香港站，按这票货的始发地取：发货渠道绑的是 UPS 自家的转单接口（直连）时，用接口参数里的发件人国家（寄件人在香港就取香港站）；绑的是代理系统接口或没绑接口时，看渠道资料里的「启运地」：写了香港（含 HK、Hong Kong）取香港站，其余取中国大陆站。这和「官方旺季附加费」判始发地是同一套规则，详见 承运商官网旺季附加费与公式函数。DHL、FedEx、TNT 只有一套费率，不需要判断。
- 渠道自己配置的专属燃油率优先级最高，不受这个开关影响。
- 应收、应付、销售成本三类各算各的：例如 DHL 应收有手动记录、应付没有，那么开关打开后应收仍按手动记录、应付才走官网。
- 官网那天没有对应费率时按 0 计算。
¶ 五、变更记录
新增、修改、立即失效、删除、开关变动，以及系统对旧记录做的自动调整，全部记在这里，长期保留。可以按时间、操作人、对象、操作、变更内容筛选，也可以导出。
每条记录都保存了改前和改后的完整内容，例如「失效时间：空 → 2026-09-09 15:25:37（记录：生效 2026-09-01 00:00:00 起，18.00%）」。
¶ 六、和账单核对怎么配合
小易的「燃油率核对结果表」里那一列官方燃油率，取的就是这里的官网存档。
它按账单上的出口时间，去查那一周官网公布的费率（UPS 的站点也按上面的始发地规则取），再和系统里这票实际记的燃油率逐票对比。
- 想看某一票为什么核出不一致，可以到「官网费率」页签按那一周的日期筛选，确认官网当时公布的是多少。
- 核出来不一致、要批量修正的，用小易的「更新燃油率」指令，它取的费率和核对表同源。
详见 用小易核对代理账单。
¶ 相关文档
- 用小易核对代理账单
- 按上网时间调整燃油费
- 承运商官网旺季附加费与公式函数：同样自动采集的官网旺季附加费，始发地判定与本页相同