Сделки
| Функция | Описание |
|---|---|
| crm.deal.add | Создаёт новую сделку. |
| crm.deal.contact.add | Добавляет контакт к указанной сделке. |
| crm.deal.contact.delete | Удаляет контакт из указанной сделки. |
| crm.deal.contact.fields | Возвращает описание полей для связи сделка-контакт. |
| crm.deal.contact.items.delete | Очищает набор контактов, связанных с указанной сделкой. |
| crm.deal.contact.items.get | Возвращает набор контактов, связанных с указанной сделкой. |
| crm.deal.contact.items.set | Устанавливает набор контактов, связанных с указанной сделкой. |
| crm.deal.delete | Удаляет сделку и все связанные с ней объекты. |
| crm.deal.fields | Возвращает описание полей сделки. |
| crm.deal.get | Возвращает сделку по идентификатору. |
| crm.deal.list | Возвращает список сделок по фильтру. |
| crm.deal.productrows.get | Возвращает товарные позиции сделки. |
| crm.deal.productrows.set | Устанавливает (создаёт или обновляет) товарные позиции сделки. |
| crm.deal.recurring.add | Добавляет новую настройку для регулярной сделки. |
| crm.deal.recurring.delete | Удаляет существующую настройку для шаблона регулярной сделки. |
| crm.deal.recurring.expose | Создает новую сделку из шаблона. |
| crm.deal.recurring.fields | Возвращает список полей настройки шаблона регулярной сделки c описанием. |
| crm.deal.recurring.get | Возвращает поля настройки шаблона регулярной сделки по идентификатору. |
| crm.deal.recurring.list | Возвращает список настроек шаблонов регулярных сделок по фильтру. |
| crm.deal.recurring.update | Обновляет существующую настройку для шаблона регулярной сделки. |
| crm.deal.update | Обновляет существующую сделку. |
| crm.deal.userfield.add | Создаёт новое пользовательское поле для сделок. |
| crm.deal.userfield.get | Возвращает пользовательское поле сделок по идентификатору. |
| crm.deal.userfield.list | Возвращает список пользовательских полей сделок по фильтру. |
| crm.deal.userfield.update | Обновляет существующее пользовательское поле сделок. |
| crm.deal.userfield.delete | Удаляет пользовательское поле сделок. |
Общий список событий сделки приведен здесь.
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.
Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
Добавление сделки (лида, счета, компреда) с товарами, с применением скидок и налогов
Описание
Примеры создания различных сущностей с одновременным добавленем товаров к ним. Добавляемый товар берётся из Битрикс24 с ценой больше нуля. Все примеры добавляют товар в максимально возможном количестве вариаций, около каждой вариации есть мини комментарий с описанием какими дополнительными условиями будет отображаться товар.
Прикрепление товаров к сделке
Прикрепление товаров к лиду
Создание счёта с товарами
Прикрепление товаров к компред
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.
Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
В дальнейшей работе с товарами REST API Битрикс24 возвращает полезные параметры цены товарных позиций:
PRICE_EXCLUSIVE — цена без налога со скидкой
PRICE_NETTO — цена без налога и без скидки
PRICE_BRUTTO — цена с налогом без скидки
PRICE — итоговая цена позиции с налогом и со скидкой
Прикрепляя товары к сделке \ лиду описанными выше способами, хоть и, действительно, параметр итоговой цены PRICE можно не указывать (в интерфейсе он рассчитается автоматически), тем не менее, в дальнейшей работе с товарами по REST вам будут возвращать его значение, равное 0.
Поэтому лучше его, всё-таки, указывать:
Создаем лид в Битрикс24 через API
Введение
У Битрикс24 есть API, который позволяет делать определенные полезные штуки. Одна из них – отправка лида в CRM. Т.е. мы можем запрограммировать отправку данных из любой формы своего сайта в свой Битрикс24. Супер! Разберемся, как это сделать.
Создание вебхука
Прежде всего, в рамках Битрикс24 нужно создать вебхук, в который мы будем отправлять данные с сайта. В Битрикс24 в левом меню переходим в раздел Приложения, идем на вкладку Вебхуки, жмем кнопку Добавить вебхук, в подменю выбираем Входящий вебхук:
Открылась форма добавления вебхука. В поле Название вводим произвольное название, например Получение лидов с сайта. Поле Описание заполняем по своему желанию. В списке Права доступа отмечаем чекбокс CRM:
Больше ничего отмечать не нужно, нажимаем кнопку Сохранить (находится под списком прав доступа):
Перед нами открывается страница с кодом вебхука:
Сохраните этот код, он понадобится нам далее. Код никому не показывайте, это конфиденциальная информация.
Пример 1: передаем имя и телефон
Начнем с самого простого примера: передадим в CRM имя и номер телефона:
Комментарии добавил прямо в код, думаю вопросов быть не должно. Если запустим этот код — в Битрикс24 появится уведомление о создании нового лида:
В CRM зайдем в лид и увидим всю информацию, которую мы передали:
Супер! В примере мы заполнили только Название лида, Имя и Номер телефона. Но в CRM Б24 доступно намного больше полей. Их список можно посмотреть в документации по ссылке: https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php — обязательно ознакомьтесь с этой табличкой.
Пример 2: передаем пользовательские свойства
Немного дополним наш пример, передадим значения двух пользовательских полей. Предположим, что в CRM у нас есть поле Ждет звонка типа Да/Нет (содержит информацию о том, нужно ли перезвонить этому клиенту). И поле Дополнительное сообщение типа Строка, в котором мы передаем сообщение, оставленное пользователем:
Нам нужно получить коды этих свойств. Узнать их можно через просмотр кода элемента. Вот код нашего первого свойства:
Добавим их в наш код и получим следующее:
Как видим, пользовательские свойства передаются точно так же, как и обычные поля. Результат в CRM выглядит следующим образом:
Пользовательские поля корректно сохранились в Битрикс24.
Пример 3: передаем UTM-метки
Передача UTM-меток ничем не отличается от передачи обычных полей. Но я решил вынести этот пример в отдельный блок, т.к. в свое время сам не знал о существовании специальных полей для UTM-меток в CRM Битрикс24. А они есть, это следующие поля:
Дополним наш код исходя из этой информации: вытянем UTM-метки из урла и отправим их в лид:
Отправим лид со страницы со следующим набором значений в урле:
В итоге получим этот набор UTM-меток в соответствующих полях лида:
Пример сообщения об ошибке
У нас в коде есть блок, который отвечает за вывод ошибок, вот он:
Давайте попробуем получить какую-нибудь ошибку. Например, укажем несуществующего пользователя в переменной $b24UserID:
Запустив код с неправильным ID пользователя, мы получим следующее сообщение:
А в ячейке $result[‘error’] будет храниться код ошибки, в данном случае INVALID_CREDENTIALS.
Возможно, это поможет кому-то при дебаге.
Другие посты из этой же рубрики:
Copyright © 2015-2021, Алфавитка.ру – IT-блог разработчика.
Bitrix24 api создать сделку
Bitrix24 API PHP Wrapper
Обертка на PHP7+ для работы с REST API Битрикс24 с использованием механизма входящих вебхуков, троттлингом запросов и логированием в файл.
Разработчики на JavaScript могут воспользоваться классом-оберткой andrey-tech/bx24-wrapper-js.
Установка через composer:
в секцию require файла composer.json.
Базовые методы класса
Базовые методы находятся в классе \App\Bitrix24\Bitrix24API :
Дополнительные параметры настройки доступны через публичные статические и нестатические свойства класса \App\Bitrix24\Bitrix24API :
Методы для работы с сущностями Битрикс24
Методы работы со сделками
Методы для работы со сделками находятся в трейте \App\Bitrix24\Deal :
Методы для работы с контактами
Методы для работы с контактами находятся в трейте \App\Bitrix24\Contact :
Методы для работы с компаниями
Методы для работы с компаниями находятся в трейте \App\Bitrix24\Company :
Методы для работы с каталогами
Методы для работы с товарными каталогами находятся в трейте \App\Bitrix24\Catalog :
Методы для работы с товарами
Методы для работы с товарами находятся в трейте \App\Bitrix24\Product :
Методы работы с разделами товаров
Методы для работы с разделами товаров находятся в трейте \App\Bitrix24\ProductSection :
Методы работы с товарными позициями
Методы для работы с товарными позициями находятся в трейте \App\Bitrix24\ProductRow :
Методы для работы с пользователями
Методы для работы с пользователями находятся в трейте \App\Bitrix24\User :
Методы работы с задачами
Методы для работы с задачами находятся в трейте \App\Bitrix24\Task :
Методы для работы с делами
Методы для работы с делами (активностями) находятся в трейте \App\Bitrix24\Activity :
Методы для работы с диском
Методы для работы с Диском находятся в трейте \App\Bitrix24\Disk :
Методы для работы с лидами
Методы для работы с лидами находятся в трейте \App\Bitrix24\Lead :
Дополнительные параметры устанавливаются через публичные свойства объекта класса \App\HTTP\HTTP :
Примеры отладочных сообщений:
Дополнительные параметры устанавливаются через публичные свойства класса \App\DebugLogger\DebugLogger :
Пример результатов логирования:
Формат заголовков лога
Данная библиотека распространяется на условиях лицензии MIT.
About
Обертка на PHP7+ для работы с REST API Битрикс24 с использованием механизма входящих вебхуков, троттлингом запросов к API и логированием в файл.
Как добавить сделку?
Прежде всего сделку необходимо создать. Давайте рассмотрим все варианты добавления сделок.
Как добавить сделку?
Нажать кнопку Добавить сделку на странице сделок или плюсик под пунктом меню.
Нажать кнопку на закладке Сделки в карточке контакта или компании.
В меню действий торгового предложения:
Или в форме просмотра предложения
В меню действий контакта или компании
Сделки также можно добавить через интеграцию с интернет-магазином.
В этом случае заказы на стороне сайта будут формировать сделки на стороне Битрикс24. Подробнее об этой возможности читайте в статье Интеграция с интернет-магазином
В некоторых случаях при создании сделки необходимо указать ее направление. Подробнее об этом читайте в статье Направления сделок