Роботека
Роботека · Роботы · Рабочих дней в стадии

Рабочих дней в стадии

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

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

Какие параметры принимает робот?

Параметр Тип Обязательный? По умолчанию
Сущность select Текущая сущность, Сделка по ID, Лид по ID, Смарт-процесс по ID — 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 на согласование в рабочих днях

  1. Регулярный бизнес-процесс запускается по сделке
  2. Робот считает рабочие дни в текущей стадии «Согласование»
  3. Если их больше двух, сделка нарушила SLA и руководителю уходит уведомление — выходные и праздники в просрочку не засчитываются

Похожие роботы