добавить товар в сделку bitrix24 rest api
Добавление сделки (лида, счета, компреда) с товарами, с применением скидок и налогов
Описание
Примеры создания различных сущностей с одновременным добавленем товаров к ним. Добавляемый товар берётся из Битрикс24 с ценой больше нуля. Все примеры добавляют товар в максимально возможном количестве вариаций, около каждой вариации есть мини комментарий с описанием какими дополнительными условиями будет отображаться товар.
Прикрепление товаров к сделке
Прикрепление товаров к лиду
Создание счёта с товарами
Прикрепление товаров к компред
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.
Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
В дальнейшей работе с товарами REST API Битрикс24 возвращает полезные параметры цены товарных позиций:
PRICE_EXCLUSIVE — цена без налога со скидкой
PRICE_NETTO — цена без налога и без скидки
PRICE_BRUTTO — цена с налогом без скидки
PRICE — итоговая цена позиции с налогом и со скидкой
Прикрепляя товары к сделке \ лиду описанными выше способами, хоть и, действительно, параметр итоговой цены PRICE можно не указывать (в интерфейсе он рассчитается автоматически), тем не менее, в дальнейшей работе с товарами по REST вам будут возвращать его значение, равное 0.
Поэтому лучше его, всё-таки, указывать:
Как добавить товары в сделки, лиды и предложения
В лидах, сделках, предложениях и счетах можно выбрать товары. Это поможет не забыть, что именно выбрал клиент, правильно рассчитать стоимость сделки, а потом собрать аналитику по товарам.
Товары в карточке CRM
В карточках лидов, сделок и предложений товары находятся в отдельной вкладке.
В верхней части окна находятся кнопки Добавить товар и Выбрать товар.
Кнопка Добавить товар добавляет в карточку элемента ещё одну строку, в который вы сможете выбрать товар.
Кнопка Выбрать товар открывает каталог товаров, в нём можете выбрать нужный и добавить его в карточку двойным кликом.
В окне товаров есть две кнопки с настройками. В них вы можете выбрать, какие поля отображать в таблице товаров, например, скидку и налог.
Когда кликните на строку поиска, отобразятся последние товары, которые вы использовали. Если начнёте вводить название товара, то увидите результаты поиска.
В таблице отображаются вариации, которые есть у товара. Вы можете указать, какой цвет, размер или другой параметр нужен покупателю.
Не забудьте указать количество, а цена подтянется автоматически из карточки товара. При необходимости её можно изменить прямо в сделке.
В правой части экрана вы увидите полную информацию о товарах, которые добавили в карточку.
После того, как вы добавили товары, указали количество, скидки и налоги, сохраните изменения. Сумма товаров станет суммой сделки и товары отобразятся в соответствующем разделе в карточке.
Сделки
| Функция | Описание |
|---|---|
| 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 | Удаляет пользовательское поле сделок. |
Общий список событий сделки приведен здесь.
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.
Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
Bitrix24 лиды с сайта — автоматическое создание лидов
Как добавлять в Bitrix24 лиды с сайта? Данным вопросом начинают задаваться многие, так как с каждым днем CRM Битрикс24 набирает популярность среди вебмастеров и владельцев сайтов. И у многих встает вопрос, как же организовать автоматическое создание лидов с сайта в CRM Битрикс24, если Вы не используете одноименную CMS.
Для этого давайте рассмотрим два способа:
См. также публикацию на тему:
Автоматическое создание лидов в Битрикс24 через упрощенный Rest API
Для того, чтобы организовать автоматическое создание лидов в Битрикс24 Вам необходимо:
Логин и пароль пользователя Вашей CRM
Так как логин и пароль пользователя из-под которого будут создаваться лиды указываются в скрипте, то для безопасности рекомендуется использовать отдельного пользователя с правами только на добавление лида и без доступа куда-либо еще. Данная мера необходима для безопасности Ваших данных, на тот случай, если каким-то образом PHP скрипт для отправки данных в Битрикс 24 окажется у злоумышленников.
PHP скрипт для отправки данных
В Bitrix24 лиды с сайта можно передавать PHP скриптом, который приведен ниже. При этом для автоматического создания лидов, необходимо передать 3 обязательных параметра:
все остальные параметры являются не обязательными и не подлежат обязательной передаче. Однако советую Вам передавать как можно больше данных в лиде: email, телефон, комментарий, utm метки и многое другое (см. все параметры для формирования лидов).
И умение перехватывать данные из форм
По умолчанию, обязательным параметром для заполнения является Title, значение которого будет названием для лида в Битрикс24. Все остальные параметры Вы можете передавать на свое усмотрение (см.таблицы с параметрами).
Данные параметры из «Таблица 1: Параметры для лидов», отвечают за передачу данных в стандартные поля Битрикс24. Если у Вас есть поля, которые Вы самостоятельно создали в Битрикс24, и Вам необходимо передавать для них значение с сайта вместе с лидами, то предлагаю Вам ознакомится с данной статьей.
Автоматическое создание лидов в Битрикс24 при помощи входящего вебхука
Комманда Битрикс 24 внедрила очень простой и функциональный способ интеграции с CRM системой. Если ранее интеграция с Битрикс 24 была не простой задачей, требующей отличной квалификации и знаний от вебмастеров и владельцев сайта, то теперь, с внедрением вебхуков, произвести интеграцию своего сайта с CRM системой может практически каждый желающий.
Так что такое вебхуки в Битрикс24? WebHooks Bitrix24 — механизм, который позволяет вам использовать практически весь богатый функционал Rest API Битрикс24, но при минимальных знаниях и трудозатрат.
На мой взгляд, это более безопасный способ передачи информации в CRM систему, чем при помощи упрощенного Rest API.
И так, для организации автоматической передачи лидов при помощи вебхуков необходимо:
Создать входящий вубхук
Для того, чтобы передать данные с вашей формы обратной связи в лиды Битрикс 24 необходимо создать входящий вебхук. Для этого следуем по инструкции:
Написать короткий код для перехвата и передачи данных
Для завершения организации передачи данных с формы сайта в лиды Битрикс24 при помощи вебхуков необходимо всего лишь написать коротенький код. При написание кода необходимо учесть всего 3 простых шага:
Пример кода для интеграции Битрикс24 и сайта при помощи вебхуков
Учесть особенность для передачи номера телефона, email, мессенджера
, где nX — это одно значение (телефона или электронной почты), которое всегда начинается с 0.
Таким образом, для передачи хотя бы одного телефона и адреса электронной почты, код будет иметь следующий вид:
Теперь проверьте свой Битрикс 24 и вы найдете там созданный лид =)
Добавить товар в сделку bitrix24 rest 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 и логированием в файл.