Настройка Logus для интеграции с Bitrix24

Настройка производится в файле 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 статуса стадии, при изменении/добавлении которой приходит запрос в Логус.

Space shortcuts

Page tree