Как подключить синхронизацию через iCal

Чтобы синхронизация работала корректно, необходимо выполнить два действия:

1. Добавить нашу ссылку (экспорт) в канал
   → чтобы передавать занятость из Werent на площадку
2. Добавить ссылку с площадки (импорт) в Werent
   → чтобы получать занятость из площадки в Werent
   

Как это сделать в Werent

🔹 Шаг 1: Открыть менеджер каналов

Перейдите в Календарь — Менеджер каналов по ссылке, или:

• На ПК вы сможете перейти в Менеджер, нажав синюю кнопку в левом верхнем углу экрана в Шахматке
  
• Со смартфона - нажав кнопку "Каналы" в нижнем меню в Шахматке

1. Найдите нужный объект в списке
2. Нажмите «Добавить канал» рядом с ним
   
3. Выберите канал «iCalendar»

🔹 Шаг 2: Работа с полями экспорт и импорт

1. Поле «Экспорт» — это ссылка, которую нужно вставить в личный кабинет на площадке бронирований
   🔹 Нажмите на поле, чтобы скопировать ссылку
   
2. Поле «Импорт» — сюда нужно вставить ссылку, которую вы получите на площадке
   
3. Поле «Название» — как будет называться площадка внутри сервиса WeRent, впишите сюда название той площадки, что подключаете через iCal
   

🔹 Шаг 3: Завершите подключение канала

Заполните 2 обязательных поля: импорт и название
После нажмите синюю кнопку «Добавить канал»

Что такое ссылки "экспорт", "импорт"?

Экспорт - ссылка на файл WeRent, который вставляется НА площадку. Площадка читает его и видит занятые даты.

Импорт - чужая, сторонняя ссылка с площадки/откуда либо еще, которую вы добавили в менеджере каналов. Мы читаем её раз в 10 минут и создаём по ней брони. Менять и отменять уже созданные бронирования умеет только Kufar, у остальных площадок - нет.

Каждая ссылка работает только в одну сторону. Например закрытие дат не сработает, если будет добавлена только ссылка импорта - т.к. она работает только на принятие информации о бронированиях, а занятость передается ссылкой экспорта. Т.е важно добавить ссылки и в WeRent, и в площадку.

Цены не уходят на площадку? Что уходит в экспорт, а что нет?

Уходит только занятость: интервалы закрытых дат. Цен, минимального срока и правил заезда в файле нет - на площадку они попадают только через прямую интеграцию.

Как самостоятельно проверить экспорт файл iCal?

1. Для начала скачайте файл. Для этого откройте редактирование канала, скопируйте оттуда экспорт ссылку. Откройте её в любом браузере - скачается файл.

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

• 404 неправильная ссылка: путь без .ics и без ?ical_id=, либо не тот поддомен: работает только export.werent.me
  
• 400 неверный public_id
  
• 500 опечатка в ссылке - в ссылке нет числового public_id
  

2. Далее откройте этот файл любым текстовым редактором.

3. Как читать файл:

Каждый блок от BEGIN:VEVENT до END:VEVENT - один закрытый интервал. Дат внутри нет, есть границы: дата закрыта, если DTSTART ≤ дата < DTEND. День DTEND уже свободен.

Правило дня выезда: бронь с 10 по 12 закрывает 10 и 11, 12 остаётся открытым. Это не ошибка.


Пример файла целиком:

BEGIN:VCALENDAR
VERSION:2.0
PRODID:WeRent.me
METHOD:PUBLISH
BEGIN:VEVENT
UID:268151438@werent.me
DTSTART;VALUE=DATE:20260828
DTEND;VALUE=DATE:20260831
SUMMARY:WeRent(268151438)
END:VEVENT
BEGIN:VEVENT
UID:2670706102@werent.me
DTSTART;VALUE=DATE:20261128
DTEND;VALUE=DATE:20270828
SUMMARY:WeRent(20261128 - 20270828 - 2606261021001)
END:VEVENT
END:VCALENDAR

Здесь первый блок - бронь: закрыты 28, 29 и 30 августа, 31-е свободно. Второй - закрытие с 28.11.2026 по 27.08.2027, то есть граница окна бронирования.


Строка SUMMARY бывает двух форм:

• SUMMARY:WeRent(268280839) - закрыто бронью, в скобках её номер. Бронь открывается по нему напрямую: добавить к адресу шахматки ?public_id={номер}, карточка откроется сама
  
• SUMMARY:WeRent(20261002 - 20261004 - 2608280839001) - дата начала, дата конца в формате ГГГГММДД и public_id квартиры. Так выглядит и ручное закрытие, и блок границы окна бронирования: по SUMMARY их не различить. Признак окна - это последний блок файла и он упирается ровно в сегодня + 12 месяцев

Даты в файле не дублируются. Если у хоста две пересекающиеся брони, границы блоков не обязаны совпадать с датами броней: при частичном пересечении блоков будет два, но с "неправильными" границами, а бронь, целиком лежащая внутри другой, отдельным блоком не появится вовсе. Само по себе это не расхождение.

По всем вопросам вы всегда можете обращаться в поддержку любым удобным вам способом. А чтобы вы при желании могли разобраться самостоятельно, мы подготовили список проверок и решений:

Площадка продала занятую дату

1. Открыть ту ссылку, что стоит на площадке. Не отдаётся или отдаёт не то, что ссылка в редактировании канала в WeRent - ошибка найдена: ссылку на площадке надо заменить на ту, что в личном кабинете WeRent. 
   
2. Ссылка корректная - проверить, попадает ли дата в какой-нибудь интервал. Попадает - экспорт корректен, дело в периоде чтения на стороне площадки: его задаёт площадка, мы на него не влияем.
   
3. Не попадает - убедиться, что бронь активная. Отменённые и архивные брони в экспорт не идут. Бронь активная, а даты в файле нет - писать в поддержку.

В WeRent дату закрыли, а на площадке открыта

Время передачи информации зависит от площадки (сама площадка решает, как часто забирать у нас информацию, мы на это повлиять не можем) и может занимать до 60 минут. 
В файл экспорта WeRent данные об изменении попадут в течение 30 секунд. Вы можете проверить файл - если в файле экспорта дата есть, значит в течение часа данные должны попасть на площадку.

На площадке закрыты дальние даты, но вручную в календаре WeRent их не закрывали

Это работа функции "Окно бронирования". Она отвечает за то, чтобы гости не забронировали у вас по слишком низкой цене на дальние даты (если например вы забываете или не выставляете цены далеко вперёд). 

"Окно бронирований" находится в шахматке, в разделе настройки. Действует на все объекты, а не на отдельную квартиру.

Если окно меньше 12 месяцев, всё от конца окна до года выгружается одним большим закрытым блоком - это он и есть. Дальше года в файле нет ничего.
При окне 12 месяцев, а это значение по-умолчанию, закрывающего блока нет вообще: даты дальше года в файле просто отсутствуют, и площадка может считать их свободными - напишите в поддержку, если столкнулись с такой проблемой.

В WeRent не пришло бронирование с площадки

1. Открыть редактирование канала в менеджере каналов WeRent, и проверить, что в поле "Импорт" вставлена корректная ссылка с площадки

2. Если ссылка корректная, то далее посмотреть строку статуса синхронизации: при ошибке будет "Ошибка получения данных", иначе "Данные получены". Если пока что еще не было ни одной попытки получения данных, строка статуса скрыта целиком. У только что добавленного канала статуса ещё не существует.

Дата рядом со статусом - время последней попытки, а не последнего успеха. Опрос идёт каждые 10 минут, один цикл может штатно пропуститься, поэтому тревожный признак - дата старше получаса: значит источник не опрашивается вовсе.

Ошибка появляется с первой же неудачной попытки, порога нет. Причины: ссылка сменилась, площадка закрыла доступ, площадка отдаёт мусор.

3. Ошибки нет, дата попытки свежая - значит синхронизация работает. Остаётся дождаться, пока площадка отдаст данные - этот срок мы не контролируем, у крупных каналов он измеряется часами.

После синхронизации стало приходить много уведомлений о неполных бронированиях

У бронирований из iCal нет ни телефона, ни почты гостя, поэтому на каждую импортированную бронь приходит письмо, сообщение в Telegram и push - те из них, что включены в настройках уведомлений. Необходимо просто дождаться, пока все брони будут получены.

Бронь отменена или перенесена на площадке, в WeRent не пришли изменения

Это стандартное поведение iCal, площадки не передают отмены/переносы. После отмены или переноса брони в площадке, это же действие нужно сделать с этой бронью вручную в шахматке WeRent. Брони с уже прошедшим выездом не трогаются.
Исключение - площадка Kufar. Она не передает перенос дат, но передает отмену. 

Удалили/отменили импортированную бронь в WeRent, а на площадке она осталась

Чтобы отменить бронирование на площадке - необходимо связаться с гостем или поддержкой площадки. 
Если же необходимо восстановить бронирование в WeRent - просто добавьте его вручную, чтобы закрыть даты. Автоматически повторно бронирование не будет передано.
Исключение - площадка Kufar. Она восстановит бронирование в WeRent.

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

Подсвечивает поле импорт красным и выдает ошибку. Причины:

• поле импорта пустое. iCal-канал нельзя создать без ссылки импорта, даже если нужен только экспорт
  
• в поле импорт добавлена наша собственную экспортную ссылку werent.me - её подключать как импорт нельзя
  
• ссылка не похожа на адрес или ведёт на внутренний адрес сети
  

Дублирование бронирований с одной площадки

1. Это может быть дубль канала в системе WeRent. 
Часть площадок, подключаемых через iCal, уже добавлена в WeRent как отдельный канал (например вы выбираете "ДомКлик" - и его подключение идет через ical). Либо вы добавляете новый, еще не существующий в WeRent канал (когда в списке каналов вы выберите "iCal")
И если вы добавите одну и ту же площадку, но вышеописанными двумя способами, то появятся дубли.
2. В случае, если дублей канала нет - напишите в поддержку и расскажите нам про сайт / площадку, с которой приходят дубли.

Площадка подключена в WeRent одновременно напрямую и через iCal

Например в случае новой интеграции WeRent с новой площадкой - вы добавили прямое подключение, но не удалили старое подключение через iCal. В таком случае будут дублирования бронирований. В менеджере каналов удалите синхронизацию через iCal для этой площадки.