Пересчитать сумму по переданному курсу валют
Робот «Пересчитать сумму по переданному курсу валют» вычисляет сумму в другой валюте по явно переданному курсу и номиналу.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору финансового процесса, которому нужно пересчитать подготовленную сумму по явно переданному курсу и сохранить основание расчёта.
Ошибка направления курса или номинала меняет сумму многократно. Робот принимает обе валюты, курс за заданный номинал и дату источника. Он не выбирает курс самостоятельно и позволяет явно контролировать округление результата.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Исходная сумма (AMOUNT) |
Обязательное поле |
Исходная валюта (FROM_CURRENCY) |
Обязательное поле |
Целевая валюта (CURRENCY) |
Обязательное поле |
Дробных знаков результата: 0–6 (SCALE) |
Обязательное поле |
Курс в целевой валюте (RATE) |
Обязательное поле |
Номинал исходной валюты (NOMINAL) |
Обязательное поле |
Дата курса YYYY-MM-DD (RATE_DATE) |
Обязательное поле |
Название переданного источника (SOURCE) |
Обязательное поле |
Округление (ROUNDING) |
Обязательное поле. Только точная сумма (exact); Ближайшее, половина вверх (half_up); Вниз (down); Вверх (up) |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Укажите AMOUNT, FROM_CURRENCY и целевую CURRENCY. Передавайте числа точными строками без разделителей тысяч и знаков валют.
- Заполните RATE как число единиц целевой валюты за NOMINAL единиц исходной. Курс и номинал должны быть строго положительными.
- Укажите RATE_DATE, название SOURCE, SCALE от 0 до 6 и ROUNDING. Значение source описывает переданный источник, а не подтверждает его достоверность.
- После выполнения проверьте статус, итоговую валюту и roundingDifference. Для exact дробный остаток при выбранной точности приведёт к ошибке.
Учебный пример и ожидаемый результат
Учебный курс: 9000 RUB за номинал 100 USD. Укажите AMOUNT=10, FROM_CURRENCY=USD, CURRENCY=RUB, RATE=9000, NOMINAL=100, RATE_DATE=2026-10-15, SOURCE=«Учебный курс», SCALE=2, ROUNDING=exact. Ожидается 900.00 RUB и нулевая разница округления. Числа демонстрационные и не отражают текущий рыночный курс.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Сумма в целевой валюте» (
amount). - «Целевая валюта» (
currency). - «Исходная валюта» (
fromCurrency). - «Дата курса» (
rateDate). - «Переданный источник» (
source). - «Результат минус точная сумма, дробь» (
roundingDifference).
Дата и источник возвращаются вместе с суммой, чтобы следующий шаг мог показать основание. roundingDifference хранит результат минус точную сумму дробью; положительное значение означает округление вверх относительно точного расчёта.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Принимает сумму, исходную и целевую валюты, курс, номинал, дату и название источника. Курс означает количество единиц целевой валюты за указанный номинал исходной. Целевая точность 0–6 и правило округления обязательны. Возвращает точную строковую сумму, остаток округления как дробь и основание расчёта. Курсы самостоятельно не загружает и актуальность источника не подтверждает. Числа передаются строками, неотрицательны и меньше 10^24; курс и номинал строго положительны.
Робот не загружает курс из ЦБ или банка и не подтверждает актуальность источника. Он не выполняет банковский обмен и не учитывает комиссии автоматически. Перепроверьте направление и номинал до применения суммы в документах.