¶ 承运商官网燃油率与燃油率维护
系统每天自动去 UPS、DHL、FedEx（联邦）、TNT 官网抓取燃油附加费率并长期存档；其中联邦德国分为欧洲区域、国际、国内三个服务。燃油率页面同时管理公司自己维护的燃油率记录。算费时优先用公司自己维护的记录，没有维护过的，可以选择是否按官网当天费率计算。
入口：菜单 → 报价 → 燃油附加费（需要「燃油附加费」查看权限；新建、修改、立即失效、删除需要写权限）
版本提示：联邦德国三个服务及报价中的来源选择，需要使用包含该功能的版本；未升级的页面仍保持原有界面。
¶ 一、页面入口
页面分三个页签：
| 页签 | 用途 |
|---|---|
| 燃油率 | 公司自己维护的燃油率记录（应收 / 应付 / 销售成本三类），算费优先用这里 |
| 官网费率 | 系统从四家承运商官网抓回来的费率存档，只读，用来核对和参考 |
| 变更记录 | 谁在什么时候改了什么，长期保留 |
¶ 二、手工燃油率
¶ 按状态分三段查看
记录按当前时间分成三段，点上方按钮切换，默认看「生效中」：
| 段 | 含义 | 可做的操作 |
|---|---|---|
| 生效中 | 现在正在用的 | 新建、立即失效 |
| 将生效 | 生效时间还没到 | 新建、删除 |
| 已失效 | 已经过了失效时间 | 只能查看 |
「已经生效过」的记录不能删除，只能「立即失效」——因为它可能已经参与过费用计算，删掉就查不到当时按什么费率算的了。想停用请用「立即失效」。
¶ 新建一条燃油率
填承运商、燃油率、类型（应收 / 应付 / 销售成本）、生效时间；失效时间可以留空，表示一直有效。
「↓官网」按钮：填燃油率时，旁边会出现取官网当前费率的按钮，点一下直接填进来，不用手抄：
- UPS 出两个按钮：↓中国大陆站、↓香港站（UPS 官网分两套费率）
- FedEx（联邦） 有四个按钮：↓官网（原大陆来源）、↓德国－欧洲区域、↓德国－国际、↓德国－国内。
- DHL / TNT 各出一个：↓官网
- 其他承运商没有官网数据，不显示按钮
点击按钮只是把当前官网数值填入这条手工记录；保存后仍按手工记录使用，不会随官网每周自动变动。
¶ 时间段重叠
同一个承运商 + 同一个类型下，任何一个时间点只会有一条记录生效。新建的记录和已有记录时间段重叠时，系统按下面的规则自动处理旧记录，并在「变更记录」里留痕：
| 重叠情形 | 系统怎么处理旧记录 |
|---|---|
| 新记录压住旧记录的后半段 | 旧记录的失效时间提前到新记录生效前一秒 |
| 新记录压住旧记录的前半段 | 旧记录的生效时间推后到新记录失效后一秒 |
| 新记录整段包住旧记录，且旧记录已经生效过 | 旧记录自动失效（保留历史，不删） |
| 新记录整段包住旧记录，且旧记录还没开始生效 | 旧记录直接删除（从没算过费用，留着只会变成一条永远不会生效的幽灵记录） |
| 旧记录整段包住新记录 | 旧记录被拆成前后两段，中间让给新记录 |
这些调整都会自动完成，不需要手工去改旧记录；每一次调整都能在「变更记录」里查到改前改后。
¶ 立即失效
在「生效中」段勾选一条或多条，点「立即失效」并确认，这些记录从现在起失效，之后的费用不再按它们计算；已经算好的费用不变。
¶ 三、查看官网费率
¶ 抓的是什么、什么时候抓
- 每天早上 5:00 自动去四家官网抓一次；当天没抓成功的，7:00 到 21:00 每两小时重试一次，成功了当天就不再重试。
- 一次抓回官网公布的最近一段时间的每周费率（通常十来周），长期存档，所以几个月前的账单也能对到当时的费率。
- 也可以点「立即更新」手动抓一次。正在抓的时候再点会提示「正在更新，请稍后再试」，不会重复抓。
| 来源 | 说明 |
|---|---|
| UPS · 中国大陆站 | UPS 中国大陆官网费率 |
| UPS · 香港站 | UPS 香港官网费率（和大陆站是两套） |
| DHL | DHL 香港站费率 |
| FedEx | 原 FedEx 中国官网的国际服务费率；报价选项中称为「联邦－国际服务（中国官网）」 |
| 联邦德国－欧洲区域 | 德国官网欧洲区域服务费率 |
| 联邦德国－国际 | 德国官网国际服务费率 |
| 联邦德国－国内 | 德国官网德国国内服务费率 |
| TNT | TNT 亚太费率 |
德国三个服务来自同一德国官网页面，定时采集时共享页面请求、分别保存三套费率；手动「立即更新」只更新当前选中的服务。德国来源不代表法国、英国或所有欧洲国家的官网费率。
¶ 页面上能看到什么
上方每个来源各是一块，显示该来源当前生效的费率和生效起始日；点一块切换下面的明细表。明细表每行是官网的一周：
| 列 | 说明 |
|---|---|
| 生效开始 / 生效结束 | 官网公布的区间，开放结束的记录显示「至今」；德国来源同时显示德国日期及北京时间，详见「德国生效时间」 |
| 燃油率 | 当期费率会高亮 |
| 官网更正 | 官网事后改过这一周的费率时显示「有更正」，点开可以看历史版本；没改过显示「—」 |
| 更新时间 | 最近一次抓到这条的时间 |
| 官网页面 | 点「查看」跳到承运商官网对应页面，可以自己核对 |
还可以按生效日期区间筛选，以及把当前来源、当前筛选范围内的记录导出。
右上角的状态图标显示最近一次抓取是否成功。抓失败时鼠标停上去能看到失败原因和下次重试时间。抓取失败不会影响已存档的费率，页面照常可用。
¶ 四、开启官网算费
「燃油率」页签上方有一个开关：没有手动记录时，使用官网费率。
| 开关 | 算费时怎么取燃油率 |
|---|---|
| 关（默认） | 有手动维护的记录就用它；没有匹配到当时有效记录的按 0 计算燃油 |
| 开 | 有手动维护的记录仍然优先用它；只有没维护过的，才按官网当天的费率计算 |
一点即保存、立即生效，并写入变更记录。已经生成的费用不会变，只影响之后新算的费用。
开关打开后，页面上会列出当前正在使用官网费率的承运商和类型，例如「DHL 应付、销售成本 · FedEx 应付、应收、销售成本 · UPS 应付、应收、销售成本」——列在这里的，就是没有手动记录、正在走官网费率的组合。给对应承运商和类型加一条手动记录，它就会从这个列表里消失。
几点要注意：
- 手动记录永远优先，开关只决定"没有手动记录时怎么办"。
- 默认按承运商自动匹配；UPS 区分大陆 / 香港，联邦区分大陆 / 德国服务，详见「自动匹配规则」。也可在报价中直接指定官网来源。
- 渠道自己配置的专属燃油率优先级最高，不受这个开关影响。
- 应收、应付、销售成本三类各算各的：例如 DHL 应收有手动记录、应付没有，那么开关打开后应收仍按手动记录、应付才走官网。
- 按基准时间匹配不到所选来源的官网费率时，沿用无匹配按 0 的规则；不会改用另一服务或另一国家的费率。
- 手工记录即使是 0% 也优先，表示这一类型在该时间段免燃油，不会再取官网。
¶ 五、报价选择来源
¶ 设置前先开开关
- 打开「燃油附加费」窗口的「燃油率」页签。
- 打开「没有手动记录时，使用官网费率」。
- 打开需要设置的报价，进入「基本」页签。
- 在「官网燃油费率」选择来源，点击「确认」保存。
截图为演示配置。编号 1 是来源选择，编号 2 是说明图标；鼠标停在图标上查看提示，点击图标打开本文。
开关关闭时，这个下拉框隐藏。报价填写了专属燃油率时，按原界面交互隐藏相关官网选项；专属值仍然优先。未勾选「计算燃油」时，不因选择来源而额外计算燃油。
¶ 默认或指定
| 选择 | 含义 |
|---|---|
| 自动匹配（默认） | 由报价的承运商、转单接口配置及启运地判断，规则见下一节；旧报价未作选择时也按自动匹配 |
| UPS－中国大陆 / UPS－香港 | 直接使用对应 UPS 官网来源 |
| DHL－香港 / TNT－亚太 | 直接使用该承运商原官网来源 |
| 联邦－国际服务（中国官网） | 直接使用原 FedEx 中国官网的国际服务费率 |
| 联邦德国－欧洲区域 | 直接使用德国官网欧洲区域费率 |
| 联邦德国－国际 | 直接使用德国官网国际费率 |
| 联邦德国－国内 | 直接使用德国官网德国国内费率 |
指定后，不再执行自动判断，不会因报价承运商、API 发件国家、启运地或服务类型而切换来源。例如指定「联邦德国－欧洲区域」，即使报价接口配置了国内服务，也仍取欧洲区域。
指定来源仍须满足官网开关已开启、未命中手工记录、报价未设置专属燃油率等前提，不会越过手工记录。系统允许自主指定来源，保存前请核对所选服务是否符合实际计费约定。
¶ 复制与历史
复制报价保留原来的选择。该选择跟随报价保存及现有报价版本规则；新功能不会批量改写已经生成的费用。按历史基准时间计算时，仍按原流程选择报价版本和当期费率。
¶ 六、自动匹配规则
本节只适用于「自动匹配（默认）」。单独查价和运单算费，都根据本次选中的报价判断，不要求一定有运单。
¶ 先认承运商
按报价里的承运商识别 UPS、DHL、FedEx（联邦）或 TNT。DHL、TNT 沿用原来源；UPS 和联邦再判断始发地。
¶ 再判断始发地
- 报价绑定承运商自家直连转单 API，且配置的「发件人国家」可识别时，优先用这个国家。
- 没有接口、属于代理系统接口，或直连接口的发件国家未填写 / 无法识别时，看报价的「启运地」。代理系统的发件地址可能只是揽收地址，不用于判断承运商的计费站点。
这里的「发件人国家」在报价绑定的转单 API 参数中配置，不是让用户修改运单上的寄件人地址。「使用运单寄件地址」不改变此处的判断，UPS 与联邦沿用同一套规则。
| 承运商 | 判断结果 |
|---|---|
| UPS | 直连 API 发件国家有效时，香港取香港站，其余取大陆站；需要回看启运地时，香港（含 HK、Hong Kong）取香港站，其余仍取大陆站 |
| 联邦 | 直连 API 发件国家有效时，德国进入德国服务匹配，其余取原大陆来源；需要回看启运地时，能识别为德国才进入德国服务匹配，否则取原大陆来源 |
例如，报价启运地写深圳，但联邦直连 API 的发件国家配置 DE，自动按德国处理。客户价没有绑定 API、启运地为德国，也按德国处理；启运地无法判断为德国时，沿用大陆联邦。
¶ 德国再认服务
先确定德国来源，再根据本次报价绑定接口的实际服务选择对应费率；不按重量或目的国家重新猜服务。
| 德国服务 | 接口中已识别的服务代码 |
|---|---|
| 欧洲区域 | FEDEX_REGIONAL_ECONOMY、FEDEX_REGIONAL_ECONOMY_FREIGHT |
| 国际 | INTERNATIONAL_ECONOMY、INTERNATIONAL_ECONOMY_FREIGHT、INTERNATIONAL_FIRST、INTERNATIONAL_PRIORITY、INTERNATIONAL_PRIORITY_FREIGHT、FEDEX_INTERNATIONAL_PRIORITY、FEDEX_INTERNATIONAL_PRIORITY_EXPRESS、FEDEX_INTERNATIONAL_CONNECT_PLUS、EUROPE_FIRST_INTERNATIONAL_PRIORITY |
| 国内 | FEDEX_FIRST、FEDEX_PRIORITY_EXPRESS、FEDEX_PRIORITY、FEDEX_PRIORITY_EXPRESS_FREIGHT、FEDEX_PRIORITY_FREIGHT |
不同联邦接口的服务参数各按原接口解释：新联邦直连读取其服务选择；原联邦 V28/V29 按对应服务代码；默认旧版及 V26 只按其支持的国际代码判断，不把新版专用的 FEDEX_INTERNATIONAL_PRIORITY_EXPRESS 当作旧版已支持服务。亿龙达选择 FedexApi 时，0/IP、1/IE、2/FICP、3/IPF、4/IEF 对应国际；其他代理接口不套用这张数字表。
已确定是德国，但没有接口、服务为空或无法可靠对应时，统一取欧洲区域。 这只是系统默认规则，不表示这些未知服务已经被证明属于欧洲区域。如计费约定不同，可在报价中明确指定来源。
服务已经明确为国际或国内、只是该服务当时没有官网数据时，不切换到欧洲区域，按原无匹配规则处理。
¶ 七、德国生效时间
德国来源按德国当地日期生效，页面同时给出北京时间，避免把北京时间零点误当作换周时间。报价算费使用原有计算基准时间，不是固定拿今天的费率。
- 德国夏令时的当地周一 00:00，对应北京时间周一 06:00。
- 德国冬令时的当地周一 00:00，对应北京时间周一 07:00。
- 「北京时间……前」表示该时刻起已切到下一期；已经抓回的未来一期，不会提前参与计算。
例如德国欧洲区域费率周一从 33% 改为 32.5%，夏令时下，北京时间 05:59:59 仍用 33%，06:00:00 才用 32.5%。这是说明时间边界的示例，不代表长期固定费率。
官网历史更正、日期筛选和导出仍可用；德国导出包含德国日期及北京时间生效边界，其他来源保持原有格式。
¶ 八、查看修改记录
新增、修改、立即失效、删除、开关变动，以及系统对旧记录做的自动调整，全部记在这里，长期保留。可以按时间、操作人、对象、操作、变更内容筛选，也可以导出。
报价的官网来源选择另记入原渠道修改日志和「修改历史」：可以核对谁在什么时候把哪个来源改成哪个来源；复制报价也记录继承的选择。查看早期历史时，若当时没有记录来源，显示「当时未记录」，不会伪称当时是自动匹配。
燃油率页面每条记录都保存了改前和改后的完整内容，例如「失效时间：空 → 2026-09-09 15:25:37（记录：生效 2026-09-01 00:00:00 起，18.00%）」。
¶ 九、核对与调费
小易的「燃油率核对结果表」里那一列官方燃油率，取的就是这里的官网存档。
它按账单上的出口时间，依照账单承运商和原有核对规则，去查那一周官网公布的费率（UPS 的站点沿用原始发地规则），再和系统里这票实际记的燃油率逐票对比。
- 想看某一票为什么核出不一致，可以到「官网费率」页签按那一周的日期筛选，确认官网当时公布的是多少。
- 核出来不一致、要批量修正的，对小易说「更新燃油率」：按运单的上网时间取官网当期燃油率，支持 UPS、DHL、FedEx、TNT；核对表按账单出口时间核对，两处使用的日期可能不同。也可以在费用页面勾选费用，用「调整燃油」选择「按承运商官网燃油率」，见调整燃油。
报价中的「官网燃油费率」用于报价算费，不会把 UPS 账单改成跟随报价选择的联邦来源核对。核对账单、调整已有费用与报价算费是不同操作，各自使用原有入口及时间规则。
实际操作时，先核对差异，再检查并确认调整；完整步骤和完成效果见用小易调整燃油。
详见 用小易核对代理账单。
¶ 相关文档
- 用小易核对代理账单
- 按上网时间调整燃油费
- 承运商官网旺季附加费与公式函数：同样自动采集的官网旺季附加费；燃油德国服务的选择规则以本文为准
- 附加费与加收规则