Получение текущего номера нумератора

Робот «Получение текущего номера нумератора» для Битрикс24: автоматическая нумерация документов в бизнес-процессах

Что делает робот

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

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

Главная ценность робота — он делает номер нумератора доступным внутри цепочки автоматизации. Раньше для этого приходилось писать код или обращаться к REST API вручную. Теперь достаточно добавить робота в бизнес-процесс и указать, какой нумератор использовать.

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

Автоматическая генерация номера договора. При создании сделки запускается бизнес-процесс, который с помощью этого робота получает текущий номер нумератора «Договоры», увеличивает его на единицу и присваивает сделке. Менеджеру больше не нужно вручную вводить номер — исключаются дубликаты и пропуски.

Контроль целостности нумерации счетов. Бухгалтер раз в день запускает проверку: робот получает последний номер счёта из нумератора и сверяет его с номером последнего счёта в учётной системе. Если номера расходятся, создаётся задача на расследование. Это помогает вовремя заметить, что кто-то создал счёт в обход CRM.

Передача номера во внешнюю систему. При создании документа в CRM его номер нужно передать в 1С или другую учётную систему. Бизнес-процесс использует робота, чтобы получить следующий номер нумератора, и отправляет его вместе с остальными данными во внешний API.

Формирование отчёта по нумерации. Руководитель хочет видеть, сколько документов каждого типа было создано за месяц. Бизнес-процесс собирает текущие номера всех нумераторов на начало и конец месяца, вычисляет разницу и формирует сводку.

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

Для настройки достаточно указать ID нумератора в Битрикс24. ID можно найти в разделе «Настройки CRM» → «Нумераторы» — он отображается в URL страницы редактирования конкретного нумератора. Никаких дополнительных параметров робот не требует.

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

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

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

Обратите внимание: робот возвращает «сырое» число. Если вам нужен номер с ведущими нулями (например, «00457» вместо «457»), используйте робота «Действия над текстом» для форматирования результата.

Интеграция с другими роботами

Робот «Получение текущего номера нумератора» эффективен в связке:

• С роботом «Действия над текстом» — чтобы отформатировать номер (добавить ведущие нули, префиксы, суффиксы).
• С роботом «Добавить комментарий задачу» — чтобы записать полученный номер в комментарий к задаче бухгалтера.
• С роботом «Забытые сделки» — например, чтобы проверить, не остались ли сделки с номерами договоров, которые давно не обновлялись.

Пример цепочки: «Получение текущего номера нумератора» → «Действия над текстом» (форматирование: добавить префикс «ДОГ-» и ведущие нули до 5 знаков) → запись в поле сделки.

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

Неверный ID нумератора. Если указать несуществующий ID, робот вернёт ошибку. Убедитесь, что нумератор создан и активен в разделе «Настройки CRM». ID можно скопировать из адресной строки браузера при редактировании нумератора.

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

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