Особенности работы iCal, ответы на вопросы

Что такое iCal?

iCal позволяет подключить передачу занятости для любых площадок/календарей/сервисов.

Это не программа/приложение, ничего скачивать не нужно. Это просто способ передачи информации, всё настроено на нашей стороне. Вам нужно только понимать, что занятость будет передаваться, а цены нужно будет менять вручную на площадках, но овербукингов не будет. 

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

Экспорт - ссылка на файл 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

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

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

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. В случае, если дублей канала нет - напишите в поддержку и расскажите нам про сайт / площадку, с которой приходят дубли.