Настройка производится в файле logus.local.config в теге <Modules> секции <Bitrix>.

<Bitrix Enabled="True">
  <DebugMode>False</DebugMode>
  <DisableGuestsSync>False</DisableGuestsSync>
  <ContactsWithDeal>False</ContactsWithDeal>
  <IsCompaniesSynchronize>True</IsCompaniesSynchronize>
  <LastNameAndNameRequired>False</LastNameAndNameRequired>
  <EmailOrPnoneRequired>True</EmailOrPnoneRequired>
  <Domain></Domain>
  <UserId>1</UserId>
<RequiredChangeAssignedOnCrmUpdate>False</RequiredChangeAssignedOnCrmUpdate>
  <WebHookId></WebHookId>
<CheckWebHookAuthorizationCodes>True</CheckWebHookAuthorizationCodes>
  <WebHookAuthorizationCodes>
			pedmohfjiccmx8p73nfxgxdqe6ypzjw5,
			kace64mj8i7owr25mip9w40xrby4m5zl,
			uo3mqun18n1ljoj13xwejt7kcnou44ug,
			z9da9p1wnu337r0hiaxnx87i3v1220ki,
			x6iiiym10k76rjuyct1lnqj5vvbzd6pk,
			sa3urdtmbj03gy2qldpmffeapw4i9met
  </WebHookAuthorizationCodes>
  <EventsBaseUrl>http://*:8080/</EventsBaseUrl>
  <AgentDealTypeId>103</AgentDealTypeId>
  <RevenueTypesToSum>КОМН,MED</RevenueTypesToSum>
  <Fields>
	<ArrivalDate>UF_CRM_1479367962</ArrivalDate>
	<DepartureDate>UF_CRM_1479707896</DepartureDate>
	<RoomType Type="list">UF_CRM_1491462353</RoomType>
	<Rate Type="list">UF_CRM_1485337997</Rate>
	<AdultCount>UF_CRM_1479707921</AdultCount>
	<Child1Count>UF_CRM_1479707928</Child1Count>
	<Child2Count>UF_CRM_1479707934</Child2Count>
	<Child3Count>UF_CRM_1479707939</Child3Count>
	<Error>UF_CRM_1480510533</Error>
	<Discount Type="list">UF_CRM_1485419873</Discount>
	<SumToPay>UF_CRM_1496144774</SumToPay>
	<PaymentsSum>UF_CRM_1496144738</PaymentsSum>
	<GeoCode Type="list">UF_CRM_1556179362</GeoCode>
	<TrackCode Type="list">UF_CRM_1556179426</TrackCode>
	<OpenCode Type="list">UF_CRM_1556179494</OpenCode>
	<MarketSegment Type="list">UF_CRM_1556179597</MarketSegment>
	<BookingSource Type="list">UF_CRM_1556179684</BookingSource>
	<Days>UF_CRM_1496927003</Days>
	<Gender M="Муж." F="Жен.">UF_CRM_1511878904</Gender>
  </Fields>
  <DefaultCompanyGenericNo>300002</DefaultCompanyGenericNo>
  <DefaultContactId>94</DefaultContactId>
  <DealsSyncStartDate>26.02.2019</DealsSyncStartDate>
  <Stages>
	<Calculation>DETAILS</Calculation>
    <WaitList>PREPARATION,2</WaitList>
	<Reservation>PROPOSAL</Reservation>
	<Payment>WON</Payment>
	<Out>WON</Out>
  </Stages>
  <Cancellation>
	<DefaultState>LOSE</DefaultState>
	<ReasonMap>
	  <Map1 Reason="ОТКАЗ" Status="3" />
	  <Map2 Reason="ЦЕНА" Status="4" />
	  <Map3 Reason="ПЛАНЫ" Status="5" />
	  <Map4 Reason="ДРУГОЕ" Status="6" />
	</ReasonMap>
  </Cancellation>
</Bitrix> 
Поле

Источник

значения

Значение
Bitrix
  • Enabled="True" — синхронизация с системой Битрикс включена
  • Enabled="False" — синхронизация с системой Битрикс отключена
DebugMode
  • True — режим отладки включён, синхронизируются только сущности, название которых начинаются на "ЛогусТест"
  • False — режим отладки отключён
DisableGuestsSync 
  • True — синхронизация профилей гостей отключена
  • False — синхронизация профилей гостей включена
ContactsWithDeal 
  • True — профили гостей синхронизируются, только если они привязаны к броням
  • False — синхронизируются все профили гостей
IsCompaniesSynchronize
  • True — синхронизация профилей компаний включена
  • False — синхронизация профилей компаний отключена

LastNameAndNameRequired



  • True — профили гостей из Битрикс24 синхронизируются, только если у них указаны Имя или Фамилия.
  • False — синхронизируются даже профили без Имени и Фамилии

Проверяется только при загрузке данных из Битрикс24 в Логус

EmailOrPhoneRequired



  • True — профили гостей из Логуса синхронизируются только если у них есть телефон или email
  • False — синхронизируются даже профили без телефона и email

Проверяется только при загрузке данных из Логуса в Битрикс24.

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

DomainБитрикс24Адрес сервера, на котором работает сервис Битрикс24 (ссылка вида https://<ваш_домен>.bitrix24.ru)
UserIdБитрикс24Идентификатор пользователя в Битрикс24, от имени которого будут производиться все операции.
WebHookIdБитрикс24Идентификатор Входящего вебхука
CheckWebHookAuthorizationCodesЛогус
  • True - проверка вебхуков выполняется
  • False - проверка вебхуков выполняться не будет

Подробнее в разделе "Создание исходящих вебхуков" статьи Настройка Logus для интеграции с Bitrix24.

WebHookAuthorizationCodesБитрикс24

Коды авторизации Исходящих вебхуков (необходимы для проверки запросов).

Если коды не указаны или ошибочны, обработка запроса будет прерваться с ошибкой:

Код авторизации WebHook {код авторизации (если есть)} не корректный.
EventsBaseUrlЛогусМаска подключения к серверу Логуса (протокол и порт)
??? AgentDealTypeIdЛогус

Идентификатор агентских типов сделок. При синхронизации, в качестве Компании-агента будет подставляться компания с указанным идентификатором.

??? RevenueTypesToSumЛогусКоды Типов дохода в Логусе (Администрирование / Типы дохода), транзакции по которым суммируются и синхронизируются как сумма Сделки в Битрикс24 (поле Сумма и валюта). Перечисление кодов должно быть через запятую без пробелов.
FieldsЛогусСписок полей Брони (<Deal>) и Профиля гостя (<Contact>) в Логусе с указанием соответствующих им идентификаторов полей Сделки и Контакта в Битрикс24
DefaultCompanyGenericNoЛогусИдентификатор (GenericNo) компании в Логусе, который подставляется при синхронизации, если в сделке (в Битрикс24) компания не указана.
DefaultContactIdБитрикс24

Идентификатор Контакта в Битриксе, который будет подставлен в Сделку, в случае, если Профиль в брони не указан.

Профиль гостя в Логусе, соответствующий этому Контакту, будет подставлен в Бронь.

DealsSyncStartDate

Дата, с которой начинает действовать синхронизация Броней в Логусе и Сделок в Битрикс24.

Параметр влияет как на сделки в Битрикс24 (сделки, даты создания которых меньше даты в данном поле, не синхронизируются с Логус), так и на брони в Логусе (брони, даты создания которых меньше даты в данном поле, не синхронизируются с Битрикс24).

??? DealPipelines

??? Pipeline

StagesБитрикс24Коды Стадий сделок в Битрикс24. Для каждой стадии можно через запятую указать несколько кодов стадий
Stages.СalculationБитрикс24

При синхронизации, по Сделкам указанных стадий будет осуществлён только расчет стоимости (соответствующих Броней) в Логусе.

Stages.WaitListБитрикс24

При синхронизации, по Сделкам указанных стадий будет осуществлёно создание брони в  Логус  (в статусе ожидания).

Stages.ReservationБитрикс24

При синхронизации, на основании Сделок указанных стадий будут созданы Брони в Логусе.

Stages.PaymentБитрикс24

Код Стадии сделки, в который необходимо переводить Сделку в Битрикс24 при поступлении (на соответствующую Бронь) оплаты в Логус.

Stages.OutБитрикс24Код Стадии сделки, в который необходимо переводить Сделку в Битрикс24 при выезде Брони в Логусе (переходит в статус Выезд (Out)).
Stages.CancelБитрикс24
CancellationReasons

Логус,

Битрикс24

Причины отмены брони
CancellationReasons.DefaultStateБитрикс24Код Стадии сделки, который подставляется при синхронизации, в случае, если Причина отмены брони в Логусе не совпадает ни с одним из кодов, перечисленных в ReasonMap.

CancellationReasons.ReasonMap


Логус,

Битрикс24

Секция для описания соответствия (маппинга) Причины отмены брони в Логусе и Идентификатора статуса сделки в Битрикс24.

  • <тег> — код причины отмены брони в Логусе (Администрирование / Причины отмены брони)
  • значение — идентификатор статуса сделки в Битрикс24



  • Посмотреть в браузере (WON - это id стадии):

  • Для настройки полей кодов Стадий сделок (Stages.Reservation, Stages.Сalculation, Stages.Payment и т.д.) можно воспользоваться логом сервера Логус:

Выделенное поле показывает id статуса стадии, при изменении/добавлении которой приходит запрос в Логус.