В Логусе раздел "Администрирование" - "Bitrix" предназначен для упрощения настройки интеграции с системой Битрикс24, отслеживания статистики обновлений сущностей, а также для массовой загрузки сущностей из Битрикс в Логус.
Доступ к данному разделу появляется после активации модуля в конфигурационном файле (<Modules> - <Bitrix Enabled="True">). Подробнее о данном разделе в статье Модуль "Bitrix" в Администрировании.
Синхронизация полей
В синхронизации участвуют поля Контакта (Профиля гостя) и Сделки (Брони).
Все возможные, для автоматической синхронизации, дополнительные поля сделки и контакта уже добавлены в конфиг.
Для синхронизации полей необходимо в разделе "Администрирование" - "Bitrix" нажать одноимённую кнопку.
После этого все поля из конфига Логуса, а также значения списочных полей, будут созданы в Битрикс.
Для отображения информации следует нажать кнопку "Обновить".
После создания полей в Битрикс их можно просмотреть в разделе CRM - Настройки - Настройки форм и отчётов - Пользовательские поля. Далее перейдите к списку полей.
Чтобы просмотреть значения списочных полей (Тип комнаты, Тариф, Скидка и т.д.), откройте страницу списочного поля и перейдите во вкладку "Список".
Если после синхронизации в Логусе были добавлены новые поля или значения списочных полей, для их добавления в Битрикс необходимо повторно нажать "Синхронизировать поля".
Если по каким-то причинам в конфиге Логуса были изменены имя, сортировка или тип переменной, следует воспользоваться Принудительным обновлением.
Полный перечень действий:
- если в конфиге изменились имя переменной, тип или сортировка
- необходимо перечитать конфиг через Администрирование - Конфигурация (или перезапустить службу Логуса)
- в Администрировании - Bitrix активировать переключатель "Принудительное обновление"
- нажать "Синхронизировать поля"
CRM ⟶ Настройки ⟶ Настройки форм и отчетов ⟶ Пользовательские поля
Настройка полей для Сделки
| Название | Тип | Обязательное | Множественное | Поле в logus.config | Сортировка |
|---|---|---|---|---|---|
| Общие данные | |||||
| Дата заезда | Дата/Время | Нет | Нет | ArrivalDate | 100 |
| Дата выезда | Дата/Время | Нет | Нет | DepartureDate | 200 |
| Количество дней | Число | Нет | Нет | Days | 300 |
| Взрослые | Число | Нет | Нет | AdultCount | 400 |
| Дети1 | Число | Нет | Нет | Child1Count | 500 |
| Дети2 | Число | Нет | Нет | Child2Count | 600 |
| Дети3 | Число | Нет | Нет | Child3Count | 700 |
| Тип комнаты | Список | Нет | Нет | RoomType | 800 |
| Тариф | Список | Нет | Нет | Rate | 900 |
| Пакеты | Список | Нет | Да | Packages | 950 |
| Скидка | Список | Нет | Нет | Discount | 1000 |
| Сумма к оплате | Число | Нет | Нет | SumToPay | 1100 |
| Сумма оплат | Число | Нет | Нет | PaymentsSum | 1200 |
| Ошибки | Строка | Нет | Нет | Error | 1800 |
| Маркетинговые данные | |||||
| ГЕО-код | Список | Нет | Нет | GeoCode | 1300 |
| Трек-код | Список | Нет | Нет | TrackCode | 1400 |
| Открытый код | Список | Нет | Нет | OpenCode | 1500 |
| Сегмент рынка | Список | Нет | Нет | MarketSegment | 1600 |
Источник бронирования | Список | Нет | Нет |
| 1700 |
Все поля с типом "Список" необходимо заполнить соответствующими вариантами значений.
Для этого откройте страницу поля, перейдите на вкладку "Список" и добавьте значения в соответствии с настройками Логуса.
Тоже самое проделайте со всеми полями списков.
Настройка полей для Контакта
| Название | Тип | Обязательное | Множественное | Поле в logus.config | Комментарий |
|---|---|---|---|---|---|
| Пол | Список | Нет | Нет | Gender | В список завести 2 элемента (Муж. и Жен.) |
Каждому созданному пользовательскому полю будет присвоен уникальный идентификатор вида UF_CRM_1576130157 и ссылка вида https://<вашдомен>.bitrix24.ru/crm/configs/fields/CRM_DEAL/edit/UF_CRM_1576130157/
Идентификаторы полей необходимо прописать в файле logus.local.config в секции <Fields>.
Список Тарифов и Пакетов
Теперь список Тарифов и Пакетов также заполняется автоматически.
Необходимо убедиться, что в конфигурационном файле в раздел <Bitrix> - <Fields> - <Deal> добавлен параметр:
<Packages Label="Пакеты" Multiple="True" Type="enumeration" SortOrder="950" GenericName="UF_CRM_PACKAGES">UF_CRM_PACKAGES</Packages>
А также данные поля должны быть синхронизированы с полями Битрикс (подробнее в разделе "Синхронизация полей").
Теперь при создании сделки в Битрикс, пакеты для брони выбираются из списка с возможностью множественного выбора.
Поддержка старого формата списка Тарифов/Пакетов также действует.
Чтобы указать включённые в тариф пакеты, их необходимо перечислить после названия тарифа следующим образом: {Название тарифа}:{Код пакета1},{Код пакета2}
Например: Стандартный тариф:HB,BED
Битрикс: добавлена передача id профиля гостя в дополнительное поле контакта
Добавлена возможность передавать id профиля гостя в дополнительное поле контакта в Битриксе. Данная функция настраивается сотрудниками технической поддержки.
Клиент создаёт доп.поле в карточку контакта в битриксе, у неё соответственно будет свой адрес, к примеру CRM_CONTACT UF_CRM_1673956664
В логусе, в конфиге будет параметр:
<GenericNo Label="Id профиля гостя" Type="string" GenericName="UF_CRM_PROFILENO">CRM_CONTACT UF_CRM_1673956664</GenericNo>
Туда прописывается id профиля гостя и, при привязывании контакта(он должен по дефолту всегда быть в сделке), к нему будет отправлен номер профиля гостя.
Тип данных дополнительного поля должен быть строковый.