Конвертировать сумму в текст

Что делает робот «Конвертировать сумму в текст»

В договорах, счетах и коммерческих предложениях сумму принято писать дважды: цифрами и прописью. Цифры Битрикс24 подставляет сам, а вот строку «Десять тысяч пятьсот рублей» кто-то набирает руками — и периодически ошибается в падежах. Робот убирает эту ручную работу: получает сумму с валютой одной строкой и возвращает готовый текст для документа.

Робот работает внутри бизнес-процесса: сумму он берёт из поля сделки, счёта или смарт-процесса, а результат кладёт обратно в поле или передаёт следующему роботу — например, в шаблон договора.

Как выглядит результат

Робот пишет сумму по-русски, с правильными падежами:

• «10500.00 RUB» → Десять тысяч пятьсот рублей
• «100.50 USD» → Сто долларов, 50 центов
• «25400,75 EUR» → Двадцать пять тысяч четыреста евро, 75 евроцентов

Целая часть уходит в текст полностью, дробная пишется цифрами с названием мелкой единицы — так принято в финансовых документах. Для валют без мелких единиц в обиходе (иена, южнокорейская вона, чилийское песо) дробная часть не выводится вовсе.

Формат входной строки свободный: разделителем копеек может быть точка или запятая, пробелы и переносы робот отбрасывает сам. Главное — чтобы в строке было число и буквенный код валюты.

Поддерживаемые валюты

Около шестидесяти валют: рубль, доллар, евро, юань, тенге, гривна, белорусский рубль, фунт стерлингов, иена, лари, драм, манат, турецкая лира, дирхам ОАЭ, польский злотый, чешская крона и другие. Названия валют склоняются по правилам русского языка: один рубль, два рубля, пять рублей.

Если код валюты роботу незнаком, он вернёт ошибку — текст не соберётся из неверного названия.

Настройка робота

Параметр один — «Сумма с валютой». Сюда подставляют значение из контекста процесса: поле с суммой сделки, результат предыдущего робота или готовую строку вида «10500.00 RUB». Больше настраивать нечего — язык результата всегда русский.

В карточке робота внутри приложения видны назначение, параметры и результат:

Сценарии использования

Договор с суммой прописью. Сделка переходит на стадию «Договор», бизнес-процесс генерирует документ из шаблона. Робот берёт сумму сделки, превращает её в текст, и в договоре появляется строка «Стоимость работ составляет Двести сорок тысяч рублей (240000 руб.)». Юрист больше не правит каждый договор руками.

Письмо клиенту с условиями оплаты. После выставления счёта робот отправляет письмо: «К оплате Семьдесят пять тысяч рублей, счёт во вложении». Текст собирается автоматически, менеджер только проверяет адрес.

Внутреннее согласование закупки. В смарт-процессе закупок заявка уходит руководителю на одобрение. Робот добавляет в задачу сумму прописью — на совещании проще зачитать «один миллион сто тысяч», чем разбирать цифры с экрана.

Результат работы

Робот возвращает два значения:

• Текст — сумма прописью с названием валюты. Его можно записать в поле, вставить в шаблон документа или передать роботу уведомлений;
• Статус — признак успешного выполнения. Если строка пустая или валюта не распознана, статус будет неуспешным, а текст останется пустым — такое стоит отлавливать условием в процессе.

Когда этот робот не подходит

Это legacy-робот для старых сценариев, где сумма и валюта уже хранятся одной строкой. Для новых бизнес-процессов используйте робота «Сумма прописью» из этого же приложения: там сумма, валюта и язык результата задаются отдельными параметрами, а валюту можно брать прямо из поля «Сумма и валюта» сделки.

Типичные ошибки при настройке

Валюта символом вместо кода. Строку «10500 ₽» робот не поймёт — нужен буквенный код RUB. Если в поле хранится символ, сначала прогоните значение через замену текста.

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

Пустое значение из поля. Если поле суммы не заполнено, робот завершится с неуспешным статусом. Перед ним полезно ставить условие «поле не пустое», иначе в документ попадёт пустая строка.