В Логусе раздел "Администрирование" - "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 профиля гостя в дополнительное поле контакта
С версии 2.9.114 реализована возможность передавать id профиля гостя в дополнительное поле контакта в Битриксе. Данная функция настраивается сотрудниками технической поддержки.
Клиент создаёт дополнительное поле в карточку контакта в битриксе, к примеру CRM_CONTACT UF_CRM_1673956664. В Логусе, в конфиге будет параметр, тип данных дополнительного поля должен быть строковый:
<GenericNo Label="Id профиля гостя" Type="string" GenericName="UF_CRM_PROFILENO">CRM_CONTACT UF_CRM_1673956664</GenericNo>
Передача ответственного (менеджера) в обе стороны
Из карточки брони в Логусе с версии 2.9.177 появилась возможность передавать данные поля "Менеджер" в поле "Ответственный" карточки сделки в Bitrix24. Если изменение происходит в одном из полей, они передаются в другое. Менеджеры синхронизируются по аналогии с Амо - нужно в Логусе создать пользователя с мейлом, как у сотрудника в Bitrix24 и правом создания новой брони. Тогда по мейлу ответственный и менеджер синхронизируются:
1 Comment
Libra Hospitality
Feb 01, 2022Важно! Списочные поля не должны содержать повторяющиеся значения в колонке "Наименование", так же не должно быть лишних пробелов в конце названия.