Создание сделки с товарами
- Автоматическое создание сделок с заранее определённым набором товаров при выполнении определённых условий;
- Создание сделок на основе данных из других систем или документов с автоматическим добавлением товарных позиций;
- Массовое создание сделок с товарами через бизнес-процессы;
- Автоматизация создания сделок из лидов с товарными позициями;
- Создание сделок с товарами при обработке заказов из интернет-магазина;
- Формирование коммерческих предложений в виде сделок с товарами;
- Дублирование сделок с сохранением товарных позиций для новых клиентов.
- Активити (робот) автоматически получает список всех доступных полей сделки из CRM вашего портала;
- Для каждого поля (кроме недоступных для редактирования) создаётся параметр, который можно заполнить при создании сделки;
- Обязательными для заполнения являются только поля "Название" (TITLE) и "Ответственный" (ASSIGNED_BY_ID);
- После создания сделки активити (робот) автоматически добавляет указанные товарные позиции к созданной сделке;
- Формат товаров: ID##количество##ед. измерения##цена##название товара;
- Активити (робот) возвращает ID созданной сделки для использования в дальнейших шагах бизнес-процесса.
Обязательные параметры:
| Название поля | Описание и примеры использования |
|---|---|
| Название (TITLE): |
Обязательное поле. В данном поле необходимо указать название создаваемой сделки. Примеры: - Договор поставки №123; - ={Договор {=Document:ID}}; - ={Новая сделка от {=System:NowLocal}}; |
| Ответственный (ASSIGNED_BY_ID): |
Обязательное поле. В данном поле необходимо указать ответственного за создаваемую сделку. Примеры: - ={user_25} - назначить пользователя с ID 25 (формат: user_ID); - ={25} - также можно указать только ID (активити (робота) автоматически добавит префикс user_); - ={=Document:ASSIGNED_BY_ID} - назначить ответственного из текущего документа; - Используйте условие в бизнес-процессе: если {=Variable:OPPORTUNITY} > 1000000, то назначить user_50.
Важно: При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв (или в формате user_ID). Если пользователь не найден по указанному ID, сделка не будет создана.
|
Параметры для работы с полями сделки:
Активити (робот) автоматически создаёт параметры для всех полей сделки, доступных для редактирования в вашем портале. Ниже описаны основные и наиболее часто используемые поля. Обратите внимание, что названия полей могут отличаться в зависимости от настроек вашего портала.
| Название поля | Описание и примеры использования |
|---|---|
| Тип (TYPE_ID): |
В данном поле можно указать тип создаваемой сделки. Значения берутся из одноимённого справочника CRM. Примеры: - SALE - тип "Продажа"; - COMPLEX - тип "Комплексная сделка"; - Необходимо указывать символьный код типа сделки из настроек CRM.
Как узнать символьный код типа сделки:
- Перейдите в CRM → Настройки → Типы сделок; - Или используйте активити (робот) для получения типов сделок. |
| Стадия сделки (STAGE_ID): |
В данном поле можно указать стадию создаваемой сделки. Примеры: - NEW - стадия "Новая"; - QUALIFICATION - стадия "Квалификация"; - Необходимо указывать символьный код стадии. Как узнать символьный код стадии: 1. В сделке нужно добавить штатное активити "Изменение документа" или штатное "Изменение стадии"; 2. В этом активити (роботе) выбрать поле "стадия"; 3. Нажать F12 и выбрать инструмент "выбор элемента страницы", и выбрать поле напротив поля "стадия"; 4. Появится расшифровка всех Стадий, выбираете название нужной и прописываете данное название в активити (робот) "Создание Сделки с товарами". |
| Направление (CATEGORY_ID): |
В данном поле можно указать направление создаваемой сделки. Направление сделки указывается в виде ID направления. Примеры: - ={0} - направление по умолчанию (ID 0); - ={=Document:CATEGORY_ID} - использовать направление из текущего документа;
Важно: Для корректного указания направления необходимо знать его числовой ID. Используйте активити (робот) "Получение данных Сделки" для получения ID направления существующей сделки.
|
| Вероятность (PROBABILITY): |
В данном поле можно указать вероятность заключения сделки в процентах (от 0 до 100). Примеры: - ={50} - установить вероятность 50%; - ={100} - установить вероятность 100% (высокая вероятность успеха); - ={0} - установить вероятность 0% (сделка неактивна). |
| Сумма (OPPORTUNITY): |
В данном поле можно указать предполагаемую сумму создаваемой сделки. Данное поле может заполняться автоматически из товарного раздела, если товары указаны с ценами и количествами. Примеры: - ={100000} - установить сумму 100 000; - ={{={=Variable:AMOUNT} * 1.1}} - установить сумму на основе переменной из предыдущего активити (робота) с увеличением на 10%;
Примечание: Если указаны товары с ценами и количествами, сумма сделки может быть рассчитана автоматически на основе товарных позиций.
|
| Валюта расчетов (CURRENCY_ID): |
В данном поле можно указать валюту расчётов создаваемой сделки. Значения берутся из одноимённого справочника CRM. Примеры: - RUB - рубли; - USD - доллары США; - EUR - евро. Необходимо указывать символьный код валюты из настроек CRM. |
| Ставка налога (TAX_VALUE): |
В данном поле указывается ставка налога, применяемая к создаваемой сделке (в процентах). Примеры: - ={20} - установить ставку НДС 20%; - ={0} - установить ставку 0% (без НДС); |
| Компания (COMPANY_ID): |
В данном поле можно указать компанию, которая будет привязана к создаваемой сделке. Примеры: - ={123} - привязать компанию с ID 123; - ={=Document:COMPANY_ID} - привязать компанию из текущего документа; |
| Контакт (CONTACT_ID): |
В этом поле указывается ID только одного контакта (устаревшее поле, сохраняется для совместимости). Примеры: - ={456} - привязать контакт с ID 456; - ={=Document:CONTACT_ID} - привязать контакт из текущего документа;
Рекомендация: Для работы с несколькими контактами используйте поле "Контакты (CONTACT_IDS)" вместо этого поля.
|
| Контакты (CONTACT_IDS): |
В данном поле можно указать контакты, которые будут привязаны к создаваемой сделке. Можно указать несколько ID через запятую или использовать массив значений. Примеры: - ={456,789,101112} - привязать контакты с ID 456, 789 и 101112; - ={=Document:CONTACT_IDS} - использовать массив контактов из документа; - В переменной типа "Множественное значение" указать список ID контактов. |
| Лид (LEAD_ID): |
В данном поле можно указать идентификатор привязанного к создаваемой сделке лида. Примеры: - ={789} - привязать лид с ID 789; |
| Дата начала (BEGINDATE): |
В данном поле можно указать дату начала создаваемой сделки. Примеры: - ={01.01.2025 00:00:00} - установить дату начала; - ={=System:NowLocal} - установить текущую дату и время; - ={=Variable:BEGINDATE} - использовать дату из другой сделки (используйте переменную из предыдущего активити (робота)). |
| Дата завершения (CLOSEDATE): |
В данном поле можно указать предполагаемую дату завершения создаваемой сделки. Примеры: - ={31.12.2025 23:59:59} - установить дату завершения; - ={{=dateadd({=System:NowLocal}, "30d")}} - установить дату на 30 дней позже текущей даты; - Используется для автоматизации контроля сроков и напоминаний. |
| Источник (SOURCE_ID): |
В данном поле указывается источник создаваемой сделки (символьный код источника). Примеры: - WEB - источник "Веб-сайт"; - CALL - источник "Звонок"; - EMAIL - источник "Email"; - Необходимо указывать символьный код источника из настроек CRM. |
| Дополнительно об источнике (SOURCE_DESCRIPTION): |
В этом поле указывается дополнительная информация об источнике. Примеры: - Реклама в Google; - Рекомендация партнёра; |
| Комментарий (COMMENTS): |
В данном поле можно указать комментарий к создаваемой сделке. Примеры: - Важная сделка, требует особого внимания; - ={=Variable:COMMENTS} - скопировать комментарий из другой сделки (используйте переменную из предыдущего активити (робота)); - ={Сделка создана автоматически из лида {=Document:ID}}; |
| Дополнительная информация (ADDITIONAL_INFO): |
В данном поле можно указать дополнительную информацию о создаваемой сделке. Примеры: - Специфические требования клиента; - Информация для внутреннего использования; |
| Рекламная система (UTM_SOURCE): |
В данном поле указывается рекламная система в создаваемой сделке (из UTM-меток). Примеры: - google; - yandex; - Используется для анализа эффективности рекламных каналов. |
| Тип трафика (UTM_MEDIUM): |
В данном поле указывается тип трафика в создаваемой сделке (из UTM-меток). Примеры: - cpc; - organic; - banner. |
| Обозначение рекламной кампании (UTM_CAMPAIGN): |
В данном поле указываются обозначения рекламной кампании в создаваемой сделке (из UTM-меток). Примеры: - летняя_распродажа; - новый_год_2025; - Используется для отслеживания эффективности конкретных рекламных кампаний. |
| Содержание кампании (UTM_CONTENT): |
В данном поле указывается содержание кампании в создаваемой сделке (из UTM-меток). Примеры: - баннер_верхний; - текст_ссылка; - Используется для детального анализа эффективности элементов рекламы. |
| Условие поиска кампании (UTM_TERM): |
В данном поле указывается условие поиска кампании в создаваемой сделке (из UTM-меток, обычно ключевое слово). Примеры: - купить_телефон; - доставка_бесплатно; - Помогает анализировать эффективность конкретных ключевых слов в рекламе. |
| Завершена (CLOSED): |
В данном поле указывается статус завершённости создаваемой сделки. Примеры: - Y или 1 - сделка завершена; - N или 0 - сделка не завершена (по умолчанию). |
| Доступен для всех (OPENED): |
В данном поле указывается доступность создаваемой сделки для всех пользователей. Примеры: - Y или 1 - сделка доступна для всех; - N или 0 - сделка с ограниченным доступом (по умолчанию). |
| Пользовательские поля (UF_*): |
Пользовательские поля, созданные администратором портала. Тип и формат заполнения зависит от настроек поля в вашем портале.
Важно: Названия полей могут отличаться в зависимости от настроек вашего портала. Активити (робот) автоматически создаёт параметры для всех доступных пользовательских полей.
|
Специальный параметр для работы с товарами:
| Название поля | Описание и примеры использования |
|---|---|
| Товары (i_products_adds): |
Один из самых главных пунктов данного активити (робота). В данный пункт заполняются товарные позиции, которые будут прикреплены к создаваемой сделке. Формат указания товаров: ID##количество##ед. измерения##цена##название товара Параметры формата: - ID - идентификатор товара в каталоге CRM (можно указать 0, если товар ещё не добавлен в каталог); - количество - количество товара (числовое значение); - ед. измерения - единица измерения товара (буквенное обозначение, например: шт, кг, м и т.д.); - цена - цена товара за единицу (числовое значение); - название товара - название товарной позиции (текстовое значение). Примеры заполнения: - 123##10##шт##5000##Ноутбук Dell - товар с ID 123, количество 10 штук, цена 5000 за единицу, название "Ноутбук Dell"; - 0##5##кг##150##Сахар - товар без ID в каталоге (ID=0), количество 5 кг, цена 150 за кг, название "Сахар"; - 456##2##м##1200##Кабель витая пара - товар с ID 456, количество 2 метра, цена 1200 за метр, название "Кабель витая пара". Множественные товары: Для указания нескольких товаров используйте множественное значение (каждый товар в отдельной строке или отдельном элементе массива). Активити (робот) поддерживает параметр с типом "Множественное значение". Примеры для множественных товаров: В переменной типа "Множественное значение" укажите:
123##10##шт##5000##Ноутбук Dell
456##2##м##1200##Кабель витая пара
789##5##шт##800##Мышь компьютерная
Важно:
- Разделитель между параметрами - двойной символ ## (решетка); - Все параметры обязательны для заполнения, даже если ID товара равен 0; - Цена указывается за единицу измерения товара (не за общее количество); - Если товар не найден в каталоге по указанному ID, будет использовано указанное название товара; - Активити (робот) автоматически добавит товары к сделке после её создания. |
Активити (робот) автоматически создаёт параметры для всех полей сделки, доступных для редактирования в вашем портале. Помимо описанных выше, могут быть доступны:
- Пользовательские поля (UF_*), созданные администратором;
- Дополнительные поля настроек CRM;
- Специальные поля интеграций.
Некоторые поля недоступны для редактирования через REST API и не будут отображаться в настройках активити (робота).
| Название поля | Описание и примеры использования |
|---|---|
| Делать отладочные сообщения в журнал БП: |
Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота). |
| Запускать от имени: | Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. |
| Устанавливать текст статуса: | Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. |
| Текст статуса: | В данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. |
| Ожидать ответа: | Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска. |
| Период ожидания. Время ожидания ответа от приложения: |
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается. Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити (робота) и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. |
| Описание примера | Решение |
|---|---|
|
Пример использования №1 - Создание сделки с товарами из лида: Необходимо создать сделку на основе данных лида с автоматическим добавлением товарных позиций. Используются данные из текущего документа (лида). |
Название: ={Новая сделка от {=Document:TITLE}} Ответственный: {=Document:ASSIGNED_BY_ID} Компания: {=Document:COMPANY_ID} Контакты: {=Document:CONTACT_IDS} Товары: (множественное значение)
123##2##шт##50000##Ноутбук
456##1##шт##15000##Монитор
После успешного выполнения активити (робота) будет создана сделка с указанными товарами. Используйте возвращаемый параметр ID сделки для дальнейших операций. |
|
Пример использования №2 - Создание коммерческого предложения с товарами: Необходимо создать сделку типа "Коммерческое предложение" с набором товаров из каталога. Товары передаются через переменную из предыдущего активити (робота). |
Название: ={КП для {=Variable:COMPANY_NAME}} Ответственный: ={user_25} Тип: COMPLEX Вероятность: ={30} Товары: {=Variable:PRODUCTS_LIST} Где переменная PRODUCTS_LIST содержит список товаров в формате:
789##10##шт##800##Мышь компьютерная
101##5##шт##2000##Клавиатура
Активити (робот) создаст коммерческое предложение с указанными товарами. |
|
Пример использования №3 - Создание сделки из заказа интернет-магазина: Необходимо автоматически создать сделку с товарами при получении заказа из интернет-магазина. Данные заказа передаются через переменные из предыдущего активити (робота) интеграции. |
Название: ={Заказ №{=Variable:ORDER_NUMBER}} Ответственный: ={user_50} Сумма: {=Variable:ORDER_TOTAL} Компания: {=Variable:CLIENT_ID} Товары: {=Variable:ORDER_ITEMS} Стадия: NEW Источник: WEB Активити (робот) создаст сделку с товарами из заказа. Переменная ORDER_ITEMS должна содержать товары в формате ID##количество##ед. измерения##цена##название. |
|
Пример использования №4 - Массовое создание сделок через итератор: Необходимо создать сделки с товарами для каждого элемента в итераторе. ID клиента берётся из итератора. |
Шаг 1 - Подготовка данных: Используйте активити (робот) "Поиск Сделки" или другой источник для получения массива ID компаний. Шаг 2 - Создание сделок в итераторе: Для каждого ID компании: Название: ={Сделка для компании {=Iterator:Value}} Ответственный: ={user_25} Компания: {=Iterator:Value} Товары: (одинаковый набор для всех)
123##5##шт##10000##Товар 1
456##3##шт##5000##Товар 2
Для каждой компании будет создана сделка с указанными товарами. |
|
Пример использования №5 - Создание сделки с товарами без ID в каталоге: Необходимо создать сделку с товарами, которые ещё не добавлены в каталог CRM. В этом случае ID товара указывается как 0. |
Название: ={Специальное предложение} Ответственный: ={user_25} Товары: (ID = 0, товар не в каталоге)
0##1##шт##50000##Индивидуальный продукт
0##2##шт##15000##Кастомное решение
Активити (робот) создаст сделку с товарами, указав их названия. ID товаров будет 0, что означает, что товары не привязаны к каталогу. |
|
Пример использования №6 - Создание сделки с расчётом суммы из товаров: Необходимо создать сделку с товарами, сумма которой будет рассчитана автоматически на основе цен и количеств товаров. |
Название: ={Сделка с автоматическим расчётом} Ответственный: ={user_25} Валюта: RUB Товары:
123##10##шт##5000##Ноутбук Dell (итого: 50 000)
456##5##шт##2000##Мышь (итого: 10 000)
789##2##шт##8000##Клавиатура (итого: 16 000)
Примечание: Сумма сделки может быть рассчитана автоматически на основе товаров (10×5000 + 5×2000 + 2×8000 = 76 000) или указана вручную в поле "Сумма". |
|
Пример использования №7 - Создание сделки с UTM-метками и товарами: Необходимо создать сделку с товарами и информацией о рекламной кампании для аналитики эффективности рекламы. |
Название: ={Сделка из рекламы} Ответственный: ={user_30} Рекламная система: ={google} Тип трафика: ={cpc} Обозначение рекламной кампании: ={летняя_распродажа_2025} Товары:
123##1##шт##75000##Ноутбук Premium
Активити (робот) создаст сделку с товаром и UTM-метками для отслеживания эффективности рекламной кампании. |
|
Пример использования №8 - Дублирование сделки с товарами: Необходимо создать копию существующей сделки с теми же товарами для нового клиента. Данные берутся из активити (робота) "Получение данных Сделки". |
Шаг 1 - Получение данных: Используйте активити (робот) "Получение данных Сделки" для получения всех данных сделки и товаров. Шаг 2 - Создание новой сделки: Название: ={Копия {=Variable:TITLE}} Ответственный: {=Variable:ASSIGNED_BY_ID} Тип: {=Variable:TYPE_ID} Вероятность: {=Variable:PROBABILITY} Компания: {=Variable:NEW_COMPANY_ID} (новая компания) Товары: {=Variable:PRODUCTS} (товары из исходной сделки) Будет создана новая сделка с теми же товарами, но для другой компании. Необходимо предварительно преобразовать данные товаров из формата активити (робота) "Получение данных Сделки" в формат активити (робота) "Создание Сделки с товарами". |
|
Пример использования №9 - Создание сделки с товарами разных единиц измерения: Необходимо создать сделку с товарами, имеющими разные единицы измерения (штуки, килограммы, метры). |
Название: ={Смешанный заказ} Ответственный: ={user_25} Товары:
123##10##шт##5000##Ноутбуки (10 штук)
456##50##кг##150##Сахар (50 килограмм)
789##100##м##80##Кабель (100 метров)
Активити (робот) создаст сделку с товарами, имеющими разные единицы измерения. Каждый товар будет отображён с указанной единицей измерения. |
|
Пример использования №10 - Создание сделки с условием на основе суммы товаров: Необходимо создать сделку с товарами и автоматически назначить ответственного в зависимости от общей суммы товаров. |
Шаг 1 - Подготовка: Рассчитайте общую сумму товаров в переменной или используйте функцию суммирования. Шаг 2 - Создание с условием: Название: ={Крупная сделка} Ответственный: ={{=if({=Variable:TOTAL_AMOUNT} >= 1000000, "user_50", if({=Variable:TOTAL_AMOUNT} >= 500000, "user_25", "user_10"))}} Товары: {=Variable:PRODUCTS} Функция if проверяет общую сумму: если >= 1 000 000, назначается user_50 (директор), если >= 500 000, назначается user_25 (старший менеджер), иначе user_10 (менеджер). |
- ID сделки - числовой идентификатор созданной сделки, который можно использовать для дальнейших операций в бизнес-процессе;
Примеры использования:
- Передать ID в следующее активити (робота) для получения данных сделки;
- Использовать в условиях для проверки успешности создания;
- Сохранить в переменную для использования в других шагах процесса;
- Использовать для связи созданной сделки с другими сущностями CRM.
Ограничение по количеству созданий:
Запускать создание сразу более 1000 сущностей не стоит. Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.
Если вы планируете через интегратор произвести создание более 100 сущностей, то нужно использовать наш модуль массовый БП "Массовый запуск Бизнес-процессов". Настройте бизнес-процесс на использование одной сделки где данные будут браться из той сущности, из которой вы хотите произвести создания. Потом зайдите в модуль "Массовый БП" отфильтруйте по типу сущности "Сделка" и нужным вам параметрам и активируйте массовый запуск. Наше приложение равномерно распределит нагрузку.
Формат товаров:
Строго соблюдайте формат указания товаров: ID##количество##ед. измерения##цена##название товара. Разделитель - двойной символ ## (решетка). Все параметры обязательны для заполнения. Если товар не найден в каталоге по ID, будет использовано указанное название товара.
Обязательные поля:
Для успешного создания сделки обязательно должны быть заполнены поля "Название" (TITLE) и "Ответственный" (ASSIGNED_BY_ID). Без них активити (робот) не сможет создать сделку и вернёт ошибку.
Товары без ID в каталоге:
Если товар ещё не добавлен в каталог CRM, укажите ID = 0. В этом случае товар будет создан с указанным названием без привязки к каталогу. Рекомендуется добавлять товары в каталог заранее для корректной работы аналитики и отчётов.
Цена товара:
Цена указывается за единицу измерения товара, а не за общее количество. Например, если товар стоит 100 рублей за штуку, и количество 10 штук, то указывайте: ID##10##шт##100##Название. Общая стоимость товара будет рассчитана автоматически (10 × 100 = 1000).
Поля типа "Список":
Поля тип "Список" требуют формата передачи данных для изменения поля "тип список" или "привязка к списку" в виде ID элемента, а не названия. Убедитесь, что вы передаёте корректные ID элементов списка.
Работа с файлами:
Наше активити (робот) может прикрепить файл к создаваемой сделке, однако только при условии, что будет указан непосредственно ID файла на диске. Активити (робот) не может перенести файл из одной сущности в другую, для этого используйте штатное активити Б24.