Versions Compared

Key

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

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

Code Block
languagexml
titleПример настройки
collapsetrue
<Bitrix Enabled="True">
  	<DebugMode>False</DebugMode>
    <DisableGuestsSync>False</DisableGuestsSync>
    <ContactsWithDeal>False</ContactsWithDeal>
    <IsCompaniesSynchronize>True</IsCompaniesSynchronize>
    <LastNameAndNameRequired>False</LastNameAndNameRequired>
    <EmailOrPnoneRequired>True<<EmailOrPhoneRequired>False</EmailOrPnoneRequired>EmailOrPhoneRequired>
    <Domain><<Domain>https://xxxxx.bitrix24.ru</Domain>
    <UserId>1</UserId>
    <RequiredChangeAssignedOnCrmUpdate>False</RequiredChangeAssignedOnCrmUpdate>
    <WebHookId><<WebHookId>5sbxxxxx1wg</WebHookId>
    <CheckWebHookAuthorizationCodes>True</CheckWebHookAuthorizationCodes>
    <WebHookAuthorizationCodes>
			pedmohfjiccmx8p73nfxgxdqe6ypzjw5,
			kace64mj8i7owr25mip9w40xrby4m5zl,
			uo3mqun18n1ljoj13xwejt7kcnou44ug,
			z9da9p1wnu337r0hiaxnx87i3v1220ki,
			x6iiiym10k76rjuyct1lnqj5vvbzd6pk,
			sa3urdtmbj03gy2qldpmffeapw4i9met
  </WebHookAuthorizationCodes>
      	e1zzoxxxxxxxxxxxxxxxxxxxxxxitp02,
        d1e4vxxxxxxxxxxxxxxxxxxxxxx9xgxl,
        j7b2sxxxxxxxxxxxxxxxxxxxxxxy75mp,
        us3cexxxxxxxxxxxxxxxxxxxxxxvcuhi,
        mmiccxxxxxxxxxxxxxxxxxxxxxx43jh3,
        ehrakxxxxxxxxxxxxxxxxxxxxxxtcnaf
	</WebHookAuthorizationCodes>
	<EventsBaseUrl>http://*:8080/</EventsBaseUrl>
    <AgentDealTypeId>103</AgentDealTypeId>
    <RevenueTypesToSum>КОМН,MED</RevenueTypesToSum>
    <Fields>
	<ArrivalDate>UF    	<Deal>
        	<ArrivalDate Label="Дата заезда" Type="datetime" SortOrder="100">UF_CRM_1479367962<xxxxxxxxxx</ArrivalDate>
	<DepartureDate>UF            <DepartureDate Label="Дата выезда" Type="datetime" SortOrder="200">UF_CRM_1479707896<xxxxxxxxxx</DepartureDate>
	<RoomType Type="list            <Days Label="Дней" Type="integer" SortOrder="300">UF_CRM_1491462353<xxxxxxxxxx</RoomType>
	<Rate Type="listDays>
            <AdultCount Label="Взрослых" Type="integer" SortOrder="400">UF_CRM_1485337997<xxxxxxxxxx</Rate>
	<AdultCount>UFAdultCount>
            <Child1Count Label="Детей 1" Type="integer" SortOrder="500">UF_CRM_1479707921<xxxxxxxxxx</AdultCount>
	<Child1Count>UFChild1Count>
            <Child2Count Label="Детей 2" Type="integer" SortOrder="600">UF_CRM_1479707928<xxxxxxxxxx</Child1Count>
	<Child2Count>UFChild2Count>
            <Child3Count Label="Детей 3" Type="integer" SortOrder="700">UF_CRM_1479707934<xxxxxxxxxx</Child2Count>
	<Child3Count>UFChild3Count>
            <RoomType Label="Тип комнаты" Type="enumeration" SortOrder="800">UF_CRM_1479707939<xxxxxxxxxx</Child3Count>
	<Error>UFRoomType>
            <Rate Label="Тариф" Type="enumeration" SortOrder="900">UF_CRM_1480510533<xxxxxxxxxx</Error>
	<Discount Type="listRate>
            <Discount Label="Скидка" Type="enumeration" SortOrder="1000">UF_CRM_1485419873<xxxxxxxxxx</Discount>
	<SumToPay>UF            <SumToPay Label="К оплате" Type="money" SortOrder="1100">UF_CRM_1496144774<xxxxxxxxxx</SumToPay>
	<PaymentsSum>UF            <PaymentsSum Label="Сумма оплат" Type="money" SortOrder="1200">UF_CRM_1496144738<xxxxxxxxxx</PaymentsSum>
	<GeoCode            <GeoCode Label="Гео-код" Type="list"enumeration" SortOrder="1300">UF_CRM_1556179362<xxxxxxxxxx</GeoCode>
	<TrackCode Type="list            <TrackCode Label="Трек-код" Type="enumeration" SortOrder="1400">UF_CRM_1556179426<xxxxxxxxxx</TrackCode>
	<OpenCode            <OpenCode Label="Открытый код" Type="list"enumeration" SortOrder="1500">UF_CRM_1556179494<xxxxxxxxxx</OpenCode>
	<MarketSegment            <MarketSegment Label="Сегмент рынка" Type="listenumeration" SortOrder="1600">UF_CRM_1556179597<xxxxxxxxxx</MarketSegment>
	<BookingSource            <BookingSource Label="Источник" Type="list"enumeration" SortOrder="1700">UF_CRM_1556179684<xxxxxxxxxx</BookingSource>
	<Days>UF            <Error Label="Ошибки из Logus" Type="string" SortOrder="1800">UF_CRM_1496927003<xxxxxxxxxx</Days>Error>
		</Deal>
        <Contact>
        	<Gender M="Муж." F="Жен." Type="list">UF_CRM_1511878904<xxxxxxxxxx</Gender>
        </Contact>
	</Fields>
    <DefaultCompanyGenericNo>300002</DefaultCompanyGenericNo>
    <DefaultContactId>94</DefaultContactId>
    <DealsSyncStartDate>26<DealsSyncStartDate>13.0212.2019</DealsSyncStartDate>
    <DealPipelines DefaultPipelineName="">
    	<Pipeline Name="Default" CategoryId="0">
        	<Stages>
	<Calculation>DETAILS<            	<Calculation>PREPARATION</Calculation>
	    <WaitList>PREPARATION,2<        <WaitList>1</WaitList>
	<Reservation>PROPOSAL<    	        <Reservation>EXECUTING</Reservation>
        	    <Payment>WON</Payment>
            	<Out>WON</Out>
	            <Cancel>LOSE</Cancel>
			</Stages>
   <Cancellation>
	<DefaultState>LOSE<       	<CancellationReasons>
				<DefaultState>2</DefaultState>
            	<ReasonMap>
              		<Б>3</Б>
	            	<ОУП>2</ОУП>
	  			    <ПННС>4</ПННС>
        	  		<НДВ>5</НДВ>
	  <Map1 Reason="ОТКАЗ" Status="3" />
	  <Map2 Reason="ЦЕНА" Status="4" />
	  <Map3 Reason="ПЛАНЫ" Status="5" />
	  <Map4 Reason="ДРУГОЕ" Status="6" />
	</ReasonMap>
  </Cancellation>            </ReasonMap>
			</CancellationReasons>
		</Pipeline>
		<Pipeline Name="TestPipeline" CategoryId="1">
        	<Stages>
            	<Calculation>C1:PREPAYMENT_INVOICE</Calculation>
	            <WaitList>C1:FINAL_INVOICE</WaitList>
    	        <Reservation>C1:EXECUTING</Reservation>
        	    <Payment>C1:WON</Payment>
            	<Out>C1:WON</Out>
	            <Cancel>C1:LOSE</Cancel>
			</Stages>
          	<CancellationReasons>
				<DefaultState>C1:APOLOGY</DefaultState>
	            <ReasonMap>  
					<ПУ>C1:APOLOGY</ПУ>
    	        </ReasonMap>
          	</CancellationReasons>
		</Pipeline>
	</DealPipelines>
</Bitrix> 

EmailOrPhoneRequired

Поле

Источник

значения

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

Проверяется в обе стороны (но профиль гостя в Логусе нельзя создать в отладочном режиме, так как Логус не даёт создать Фамилию в виде «ЛогусТест» с буквами разного регистра)

DisableGuestsSync 
  • True синхронизация профилей гостей отключена
  • False синхронизация профилей гостей включена
ContactsWithDeal 
  • True профили гостей синхронизируются, только если они привязаны к броням
  • False синхронизируются все профили гостей
IsCompaniesSynchronize
  • True — синхронизация профилей компаний включена
  • False — синхронизация профилей компаний отключена

LastNameAndNameRequired



Данная настройка проверяется как на стороне Логуса, так и на стороне Битрикса.
  • True — контакт/профиль проверяется на наличие фамилии И имени. Если что-либо не указано, контакт не синхронизируется со второй системой. В логах запишется информация: «Профиль ** не синхронизируется так как не указаны фамилия и имя;». Как только заполнится фамилия и имя, во вторую систему прилетит контакт/профиль со всей изменённой информацией.
  • True — если контакт/профиль был создан и успешно синхронизирован в системах, но после этого в одной из систем внесли изменения в контакт/профиль и при этом удалили Фамилию или Имя, во вторую систему изменения не прилетят. В логах запишется информация: «Профиль ** не синхронизируется так как не указаны фамилия и имя;». Как только заполнится фамилия и имя, во вторую систему прилетит контакт/профиль со всей изменённой информацией.
  • False проверка не осуществляется

EmailOrPhoneRequired



  • True — профиль в Логусе проверяется на наличие телефона ИЛИ email. Если хотя бы одна позиция указана, профиль синхронизируется с контактом Битрикса.
  • True — если контакт/профиль был успешно создан (присутствует телефон ИЛИ email), после этого в одной из систем внесли изменения в контакт/профиль и при этом удалили телефон и email, внесенные изменения синхронизируются во вторую систему. Но после этого, изменения вносимые в Логусе не будут передаваться в Битрикс. Как только в любой из систем в профиль внесут телефон или email, синхронизация с Битриксом произойдёт корректно.
  • False — проверка не осуществляется
  • True профили гостей из Битрикс24 синхронизируются, только если у них указаны Имя или Фамилия.
  • False синхронизируются даже профили без Имени и Фамилии

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

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

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

    .В Битрикс

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

    Image Added

    DomainБитрикс24Адрес сервера, на котором работает сервис Битрикс24 (ссылка вида https://<ваш_домен>домен>.bitrix24.ru)
    UserIdБитрикс24

    Идентификатор пользователя в Битрикс24, от имени которого будут производиться все операции. Id можно просмотреть в адресной строке браузера при открытии профиля сотрудника.

    Image Added

    WebHookIdБитрикс24Идентификатор Входящего вебхукаПодробнее о настройке вебхуков в статье Настройка Bitrix24 для интеграции с Logus.
    CheckWebHookAuthorizationCodesЛогус
    • True - проверка вебхуков выполняется
    • False - проверка вебхуков выполняться не будет

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

    WebHookAuthorizationCodesБитрикс24

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

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

    Code Block
    Код авторизации WebHook {код авторизации (если есть)} не корректный.
    Подробнее в разделе "Создание исходящих вебхуков" статьи Настройка Logus для интеграции с Bitrix24.
    EventsBaseUrlЛогусМаска подключения к серверу Логуса (протокол и порт)
    ??? AgentDealTypeIdЛогус

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

    ??? RevenueTypesToSumЛогусКоды Типов дохода в Логусе (Администрирование / Типы дохода), транзакции по которым суммируются и синхронизируются как сумма Сделки в Битрикс24 (поле Сумма и валюта). Перечисление кодов должно быть через запятую без пробелов.
    FieldsЛогус

    Список полей Брони (<Deal>) и Профиля гостя (<Contact>) в Логусе с указанием соответствующих им идентификаторов полей Сделки и Контакта в Битрикс24

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

    DefaultCompanyGenericNoЛогусИдентификатор (GenericNo) компании в Логусе, который подставляется при синхронизации, если в сделке (в Битрикс24) компания не указана.
    DefaultContactIdБитрикс24

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

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

    Контакт/Профиль не был указан при создании Сделки/Брони.

    DealsSyncStartDate

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

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

    DealPipelines

    Блок настройки воронок продаж (направление продажи). Если в Битриксе заведено несколько воронок, в параметре DefaultPipelineName указывается название воронки, в которую будет помещаться бронь при создании. Если ничего не указано, активной будет стандартная воронка с CategoryId="0".

    Здесь можно добавить другие воронки, если в Битрикс несколько направлений продаж.

    Pipeline

    Блок описания воронки.

    • Name - имя воронки (произвольное). Используется внутри конфига для указания воронки по умолчанию в параметре DefaultPipelineName тега DealPipelines.
    • CategoryId - категория воронки (берётся из Битрикса)

    Основная (дефолтная) воронка в Битриксе с CategoryId = 0. Остальные Id можно просмотреть в разделе Настройки - С чего начать - Направления сделок.

    Image Added

    StagesБитрикс24Блок кодов ??? DealPipelines??? PipelineStagesБитрикс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



    Info
    titleМетоды определения идентификаторов стадий в Битрикс
    • Посмотреть в браузере (WON - это id стадии):

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

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


    Изменения в конфиге вступают в силу после перезапуска сервиса Логус.