Properties import

For exchange of properties between agency and LiveOnRiviera platform we use XML exchange format.

Agency-client will store generated XML files with properties (based on documentation below) either on public URL, where LiveOnRiviera robot can access them, or on password protected FTP account provided by client. Client is required to send URL or FTP account credentials to LiveOnRiviera business representative.

Links to complete examples with comments can be found below.
Properties XML file must be well-formed and valid against XSD schema.
XML files will be downloaded by default once a day in night hours, can negotiate different period with LiveOnRiviera bussiness representative.
In case of any question, please use contact form on the bottom of this page.

To assure high level of quality, all properties are required to include at least these attributes as minimum setup to import at LiveOnRiviera:

Properties.xml Properties.xsd (schema) Prices (rentals) Availability (rentals)

For rentals, client must implement booking API for booking request verification.

Numeric lists

ID Type
1 rent
2 sale
3 long term rent
4 new construction

Estatetypes.xml

ID Type
1 Апартамент
2 Луксозна вила
3 Пансион със закуска
4 Сграда
5 Парцел
6 Замък
7 Изба
8 Вила
9 Дуплекс жилище
10 Фермерска къща
11 Гараж
12 Градина
13 Къща
14 Парцел
15 Обзаведен апартамент
16 Офис
17 Паркинг
18 Пентхаус апартамент
19 Под наем
20 Обзаведена вила
21 Студио
22 Триетажно жилище
23 Вила
24 Лозе
25 Склад
26 Търговски обект
27 Индустриален обект
28 Семейна къща
29 Магазин
30 Хотел
31 Градска къща
32 Ново строителство

Features.xml

ID Feature description
1 Баня с душ
2 Еркер
3 Билярд
4 Закуска
5 Трапезария
6 Двоен стъклопакет
7 Външна автоматизирана врата/порта
8 Електрически външни щори
9 Електрически вътрешни щори
11 Полу-пансион
12 Земя
13 Дневна
14 Лоджия
15 Стая за игра
16 Баня / тоалетна
17 Солариум
18 Студио
19 Кабинет
20 Връзка с Интернет
21 Камина
22 Улеснен достъп за хора със специални потребности
23 Климатизация
24 Аларма
25 Лифт
26 Поддържащ персонал
27 Интерком
28 Параболична антена (сателит)
29 Басейн
30 Защитна врата
31 Тенис корт
32 Поливна система
33 Барбекю
35 Повдигнат под
36 Автомобилен навес
37 Къща за поддържащ персонал
38 Еркер
39 Централна вакуумна система (прахопочистване)
41 Щори
43 Перална машина
44 Джакузи
45 Сауна
46 Вана с джакузи
47 Кладенец
49 Собствен генератор на ток (с двигател)
50 Съдомиялна машина
51 Кухненски котлон (ел.,газ)
52 Сейф
53 Площадка за хеликоптер
54 Видеофон
55 Видео наблюдение
56 Кухненска печка
57 Ютия
58 Сешоар
59 Сателитна телевизия
60 DVD плейър
61 CD плейър
62 Външно осветление
63 Спа
64 Home automation_bg
65 Обзаведен
66 Спално бельо
67 Съдове и прибори за сервиране
68 Сушилна машина
69 Телефон
70 Хладилник
71 Фурна
72 Рецепция 24/7
73 Кафе машина
74 Микровълнова печка
75 Асансьор
78 Спалня
80 Кухня
81 Гараж
82 Паркинг
83 Изба
84 Градински навес
85 Баня
86 Сервизно помещение
88 Коридор
89 Коридор
90 Душ
91 Килер за дрехи
93 Тоалетна
94 Веранда
95 Тераса
100 Павилион край външен басейн
101 Шкаф
104 Таванско помещение
105 Мецанин
106 Мазе
107 Сервизно помещение
108 Работилница
110 Лофт
111 Библиотека
112 Килер
113 Вътрешен двор
115 Стая за спално бельо
116 Маза
117 Баня-тоалетна
119 Балкон
120 Фитнес зала
121 Музикален клуб
122 Домашна кино зала
123 Стая за гости
124 Стая за багаж
125 Градина
126 Парк
128 Вътрешен двор
129 Основна спалня
130 Студио
131 Гараж за карети
132 Апартамент
133 Хижа
134 Обор
135 Градинска къща
136 Помещение за колелета
137 Помещение за ски
138 Помещение за отпадъци
139 Турска баня
140 Закрит басейн
141 Стая за молитва и медитация
144 Стая
145 Конферентна стая
146 Стая за камериерка
147 Студио за камериерка
148 Двойна стая за гости
149 Тройна стая за гости
150 Добри условия
151 Много добри условия
152 За реновиране
153 Ново строителство
154 Ново строителство или реновиран имот
155 Реновиран имот
156 Ориентация на изток
157 Ориентация на север
158 Ориентация на юг
159 Ориентация на запад
160 Край море
161 Стар град
162 В близост до плаж
163 В близост до ски писти
164 Разположение в село
165 Висок стандарт
166 Луксозен стандарт
167 Високо качество
168 Асансьор
169 Детски кът
170 Подземен паркинг
171 Домакинство
172 Румсървис
173 Консиерж/портиер
174 Обзаведен офис
175 Просторен луксозен офис
176 Частен плаж
177 Частно пристанище
178 Гледка към море
179 Гледка към езерото
180 Гледка към пристанището
181 Гледка към градината
182 Гледка към парка
183 Гледка към селото
184 Гледка към града
185 Гледка към басейн
186 Резиденция
187 Допълнително легло
188 За не-пушачи
189 Домашни любимци
190 Регион подходящ за хайкинг
191 Хайкинг зона
192 Планински туризъм
193 Планинско колоездене
194 Колоездене
195 Ветроходство
196 Сърф
197 Ски бягане
198 Ледена пързалка
199 Сноуборд
200 Тобоган/шейна
201 Зимна пешеходна пътека
202 Таласо терапия
203 Голф
204 Конна езда
205 Тематичен парк
206 Ресторант
207 Готвач
208 Ограда
210 Масаж
211 Бебешко легло (креватче)
212 Feature.parkingprivate
213 Закрит паркинг
214 Частен басейн
216 Отопляем басейн
217 Детски басейн (в т.ч. надуваем)
218 Телевизор
219 Wifi интернет
220 Container
221 Почистване в края на престоя
222 Тенис на маса
223 Необзаведен
224 Електрическо отопление
225 Централно отопление
226 Стълбище
227 Feature.PVC-windows
228 Дървени прозорци
229 Гледки към града
230 Атрактивно местоположение
231 Слънчев панел
232 Съвременен дизайн
233 Керамична настилка
234 Луксозни покрития
235 Керамичен мозаечен под
236 Външни алуминиеви щори
237 Railings in glass and aluminium_bg
238 Керамични плочки
239 Предварителна инсталация за централно отопление или климатизация/климатик
240 Централна вакуумна система за предварително инсталиране
241 Външна настилка
243 Подово отопление
244 Отделен вход
245 Затворен курорт
246 Централно разположен
247 LCD телевизор
248 Интериорни врати от дъб или бук
249 Напълно оборудвана кухня
250 Веранда
251 Детектор за дим
252 Ламиниран паркет
253 Нови водопроводни инсталации
254 Частна земя
255 Open living room_bg
256 Красива гледка
257 Просторен
258 Енергийна ефективност
259 Енергиен клас А
260 Connection for fireplace_bg
261 Дървени подове
263 Разположен в тих/спокоен район
264 Отопление на газ
265 Бойлер
266 Навес
267 Модерни уреди
268 Топлинна помпа
269 Частичо обзаведен
270 Външна изолация
271 Месечни такси
272 Термо-камина
273 Alarm predisposition_bg
274 Енергиен клас B
275 Енергиен клас C
276 Енергиен клас D
277 Енергиен клас E
278 Енергиен клас F
279 Енергиен клас G
280 Енергиен клас H
281 Депозит
282 Children's room_bg
283 Клуб
284 24 часа поддръжка
285 Вградени гардероби
286 Мраморни подове
287 Двоен гараж
288 Utilities Included_bg
289 Feature.moutain-view

Use distance in meters or value of "1" to indicate this property is located in close proximity of selected object.

Distances.xml

ID Distance description
1 Водни спортове
2 Нощен клуб
3 Тенис корт
4 Доктор
5 Болница
7 Магазини
9 Ски писти
10 Публичен транспорт
11 Голф
12 Център
13 Море
14 Училище
15 Всички удобства
16 Аптека
17 Летище

Booking API

format: application/json
response success: response.msg
response error: response.error

Request URL Description
POST /available

Check if property is available in selected dates for renting.
Response 200 - available.
Response 404 - not available.

Params:
partner_id Partner ID (verification)
date_from date of arrival, format year-month-day
date_to date of departure, format year-month-day
reference_id unique property id
persons no. of persons

POST /booking

Book property.
Response 200 - booking successful.
Response 405 - invalid input.

Params:
partner_id Partner ID (verification)
reference_id property ID
email valid email
full name name
street address, street
city address, city
postal address, postal
country address, country
phone phone
date_from date of arrival, format year-month-day
date_to date of departure, format year-month-day
persons no. of persons
Return:
booking_id ID of booking in client system

GET /state/{booking_id}

Get information about booking.
Response 200 - ok.
Response 404 - booking not available.

Params:
partner_id Partner ID (verification)
reference_id unique property id
Return:
state new|confirmed|payed|cancelled

DELETE /cancel/{booking_id}

Cancel booking.
Response 200 - ok.
Response 404 - booking not available.

Params:
partner_id Partner ID (verification)

GET /payment/{booking_id}

Get information about payment. Get URL to redirect user.
Response 200 - ok.
Response 404 - booking not available.

Params:
partner_id Partner ID (verification)
booking_id ID of booking in client system
return_url URL where partner redirects after succesfull payment
return_url_fail URL where partner redirects after payment failure
Return:
payment_url URL in clients system where user will finish payment