Коннектор
Банк России API: ИИ-агент для курсов и ставок
Сервиса нет в каталоге. Подключение по описанию API.
Банк России API — веб-сервис ежедневных данных: курсы валют, учётные значения драгоценных металлов и другие показатели. Агент строит из них свою выгрузку и пересчитывает ваши таблицы по официальным значениям.
Что такое агент
Агент — программа, которой ставят дело, а не вопрос. Она сама открывает ваши сервисы, добирает данные, сверяет их по правилам и возвращается с готовым результатом: файлом, заявкой, списком расхождений. Признаки три: работает в ваших сервисах, доводит дело до артефакта, работает без вас. Чат-бот отвечает текстом, агент приходит с результатом. Для расчётов это значит: вместо ручного копирования курса — готовая таблица за период с указанием даты данных.
Что такое коннектор
Это подключение к веб-сервису по протоколу SOAP, а не плагин в бухгалтерскую программу. Адрес сервиса опубликован, отдельных ключей не требуется: данные открыты. При работе без платформы .NET понадобится SOAP-клиент и библиотека MSXML.
Проверка связи — вызов метода за конкретную дату: в ответ приходит документ с таблицей и датой, за которую данные. Коннектор не хранит паролей, потому что личный кабинет для этого не нужен.
Что это за сервис
Сервис отдаёт XML-документ в формате набора данных с таблицей курсов. В таблице есть название валюты, номинал, курс, цифровой код ISO, символьный код и курс за одну единицу валюты. Рядом в ответе лежит свойство с датой, за которую присланы данные.
Методы описаны отдельно: получение курсов на дату, получение месячных курсов и справочник валют. Для части методов нужен признак периодичности, чтобы отделить ежедневные значения от ежемесячных.
Что делает агент с Банк России API
### Своя система по API: чтение и запись
Агент вызывает метод за нужный день и складывает ответ в вашу базу: дата, валюта, номинал, курс, коды. Повторный запрос за ту же дату он распознаёт и не создаёт дубль, а обновляет строку, если данные изменились.
### Пересчёт чужой таблицы: найти ошибку
Агент пересчитывает присланную таблицу по официальному курсу и сравнивает с тем, что в ней записано. Строки, где результат расходится, он помечает и показывает, какой курс подставили вместо официального.
### Индексация и техошибки: список правок
Агент ведёт список валют и кодов, отмечает пропавшие и новые позиции, ловит ответы с пустой таблицей или с чужой датой. На выходе — перечень правок: что обновить в справочнике и где ответ пришёл не за ту дату.
Что остаётся человеку
Методика расчёта и трактовка нормативных документов. Проверку итогов перед отчётностью и решение по спорным позициям тоже делает финансист.
Как подключить
Откройте описание веб-сервиса ежедневных данных в разделе технических ресурсов, скопируйте адрес сервиса и список методов. Подготовьте SOAP-клиент: без платформы .NET нужна библиотека MSXML. Сделайте пробный вызов за вчерашнюю дату.
Чего агент не делает
Не считает курсовые разницы по вашей методике без правил. Не исправляет данные в источнике. Не работает, если сервис изменил формат ответа, — тогда он сообщает об ошибке разбора.
Вопросы
Что такое агент, если коротко? Программа, которая берёт дело и приносит результат: таблицу курсов за период, пересчёт, список правок. Разговаривать с ней не надо.
Что такое коннектор к веб-сервису? Подключение по протоколу SOAP к опубликованному адресу. Ключи не нужны, доступ открытый.
Что если ответ пришёл за другую дату? Агент сверяет дату в ответе с запрошенной и помечает такой ответ как ошибку, не записывая его в базу.
Подключение
- Шаг 1: откройте раздел «Веб-сервис для получения ежедневных данных» на cbr.ru и скопируйте адрес сервиса.
- Шаг 2: изучите описание методов — получение курсов на дату, месячные курсы, справочник валют — и формат ответа.
- Шаг 3: подготовьте SOAP-клиент (без .NET понадобится MSXML) и выполните пробный вызов за вчерашнюю дату.