Курс валюты ЦБ РФ
Робот «Курс валюты ЦБ РФ» возвращает официальный курс выбранной валюты на последнюю опубликованную дату Банка России.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM, который использует справочный курс ЦБ РФ в автоматизации и хочет различать рубли за единицу валюты и обратное значение.
При пересчёте суммы легко перепутать направление курса или номинал публикации. Робот возвращает два отдельно подписанных показателя. Он читает доступную ежедневную публикацию источника и не обещает курс фактической банковской операции.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Валюта (rate) |
Обязательное поле. Доллар США (USD); Евро (EUR); Китайский юань (CNY); Белорусский рубль (BYN); Казахстанский тенге (KZT); Фунт стерлингов (GBP); Австралийский доллар (AUD); Азербайджанский манат (AZN); Армянский драм (AMD); Болгарский лев (BGN); Бразильский реал (BRL); Венгерский форинт (HUF); Вьетнамский донг (VND); Гонконгский доллар (HKD); Грузинский лари (GEL); Датская крона (DKK); Дирхам ОАЭ (AED); Египетский фунт (EGP); Индийская рупия (INR); Индонезийская рупия (IDR); Канадский доллар (CAD); Катарский риал (QAR); Киргизский сом (KGS); Молдавский лей (MDL); Новозеландский доллар (NZD); Норвежская крона (NOK); Польский злотый (PLN); Румынский лей (RON); Специальные права заимствования (XDR); Сингапурский доллар (SGD); Таджикский сомони (TJS); Таиландский бат (THB); Турецкая лира (TRY); Туркменский манат (TMT); Узбекский сум (UZS); Украинская гривна (UAH); Чешская крона (CZK); Шведская крона (SEK); Швейцарский франк (CHF); Сербский динар (RSD); Южноафриканский рэнд (ZAR); Южнокорейская вона (KRW); Японская иена (JPY) |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Выберите валюту из списка настроек. Поле даты в этом роботе отсутствует: произвольный исторический курс не запрашивается.
- Добавьте робота до шага расчёта и проверьте, какое направление нужно формуле. «Стоимость валюты» означает рубли за одну единицу выбранной валюты.
- После выполнения проверьте статус. При ошибке оба числовых результата нулевые; не используйте ноль как настоящий обменный курс.
- Передайте нужный показатель дальше только при успешном результате. Для расчёта с подтверждённым номиналом, датой и явным округлением используйте отдельное подготовленное действие.
Учебный пример и ожидаемый результат
Учебная публикация для выбранной валюты задаёт номинал 100 и стоимость 9000 рублей. Смысл результатов: «Стоимость валюты» 90 рублей за единицу, «Стоимость рубля» около 0.011111 единицы валюты за рубль. Это объяснение направлений на условных числах, а не текущий курс ЦБ РФ. Фактические значения берутся из доступной публикации во время действия.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Стоимость рубля» (
costRub). - «Стоимость валюты» (
costRate).
Результаты costRate и costRub имеют разные единицы. Умножение исходной валютной суммы на стоимость валюты переводит её в рубли; обратный показатель нужен для противоположного направления. Правила округления итоговой суммы задавайте отдельно.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Стоимость рубля: количество единиц валюты за один рубль. Стоимость валюты: рубли за одну единицу выбранной валюты. При ошибке оба значения равны нулю.
Источник может быть недоступен или не содержать выбранную валюту. В таком случае проверьте ошибку и не продолжайте денежный расчёт. Курс не включает банковские комиссии и не подтверждает фактическую цену покупки или продажи. Дата публикации отдельно в результатах не возвращается.