Курс валюты из настроек Битрикс24
Робот возвращает курс валюты, который записан в настройках валют самого Битрикс24 (CRM → Настройки → Валюты), прямо в бизнес-процессе или роботе. На вход принимает код валюты: USD, EUR, CNY и другие. Возвращает курс за одну единицу в базовой валюте портала, код базовой валюты и признак «найдено». Подходит, когда компания работает по своему курсу, а не по курсу банка.
Робот читает справочник валют портала — тот же, который администратор заполняет в разделе CRM → Настройки → Валюты. Курс возвращается за одну единицу валюты с учётом номинала: если в настройках задано «100 JPY = 60», робот вернёт 0.6. Для базовой валюты возвращается 1. Если такой валюты в настройках нет, признак «найдено» равен N. Робот всегда берёт текущий курс: историю курсов портал не хранит. Типовые случаи: пересчёт суммы сделки по внутреннему курсу компании формулой в дизайнере бизнес-процессов и запись курса в поле сделки или смарт-процесса в момент выставления счёта.
Какую задачу закрывает
Многие компании считают сделки не по курсу банка, а по своему: курс закладывает запас на колебания или согласован с поставщиком. Такой курс администратор вводит в Битрикс24 в разделе CRM → Настройки → Валюты, но в дизайнере бизнес-процессов готового способа достать его нет. Робот возвращает курс из этого раздела по коду валюты, и дальше его можно записать в поле или подставить в формулу.
Как настроить
В поле «Код валюты (USD, EUR, CNY...)» укажите трёхбуквенный код. Регистр и пробелы не важны: « usd » робот поймёт как USD. Робот возвращает три значения: курс за одну единицу в базовой валюте портала, код базовой валюты и признак «найдено» (Y или N). Типовые случаи:
- Курс в сделку при выставлении счёта: робот ставится на стадию «Счёт», курс записывается в пользовательское поле сделки.
- Сумма в базовой валюте: курс умножается на сумму сделки формулой в дизайнере, например ={{Сумма}} * курс из результата робота.
Номинал учитывается сам: если в настройках задано «100 JPY = 60», робот вернёт 0.6. Для базовой валюты курс равен 1.
Если робот вернул ошибку
«Валюты нет в настройках валют Битрикс24» — такого кода нет в разделе CRM → Настройки → Валюты. Признак «найдено» в этом случае равен N, а код базовой валюты всё равно заполнен. Добавьте валюту в настройках или проверьте код.
Доступы. Робот читает настройки валют от имени администратора, который установил Роботеку на портал. Битрикс24 отдаёт список валют только пользователю с правом на чтение настроек CRM. У администратора портала это право есть. Если у этой учётной записи права урезали или её отключили, Битрикс24 отвечает отказом в доступе, и робот завершается ошибкой. В этом случае признак «найдено» приходит пустым, а не N, поэтому условие «найдено = N» такую ошибку не поймает.
Курс всегда текущий: историю курсов портал не хранит.
В связке с другими роботами
- Курс валюты ЦБ РФ — официальный курс Центробанка на любую дату, если нужен курс банка, а не свой.
- Округлить число (до N знаков) — привести сумму после пересчёта к двум знакам.
- LTV клиента — сумма покупок клиента в базовой валюте по тем же курсам из настроек портала.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Код валюты (USD, EUR, CNY...) | string | да |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Курс за 1 единицу в базовой валюте | string |
| Базовая валюта портала | string |
| Валюта найдена (Y/N) | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: укажите код валюты
- Валюты «{currency}» нет в настройках валют Битрикс24
- Ошибка: в настройках валют Битрикс24 не найдена базовая валюта
Сценарий: внутренний курс компании в сделку
- Сделка в долларах переходит на стадию «Счёт»
- Робот получает курс USD из настроек валют Битрикс24
- Курс записывается в поле сделки
- Сумма в базовой валюте считается формулой: сумма × курс