Пересчитать количество между согласованными единицами

Робот «Пересчитать количество между согласованными единицами» вычисляет количество по заданному коэффициенту и кратности, показывая остаток округления.

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

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

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

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

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

Поле	Как заполнить
Исходное количество (QUANTITY)	Обязательное поле
Коэффициент: целевых единиц в исходной (FACTOR)	Обязательное поле
Исходная единица (SOURCE_UNIT)	Обязательное поле
Целевая единица (TARGET_UNIT)	Обязательное поле
Кратность целевого количества (STEP)	Необязательное поле. по умолчанию 1
Округление (ROUNDING)	Обязательное поле. по умолчанию exact. Без остатка (exact); Вниз (down); Вверх (up); Ближайшее, половина вверх (nearest)

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

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

1. Заполните исходное количество, коэффициент и обе подписи единиц. Коэффициент означает число целевых единиц в одной исходной.
2. Укажите кратность целевого количества. По умолчанию 1 означает целые целевые единицы; для долей задайте нужный положительный шаг.
3. Оставьте exact, если потеря остатка запрещена. Выберите down/up/nearest только при согласованном правиле округления.
4. После выполнения проверьте статус и «Было округление». Передайте итоговое количество дальше, а остаток сохраните для контроля расхождений.

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

Для количества 2.5, коэффициента 12, единиц «упаковка» и «шт.», шага 1 и режима exact ожидается 30 целевых единиц без остатка. Для количества 1, коэффициента 2.5, шага 1, режима down результат будет 2, точное количество 2.5, остаток 0.5. При up результат 3, остаток -0.5.

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

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

• «Итоговое количество» (quantity).
• «До округления» (exactQuantity).
• «Остаток в целевой единице» (remainder).
• «Исходная единица» (sourceUnit).
• «Целевая единица» (targetUnit).
• «Было округление» (rounded).

Остаток вычисляется как точное количество минус округлённое в целевой единице. Поэтому при округлении вверх он может быть отрицательным. «До округления» позволяет восстановить исходную точную величину, а подписи единиц помогают верно трактовать результаты.

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

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

Целевое количество = исходное количество × коэффициент. Коэффициент и кратность положительные, количество от нуля. Исходная и целевая единицы: явные подписи; их совместимость и коэффициент задает автор процесса. Кратность по умолчанию 1. Режим exact по умолчанию запрещает потерю остатка; down/up округляют вниз/вверх, nearest: к ближайшему кратному, половина вверх. Остаток = точное количество минус округленное в целевой единице. Числа с точкой, до 100 значащих цифр и порядка от -100 до 100; возвращаются точными строками.

Робот не берёт коэффициент из ОКЕИ и не проверяет физическую совместимость единиц. Нельзя автоматически переводить вес в штуки без обоснованного коэффициента. Для денежного округления и налогов применяйте отдельно согласованные правила.