API курсов налоговых органов

Официальные курсы налоговых органов через один API: ежемесячные таможенные и НДС-курсы британской HMRC и квартальные отчётные курсы Минфина США в формате JSON, с историей с 2001 года. Фиксированные курсы, которые обязаны применять таможенные декларации, счета с НДС и федеральная отчётность.

Почему курс налогового органа — не рыночный курс

В любой день рыночный курс и курс, который вы обязаны применять по закону, — это два разных числа, и для таможенных и налоговых целей учитывается только второе. Налоговый орган фиксирует один курс на период, публикует его и ожидает, что все декларации этого периода будут использовать именно его, куда бы ни ушёл рынок за это время. Пересчитайте счёт по рыночному курсу дня — и сумма пошлины или НДС не сойдётся с той, которую посчитает орган.

Это свойство, а не ограничение. Курс, зафиксированный на месяц или квартал, позволяет импортёру, его брокеру и таможне независимо друг от друга прийти к одному и тому же числу — поэтому расхождение означает реальную ошибку, а не то, что две системы взяли рынок с разницей в несколько часов.

Чем различаются графики публикации

Два источника решают одну и ту же задачу по разным графикам, и при интеграции эта разница важна:

• HMRC — ежемесячно, публикация заранее. Одна таблица на календарный месяц, выходит примерно за две недели до месяца, к которому применяется, поэтому курс следующего месяца известен заранее. Любая дата внутри месяца разрешается в курс этого месяца.
• Минфин США — ежеквартально, с поправками внутри квартала. Одна таблица на квартал с датой на конец квартала; по отдельным валютам с резкими движениями выпускаются поправки. Поправка охватывает только эти валюты — поэтому самая свежая дата публикации часто не является полной таблицей.

API возвращает действующую таблицу, а не строки с самой свежей датой: курсы периода с уже применёнными более поздними поправками, где каждая строка несёт дату своей фактической публикации. Вы получаете то состояние, по которому подаёт отчётность заявитель сегодня, без реконструкции из сырого фида.

Охваченные налоговые органы

Актуальное покрытие — таблица строится из той же базы, что и API, поэтому всегда совпадает с /api/v1/central-banks:

Орган	Страна	Код	Периодичность	Валют	История с	Последняя таблица
HM Revenue & Customs	United Kingdom	hmrc	Monthly	150	январь 2021 г.	2026-08-01
U.S. Department of the Treasury	United States	ustreasury	Quarterly	187	март 2001 г.	2026-07-15

В планах — новые органы: ирландская Revenue, Канада, австралийская ATO и таможенные курсы ЕС. Нужен конкретный? Напишите нам — запросы двигают источники вверх по очереди.

Быстрый старт

Те же API-ключи, аутентификация и эндпоинты, что и в остальном AllRatesToday — налоговые органы обслуживаются теми же маршрутами /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 курсов налоговых органов?

API, возвращающий курсы, которые национальные налоговые и таможенные органы публикуют для целей комплаенса, — например ежемесячные таможенные и НДС-курсы HMRC или квартальные отчётные курсы Минфина США, — а не рыночные котировки. Именно эти курсы обязаны применять декларации, счета и официальные отчёты.

Какие налоговые органы охвачены?

2: HM Revenue & Customs, U.S. Department of the Treasury. Список пополняется, и тот же API покрывает 35 центральных банка.

Чем это отличается от API курсов центральных банков?

Это тот же API и те же эндпоинты — различается только публикующая сторона. Центральные банки публикуют курс каждый рабочий день в рамках денежно-кредитной политики; налоговые органы фиксируют один курс на месяц или квартал именно для того, чтобы отчётность внутри периода сходилась. Что нужно вам, зависит от правила, которое вы соблюдаете.

Какой курс использовать для таможенной декларации?

Курс налогового органа за период, в который попадает декларация, а не рыночный курс дня. Запрос любой даты внутри периода возвращает официальный курс этого периода, поэтому поиск по дате счёта или дате ввоза даёт именно тот курс, который вы обязаны применить.

Как обрабатываются поправки внутри квартала?

Минфин США вносит поправки по отдельным валютам в середине квартала, поэтому его самая свежая дата публикации часто представляет собой несколько строк, а не таблицу. API возвращает действующую таблицу — курсы квартала с применёнными более поздними поправками, — и каждая строка несёт дату своей фактической публикации.

См. также