0  /  8

Интеграция с Битрикс24

Настройка обмена с Битрикс24

Обратите внимание! Перед началом настройки обмена между 1С-Отель и Битрикс 24 необходимо установить приложение «Интерфейс с 1С-Отель ред.9» из маркетплейса Битрикс24.
Примечание: Все дальнейшие настройки выполняются на стороне 1С-Отель.

Откройте справочник взаимодействий с внешними системами выбрав в меню «Интеграция/ Взаимодействия с внешними системами».

взаимод с внешними системами.png

Создайте новый элемент справочника – кнопка «Создать».

создать новый элемент.png

Заполните следующие параметры элемента справочника взаимодействий с внешними системами:

  • Заполните Код, например BITRIX24.
  • Укажите Наименование, например название вашего портала Битрикс 24.
  • Выберите Тип интеграции - Битрикс24.
  • Включите флажок Действует.

основные настройки.png

Сохраните элемент нажав на кнопку «Записать».

сохранить элемент.png

Перейдите в настройки взаимодействия с внешними системами нажав на кнопку «Настройки».

перейти в настройки.png

Откроется окно, в котором необходимо настроить параметры подключения, соответствия полей и типы клиентов.

настройки параметров.png

Обратите внимание, что флажок Режим отладки включает запись всех обменов в регистр логов.

Чтобы просмотреть регистр логов по конкретному взаимодействию, откройте «Интеграции/ Взаимодействия с внешними системами», выделите нужное взаимодействие и нажмите ссылку «Логи интеграций со внешними системами».

открыть логи.png

В открывшемся окне можно просмотреть лог каждого выполненного запроса. Поле «Тип события» в большинстве случаев отображает статус выполнения HTTP запроса. Тип «Ошибка» в данном поле будет, например, в случае отсутствия соединения с внешней системой. Также в случаях необрабатываемой ошибки сюда может быть записан лог со статусом «Ошибка» или «Предупреждение».

окно с логами.png

При открытии любого лога можно просмотреть отправленный запрос и полученный ответ. Также запрос и ответ можно просмотреть в виде дерева - нажать на кнопку «Просмотр в виде дерева».

в виде дерева.png

Поддержка просмотра в виде дерева доступна только для запросов/ответов в виде XML или JSON.


Настройка параметров подключения

Перейдите на вкладку «Настройки/ Настройки подключения» и заполните следующие параметры:

  1. Адрес портала: укажите адрес вашего портала Битрикс24 (без http или https).
  2. Порт: Для облачной версии укажите порт 443. Для коробочной версии уточните адрес у администратора портала.
  3. Исп. SSL соединение: Для коробочной версии уточните адрес публикации. Если он начинается с https, то нужно включить галочку «Использовать SSL соединение», если он начинается с http, то галочку нужно выключить.
  4. настройки подключения.png

  5. Авторизация: Авторизация производится по технологии OAuth.

    По кнопке «Получить код приложения» открывается окно браузера с авторизацией на вашем портале Битрикс24. Нужно войти на портал с учетной записью того пользователя, от имени которого будет выполняться обмен.

    Внимание! Именно этот пользователь будет отражен в истории изменения элементов CRM. Если требуется отличать такие записи, то лучше создать отдельного пользователя «Обмен с 1С-Отель» и авторизовать приложение от его имени.

    Если вы не были авторизованы, то сначала нужно авторизоваться на портале. Если вы уже были авторизованы на портале, то будет сразу показан «Код приложения».

    код приложения.png

    Полученный код приложения нужно ввести в поле Код приложения и нажать «ОК».

    ввод кода приложения.png

Примечание:

Проверить соединение можно нажав на кнопку «Тест подключения».

В случае успеха адрес портала будет подсвечен зеленым и будет выведено сообщение «Успешное подключение».

тест подключения.png

Что может пойти не так?

  1. Сообщение «ERROR_OAUTH: Application not installed»:
    В этом случае нужно установить приложение из маркетплейса Битрикс24. После чего снова повторить попытку получения кода приложения.

  2. Сообщение «Не удалось подключиться к серверу»:
    1. Ввели неверный код приложения - введите верный код.

      ошибка подключения.png

    2. Прошло более 30 секунд между авторизацией и вводом кода в 1С - повторите попытку получения кода.
Примечание:

Перед началом настройки синхронизации нажмите кнопку «Сохранить и обновить данные», чтобы получить актуальные данные из Битрикс24.

сохранить и обновить данные.png


Настройка синхронизации данных между 1С-Отель и Битрикс24

В рамках обмена между 1С-Отель и Битрикс 24 с использованием приложения «Интерфейс с 1С-Отель ред.9» можно настроить синхронизацию следующих данных:

  • синхронизация клиентов - синхронизируются клиенты в 1С-Отель и контакты в Битрикс 24
  • синхронизация контрагентов - синхронизируются контрагенты в 1С-Отель и контрагенты Битрикс 24
  • синхронизация сделок - синхронизируются группы гостей в 1С-Отель и сделки в Битрикс 24

Синхронизация клиентов

Обратите внимание, что клиенты в 1С-Отель синхронизируются с контактами в Битрикс24.

Настройка синхронизации клиентов проводится в два шага:

1. Задаются соответствия для типов контактов из Битрикс24 на вкладке «Типы клиентов»

2. Задаются соответствия для полей из Битрикс24 на вкладке «Соответствие полей»

Настройка соответствий типов клиентов

Перейдите на вкладку «Настройки/ Клиенты/ Типы клиентов».

типы клиентов.png

На данной вкладке отображаются все типы контактов из Битрикс24. Чтобы настроить соответствия нужно выбрать тип клиента из 1С-Отель в соответствующем поле.

выбор типа клиента.png

Обратите внимание, что типы контактов: Клиенты, Партнеры, Поставщики, Другое- представлены в Битрикс24 по умолчанию, но можно добавить дополнительные типы контактов, соответствующие типам клиентов в 1С-Отель. 

битрикс справочники.png

После добавления новых типов контактов в Битрикс24 нужно нажать кнопку Сохранить и обновить данные и настроить соответствие в таблице.   

дополнительный тип контакта.png

Настройка соответствия полей

Перейдите на вкладку «Настройки/ Клиенты/ Соответствие полей».

соответствия полей.png

В таблице соответствий полей отображается список всех доступных полей для карточки контакта в Битрикс24. При этом стандартные поля, такие как Фамилия, Имя, Дата рождения и прочее будут автоматически сопоставлены полям клиента в базе 1С-Отель. Для дополнительных полей можно выбрать соответствие вручную.

виды полей.png


Если на вашем портале Битрикс24 уже были созданы дополнительные пользовательские поля для карточки клиента, то вы можете выбрать соответствия полям клиента в базе 1С-Отель.

выбор пользовательских полей.png

Обратите внимание, что пользовательские поля в 1С-Отеле отмечены галочкой в таблице соответствий.

Кроме того вы можете создать свои пользовательские поля и заполнить их данными из 1С. При создании обратите внимание на тип поля. Например, у полей дата заезда и выезда – выберите «Дата». У полей «Изменить бронь» и «Ссылка для гостя» укажите тип «Ссылка». У полей «Заездов» и «Ночей» укажите тип «Число» или «Целое число».

поля в битрикс24.jpg

Примечание: Можно проставить соответствия как показано ниже на рисунке.

соответствия полей.png

Эти вычисляемые поля могут использоваться следующим образом:

Информация о бронировании:

  1. Бронь – строка с описанием брони – такая же как в базе 1С. Содержит описание ближайшего бронирования. 
  2. Заезд – дата ближайшего заезда гостя.
  3. Выезд – дата выезда ближайшей брони. 
  4. Изменить бронь – поле содержит ссылку на бронирование в базе 1С-Отель. Если база опубликована и имеет ссылку для доступа через веб-клиент, то эта ссылка будет заполнена и пользователь сможет быстро открыть карточку брони и внести в нее изменения.
  5. Примечания к брони – содержит комментарии по брони, как правило с пожеланиями клиента.
  6. Ссылка для гостя – заполняется при использовании модуля онлайн бронирования. Отправьте эту ссылку гостю и он сможет онлайн оплатить бронь, или внести в нее изменения, или заказать дополнительные услуги.

Статистика

  1. Ночей – общее число ночей гостя за всю историю базы 1С. Используйте для сегментирования клиентов.
  2. Заездов – общее число заездов гостя по данным 1С-Отель. Чтобы сразу видеть повторных гостей, а также для сегментирования базы клиентов.

Если все данные сопоставлены и заполнены, то общий вид карточки клиента можно настроить подобным образом.

вид карточки клиента.png


Синхронизация контрагентов

Обратите внимание, что контрагенты в 1С-Отель синхронизируются с компаниями в Битрикс24.

Настройка синхронизации контрагентов проводится в три шага:

1. Задаются соответствия для типов компаний в Битрикс24 на вкладке «Типы контрагентов»

2. Задаются соответствия для сфер деятельности в Битрикс24 на вкладке «Сферы деятельности»

3. Задаются соответствия для полей в Битрикс24 на вкладке «Соответствие полей»

Настройка соответствий типов контрагентов

Перейдите на вкладку «Настройки/ Контрагенты/ Типы контрагентов».

типы контрагентов.png

На данной вкладке отображаются все типы компаний из Битрикс24. Чтобы настроить соответствия нужно выбрать тип контрагента из 1С-Отель в соответствующем поле.

выбор типа контрагента.png

Обратите внимание, что типы компаний: Конкурент, Клиент, Партнер, Поставщик, Другое - представлены в Битрикс24 по умолчанию, но можно добавить дополнительные типы компаний, соответствующие типам контрагентов в 1С-Отель.

битрикс справочники тип контрагента.png

После добавления новых типов компаний в Битрикс24 нужно нажать кнопку Сохранить и обновить данные и настроить соответствие в таблице.

дополнительный тип компании.png

Настройка соответствий для сфер деятельности

Перейдите на вкладку «Настройки/ Контрагенты/ Сферы деятельности».

сферы деят.png

На данной вкладке отображаются все сферы деятельности из Битрикс24. Чтобы настроить соответствия нужно выбрать отрасль компании из 1С-Отель в соответствующем поле.

выбор сферы деятельности.png

Обратите внимание, что по умолчанию в Битрикс24 представлен набор сфер деятельности, но можно добавить дополнительные сферы деятельности, соответствующие отраслям компаний в 1С-Отель.

битрикс справочники тип контрагента сфферы деят.png

После добавления новых сфер деятельности в Битрикс24 нужно нажать кнопку Сохранить и обновить данные и настроить соответствие в таблице.

дополнительная сфера деят.png

Настройка соответствия полей

Перейдите на вкладку «Настройки/ Контрагенты/ Соответствие полей».

контрагенты соотв полей.png

В таблице соответствий полей отображается список всех доступных полей карточки компании в Битрикс24. При этом стандартные поля, такие как Название, Адрес, будут автоматически сопоставлены полям контрагента в базе 1С-Отель. Для дополнительных полей можно выбрать соответствие вручную.

виды полей компании.png

Если на вашем портале Битрикс24 уже были созданы дополнительные пользовательские поля для карточки компании, то вы можете выбрать соответствия полям контрагента в базе 1С-Отель. Кроме того, вы можете создать свои пользовательские поля и заполнить их данными из 1С-Отель.

Обратите внимание, что пользовательские поля в 1С-Отеле отмечены галочкой в таблице соответствий.

Синхронизация сделок

Обратите внимание, что сделки в Битрикс24 синхронизируются с группами гостей в 1С-Отель.

Настройка синхронизации сделок проводится в два шага:

1. Задаются соответствия для стадий сделок в Битрикс24 на вкладке «Статусы сделки»

2. Задаются соответствия для полей карточки сделки из Битрикс24 на вкладке «Поля сделки»

Настройка соответствий статусов сделки

Перейдите на вкладку «Настройки/ Сделки/ Статусы сделки».

статусы сделки.png

На данной вкладке отображаются все стадии сделок из Битрикс24. Чтобы настроить соответствия нужно сначала выбрать тип статуса сделки, а затем выбрать статус сделки из 1С-Отель в соответствующем поле.

выбор типа статуса сделки.png
выбор статуса сделки.png

Обратите внимание, что по умолчанию в Битрикс24 представлен набор стадий сделок, которые можно настроить (удалить/ добавить) в соответствии со статусами групп гостей в 1С-Отель.

справочники стадии сделок.png

После настройки стадий сделок в Битрикс24 нужно нажать кнопку Сохранить и обновить данные и настроить соответствие в таблице статусов.

Настройка соответствия полей

Перейдите на вкладку «Настройки/ Сделки/ Поля сделки».

поля сделки.png

Таблица соответствий заполнится доступными полями карточки сделки из Битрикс24. При этом стандартные поля будут автоматически сопоставлены полям группы гостей в базе 1С-Отель. Для дополнительных полей можно выбрать соответствие вручную.

виды полей сделки.png

Если на вашем портале Битрикс24 уже были созданы дополнительные пользовательские поля для карточки сделки, то вы можете выбрать соответствия полям группы гостей в базе 1С-Отель. Кроме того, вы можете создать свои пользовательские поля и заполнить их данными из 1С

Обратите внимание, что пользовательские поля в 1С-Отеле отмечены галочкой в таблице соответствий.

Первоначальная выгрузка/загрузка данных

Обратите внимание, что в рамках данного обмена между Битрикс24 и 1С-Отель поддерживается первоначальная выгрузка данных как из 1С-Отель в Битрикс24, так и в обратном направлении - из Битрикс24 в 1С-Отель.

Из 1C-Отель в Битрикс24 можно выгрузить:

  1. клиентов
  2. теги клиентов
  3. контрагентов
  4. сделки
  5. задачи

В 1C-Отель из Битрикс24 можно загрузить:

  1. всех клиентов
  2. клиентов с изменениями

Чтобы провести первоначальную выгрузку/ загрузку данных перейдите на вкладку «Ручная синхронизация».

ручная синхронизация.png

Внимание! При проведении выгрузки/ загрузки данных обязательно дожидайтесь ее окончания – это длительный процесс!

Выгрузка клиентов

Чтобы выгрузить всех клиентов из 1С-Отель в контакты в Битрикс24, нажмите кнопку «Выгрузить клиентов».

выгрузка клиентов.png

В результате все клиенты из базы 1С-Отель будут выгружены в Битрикс24.

Выгрузка тегов клиентов

В 1С-Отель у клиентов могут быть проставлены теги по каким-то определенным алгоритмам. В рамках данного обмена на стороне Битрикс24 можно создать специальное поле «1С:Отель Теги», которое является списком с множественным выбором, и при каждой синхронизации данных обновляет данное поле новыми/измененными тегами и проставляет их клиентам. Такой механизм используется для сегментации клиентов на стороне Битрикс24.

Чтобы создать поле «1С:Отель Теги» и заполнить его тегами из 1С-Отель в ручном режиме, нажмите кнопку «Создать и обновить теги клиентов».

создать теги клиентов.png

Чтобы удалить из Битрикс24 теги, которые более не действительны в 1С, нажмите кнопку «Удалить неиспользуемые теги клиентов».

удалить теги.png

Выгрузка контрагентов

Чтобы выгрузить всех контрагентов из 1С-Отель в компании в Битрикс24, нажмите кнопку «Выгрузить контрагентов».

выгрузить контрагентов.png

В результате все контрагенты из базы 1С-Отель будут выгружены в Битрикс24.

Выгрузка сделок

Обратите внимание, что сделкам в Битрикс24 соответствуют группы гостей в 1С-Отель.

Чтобы выгрузить только измененные группы гостей из 1С-Отель в сделки в Битрикс24, нажмите кнопку «Выгрузить сделки».

выгрузить сделки.png

В результате в Битрикс24 будут выгружены только измененные за последние 24 часа группы гостей (сделки).

Обратите внимание, что только при первоначальной выгрузке по кнопке "Выгрузить сделки" выполняется выгрузка за последние сутки. При всех последующих выгрузках выполняется выгрузка с даты последней синхронизации.


Чтобы выгрузить все группы гостей, у которых дата заезда больше определенной даты, из 1С-Отель в сделки в Битрикс24, укажите дату в поле "Дата заезда сделок" и нажмите кнопку «Выгрузить сделки с даты заезда».

выгрузить с даты.png

В результате в Битрикс24 будут выгружены только те группы гостей (сделки), у которых дата заезда больше указанной даты.

Выгрузка задач

Обратите внимание, что для того, чтобы в Битрикс24 из 1С-Отель выгружались задачи, привязанные к определенному сотруднику, нужно в 1С-Отель в карточке сотрудника на вкладке "Битрикс24" предварительно указать его ID из Битрикс24. Если у сотрудника не будет указан ID, то привязанные к нему задачи не будут выгружены.

карточка сотрудника.png

Открыть карточку сотрудника можно выбрав в меню Настройки/ Администрирование/ Сотрудники.  

Чтобы выгрузить задачи из 1С-Отель в задачи в Битрикс24, нажмите кнопку «Выгрузить задачи».

выгрузить задачи.png

В результате будут выгружены из базы 1С-Отель в Битрикс24 задачи, привязанные к пользователям, у которых заполнен ID из Битрикс24.

Загрузка клиентов

Чтобы загрузить всех клиентов из Битрикс24 в 1С-Отель, нажмите кнопку «Загрузить всех клиентов».

загрузить всех клиентов.png

В результате будут загружены все клиенты из Битрикс24 в 1С-Отель. При загрузке клиенты сопоставляются по ФИО и номеру телефона/ дате рождения/ e-mail, чтобы избежать дублирования.

Загрузка клиентов с изменениями

Чтобы загрузить клиентов с изменениями с последней даты обмена из Битрикс24 в 1С-Отель, нажмите кнопку «Загрузить клиентов с изменениями».

загрузить клиентов сизменениями.png

В результате из Битрикс24 в 1С-Отель будут загружены только те клиенты, по которым зарегистрированы изменения на портале Битрикс24 с даты последнего обмена. При загрузке клиенты сопоставляются по ФИО и номеру телефона/ дате рождения/ e-mail, чтобы избежать дублирования.

Чтобы в дальнейшем в автоматическом режиме выгружать изменения по клиентам, контрагентам и сделкам необходимо настроить регулярный фоновый обмен.


Настройка автоматического обмена

Перейдите на вкладку «Фоновое задание».

настройка фонового задания.png

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

Нажмите кнопку «Расписание», чтобы задать расписание автоматического обмена, например каждые 5 минут.

настройка расписания.png   настройка расписания 2.png

Включите флажок «Использовать фоновое задание» - настройки автоматически сохранятся и в список фоновых заданий будет добавлена задача с указанным расписанием.

Обратите внимание, что при включенном фоновом задании синхронизация клиентов проводится всегда.

Чтобы при автоматическом обмене также синхронизировались задачи, включите флажок «Синхронизировать задачи».

синхронизировать задачи.png

Чтобы включить синхронизацию контрагентов, включите флажок «Синхронизировать контрагентов» на вкладке «Настройки/ Контрагенты».

синхронизировать контрагентов.png

Чтобы включить синхронизацию сделок, включите флажок «Синхронизировать сделки» на вкладке «Настройки/ Сделки».

синхронизировать сделки.png

Фоновое задание отслеживает изменения по всем синхронизируемым объектам в базе 1С-Отель и выгружает их в Битрикс24.