¶ 承运商官网旺季附加费与公式函数
每年旺季（一般是 9 月到次年 2 月），UPS、FedEx、DHL、TNT 都会在官网公布一份旺季附加费（UPS 叫「高峰期紧急服务费」，FedEx / DHL / TNT 叫「需求附加费」）：按始发地、目的地大区、有效期，规定每公斤加收多少钱，有的还有每票最低收费。
系统会每天自动去四家官网采集规则，在一个页面里给你查看；报价里的附加费、触发器、录单限制可以直接用两个函数取得这票货的官网旺季附加费，不用再每年手抄官网表格配置规则。
入口：菜单 → 报价 → 官方旺季附加费（需要「官方旺季附加费」权限；页面只读，没有新增和修改）
¶ 一、这个功能能帮你做什么
| 想做的事 | 怎么做 |
|---|---|
| 查一下今天 UPS 中国大陆发德国，官网旺季附加费是多少 | 打开页面，选择 UPS、始发地「中国大陆」和目的国家「德国」，查看每公斤单价 |
| 客户问下一期 FedEx 发美国要加多少 | 选择 FedEx 和始发地，按生效日期查询 Economy / Priority 两档 |
| 报价的附加费要按官网旺季费自动加收 | 附加费的收费公式用「官方旺季附加费金额()」，收费条件用「有官方旺季附加费()」 |
| 旺季货不让录单，或者录单时提醒 | 录单限制 / 触发器里用「有官方旺季附加费()」 |
¶ 二、怎么打开
- 点右上角的「菜单」。
- 在「报价」一列里点「官方旺季附加费」。
¶ 三、页面怎么看
| 编号 | 区域 | 说明 |
|---|---|---|
| ① | 承运商页签 | 按 UPS、FedEx、DHL、TNT 切换。✓ 表示该承运商的来源最近一次更新正常；红色感叹号表示至少一个来源更新异常 |
| ② | 筛选条件 | 选择始发地、目的国家和生效日期。始发地会随承运商变化 |
| ③ | 更新状态 | 显示当前始发地来源的更新时间；「立即更新」只更新当前选择；「官网页面」打开对应官网原文 |
| ④ | 规则列表 | 每行一条官网规则，绿色单价表示在查询日期生效 |
¶ 先选承运商，再选始发地
页面只保留四个承运商页签。FedEx、DHL、TNT 的中国大陆和香港来源合并到同一个承运商页签，通过「始发地」切换；UPS 也在同一位置选择中国大陆、香港、日本、韩国等官网支持的始发地。
不同始发地的官网地址、币种、费率和更新时间仍分别处理。切换始发地后，页面会同时切换规则、更新时间、「立即更新」和「官网页面」。
| 承运商 | 可以选择的始发地 |
|---|---|
| UPS | 中国大陆、中国香港、日本、韩国等官网规则中支持的始发地 |
| FedEx | 中国大陆、中国香港 |
| DHL | 中国大陆、中国香港 |
| TNT | 中国大陆、中国香港 |
¶ 按条件查询
- 选择承运商（①）。
- 选择始发地，再输入目的国家（②）。目的国家可以输入国家代码或名字，并从候选项中选择；留空表示查看全部。
- 选择生效日期。只填开始日期表示查看这一天正在生效的规则；填写开始和结束日期表示查看这一段时间内的规则。
- 点「查询」（③），列表只显示符合条件的规则（④）。
¶ 列表每一列的意思
| 列 | 说明 |
|---|---|
| 始发地 | 当前规则对应的始发地区 |
| 目的大区 | 官网划分的目的地大区，点名字可以展开查看包含哪些国家 |
| 服务类型 | 「全部」表示不分服务；FedEx / TNT 发美洲方向分 Economy / Priority 两档 |
| 生效开始 / 生效结束 | 官网规定的有效期。结束显示「另行通知」表示官网没有写结束日期；显示「（被新版本接替）」表示官网后来发布了新版 |
| 币种 / 每公斤单价 | 官网原币种和单价；绿色表示在查询日期生效 |
| 每票最低 | FedEx / TNT 有每票最低收费；UPS / DHL 没有时显示「—」 |
| 官网更新日 | 官网这版文件的发布日期。同一条规则出现多行、更新日不同，表示官网发布过多个版本，最新版本在上面 |
| 查看历史版本 | 查看这个始发地、目的大区和服务类型的全部历史版本 |
¶ 展开大区看国家清单
点「目的大区」列里的名字，下面会展开这个大区在官网当期脚注里包含的国家；再点一次可以收起。
每个大区包含的国家以官网当期脚注为准。同一个大区名在不同期可能包含不同国家，因此页面按这一行所属的版本展示国家清单。
¶ 查看历史版本
点行尾的「查看历史版本」，弹窗会显示这条规则（同始发地、同目的大区、同服务类型）的全部版本，最新版本在上面，绿色表示在当前查询日期生效。想知道上一版费率或规则何时切换，可以在这里查看。
¶ 当前没有规则时怎么看
查询日期没有生效规则时，先看列表中的说明：
- 显示「官网数据已采集成功」表示采集正常，只是当前日期没有适用规则。
- 系统找到更晚生效的规则时，会显示实际的下一期开始日期，并提供「查看下一期」（③）。
- 点「查看下一期」后，开始日期会自动变成实际下一期日期（①），并显示下一期规则（②）。
- 如果官网还没有发布更晚一期的规则，页面不会反复提供没有结果的“下一期”，只会说明当前条件下没有适用规则。
图中的 2026-10-01 是当时官网已采集数据里的下一期开始日期，不是系统写死的日期。以后官网发布新的周期，页面会按实际数据提示。
¶ 出现红色感叹号时怎么看
一个承运商可能有多个始发地来源。只要其中一个来源更新失败，承运商页签就会显示红色感叹号（①），页面紧接着用整行提示列出异常来源、失败原因、上次成功时间和下次重试时间（②）。
即使当前选择的是正常始发地，也能立即看到另一个始发地发生了什么；正常来源已经采集到的规则仍可以继续查询（③）。
¶ FedEx / TNT 的两档服务类型和每票最低
FedEx、TNT 发美国、加拿大、墨西哥、波多黎各方向分 Economy 和 Priority 两档，其他方向不分。它们还有每票最低收费：一票算出的旺季附加费低于这个数时，按这个数收。
¶ 立即更新
系统每天早上 5:10 自动采集一次；当天没有成功的来源会自动重试，一般不需要手动操作。
如果官网刚发布新版、需要立即查看，可以先选择承运商和始发地，再点「立即更新」。系统只更新当前选择的来源；更新过程中按钮会变成「更新中…」，完成后右上角会提示结果。
¶ 四、把官网旺季附加费自动算进报价
以前旺季要按官网表格手工配置多条附加费规则，官网更新后还要跟着修改。现在只需要在附加费里使用两个函数：
| 函数 | 返回什么 | 用在哪 |
|---|---|---|
| 有官方旺季附加费() | 这票货按承运商官网当前有没有旺季附加费规则：有 = 真，没有 = 假 | 附加费的收费条件、触发器、录单限制 |
| 官方旺季附加费金额() | 这票货按官网规则算出的旺季附加费金额（没有规则时是 0） | 附加费的收费公式；触发器、录单限制里也能用来比较 |
¶ 操作步骤
- 菜单 → 报价 → 报价管理，点顶部的「附加费」（①）。
- 点「添加」（或选择已有规则后点「修改」），先选择费用名称。
- 点「收费」右边的「公式」（①），在弹出的按钮中点「官方旺季附加费金额()」（②）。
- 函数会填入收费框（①）。
- 「收费条件」同样点「公式」，选择「有官方旺季附加费()」；这样没有旺季规则的货不会加收这条附加费。
- 保存，然后把这条附加费关联到需要的报价渠道。
先选费用名称再填公式：更换费用名称时，收费和收费条件会被清空重填。
这条附加费的币种建议使用「智能匹配报价」：函数算出的金额已经按当天汇率换算成报价币种。
¶ 函数怎么判断该用哪条规则
两个函数不传参数时，会从运单自动判断：
| 条件 | 怎么取 |
|---|---|
| 承运商 | 按报价中配置的承运商（附加费算费时）或运单发货渠道的承运商（触发器 / 录单限制）识别 UPS、FedEx、DHL 或 TNT |
| 始发地 | 渠道绑定承运商自有接口时，使用接口参数中的发件人国家；绑定代理系统接口或没有绑定接口时，查看渠道资料里的「启运地」：香港（含 HK、Hong Kong）按香港，其余按中国大陆 |
| 目的地 | 运单的收件国家 |
| 日期 | 发货时间；还没发货时使用收货时间；都没有时使用当前时间 |
| 服务类型 | FedEx / TNT 发美洲方向时，转单接口中指定的服务类型优先；没有指定时查看渠道名，包含 Economy / 经济 / IE 按 Economy，其余按 Priority |
想固定某个条件时也可以直接传参数，例如：
有官方旺季附加费('FEDEX', 'CN', 'US', '2026-10-10', 'ECONOMY')
官方旺季附加费金额('预报计费重')
¶ 金额怎么算
金额 = 计费重 × 官网每公斤单价，不低于每票最低收费。
- 重量默认取这票的计费重；也可以指定使用「预报计费重」「应收计费重」等。
- 官网单价使用官网币种（RMB、HKD、USD 等）。附加费算费时会按系统汇率换算成报价币种；触发器 / 录单限制中不换算，返回官网币种金额。
- 没有命中规则、始发地或目的地不在官网规则范围内、日期不在有效期内时，金额都是 0。
- 承运商不是这四家时，「有官方旺季附加费()」返回假，金额返回 0；保存公式时直接填写不支持的承运商名称会被拦下。
¶ 在触发器 / 录单限制里使用
在「基础数据」的触发器、录单限制的公式按钮中也可以使用这两个函数。例如：
官方旺季附加费金额('预报计费重') > 50
表示按预报重量算出的旺季附加费超过 50 时不允许录单。
¶ 五、结果验证
配置附加费后，找一票发货渠道属于这四家承运商、且收件国家在旺季规则范围内的运单，重新计算费用：
- 应收费用中应出现这条附加费。金额 = 计费重 × 页面对应规则的每公斤单价；低于每票最低时按每票最低，币种已换算成报价币种。
- 到「官方旺季附加费」页面，按这票的承运商、始发地、目的国家和发货日期查询，核对是否使用同一条规则。
- 换一票目的国家不在规则范围内的运单重新计算，这条附加费不应出现。
¶ 六、常见问题
DHL 当前日期没有数据，是不是采集失败？
不一定。先看 DHL 页签和页面提示：显示绿色对勾，并提示“官网数据已采集成功、当前日期尚无生效规则”，表示数据已经采集，只是规则还没有开始生效。页面找到下一期时，可以直接点「查看下一期」。只有页签出现红色感叹号，并显示具体异常来源和原因时，才表示最近一次更新异常。
红色感叹号表示所有始发地都不能用吗？
不是。它表示这个承运商至少有一个始发地来源最近一次更新异常。页面会明确写出发生异常的来源；其他正常来源以及此前成功采集的规则仍可查看和使用。
更新异常后，已有规则还能用吗？
能。更新异常不会删除上一次成功采集的规则。系统会按提示时间自动重试；也可以切换到异常始发地，点「立即更新」。
为什么没有“查看下一期”？
只有官网已经发布了更晚生效的规则时，页面才显示「查看下一期」。如果下一期也没有数据，页面不会继续跳转到一个没有规则的日期。
页面显示“尚未采集”怎么办？
表示当前来源还没有成功采集过，可以点「立即更新」，或等待系统下一次自动采集。
同一条规则为什么有多行？
官网发布过多个版本，每版一行，「官网更新日」不同，最新版本在上面。旧版结束日期显示「（被新版本接替）」，算费只使用查询日期对应的有效版本。
某个国家在展开的大区中能看到，函数却返回 0 / 假？
官网脚注里的国家名称和系统国家档案偶尔可能不一致。遇到这种情况请联系客服处理国家名称对应关系，补充后会在后续采集时自动对齐。
列表里没有我要查的国家？
官网当前规则没有覆盖这个国家，函数返回 0 / 假。
运单目的国家为空会怎样？
「有官方旺季附加费()」返回假，金额返回 0，不会报错。
和“燃油附加费”页面的官网费率是一回事吗？
不是。燃油率一般按周变化、按百分比计算；旺季附加费按有效期发布、按每公斤金额计算。两个页面分别维护，自动采集时间也不同。
¶ 相关文档
- 附加费与加收规则：附加费怎么配置、怎么关联到报价
- 承运商官网燃油率与燃油率维护：同样自动采集的官网燃油率
- 附加费与运费公式：附加费中可以使用的其他公式和函数
- 2025年FedEx旺季附加费设置、2025大陆DHL旺季附加费设置：以前手工配置旺季附加费的方法，现在可以改用本文函数