View Source

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

<Bitrix Enabled="True">
	<DebugMode>False</DebugMode>
    <DisableGuestsSync>False</DisableGuestsSync>
    <ContactsWithDeal>False</ContactsWithDeal>
    <IsCompaniesSynchronize>True</IsCompaniesSynchronize>
    <LastNameAndNameRequired>False</LastNameAndNameRequired>
    <EmailOrPhoneRequired>False</EmailOrPhoneRequired>
    <Domain>https://xxxxx.bitrix24.ru</Domain>
    <UserId>1</UserId>
    <RequiredChangeAssignedOnCrmUpdate>False</RequiredChangeAssignedOnCrmUpdate>
    <WebHookId>5sbxxxxx1wg</WebHookId>
    <CheckWebHookAuthorizationCodes>True</CheckWebHookAuthorizationCodes>
    <WebHookAuthorizationCodes>
    	e1zzoxxxxxxxxxxxxxxxxxxxxxxitp02,
        d1e4vxxxxxxxxxxxxxxxxxxxxxx9xgxl,
        j7b2sxxxxxxxxxxxxxxxxxxxxxxy75mp,
        us3cexxxxxxxxxxxxxxxxxxxxxxvcuhi,
        mmiccxxxxxxxxxxxxxxxxxxxxxx43jh3,
        ehrakxxxxxxxxxxxxxxxxxxxxxxtcnaf
	</WebHookAuthorizationCodes>
	<EventsBaseUrl>http://*:8080/</EventsBaseUrl>
    <AgentDealTypeId>103</AgentDealTypeId>
    <RevenueTypesToSum>КОМН,MED</RevenueTypesToSum>
    <Fields>
    	<Deal>
        	<ArrivalDate Label="Дата заезда" Type="datetime" SortOrder="100">UF_CRM_xxxxxxxxxx</ArrivalDate>
            <DepartureDate Label="Дата выезда" Type="datetime" SortOrder="200">UF_CRM_xxxxxxxxxx</DepartureDate>
            <Days Label="Дней" Type="integer" SortOrder="300">UF_CRM_xxxxxxxxxx</Days>
            <AdultCount Label="Взрослых" Type="integer" SortOrder="400">UF_CRM_xxxxxxxxxx</AdultCount>
            <Child1Count Label="Детей 1" Type="integer" SortOrder="500">UF_CRM_xxxxxxxxxx</Child1Count>
            <Child2Count Label="Детей 2" Type="integer" SortOrder="600">UF_CRM_xxxxxxxxxx</Child2Count>
            <Child3Count Label="Детей 3" Type="integer" SortOrder="700">UF_CRM_xxxxxxxxxx</Child3Count>
            <RoomType Label="Тип комнаты" Type="enumeration" SortOrder="800">UF_CRM_xxxxxxxxxx</RoomType>
            <Rate Label="Тариф" Type="enumeration" SortOrder="900">UF_CRM_xxxxxxxxxx</Rate>
            <Discount Label="Скидка" Type="enumeration" SortOrder="1000">UF_CRM_xxxxxxxxxx</Discount>
            <SumToPay Label="К оплате" Type="money" SortOrder="1100">UF_CRM_xxxxxxxxxx</SumToPay>
            <PaymentsSum Label="Сумма оплат" Type="money" SortOrder="1200">UF_CRM_xxxxxxxxxx</PaymentsSum>
            <GeoCode Label="Гео-код" Type="enumeration" SortOrder="1300">UF_CRM_xxxxxxxxxx</GeoCode>
            <TrackCode Label="Трек-код" Type="enumeration" SortOrder="1400">UF_CRM_xxxxxxxxxx</TrackCode>
            <OpenCode Label="Открытый код" Type="enumeration" SortOrder="1500">UF_CRM_xxxxxxxxxx</OpenCode>
            <MarketSegment Label="Сегмент рынка" Type="enumeration" SortOrder="1600">UF_CRM_xxxxxxxxxx</MarketSegment>
            <BookingSource Label="Источник" Type="enumeration" SortOrder="1700">UF_CRM_xxxxxxxxxx</BookingSource>
            <Error Label="Ошибки из Logus" Type="string" SortOrder="1800">UF_CRM_xxxxxxxxxx</Error>
		</Deal>
        <Contact>
        	<Gender M="Муж." F="Жен." Type="list">UF_CRM_xxxxxxxxxx</Gender>
        </Contact>
	</Fields>
    <DefaultCompanyGenericNo>300002</DefaultCompanyGenericNo>
    <DefaultContactId>94</DefaultContactId>
    <DealsSyncStartDate>13.12.2019</DealsSyncStartDate>
    <DealPipelines DefaultPipelineName="">
    	<Pipeline Name="Default" CategoryId="0">
        	<Stages>
            	<Calculation>PREPARATION</Calculation>
	            <WaitList>1</WaitList>
    	        <Reservation>EXECUTING</Reservation>
        	    <Payment>WON</Payment>
            	<Out>WON</Out>
	            <Cancel>LOSE</Cancel>
			</Stages>
          	<CancellationReasons>
            	<ReasonMap>
              		<Б>3</Б>
	            	<ОУП>2</ОУП>
	  			    <ПННС>4</ПННС>
        	  		<НДВ>5</НДВ>
	            </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>
	            <ReasonMap>  
					<ПУ>C1:APOLOGY</ПУ>
    	        </ReasonMap>
          	</CancellationReasons>
		</Pipeline>
	</DealPipelines>
</Bitrix>

Поле

Источник

значения

Значение

Bitrix

Enabled="True" — синхронизация с системой Битрикс включена
Enabled="False" — синхронизация с системой Битрикс отключена

DebugMode

True — режим отладки включён, синхронизируются только сущности, название которых начинаются на "ЛогусТест"
False — режим отладки отключён

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

DisableGuestsSync

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

True — синхронизация новых контактов отключена. При создании контакта в Битрикс, в Логусе НЕ будет создан профиль гостя.
False — синхронизация контактов/гостей включена и работает в полном объеме

ContactsWithDeal

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

Также данная настройка влияет на возможность ручной загрузки контактов из Битрикс. При значении False в Логусе в разделе Администрирование - Bitrix появляется соответствующий блок.

Logus: руководство > Описание полей секции <Bitrix> в конфигурационном файле > image2020-1-14_12-55-51.png

IsCompaniesSynchronize

True — синхронизация профилей компаний включена
False — синхронизация профилей компаний отключена

Также данная настройка влияет на возможность ручной загрузки компаний из Битрикс. При значении True в Логусе в разделе Администрирование - Bitrix появляется соответствующий блок.

Logus: руководство > Описание полей секции <Bitrix> в конфигурационном файле > image2020-1-14_8-59-27.png

LastNameAndNameRequired

Данная настройка проверяется как на стороне Логуса, так и на стороне Битрикс.

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

EmailOrPhoneRequired

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

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

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

UserId

Битрикс24

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

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

CheckWebHookAuthorizationCodes

Логус

True - проверка вебхуков выполняется
False - проверка вебхуков выполняться не будет

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

WebHookAuthorizationCodes

Битрикс24

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

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

Код авторизации WebHook {код авторизации (если есть)} не корректный.

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

EventsBaseUrl Логус Маска подключения к серверу Логуса (протокол и порт)

AgentDealTypeId

Логус

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

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

Fields

Логус

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

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

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

DefaultContactId

Битрикс24

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

DealsSyncStartDate

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

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

DealPipelines

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

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

Подробнее о работе с воронками в статье Направления продаж (Воронки).

Pipeline

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

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

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

Stages

Битрикс24

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

Подробнее о стадиях и о методе определения кода стадии в статье Стадии сделок.

Stages.Сalculation

Битрикс24

Предварительный расчёт сделки.

Stages.WaitList

Битрикс24

Стадия соответствует переводу брони в лист ожидания.

Stages.Reservation

Битрикс24

Создание брони.

Stages.Payment

Битрикс24

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

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

Stages.Cancel

Битрикс24

Код стандартной Стадии сделки, который используется при аннулировании Брони в Логусе.

CancellationReasons

Логус,

Битрикс24

Блок причин отмены (аннуляции) брони.

CancellationReasons.ReasonMap

Логус,

Битрикс24

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

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

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