Сумма прописью

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

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

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

Менеджеру документов и администратору, который подставляет сумму прописью в договор, акт или другой подготовленный текст.

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

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

Поле	Как заполнить
Сумма (amount)	Обязательное поле
Валюта (currency)	Необязательное поле
Язык (ru/en) (language)	Необязательное поле

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

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

1. Передайте amount как неотрицательную сумму. Десятичная часть может быть отделена точкой или запятой; пробелы в записи убираются.
2. Укажите поддерживаемый код валюты и language=ru либо en. При неизвестной валюте применяется RUB, при неизвестном языке ru, поэтому не рассчитывайте на ошибку вместо проверки настройки.
3. Учтите округление до двух знаков, половина вверх. Подготовьте сумму заранее, если правила вашего документа требуют другого округления.
4. Возьмите выход «Сумма прописью» и вставьте в нужное поле шаблона. Отдельно сверяйте, что числовой итог документа и текст описывают одну величину.

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

Для amount=125.50, currency=RUB, language=ru ожидается строка «Сто двадцать пять рублей 50 копеек». При amount=125.505 дробная часть сначала округляется до 51 копейки. Учебный пример показывает формат результата и не создаёт документ автоматически.

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

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

• «Сумма прописью» (text).

В схеме результата доступно текстовое поле text. Оно содержит готовую строку, а не раздельные рубли и копейки. Для валют без дробной единицы текст формируется без её наименования. Не используйте отсутствие отдельного поля статуса как основание игнорировать ошибку самого действия.

В объявленной схеме этого робота нет отдельных выходов статуса и пояснения ошибки: не создавайте условия на несуществующие результаты. Контролируйте завершение действия средствами процесса и проверяйте возвращённый текст перед подстановкой в документ.

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

Параметры: amount, код валюты currency, язык ru/en. Значения по умолчанию при отсутствии: сумма 0, RUB, ru. Неподдерживаемый код валюты заменяется RUB, неподдерживаемый язык ru. Сумма округляется до двух знаков по правилу половина вверх. Единственный объявленный результат: готовый текст суммы прописью.

Отрицательная или некорректная сумма не преобразуется. Робот не проверяет сумму договора, курс валюты или налоговую базу. Его задача ограничена словесной записью подготовленного числа; отправка и создание документа выполняются другими шагами.