税务机关汇率 API
一个 API 获取官方税务机关汇率:英国 HMRC 每月海关与增值税汇率、美国财政部每季度报告汇率,以 JSON 提供,历史数据可追溯至 2001 年。这些是报关单、增值税发票和联邦报告必须使用的固定汇率。
为什么税务机关汇率不是市场汇率
在任何一天,市场汇率和你依法必须适用的汇率是两个不同的数字 — 对海关和税务而言只有后者算数。税务机关为一个期间确定一个汇率并予以公布,要求该期间内的每一份申报都使用它,无论其间市场如何波动。若改用当天的市场汇率换算发票,关税或增值税金额将无法与机关计算的结果对上。
这是特性,不是局限。一个按月或按季度固定的汇率,让进口商、其报关行和海关当局各自独立地算出同一个数字 — 因此出现差异意味着确实有错误,而不是两个系统在相隔几小时的时点取了市场价。
两种发布周期的差别
两个数据源以不同的时间表解决同一个问题,集成时这一差别很重要:
- HMRC — 每月发布,提前公布。每个日历月一张汇率表,在其适用月份之前约两周发布,因此下个月的汇率可以提前知道。该月内任何日期都解析为当月汇率。
- 美国财政部 — 每季度发布,季中修订。每季度一张汇率表,日期为季末;对波动剧烈的个别货币会发布修订。修订只涵盖这些货币 — 因此最新的发布日期往往并非一张完整的汇率表。
API 返回的是现行有效的汇率表,而不是共享最新日期的那些行:即该期间的汇率并已套用其后的所有修订,每一行都带有它实际发布的日期。你直接得到申报人今天应据以报告的状态,无需从原始数据流重建。
覆盖的税务机关
实时覆盖 — 此表由 API 所用的同一数据库生成,因此始终与 /api/v1/central-banks 一致:
| 机关 | 国家/地区 | 代码 | 发布周期 | 货币数 | 历史起始 | 最新汇率表 |
|---|---|---|---|---|---|---|
| United Kingdom | hmrc | Monthly | 150 | 2021年1月 | 2026-08-01 | |
| United States | ustreasury | Quarterly | 187 | 2001年3月 | 2026-07-15 |
路线图上还有更多机关 — 包括爱尔兰 Revenue、加拿大、澳大利亚 ATO 和欧盟海关汇率。需要特定机关?告诉我们 — 请求会让相应数据源提前排期。
快速开始
与 AllRatesToday 其余部分相同的 API 密钥、认证和端点 — 税务机关由同样的 /central-bank/ 路由提供服务。用熟悉的 source/target 参数查询货币对:
curl "https://allratestoday.com/api/v1/central-bank/hmrc/latest?source=GBP&target=USD" \
-H "Authorization: Bearer art_live_your_key" 响应带有该汇率所属汇率表的发布日期:
{
"bank": "hmrc",
"name": "HM Revenue & Customs",
"rate_date": "2026-08-01",
"source": "GBP",
"target": "USD",
"rate": 1.3367,
"rate_type": "monthly",
"derived": false,
"method": "published"
} 或获取该机关公布的完整汇率表 — 当前期间它公布的每一种货币:
curl "https://allratestoday.com/api/v1/central-bank/ustreasury/latest" \
-H "Authorization: Bearer art_live_your_key" 付费套餐可查任意历史日期上现行有效的汇率表 — 发票日期、进口日期、报告日期:
curl "https://allratestoday.com/api/v1/central-bank/hmrc/2026-03-20?source=GBP&target=USD" \
-H "Authorization: Bearer art_live_your_key" 人们用它做什么
- 海关与进口关税 — 按申报所属月份的 HMRC 汇率自动为货物计价,不必每月从 PDF 里粘贴数字。
- 增值税开票 — 按 HMRC 对相应期间要求的汇率开具并核对外币发票。
- 美国联邦报告 — 按各机构、承包商和受资助方都必须使用的财政部报告汇率换算外币余额。
- 审计与重述 — 取出某个历史日期上现行有效的确切汇率表(已套用修订),使重述后的数字与原始申报一致。
- ERP 与会计系统集成 — 每个期间只需安排一次获取并缓存;按月或按季度的汇率不会在期间中途变动。
套餐
- 所有套餐(含免费版):最新现行汇率表,以及从中取用的单一货币对。
- 付费套餐:历史日期、时间序列和发布日历。
由于汇率按月或按季度固定,每个期间缓存一次请求即可覆盖该期间的全部单据 — 在这里,很小的配额也能用很久。查看套餐。
常见问题
什么是税务机关汇率 API?
返回各国税务和海关机关为合规目的公布的汇率(如 HMRC 每月海关与增值税汇率或美国财政部每季度报告汇率)而非实时市场汇率的 API。申报单、发票和官方报告必须使用这些汇率。
覆盖哪些税务机关?
2:HM Revenue & Customs, U.S. Department of the Treasury。还在持续增加,同一个 API 也覆盖 35 家央行。
这与央行汇率 API 有何不同?
这是同一个 API、同样的端点 — 只是发布方不同。央行作为货币政策的一部分每个工作日发布一次汇率;税务机关每月或每季度固定一个汇率,正是为了让该期间内的各项申报彼此一致。你需要哪一种,取决于你要遵守的规则。
报关时应该用哪个汇率?
用申报所属期间的税务机关汇率,而不是当天的市场汇率。查询期间内的任意日期都会返回该期间的官方汇率,因此按发票日期或进口日期查询即可得到你必须适用的汇率。
季中修订如何处理?
美国财政部会在季度中途修订个别货币,因此它最新的发布日期往往只有寥寥数行而不是一张汇率表。API 返回现行有效的汇率表 — 该季度的汇率并已套用其后的所有修订 — 且每一行都带有它实际发布的日期。