Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Для работы интеграции в Битрикс необходимо добавить Пользовательские поля для Сделки и Контакта:

В Логусе раздел "Администрирование" - "Bitrix" предназначен для упрощения настройки интеграции с системой Битрикс24, отслеживания статистики обновлений сущностей, а также для массовой загрузки сущностей из Битрикс в Логус.

Доступ к данному разделу появляется после активации модуля в конфигурационном файле (<Modules> - <Bitrix Enabled="True">). Подробнее о данном разделе в статье Модуль "Bitrix" в Администрировании.

Anchor
Синхр.полей
Синхр.полей
Синхронизация полей

В синхронизации участвуют поля Контакта (Профиля гостя) и Сделки (Брони).

Все возможные, для автоматической синхронизации, дополнительные поля сделки и контакта уже добавлены в конфиг.

Image Added

Для синхронизации полей необходимо в разделе "Администрирование" - "Bitrix" нажать одноимённую кнопку.

Image Added

После этого все поля из конфига Логуса, а также значения списочных полей, будут созданы в Битрикс.

Для отображения информации следует нажать кнопку "Обновить".

Image Added

После создания полей в Битрикс их можно просмотреть в разделе CRM - Настройки - Настройки форм и отчётов - Пользовательские поля. Далее перейдите к списку полей.

Image AddedImage AddedImage Added

Чтобы просмотреть значения списочных полей (Тип комнаты, Тариф, Скидка и т.д.), откройте страницу списочного поля и перейдите во вкладку "Список".

Image Added

Если после синхронизации в Логусе были добавлены новые поля или значения списочных полей, для их добавления в Битрикс необходимо повторно нажать "Синхронизировать поля".

Если по каким-то причинам в конфиге Логуса были изменены имя, сортировка или тип переменной, следует воспользоваться Принудительным обновлением.

Полный перечень действий:

  1. если в конфиге изменились имя переменной, тип или сортировка
  2. необходимо перечитать конфиг через Администрирование - Конфигурация (или перезапустить службу Логуса)
  3. в Администрировании - Bitrix активировать переключатель "Принудительное обновление"
  4. нажать "Синхронизировать поля"

Image Added


Expand
titleУстаревший метод добавления полей

CRM Настройки Настройки форм и отчетов Пользовательские поля

Image Modified


Настройка полей для Сделки

НазваниеТипОбязательноеМножественноеПоле в logus.configСортировка
Общие данные
Дата заездаДата/ВремяНетНетArrivalDate100
Дата выездаДата/ВремяНетНетDepartureDate200
Количество днейЧислоНетНетDays300
ВзрослыеЧислоНетНетAdultCount400
Дети1ЧислоНетНетChild1Count500
Дети2ЧислоНетНетChild2Count600
Дети3ЧислоНетНетChild3Count700
Тип комнатыСписокНетНетRoomType800
ТарифСписокНетНетRate900
ПакетыСписокНетДаPackages950
СкидкаСписокНетНетDiscount1000
Сумма к оплатеЧислоНетНетSumToPay1100
Сумма оплатЧислоНетНетPaymentsSum1200
ОшибкиСтрокаНетНетError1800
Маркетинговые данные
ГЕО-кодСписокНетНетGeoCode1300
Трек-кодСписокНетНетTrackCode1400
Открытый кодСписокНетНетOpenCode1500
Сегмент рынкаСписокНетНетMarketSegment1600

Источник бронирования

Список

Нет

Нет

BookingSource

1700

Все поля с типом "Список" необходимо заполнить соответствующими вариантами значений.

Для этого откройте страницу поля, перейдите на вкладку "Список" и добавьте значения в соответствии с настройками Логуса.

Image ModifiedImage ModifiedImage ModifiedImage Modified

Тоже самое проделайте со всеми полями списков.

...

Tip
titleЗаполнение списка тарифов

Чтобы указать включённые в Тариф пакеты, их необходимо перечислить после названия тарифа следующим образом: {Название тарифа}:{Код пакета1},{Код пакета2}

Например: Базовый тариф:BB, BBTest

Image Removed

Настройка полей для Контакта

НазваниеТипОбязательноеМножественноеПоле в logus.configКомментарий
ПолСписокНетНетGenderВ список завести 2 элемента (Муж. и Жен.)

Каждому созданному пользовательскому полю будет присвоен уникальный идентификатор вида UF_CRM_1576130157 и ссылка вида https://<вашдомен>.bitrix24.ru/crm/configs/fields/CRM_DEAL/edit/UF_CRM_1576130157/

Image Modified

Идентификаторы полей необходимо прописать в файле logus.local.config в секции <Fields>.

image2020-6-18_12-11-26.pngImage Added

Список Тарифов и Пакетов

Теперь список Тарифов и Пакетов также заполняется автоматически.
Необходимо убедиться, что в конфигурационном файле в раздел <Bitrix> - <Fields> - <Deal> добавлен параметр:

<Packages Label="Пакеты" Multiple="True" Type="enumeration" SortOrder="950" GenericName="UF_CRM_PACKAGES">UF_CRM_PACKAGES</Packages>

А также данные поля должны быть синхронизированы с полями Битрикс (подробнее в разделе "Синхронизация полей").

Теперь при создании сделки в Битрикс, пакеты для брони выбираются из списка с возможностью множественного выбора.

Image Added

Поддержка старого формата списка Тарифов/Пакетов также действует.

Image Added


Expand
titleУстаревший метод добавления Тарифов/Пакетов

Чтобы указать включённые в тариф пакеты, их необходимо перечислить после названия тарифа следующим образом: {Название тарифа}:{Код пакета1},{Код пакета2}

Например: Стандартный тариф:HB,BED

Image Added

Передача id профиля гостя в дополнительное поле контакта

С версии 2.9.114 реализована возможность передавать id профиля гостя в дополнительное поле контакта в Битриксе. Image RemovedДанная функция настраивается сотрудниками технической поддержки.

Клиент создаёт дополнительное поле в карточку контакта в битриксе, к примеру CRM_CONTACT UF_CRM_1673956664. В Логусе, в конфиге будет параметр, тип данных дополнительного поля должен быть строковый:

Code Block
languagejson
titleПараметр
<GenericNo Label="Id профиля гостя" Type="string" GenericName="UF_CRM_PROFILENO">CRM_CONTACT UF_CRM_1673956664</GenericNo>
Info
titleПередача ответственного (менеджера) в обе стороны

Из карточки брони в Логусе с версии 2.9.177 появилась возможность передавать данные поля "Менеджер" в поле "Ответственный" карточки сделки в Bitrix24. Если изменение происходит в одном из полей, они передаются в другое. Менеджеры синхронизируются по аналогии с Амо - нужно в Логусе создать пользователя с мейлом, как у сотрудника в Bitrix24 и правом создания новой брони. Тогда по мейлу ответственный и менеджер синхронизируются:

Image Added