Рабочих дней в стадии
Робот «Рабочих дней в стадии» возвращает в бизнес-процесс Битрикс24, сколько рабочих дней сделка, лид или элемент смарт-процесса провёл в указанной стадии по производственному календарю РФ — выходные и государственные праздники не считаются.
Робот считает рабочие дни в стадии прямо в бизнес-процессе Битрикс24, читая историю переходов в момент выполнения и сверяясь с производственным календарём РФ: субботы, воскресенья и государственные праздники из счёта выпадают. Это отвечает на вопрос «сколько реально простояла», когда календарные сутки вводят в заблуждение — сделка, попавшая в стадию в пятницу вечером, к утру понедельника висит три календарных дня, но всего один рабочий. Стадия задаётся кодом или названием, код в приоритете. Если сущность в стадии прямо сейчас, счёт идёт до сегодняшнего дня. При нескольких заходах можно взять последний или сумму всех; число заходов возвращается отдельно. Заход короче суток даёт ноль рабочих дней. Поддерживаются сделки, лиды и смарт-процессы. Для календарного времени есть парный робот «Время в стадии».
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Сущность | select | — | auto |
| ID сущности (для режимов «по ID») | string | — | |
| ID типа смарт-процесса (только для режима смарт-процесса) | string | — | |
| Стадия — код или название | string | да | |
| Что считаем | select | — | last |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Рабочих дней в стадии | int |
| Сколько раз входили в стадию | int |
| Сейчас в этой стадии (Y/N) | string |
| Код стадии | string |
| Название стадии | string |
| Стадия найдена (Y/N) | bool |
| Успешно | bool |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Стадия «{stage}» не найдена на портале. Укажите код стадии или её точное название.
- У этой сущности нет стадий. Робот работает со сделками, лидами и смарт-процессами; для режима «по ID» укажите корректный ID.
- Ошибка API при чтении истории стадий.
Сценарий: SLA на согласование в рабочих днях
- Регулярный бизнес-процесс запускается по сделке
- Робот считает рабочие дни в текущей стадии «Согласование»
- Если их больше двух, сделка нарушила SLA и руководителю уходит уведомление — выходные и праздники в просрочку не засчитываются