Коннектор

Банк России API: ИИ-агент для курсов и ставок

Сервиса нет в каталоге. Подключение по описанию API.

Банк России API — веб-сервис ежедневных данных: курсы валют, учётные значения драгоценных металлов и другие показатели. Агент строит из них свою выгрузку и пересчитывает ваши таблицы по официальным значениям.

Что такое агент

Агент — программа, которой ставят дело, а не вопрос. Она сама открывает ваши сервисы, добирает данные, сверяет их по правилам и возвращается с готовым результатом: файлом, заявкой, списком расхождений. Признаки три: работает в ваших сервисах, доводит дело до артефакта, работает без вас. Чат-бот отвечает текстом, агент приходит с результатом. Для расчётов это значит: вместо ручного копирования курса — готовая таблица за период с указанием даты данных.

Что такое коннектор

Это подключение к веб-сервису по протоколу SOAP, а не плагин в бухгалтерскую программу. Адрес сервиса опубликован, отдельных ключей не требуется: данные открыты. При работе без платформы .NET понадобится SOAP-клиент и библиотека MSXML.

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

Что это за сервис

Сервис отдаёт XML-документ в формате набора данных с таблицей курсов. В таблице есть название валюты, номинал, курс, цифровой код ISO, символьный код и курс за одну единицу валюты. Рядом в ответе лежит свойство с датой, за которую присланы данные.

Методы описаны отдельно: получение курсов на дату, получение месячных курсов и справочник валют. Для части методов нужен признак периодичности, чтобы отделить ежедневные значения от ежемесячных.

Что делает агент с Банк России API

### Своя система по API: чтение и запись

Агент вызывает метод за нужный день и складывает ответ в вашу базу: дата, валюта, номинал, курс, коды. Повторный запрос за ту же дату он распознаёт и не создаёт дубль, а обновляет строку, если данные изменились.

### Пересчёт чужой таблицы: найти ошибку

Агент пересчитывает присланную таблицу по официальному курсу и сравнивает с тем, что в ней записано. Строки, где результат расходится, он помечает и показывает, какой курс подставили вместо официального.

### Индексация и техошибки: список правок

Агент ведёт список валют и кодов, отмечает пропавшие и новые позиции, ловит ответы с пустой таблицей или с чужой датой. На выходе — перечень правок: что обновить в справочнике и где ответ пришёл не за ту дату.

Что остаётся человеку

Методика расчёта и трактовка нормативных документов. Проверку итогов перед отчётностью и решение по спорным позициям тоже делает финансист.

Как подключить

Откройте описание веб-сервиса ежедневных данных в разделе технических ресурсов, скопируйте адрес сервиса и список методов. Подготовьте SOAP-клиент: без платформы .NET нужна библиотека MSXML. Сделайте пробный вызов за вчерашнюю дату.

Чего агент не делает

Не считает курсовые разницы по вашей методике без правил. Не исправляет данные в источнике. Не работает, если сервис изменил формат ответа, — тогда он сообщает об ошибке разбора.

Вопросы

Что такое агент, если коротко? Программа, которая берёт дело и приносит результат: таблицу курсов за период, пересчёт, список правок. Разговаривать с ней не надо.

Что такое коннектор к веб-сервису? Подключение по протоколу SOAP к опубликованному адресу. Ключи не нужны, доступ открытый.

Что если ответ пришёл за другую дату? Агент сверяет дату в ответе с запрошенной и помечает такой ответ как ошибку, не записывая его в базу.

Подключение

  1. Шаг 1: откройте раздел «Веб-сервис для получения ежедневных данных» на cbr.ru и скопируйте адрес сервиса.
  2. Шаг 2: изучите описание методов — получение курсов на дату, месячные курсы, справочник валют — и формат ответа.
  3. Шаг 3: подготовьте SOAP-клиент (без .NET понадобится MSXML) и выполните пробный вызов за вчерашнюю дату.

Роли

Сценарии