Интеграция

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

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

TOKEN

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

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

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

Интеграция

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

array:8 [ // resources/views/integrations/instructions/general.blade.php
  "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 [ // resources/views/integrations/instructions/general.blade.php
  "NAME" => "Товар 1"
  "PRICE" => 150
  "FIND_BY" => "NAME"
  "QUANTITY" => 2
]

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

array:4 [ // resources/views/integrations/instructions/general.blade.php
  "PRICE" => 1500
  "FIND_BY" => "CODE"
  "CODE" => "test_2222"
  "QUANTITY" => 2
]
Список полей для поиска
array:149 [ // resources/views/integrations/instructions/general.blade.php
  "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_138" => "pa_color"
  "PROPERTY_140" => "Минимальная цена"
  "PROPERTY_108" => "Тип лецензии"
  "PROPERTY_142" => "Максимальная цена"
  "PROPERTY_110" => "Редакция продукта"
  "PROPERTY_144" => "Наши предложения"
  "PROPERTY_112" => "Тип продления"
  "PROPERTY_146" => "Бренд"
  "PROPERTY_102" => "Картинки"
  "PROPERTY_114" => "Количество ограничено или нет"
  "PROPERTY_122" => "ШтрихКод"
  "PROPERTY_124" => "Артикул"
  "PROPERTY_126" => "Характеристики"
  "PROPERTY_128" => "Реквизиты"
  "PROPERTY_130" => "Базовая единица"
  "PROPERTY_132" => "Ставки налогов"
  "PROPERTY_134" => "Файлы"
  "PROPERTY_136" => "Производитель"
  "PROPERTY_148" => "Количество отзывов"
  "PROPERTY_116" => "Количество пользователей"
  "PROPERTY_150" => "Рейтинг по отзывам"
  "PROPERTY_118" => "Переход на какую редакцию"
  "PROPERTY_152" => "Производитель"
  "PROPERTY_120" => "Срок лицензии для Битрикс24"
  "PROPERTY_154" => "Акция"
  "PROPERTY_156" => "Похожие товары по фильтру"
  "PROPERTY_158" => "Аксессуары по фильтру"
  "PROPERTY_160" => "Комментарии покупателя"
  "PROPERTY_162" => "Статуса заказа ИД"
  "PROPERTY_164" => "Статус заказа"
  "PROPERTY_166" => "Видео в попапе"
  "PROPERTY_168" => "Подборки"
  "PROPERTY_170" => "Цвет"
  "PROPERTY_172" => "Аксессуары"
  "PROPERTY_174" => "Похожие товары"
  "PROPERTY_176" => "Количество комментариев к элементу"
  "PROPERTY_178" => "Тема форума для комментариев"
  "PROPERTY_180" => "Услуги"
  "PROPERTY_182" => "Сумма оценок"
  "PROPERTY_184" => "Рейтинг"
  "PROPERTY_186" => "Видео (код из Youtube)"
  "PROPERTY_188" => "Тип"
  "PROPERTY_190" => "В наличии"
  "PROPERTY_192" => "Вид инъекций"
  "PROPERTY_194" => "Функции"
  "PROPERTY_196" => "Материал"
  "PROPERTY_198" => "Поставщик"
  "PROPERTY_200" => "Комплект поставки"
  "PROPERTY_202" => "Количество элементов"
  "PROPERTY_204" => "Материал"
  "PROPERTY_206" => "Дистанция стрельбы"
  "PROPERTY_208" => "Вид оружия"
  "PROPERTY_210" => "Размещение"
  "PROPERTY_212" => "Финальный статус"
  "PROPERTY_214" => "Отменен"
  "PROPERTY_216" => "Доставка разрешена"
  "PROPERTY_218" => "Текст с акцией"
  "PROPERTY_220" => "Заказ оплачен"
  "PROPERTY_222" => "Метод оплаты ИД"
  "PROPERTY_224" => "Метод оплаты"
  "PROPERTY_226" => "Дата изменения статуса"
  "PROPERTY_228" => "Метод доставки ИД"
  "PROPERTY_230" => "Способ доставки"
  "PROPERTY_232" => "Подкатегория"
  "PROPERTY_234" => "Артикул"
  "PROPERTY_236" => "Возраст"
  "PROPERTY_238" => "Тип микроскопа"
  "PROPERTY_240" => "Увеличение, крат"
  "PROPERTY_242" => "Тип насадки"
  "PROPERTY_244" => "Расположение подсветки"
  "PROPERTY_246" => "Тип подсветки"
  "PROPERTY_248" => "Метод исследования"
  "PROPERTY_250" => "Назначение"
  "PROPERTY_252" => "Тип"
  "PROPERTY_254" => "Серия"
  "PROPERTY_256" => "Комплект поставки"
  "PROPERTY_258" => "Материал"
  "PROPERTY_260" => "Тип"
  "PROPERTY_262" => "Раздел"
  "PROPERTY_264" => "Категория"
  "PROPERTY_266" => "Подкатегория"
  "PROPERTY_268" => "Тип помощи"
  "PROPERTY_270" => "Модель"
  "PROPERTY_272" => "Вид анатомической модели"
  "PROPERTY_274" => "Комплект поставки"
  "PROPERTY_276" => "Материал"
  "PROPERTY_278" => "Функции"
  "PROPERTY_280" => "Комплект поставки"
  "PROPERTY_282" => "Материал"
  "PROPERTY_284" => "Преимущества"
  "PROPERTY_286" => "Раздел"
  "PROPERTY_288" => "Подраздел"
  "PROPERTY_290" => "Тип"
  "PROPERTY_292" => "Количество стрелков"
  "PROPERTY_294" => "Количество мишеней"
  "PROPERTY_296" => "Вид оружия"
  "PROPERTY_298" => "Вид мишени"
  "PROPERTY_300" => "Комплект поставки 1"
  "PROPERTY_302" => "Комплект поставки"
  "PROPERTY_304" => "Краткое описание"
  "PROPERTY_306" => "Характеристики"
  "PROPERTY_308" => "Вид"
  "PROPERTY_310" => "Размер"
  "PROPERTY_312" => "Материал"
  "PROPERTY_314" => "Разрешение дисплея"
  "PROPERTY_316" => "Модель"
  "PROPERTY_318" => "Воспроизведение видео"
  "PROPERTY_320" => "Диагональ дисплея"
  "PROPERTY_322" => "Оптическое увеличение"
  "PROPERTY_324" => "Гриль"
  "PROPERTY_326" => "Объем, л"
  "PROPERTY_328" => "Тип управления"
  "PROPERTY_330" => "Вес, кг"
  "PROPERTY_332" => "Площадь обработки, м2"
  "PROPERTY_334" => "Вид"
  "PROPERTY_336" => "Вид"
  "PROPERTY_338" => "Серия"
  "PROPERTY_340" => "Серия"
  "PROPERTY_342" => "Модификация"
  "PROPERTY_344" => "Интерфейс"
  "PROPERTY_346" => "Условия эксплуатации"
  "PROPERTY_348" => "Диагональ"
  "PROPERTY_350" => "Серия"
  "PROPERTY_352" => "Диагональ"
  "PROPERTY_354" => "Серия"
  "PROPERTY_356" => "Подраздел"
  "PROPERTY_358" => "Обновлять цену"
]

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

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

array:5 [ // resources/views/integrations/instructions/general.blade.php
  "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 (пример выше).