Помощник в управлении бизнес процессами
При работе с бизнес-процессами в Битрикс24 часто наступает такой момент когда штатных функций конструктора бизнес-процессов становится недостаточно для реализации необходимой логики. Тут на помощь приходит наш модуль, который позволяет расширить функционал бизнес-процессов путем добавления дополнительных действий (активити). На данный момент реализованы следующие действия:
Создать счет на основании сделки
Выбор данных предложения
Получить ID связанных предложений
Получить ID по названию элемента универсального списка
Получить ID элементов списка привязанных к CRM сущности
В дальнейшем в приложение будут добавляться новые действия. Вы можете нам помочь расширить этот список, для этого напишите нам на support@ravidok.ru о том, что вы бы хотели видеть в приложении.
Внимание! Функционал приложения будет корректно работать только на коробочной версии Битрикс24.
“видОК” - автоматизация бизнеса с помощью Битрикс24 по всей России.
Лидер по Программе мониторинга качества внедрений 1С-Битрикс.
Консультации по Битрикс24 в WhatsApp
Консультации по Битрикс24 в Viber
Консультации по Битрикс24 в Telegram
Консультации по Битрикс24 в Skype
Консультации по Битрикс24 в Вашем Битрикс24
Разработка модулей и приложений для Битрикс24 - support@ravidok.ru
Быстрое внедрение Битрикс24 - hello@ravidok.ru
Разработка и техническая поддержка сайтов - hello@ravidok.ru
Действие “Создать счет на основании сделки” полезно при интеграции с 1С, для передачи информации о выставленном счете и получении обратно статуса оплаты. Также ссылку на оплату используют для отправки клиенту с помощью email, sms и мессенджеров. Действие поддерживает привязку реквизитов, в том числе банковских, продавца и покупателя к счету.
Как пользоваться?
-
После установки модуля, в настройках модуля нажмите кнопку “Установить” напротив действия “Создать счет на основании сделки”
-
В редакторе бизнес-процессов появится установленное действие, вставьте его в ваш бизнес-процесс
-
После вставки действие следует настроить:
-
Необходимо указать ID сделки,
-
ID платежной системы для компаний,
-
ID платежной системы для контактов,
-
ID компании от которой будет выставляться счет,
-
Срок оплаты счета
-
Запускать от имени (пользователя).
Нажмите “Сохранить”.
-
-
Если действие отработало без ошибок то вам будут доступны 4 возвращаемых значения: “Ссылка на оплату созданного счета”, “ID созданного счета”, “Номер созданного счета” и ”Текст ошибки”, которые можно использовать в последующих действиях. Значения выбираются в форме “Вставка значения”->”Дополнительные результаты”.
-
Далее, после добавления действия, рекомендуется создать условие для проверки корректности возвращаемых значений. Рекомендуется проверять значение “ID созданного счета”, так как в случае ошибки это поле будет пустым (меньше или равно нулю), а значение “Текст ошибки” будет содержать текст ошибки. Для проверки возможно потребуется создать дополнительную переменную.
Входные параметры.
-
ID сделки, на основании которой будет создан счет (обязательный). По умолчанию стоит значение {=Document:ID} которое означает ID текущего документа бизнес-процесса. Это удобно, если бизнес-процесс запущен на основе сделки (создание и/или изменение).
-
ID платежной системы для компаний (обязательный). В этом параметре вам нужно указать ID платежной системы, в настройках которой “Тип клиента” стоит “Компания”. ID платежной системы можно узнать перейдя в CRM -> Еще -> Настройки -> Способы оплаты -> Выберите нужную платежную систему, в её карточке будет поле ID.
-
ID платежной системы для контактов (обязательный). В этом параметре вам нужно указать ID платежной системы, в настройках которой “Тип клиента” стоит “Контакт”.
-
ID компании от которой будет выставляться счет (не обязательный). ID вашей компании, данные из которой будут подставляться в счет. Желательно чтобы у этой компании были реквизиты и банковские реквизиты. Если не указан или указан неверный ID счет все равно будет создан, но без привязки к реквизитам продавца.
-
Срок оплаты счета. Можно указать срок оплаты счета, он будет отображаться в карточке счета и на печатной форме счета.
-
Запускать от имени (обязательный). Выберите пользователя или группу пользователей от имени которых будет запускаться действие. Для полноценной работы желательно указывать пользователя с правами администратора, так как может возникнуть ситуация при которой у пользователя от имени которого запускается действие нет прав для просмотра сделки.
Возвращаемые значения.
-
Ссылка на оплату созданного счета (либо пустая строка в случае ошибки)
-
ID созданного счета (либо пустая строка в случае ошибки)
-
Номер созданного счета (либо пустая строка в случае ошибки)
-
Текст ошибки - в случае ошибки это поле будет содержать описание ошибки.
Особенности реализации.
-
В Битрикс24 у контакта и компании может быть несколько реквизитов, в свою очередь у каждого реквизита может быть несколько банковских реквизитов.
Действие всегда выбирает самый первый реквизит (первый по ID, т.е. тот, который создан раньше других). Если у одной из сторон нет реквизитов - счет все равно будет создан, но без привязки к отсутствующему реквизиту. -
Для создания счета в Битрикс24 обязательно нужно указывать товары, компанию или контакт, печатную форму счета (платежную систему). Если в сделке не указаны товары, не выбран контакт или компания - счет не будет создан.
-
Если возникла ошибка, в значении “Номер созданного счета” будет пустая строка (это можно отследить в бизнес-процессе), а в значении “Текст ошибки” - описание ошибки.
-
В созданный счет переносятся значения из пользовательских полей сделки, но только те (поля), которые есть в счете.
С помощью действия “Выбор данных предложения” вы можете получить значение всех полей предложения зная его ID. Это действие хорошо работает вместе с другим нашим действием “Получить ID связанных предложений”.
Как пользоваться?
-
После установки модуля, в настройках модуля нажмите кнопку “Установить” напротив действия “Выбор данных предложения”
-
В редакторе бизнес-процессов появится установленное действие, вставьте его в ваш бизнес-процесс
-
После вставки действие следует настроить:
-
Необходимо указать ID предложения,
-
Выбрать поля, которые нужно получить
Нажмите “Сохранить”.
-
Если действие отработало без ошибок то вам будут доступны все выбранные поля предложения плюс одно дополнительное значение “Текст ошибки” в котором будет текст ошибки если была ошибка.
Входные параметры.
-
ID предложения (обязательный) - число, проще всего его получить с помощью другого нашего действия “Получить ID связанных предложений”.
-
Поля (обязательный) - выберите поля предложения, которые вы бы хотели получить. Выбранные поля будут доступны через меню “Вставка значения”
Возвращаемые значения.
-
Выбранные поля - значения выбранных полей. Будьте внимательны, так-как некоторые значения могут быть множественными, такие значения можно перебрать с помощью стандартного действия “Итератор”
-
Текст ошибки - в случае ошибки это поле будет содержать описание ошибки.
Действие “Получить ID связанных предложений” позволят получить ID привязанных к лиду или сделке предложений. Это действие хорошо работает вместе с другим нашим действием “Выбор данных предложения”.
Как пользоваться?
-
После установки модуля, в настройках модуля нажмите кнопку “Установить” напротив действия “Получить ID связанных предложений”
-
В редакторе бизнес-процессов появится установленное действие, вставьте его в ваш бизнес-процесс
-
После вставки действие следует настроить:
-
Необходимо указать тип сущности
-
Необходимо указать ID сущности
Нажмите “Сохранить”
-
Если действие отработало без ошибок то вам будут доступны 3 возвращаемых значения “ID связанных предложений”, “Количество связанных предложений” и “Текст ошибки”, которые можно использовать в последующих действиях с помощью меню “Вставка значения”.
Входные параметры.
-
Тип сущности (обязательный) - нужно выбрать “Лид” или “Сделка”
-
ID сущности (обязательный) - число, по умолчанию {=Document:ID} означающее ID сущности на основе которой запущен бизнес-процесс
Возвращаемые значения.
-
ID связанных предложений (множественное) - список ID привязанных предложений. Это значение множественное, его можно обработать с помощью стандартного действия “Итератор”
-
Количество связанных предложений - число, указывающее на количество найденных предложений, если предложений не найдено - значение будет 0
-
Текст ошибки - в случае ошибки это поле будет содержать описание ошибки.
Действие “Получить ID по названию элемента универсального списка” позволят получить ID элемента универсального списка зная его название. Это действие может хорошо сочетаться со стандартным действием “Чтение элемента списка”.
Как пользоваться?
-
После установки модуля, в настройках модуля нажмите кнопку “Установить” напротив действия “Получить ID по названию элемента универсального списка”
-
В редакторе бизнес-процессов появится установленное действие, вставьте его в ваш бизнес-процесс
-
После вставки действие следует настроить:
-
Необходимо выбрать универсальный список, в котором будет производиться поиск
-
Укажите название элемента универсального списка
Нажмите “Сохранить”
-
Если действие отработало без ошибок то вам будут доступны 2 возвращаемых значения “Список ID элементов универсального списка” и “Текст ошибки”, которые можно использовать в последующих действиях с помощью меню “Вставка значения”.
Входные параметры.
-
ID универсального списка (обязательный) - выберите универсальный список в котором нужно производить поиск
-
Название элемента универсального списка (обязательный) - введите название элемента, который вы хотите найти
Возвращаемые значения.
-
Список ID элементов универсального списка (множественное) - список ID найденных элементов. Это значение множественное, его можно обработать с помощью стандартного действия “Итератор”
-
Текст ошибки - в случае ошибки это поле будет содержать описание ошибки.
Действие “Получить ID элементов списка привязанных к CRM сущности” позволят получить ID элементов универсального списка привязанных к сущности CRM (Лид, Сделка, контакт, Компания). Это действие может хорошо сочетаться со стандартным действием “Чтение элемента списка”.
Как пользоваться?
-
После установки модуля, в настройках модуля нажмите кнопку “Установить” напротив действия “Получить ID элементов списка привязанных к CRM сущности”
-
В редакторе бизнес-процессов появится установленное действие, вставьте его в ваш бизнес-процесс
-
После вставки действие следует настроить:
-
Укажите ID сущности
-
Укажите тип сущности
-
Выберите универсальный список
Нажмите “Сохранить”
-
Если действие отработало без ошибок то вам будут доступны 3 возвращаемых значения “Список ID элементов универсального списка” и “Текст ошибки”, которые можно использовать в последующих действиях с помощью меню “Вставка значения”.
Входные параметры.
-
ID сущности (обязательный) - число, по умолчанию {=Document:ID} означающее ID сущности на основе которой запущен бизнес-процесс
-
Тип сущности (обязательный) - нужно выбрать сущность с которой мы работаем. Это могут быть “Лид”, “Компания”, “Контакт”, “Компания”.
-
ID универсального списка (обязательный) - выберите универсальный список в котором нужно производить поиск
Возвращаемые значения.
-
ID связанных элементов (множественное) - список ID найденных элементов. Это значение множественное, его можно обработать с помощью стандартного действия “Итератор”
-
Количество связанных элементов - число, указывающее на количество найденных элементов, если элементы не найдены - значение будет 0
-
Текст ошибки - в случае ошибки это поле будет содержать описание ошибки.
Установить модуль