Роботека
Роботека · Роботы · Курс валюты из настроек Битрикс24

Курс валюты из настроек Битрикс24

Робот возвращает курс валюты, который записан в настройках валют самого Битрикс24 (CRM → Настройки → Валюты), прямо в бизнес-процессе или роботе. На вход принимает код валюты: USD, EUR, CNY и другие. Возвращает курс за одну единицу в базовой валюте портала, код базовой валюты и признак «найдено». Подходит, когда компания работает по своему курсу, а не по курсу банка.

Робот читает справочник валют портала — тот же, который администратор заполняет в разделе CRM → Настройки → Валюты. Курс возвращается за одну единицу валюты с учётом номинала: если в настройках задано «100 JPY = 60», робот вернёт 0.6. Для базовой валюты возвращается 1. Если такой валюты в настройках нет, признак «найдено» равен N. Робот всегда берёт текущий курс: историю курсов портал не хранит. Типовые случаи: пересчёт суммы сделки по внутреннему курсу компании формулой в дизайнере бизнес-процессов и запись курса в поле сделки или смарт-процесса в момент выставления счёта.

Какую задачу закрывает

Многие компании считают сделки не по курсу банка, а по своему: курс закладывает запас на колебания или согласован с поставщиком. Такой курс администратор вводит в Битрикс24 в разделе CRM → Настройки → Валюты, но в дизайнере бизнес-процессов готового способа достать его нет. Робот возвращает курс из этого раздела по коду валюты, и дальше его можно записать в поле или подставить в формулу.

Как настроить

В поле «Код валюты (USD, EUR, CNY...)» укажите трёхбуквенный код. Регистр и пробелы не важны: « usd » робот поймёт как USD. Робот возвращает три значения: курс за одну единицу в базовой валюте портала, код базовой валюты и признак «найдено» (Y или N). Типовые случаи:

  1. Курс в сделку при выставлении счёта: робот ставится на стадию «Счёт», курс записывается в пользовательское поле сделки.
  2. Сумма в базовой валюте: курс умножается на сумму сделки формулой в дизайнере, например ={{Сумма}} * курс из результата робота.

Номинал учитывается сам: если в настройках задано «100 JPY = 60», робот вернёт 0.6. Для базовой валюты курс равен 1.

Если робот вернул ошибку

«Валюты нет в настройках валют Битрикс24» — такого кода нет в разделе CRM → Настройки → Валюты. Признак «найдено» в этом случае равен N, а код базовой валюты всё равно заполнен. Добавьте валюту в настройках или проверьте код.

Доступы. Робот читает настройки валют от имени администратора, который установил Роботеку на портал. Битрикс24 отдаёт список валют только пользователю с правом на чтение настроек CRM. У администратора портала это право есть. Если у этой учётной записи права урезали или её отключили, Битрикс24 отвечает отказом в доступе, и робот завершается ошибкой. В этом случае признак «найдено» приходит пустым, а не N, поэтому условие «найдено = N» такую ошибку не поймает.

Курс всегда текущий: историю курсов портал не хранит.

В связке с другими роботами

Какие параметры принимает робот?

Параметр Тип Обязательный? По умолчанию
Код валюты (USD, EUR, CNY...) string да

Что возвращает робот?

Параметр Тип
Курс за 1 единицу в базовой валюте string
Базовая валюта портала string
Валюта найдена (Y/N) string

Какие ошибки может вернуть робот?

Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.

  • Ошибка: укажите код валюты
  • Валюты «{currency}» нет в настройках валют Битрикс24
  • Ошибка: в настройках валют Битрикс24 не найдена базовая валюта

Сценарий: внутренний курс компании в сделку

  1. Сделка в долларах переходит на стадию «Счёт»
  2. Робот получает курс USD из настроек валют Битрикс24
  3. Курс записывается в поле сделки
  4. Сумма в базовой валюте считается формулой: сумма × курс

Похожие роботы