Сложить денежные значения одной валюты

Робот «Сложить денежные значения одной валюты» складывает денежные значения без потери копеек и без смешивания валют.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Автору процесса согласования бюджета, который складывает подготовленные денежные позиции в одной валюте.

Суммы из нескольких шагов нужно объединить без потери десятичных долей и смешения валют. Робот проверяет валюту каждой записи и возвращает точную сумму строкой. Если встретились разные валюты, их нужно предварительно пересчитать по явно согласованному курсу.

Параметры и подготовка

Поле	Как заполнить
Массив в JSON, например [1,2,3] (ARRAY)	Обязательное поле
Код валюты из трёх латинских букв, например RUB (CURRENCY)	Обязательное поле

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

Как использовать

1. Подготовьте массив объектов с полями amount и currency для каждой позиции. Amount передавайте точной строкой с точкой, когда важна десятичная точность.
2. В отдельном поле CURRENCY укажите общий трёхбуквенный код. Он должен совпадать с валютой каждой записи.
3. Передайте массив в робота. Не используйте простой список чисел: каждой сумме требуется собственная подпись валюты.
4. После успешного выполнения используйте «Точная сумма» вместе с «Валюта». Округление для документа или отображения настройте отдельным шагом.

Как заполнить JSON-поля

Массив в JSON, например [1,2,3] (ARRAY)

[
  {
    "amount": "10.10",
    "currency": "RUB"
  },
  {
    "amount": "0.20",
    "currency": "RUB"
  }
]

Каждая запись содержит точную сумму amount и валюту currency. Валюта должна совпасть с CURRENCY. [] даёт ноль.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Учебный пример и ожидаемый результат

Массив [{"amount":"10.10","currency":"RUB"},{"amount":"0.20","currency":"RUB"}], CURRENCY=RUB. Ожидается точная сумма 10.30 и валюта RUB. Пустой массив даёт ноль в указанной валюте. Добавление позиции в другой валюте приводит к ошибке, а не к скрытому обмену.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Точная сумма» (total).
• «Валюта» (currency).

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

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Массив: [{"amount":"10.10","currency":"RUB"},{"amount":"0.20","currency":"RUB"}]. Валюта каждого значения должна совпадать с указанной. Пустой массив даёт 0 в указанной валюте. Дробный разделитель: точка. Конвертация и округление не выполняются. Размер входного JSON: до 1 МБ, массива: до 10000 элементов, вложенность: до 64 уровней.

Не добавляйте к amount знак валюты или разделители тысяч. Запятая как дробный разделитель не подходит. Робот не читает платежи самостоятельно, не проверяет их подтверждение и не применяет правила округления банка.