税务机关汇率 API
一个 API 获取官方税务机关汇率:英国 HMRC 每月海关与增值税汇率、美国财政部每季度报告汇率,以 JSON 提供,历史数据可追溯至 2001 年。这些是报关单、增值税发票和联邦报告必须使用的固定汇率。
为什么税务机关汇率不是市场汇率
在任何一天,市场汇率和你依法必须适用的汇率是两个不同的数字 — 对海关和税务而言只有后者算数。税务机关为一个期间确定一个汇率并予以公布,要求该期间内的每一份申报都使用它,无论其间市场如何波动。若改用当天的市场汇率换算发票,关税或增值税金额将无法与机关计算的结果对上。
这是特性,不是局限。一个按月或按季度固定的汇率,让进口商、其报关行和海关当局各自独立地算出同一个数字 — 因此出现差异意味着确实有错误,而不是两个系统在相隔几小时的时点取了市场价。
两种发布周期的差别
两个数据源以不同的时间表解决同一个问题,集成时这一差别很重要:
- HMRC — 每月发布,提前公布。每个日历月一张汇率表,在其适用月份之前约两周发布,因此下个月的汇率可以提前知道。该月内任何日期都解析为当月汇率。
- 印度 CBIC — 约每两周发布,次日生效。依据《海关法》第 14 条约每两周发布一份公告,自发布次日起生效,每种货币载有两个汇率(进口货物和出口货物),期间偶有针对单一货币的修订。
- 美国财政部 — 每季度发布,季中修订。每季度一张汇率表,日期为季末;对波动剧烈的个别货币会发布修订。修订只涵盖这些货币 — 因此最新的发布日期往往并非一张完整的汇率表。
API 返回的是现行有效的汇率表,而不是共享最新日期的那些行:即该期间的汇率并已套用其后的所有修订,每一行都带有它实际发布的日期。你直接得到申报人今天应据以报告的状态,无需从原始数据流重建。
当海关汇率就是央行汇率时
多数国家根本不单独发布税务汇率——其海关与税务规则直接指定央行公布的汇率。这些汇率同样在本 API 中,归属于发布它们的央行,可引用性完全相同。常见情形:
- 巴西 — 海关完税价格使用 PTAX 收盘卖出价(Portaria MF nº 6/1999),即 Banco Central do Brasil 汇率表中的
sell类型。 - 墨西哥 — 《联邦官方公报》公布的汇率就是 墨西哥银行 的 FIX,于次一工作日转载。
- 波兰 — 会计、税务与海关折算使用 NBP A 表。
- 捷克 — 捷克法律规定使用 捷克国家银行 的每日中间价。
- 罗马尼亚 — 会计、税务与海关规则引用 罗马尼亚国家银行 的参考汇率。
- 土耳其 — 海关价值按纳税义务发生之日有效的 TCMB 卖出价折算。
覆盖的税务机关
实时覆盖 — 此表由 API 所用的同一数据库生成,因此始终与 /api/v1/central-banks 一致:
| 机关 | 国家/地区 | 代码 | 发布周期 | 货币数 | 历史起始 | 最新汇率表 | 入库时间 (UTC) |
|---|---|---|---|---|---|---|---|
| India | cbic | Fortnightly | 22 | 2020年1月 | 2026-11-06 | — | |
| United Kingdom | hmrc | Monthly | 141 | 2021年1月 | 2026-11-01 | — | |
| United States | irs | Yearly | 38 | 2021年12月 | 2025-12-31 | — | |
| Peru | sunat | — | 1 | 2026年11月 | 2026-11-06 | — | |
| Switzerland | bazg | — | 72 | 2000年1月 | 2026-11-06 | 05:15 | |
| United States | ustreasury | Quarterly | 145 | 2001年3月 | 2026-10-30 | — |
货币数统计各机关当前汇率表中的货币数量。早期表中已删除的货币不计入该数字,但仍可通过历史数据端点获取。
路线图上还有更多机关 — 包括爱尔兰 Revenue、挪威与瑞典海关,以及印尼税务总局。需要特定机关?告诉我们 — 请求会让相应数据源提前排期。
快速开始
与 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。申报单、发票和官方报告必须使用这些汇率。
覆盖哪些税务机关?
6:Central Board of Indirect Taxes and Customs (CBIC), HM Revenue & Customs, Internal Revenue Service (yearly average rates), SUNAT (Peru tax and customs authority), Swiss Federal Office for Customs and Border Security, U.S. Department of the Treasury。还在持续增加,同一个 API 也覆盖 123 家央行。
这与央行汇率 API 有何不同?
这是同一个 API、同样的端点 — 只是发布方不同。央行作为货币政策的一部分每个工作日发布一次汇率;税务机关每月或每季度固定一个汇率,正是为了让该期间内的各项申报彼此一致。你需要哪一种,取决于你要遵守的规则。
报关时应该用哪个汇率?
用申报所属期间的税务机关汇率,而不是当天的市场汇率。查询期间内的任意日期都会返回该期间的官方汇率,因此按发票日期或进口日期查询即可得到你必须适用的汇率。
季中修订如何处理?
美国财政部会在季度中途修订个别货币,因此它最新的发布日期往往只有寥寥数行而不是一张汇率表。API 返回现行有效的汇率表 — 该季度的汇率并已套用其后的所有修订 — 且每一行都带有它实际发布的日期。