Интеграция

Плагин возможно интегрировать с любым сайтом или другой системой. Для популярных CMS есть готовые плагины. Нестандартные интеграции может реализовать ваш программист, инструкция описана ниже.
Нужна помощь с интеграцией, необходимо расширить функционал плагина, или есть другие вопросы - https://cp.flamix.solutions/.

Секретный токен интеграции

TOKEN

Сложные сценарии работы

Реализация сложной логики любой сущности (Лида, Сделки, Контакта и тд) осуществляется через Бизнес-процессы или Роботы. Данные работы рекомендуется поручить официальным партнерам Битрикс24.

Готовые интеграции

Интеграция

Необходимо направить данные (POST или GET запросом) на URL https://leadwp-pay.app.flamix.solutions/api/v1/lead/add
Параметры для передачи:

array:8 [ // vendor/laravel/framework/src/Illuminate/Filesystem/Filesystem.php:110
  "DOMAIN" => "Домен портала, например test.bitrix24.ru"
  "api_token" => "Секретный токен интеграции"
  "TRACE" => "Трассировка с виджета Битрикс24 (необязательное)"
  "UF_CRM_FX_CONVERSION" => "Идентификаторы пользователя (для плагина - https://flamix.solutions/bitrix24/conversion.php), необязательное"
  "UTM" => array:2 [
    "utm_source" => "google (non required)"
    "utm_campaign" => "new_year (non required)"
  ]
  "FIELDS" => array:4 [
    "your-name" => "Роман (Все поля НЕОБЯЗАТЕЛЬНЫЕ)"
    "your-phone-example" => "1234567890 (проходит дополнительную очистку, валидацию, форматирование и участвует в поиске дубликатов)"
    "your-email" => "test@test.com (участвует в поиске дубликатов)"
    "other" => "другие поля (необязательно)"
  ]
  "CURRENCY_ID" => "Код валюты (RUB, USD, UAH), по умолчанию валюта портала"
  "PRODUCTS" => array:2 [
    0 => array:4 [
      "NAME" => "Товар 1"
      "PRICE" => 150
      "FIND_BY" => "NAME"
      "QUANTITY" => 2
    ]
    1 => array:7 [
      "NAME" => "Товар 1"
      "PRICE" => 1000
      "QUANTITY" => 2
      "TAX_RATE" => 15
      "TAX_INCLUDED" => "N"
      "DISCOUNT_SUM" => 100
      "DISCOUNT_TYPE_ID" => "1 - Sum, 2 - Percent"
    ]
  ]
]

Поиск товаров

При необходимости добавить существующий товар, необходимо в каждом товаре передавать поле FIND_BY с указанием кода для поиска товара. Например, если нужно искать товары по имени, то мы передаем так:

array:4 [ // vendor/laravel/framework/src/Illuminate/Filesystem/Filesystem.php:110
  "NAME" => "Товар 1"
  "PRICE" => 150
  "FIND_BY" => "NAME"
  "QUANTITY" => 2
]

Пример поиска по полю CODE. В данном случае, будет найдено поле с кодом "test_2222". Если его не существует - добавиться товар с автоматически сгенерированным именем:

array:4 [ // vendor/laravel/framework/src/Illuminate/Filesystem/Filesystem.php:110
  "PRICE" => 1500
  "FIND_BY" => "CODE"
  "CODE" => "test_2222"
  "QUANTITY" => 2
]
Список полей для поиска
array:30 [ // vendor/laravel/framework/src/Illuminate/Filesystem/Filesystem.php:110
  "ID" => "ID"
  "CATALOG_ID" => "Каталог"
  "PRICE" => "Цена"
  "CURRENCY_ID" => "Валюта"
  "NAME" => "Название"
  "CODE" => "CODE"
  "DESCRIPTION" => "Описание"
  "DESCRIPTION_TYPE" => "Тип описания"
  "ACTIVE" => "Активен"
  "SECTION_ID" => "Раздел"
  "SORT" => "Сортировка"
  "VAT_ID" => "Ставка НДС"
  "VAT_INCLUDED" => "НДС включён в цену"
  "MEASURE" => "Единица измерения"
  "XML_ID" => "Внешний код"
  "PREVIEW_PICTURE" => "Картинка для анонса"
  "DETAIL_PICTURE" => "Детальная картинка"
  "DATE_CREATE" => "Дата создания"
  "TIMESTAMP_X" => "Дата изменения"
  "MODIFIED_BY" => "Кем изменён"
  "CREATED_BY" => "Кем создан"
  "PROPERTY_106" => "ID товара"
  "PROPERTY_108" => "Тип лецензии"
  "PROPERTY_110" => "Редакция продукта"
  "PROPERTY_112" => "Тип продления"
  "PROPERTY_102" => "Картинки товара"
  "PROPERTY_114" => "Количество ограничено или нет"
  "PROPERTY_116" => "Количество пользователей"
  "PROPERTY_118" => "Переход на какую редакцию"
  "PROPERTY_120" => "Срок лицензии для Битрикс24"
]

Синхронизация статусов

Чтобы синхронизировать статусы, вы должны изначально при создании сущности в <b>поле FIELDS</b> передать значение, указаны ниже. Это свяжет созданную сущность с конкретным заказом из сайта.

array:5 [ // vendor/laravel/framework/src/Illuminate/Filesystem/Filesystem.php:110
  "DOMAIN" => "Домен портала, например test.bitrix24.ru"
  "api_token" => "Секретный токен интеграции"
  "HOSTNAME" => "yuorshopdomain.com"
  "ORDER_ID" => "99"
  "STATUS" => "PAID"
]
  • Изменения статуса из CRM. Наш плагин пришлет GET запрос на домен (взят из HOSTNAME) на главную страницу сайта с такими параметрами: flamix_status=Y, status={Статус на сайте вверхнем регистре}, order_id={номер заказа на сайте} и hash=md5(api_token . '_' . strtoupper(status)), где api_token - Секретный токен приложения. Программист должен самостоятельно их проверить и сменить статус.
  • Изменения статуса из сайта. Для изменения статуса сайт должен отправить POST запрос на URL https://leadwp-pay.app.flamix.solutions/api/v1/status/change с DOMAIN и api_token, передав HOSTNAME, ORDER_ID и STATUS (пример выше).