Интеграция с Apart Sharing

По вопросам работоспособности приложения, а также для предложений по улучшению, обращаться support@satelab.ru

После установки приложения на портале перейдите на страницу настройки (в левом меню "Интеграция с Apart Sharing)


В открывшейся странице настройки Интеграции с Apart Sharing необходимо вести Логин и Пароль от вашего аккаунта в сервисе Apart Sharing


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


Далее необходимо сопоставить поля в сервисе Apart Sharing с полями в Битрикс 24

1. Дата и время заезда - Поле в котором хранится дата и время заезда. ВНИМАНИЕ! Если в поле содержится только дата без времени или время в поле 00:00:00, то бронь в Apart Sharing будет создана со временем заезда по умолчанию для объекта размещения.
   
2. Дата и время выезда - Поле в котором хранится дата и время выезда. ВНИМАНИЕ! Если в поле содержится только дата без времени или время в поле 00:00:00, то бронь в Apart Sharing будет создана со временем выезда по умолчанию для объекта размещения.
   
3. Телефон гостя - Поле где храниться телефон гостя для Apart Sharing
   
4. Код от замка - В данном поле можно передать индивидуальный код от электронного замка, если у вас не используются электронные замки оставьте поле не заполненным
   
5. ФИО гостя - ФИО гостя которые будут переданы в Apart Sharing
   
6. Цена договора (полная сумма бронирования) - Полная сумма брони, включая все дополнительные сборы и доп. услуги
   
7. Сумма оплаты через Apart Sharing - В случае если вы хотите принимать оплату, через сервис Apart Sharing укажите поле в котором будет храниться сумма к доплате.
   
8. Кол-во взрослых
   
9. Кол-во детей:
   
10. Комментарий - Комментарий от гостя
    
11. ID брони Apart Sharing - Поле где будет хранится Идентификатор Брони Apart Sharing. Данное поле используется для обновления информации в бронирование.
    

Сопоставьте источники Битрикс24 с источниками в Apart Sharing
В левом столбце указаны источники Б24, в правом Источники Apart Sharing



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

Выберите тип поля Текстовое или списочное (для PMS RealtyCalendar и TrevelLine - Текстовое, для Bnovo чаще всего списочное)
Выберите поле в котором хранится идентификатор объекта размещения
В левом столбце указаны объекты из Apart Sharing, в правом необходимо указать соответствующее значение выбранного поля в Битрикс24


Передача информации о брони в Apart Sharing

В связи с тем, что достоверно не известно в какой момент сделка будет содержать корректную информацию о брони, первоначальная передача брони в Apart Sharing осуществляется с помощью робота или действия в Бизнес процесса

В связи с тем, что Apart Sharing не запрещает создание дубликатов бронирования, мы рекомендуем реализовывать следующую схему Бизнес процесса:
Перед созданием брони проверять содержится ли ID брони Apart Sharing в поле или нет. Если нет, то отправлять запрос на добавление информации по бронированию



Настройки действия бизнес-процесса и робота содержит 1 настраиваемый параметр:
Добавить результат в Timeline сделки:
Если установлено "Да", то результат выполнение будет добавлен в сделку автоматически.

В результате выполнения может содержаться информация об успешном добавление сделки, не успешном и ошибках которые помешали передачи данных (Например не заполнены обязательные поля (Дата заезда, Дата Выезда, Объект размещения и т.д.)
Пример сообщения об ошибках:


В результате выполнения данного действия, будет возвращено 2 параметра

• Результат - текстовая информация, о результате выполнения действия. В случае успешного выполнения вернёт результат Бронирование успешно создано. В случае не успешного информацию об ошибке
  
• id бронирования Apart Sharing - В случае успешного добавления, будет содержать ID созданного бронирования.
  

id бронирования Apart Sharing -  Будет Автоматически добавлено в поле для хранения "ID брони Apart Sharing:" из настройки интеграции


Настройка на роботах происходит аналогично.
В списке роботов найдите робот [Интеграция с ApartSharing] Добавить бронирование в ApartSharing
Заполните поля, смысл полей тот же, что в действие Бизнес-процессов и настройки интеграции






Удаление брони в Apart Sharing.

Для удаления брони в Apart Sharing существует действие Бизнес процесса и соответствующий робот ([Интеграция с ApartSharing] Удалить бронирование в ApartSharing)
В качестве параметра необходимо передать ID брони в Apart Sharing