Текущий номер нумератора
Робот «Текущий номер нумератора» для Битрикс24: автоматическая нумерация документов без дублей
Что делает
Робот получает актуальный номер из выбранного нумератора Битрикс24 без увеличения счётчика. Это позволяет узнать, какой номер будет присвоен следующему документу, и использовать его в условиях, уведомлениях и других шагах бизнес-процесса.
Нумераторы в Битрикс24 — это механизм автоматической нумерации документов (счетов, актов, договоров, КП). Каждый нумератор хранит текущий счётчик и правила формирования номера: префиксы, постфиксы, дату и другие переменные.
Ключевые возможности:
- Получение текущего номера нумератора без инкремента
- Подстановка номера в уведомления и документы до финальной генерации
- Использование номера в условиях ветвления бизнес-процессов
- Работа с любым нумератором по его ID
Сценарии
Сценарий 1: Предварительное уведомление с номером документа Менеджер создаёт счёт. До финальной генерации счёт получает временный статус. Робот получает текущий номер нумератора → номер отправляется клиенту в уведомлении: «Вашему счёту будет присвоен № А-1245» → после подтверждения менеджером счёт генерируется окончательно с этим же номером.
Сценарий 2: Проверка лимита нумерации В компании настроен нумератор с лимитом до 9999. Робот получает текущий номер → если номер близок к лимиту (например, больше 9500) — создаётся задача администратору на расширение диапазона или создание нового нумератора.
Сценарий 3: Ветвление по диапазону номеров Компания использует разные правила обработки в зависимости от диапазона номеров. Робот получает текущий номер нумератора → если номер меньше 5000 — применяется упрощённая процедура согласования → если больше 5000 — требуется дополнительное визирование руководителем.
Сценарий 4: Логирование и аудит В конце месяца нужно зафиксировать, на каком номере остановился каждый нумератор. Робот в циклическом бизнес-процессе обходит все нумераторы → записывает текущие номера в журнал аудита → формирует отчёт для бухгалтерии.
Настройка
- Добавьте робота в бизнес-процесс или умный сценарий
- Укажите ID нумератора — его можно найти в настройках CRM (CRM → Настройки → Нумераторы) или получить через API
- Настройте ветвление — на основе полученного номера можно построить условия и направить процесс по разным веткам
- Используйте номер — подставьте полученный номер в уведомления, задачи, документы или передайте в следующий робот
Важно: робот не увеличивает счётчик нумератора. Только чтение текущего значения. Для получения и увеличения номера используйте генерацию документа через шаблон.
Обязательное условие: к нумератору должен быть привязан хотя бы один шаблон генератора документов. Если создать нумератор и не привязать к нему ни одного шаблона, робот вернёт ошибку — шаблоны, использующие выбранный нумератор, не найдены.
Результат
Робот возвращает:
- Номер — текущее значение счётчика нумератора в виде строки (с учётом всех правил форматирования: префиксов, даты и т.д.)
- Название нумератора — человекочитаемое имя для логирования и отладки
- Статус — Y (успешно) или N (ошибка получения номера)
Интеграция
Робот встраивается в цепочки, где номер документа нужен до его финальной генерации:
- Уведомления: номер нумератора → SMS/email клиенту → подтверждение → генерация документа
- Ветвление: номер нумератора → условие по диапазону → разная логика обработки
- Контроль: номер нумератора → сравнение с лимитом → задача администратору
- Аудит: перебор нумераторов → запись в журнал → отчёт
Хорошо работает в паре с:
- «Генератор документов» — для финального создания документа с номером
- «Уведомление» — для отправки номера клиенту или сотруднику
- «Цикл» — для обхода нескольких нумераторов
Ошибки
| Ситуация | Поведение | Решение |
|---|---|---|
| Нумератор с указанным ID не найден | Статус N, ошибка | Проверьте ID нумератора в настройках CRM. Убедитесь, что нумератор активен |
| К нумератору не привязан ни один шаблон | Статус N, «не найдены шаблоны» | Привяжите хотя бы один шаблон генератора документов к нумератору в настройках |
| Нумератор заблокирован или удалён | Статус N | Проверьте состояние нумератора. При необходимости создайте новый |
| Счётчик достиг максимального значения | Возвращается последний номер в диапазоне | Настройте новый нумератор или расширьте диапазон текущего |
| Передан пустой ID нумератора | Статус N | Добавьте проверку: если ID пуст — используйте значение по умолчанию или сообщите об ошибке |