Вимоги до XML-фіду для житлової нерухомості

Перед підготовкою XML-фіда ознайомтеся з вимогами щодо передачі даних.

Загальна інформація про оголошення
Інформація про продавця або орендодавця
Інформація про умови угоди
Інформація про об'єкт
Опис житлового приміщення
Опис будівлі
Опис гаражів
Приклад коректного YRL-файлу
Загальна інформація про оголошення
Елемент offer має обов'язковий атрибут internal-id, який має бути унікальним для кожного оголошення. Internal-id може складатися з цифр, латинських та кирилиць, знаків. Ми рекомендуємо заповнювати його номером із вашої бази даних.

<offer internal-id="А1245">
  ...
</offer>
Увага. Елементи з обмеженим набором значень можуть містити лише перелічені варіанти. Використання інших значень спричинить помилку обробки фіда.

Елемент Обов'язковий елемент Опис
type Так
Тип угоди.

Суворо обмежені значення:

«продаж»

«оренда»

подобова оренда.

property-type Так
Тип нерухомості.

Суворо обмежене значення: "житлова"/"living".

category Так
Категорія об'єкта.

Можливі значення:

"дача"/"котедж"/"cottage"

«будинок»/«house»

«будинок з ділянкою»/«house with lot»

«дільниця»/«lot»

«частина будинку»

«квартира»/«flat»

«кімната»/«room»

"таунхаус" / "townhouse"

"дуплекс"/"duplex"

"гараж" / "garage".

garage-type
Категорія гаража.

Обов'язковий елемент для оголошень про продаж та оренду гаражів.

Можливі значення:

«гараж»/«garage»

«машиномісце»/«parking place»

"бокс"/"box"

lot-number
Номер лоту.

cadastral-number
Кадастровий номер нерухомості.

url
URL-сторінки з оголошенням на вашому сайті. Ми не покажемо його в оголошенні.

creation-date Так
Дата створення оголошення.

Вказується у форматі YYYY-MM-DDTHH:mm:ss+00:00.
Увага. Слідкуйте за актуальністю оголошень у фідах та видаляйте об'єкти, які вже здані або продані. Модерація може заблокувати фід, де є застарілі оголошення.

vas
Додаткова опція щодо просування оголошення.

Елемент вказується, якщо до оголошення має бути використана додаткова опція.

Можливі значення:

"premium"

"raise"

«promotion»

Для значення "raise" ("Підняття") можна застосувати щоденне автопідключення у певний час.

Для цього всередині vas вкажіть атрибут start-time, дату та час у форматі YYYY-MM-DDTHH:mm:ss+00:00 та значення raise.

Приклад:
<vas start-time="2018-06-04T10:00:00+03:00">raise</vas>
Має бути зазначена дата першого застосування опції. Оновлювати атрибут не потрібно. Оголошення, до якого застосовано опцію, підніматиметься щодня у вказаний час.

Увага. Опції не можна підключити до оголошень без фотографій.

location Так
Всередині <location> передаються елементи розташування об'єкта:

<location>
       <country/>
       <region/>
       <district/>
       <locality-name/>
          <sub-locality-name/>
       <address/>
       <direction/>
       <distance/>
       <latitude/>
       <longitude/>
       <metro>
           <name/>
           <time-on-foot/>
           <time-on-transport/>
        </metro>
        <railway-station>
</location>
У кожного типів об'єкта свої обов'язкові елементи: для міської нерухомості
district - район;
Знайти свій район можна у переліку. Не потрібно вказувати для великих міст;

locality-name – назва населеного пункту;

address – вулиця та будинок.
Приклад:

<location>
     <country>Україна</country>
     <region>Київська область</region>
     <district>Оболонський район</district>
     <locality-name>Парус</locality-name>
         <sub-locality-name>Центральний</sub-locality-name>
     <address>Бандери вул., б. 12</address>
</location>
для заміської нерухомості
district - район.
Знайти свій район можна у переліку. Не потрібно вказувати для великих міст.

locality-name - назва населеного пункту.
<location>
     <country>Україна</country>
     <region>Крим</region>
     <district> Сакський район</district>
     <locality-name>село Поповка</locality-name>
     <address>Молодіжна вул.</address>
</location>
country Так
Країна, де розташований об'єкт.

Передається усередині <location>.

Примітка. Ми приймаємо оголошення з об'єктами лише на території України.

region
Назва області.

Передається усередині <location>.

Необов'язково для Києва.

district
Назва району.

Передається усередині <location>.

Дізнатися про свій район можна в переліку.

locality-name
Назва населеного пункту.

Передається усередині <location>.

sub-locality-name
Район у місті.

Передається усередині <location>.

address
Адреса об'єкту – вулиця та номер будівлі.

Передається усередині <location>.

Необов'язково для заміської нерухомості.

apartment
Номер квартири.

Передається усередині <location>.

direction
Шосе.

Передається усередині <location>.

Передається за наявністю.

distance
Відстань до центра міста.

Передається усередині <location>.

За кілометри.

latitude
Географічно