Дошка безкоштовних оголошень

XML імпорт для агентств нерухомості

Якщо Ви представляєте інтереси агентства нерухомості, зацікавленого у публікації великої кількості оголошень на порталі GVANGA.COM – для Вас існує сервіс вивантаження оголошень XML.

Завантаження XML фіда:

Крок 1 - Створіть файл XML (фід) – структурований каталог сайту, що оновлюється.

Ви можете використовувати формат XML фіду для Яндекс.Нерухомості.

Вимоги до фіда

Актуальність - Фід повинен містити лише актуальні дані про оголошення.

Редагування вже завантажених оголошень необхідно здійснювати шляхом оновлення вже існуючих даних. Зверніть увагу, що видалення старого оголошення та створення нової копії може призвести до дублювання та подальшого блокування публікації даного оголошення.

Технічні вимоги до фіду

URL фіда має бути постійним та доступним за протоколом HTTP.
Імпорт даних Вашого XML-фіду буде здійснюватися 1 раз на добу.
Фід повинен бути створений у кодуванні UTF-8.
Не допускається наявність у фіді HTML-коду.
У текстових полях не повинні використовуватися перші 32 символи з ASCII-кодами (за винятком значень 9, 10 та 13).
Крім того, ряд символів для файлу необхідно замінювати кодами:

Символ	Код
"	"
&	&
>	>
<	<
'	'

Формат фіда

Заголовок фіда має починатися зі стандартного XML-заголовка:
<?xml version="1.0" encoding="utf-8"?>

У файлі має бути кореневий елемент realty-feed - <realty-feed> …</realty-feed> з датою створення фіда:
<generation-date>YYYY-MM-DD HH:mm:ss+04:00</generation-date>

Кожне оголошення у фіді формується елементом offer, для якого необхідно вказувати унікальний ідентифікатор internal-id:
<offer internal-id="Номер id"> ... </offer>

Опис обов'язкових параметрів елемента offer:

Елемент	Описання
<type>	Напрямок угоди («продати» або «продаж», «купити» або «купівля», «здати» або «оренда», «зняти» або «орендувати»)
<category>	Категорія об'єкта: "кімната", "room", "квартира", "flat", "будинок", "house", "дача", "котедж", "cottage", "таунхаус", "townhouse", "земельна ділянка », «lot», «гараж», «garage». Для комерційної нерухомості: "офіс", "office", "коворкінг", "coworking", "магазин", "shop", "торговельні площі", "для краси, відпочинку, оздоровлення", "склад", "виробництво та промисловість », «Приміщення вільного призначення», «Будівлі, споруди».
<url>	Посилання на сторінку з оголошенням
<creation-date>	Дата створення оголошення – формат дати: YYYY-MM-DDTHH:mm:ss+00:00
<location> … </location>	Набір обов'язкових елементів для опису розташування об'єкта нерухомості:
<country>	Країна
<locality-name>	Місто
<description>	Текст оголошення – додаткова текстова інформація.
<price> … </price>	Елементи показника «Ціна».
<value>	Сума (без пробілів).
<currency>	Валюта: «RUR» або «RUB», «USD», «EUR», «UAH»

Додаткові параметри.

Рекомендується включати у фід усі елементи пропозицій, щоб Ваші об'єкти краще потрапляли у результати пошуку користувачів сайту – Ваших потенційних клієнтів.

Елемент	Описання
<last-update-date>	Дата останнього оновлення оголошення (у форматі дати)
<title>	Заголовок оголошення
<expire-date>	Термін публікації оголошення (до вказаної дати – у форматі дати)
<location> … </location>	Додатковий набір елементів для визначення розташування об'єкта.
<distance>	Відстань до міста в кілометрах.
<distance-to-metro>	Відстань до метро в метрах.
<latitude>	Географічна широта.
<longitude>	Географічна довгота.
<image>	Фото - для кожної фотографії потрібно створювати окремий тег з адресою (може бути завантажено до 4 зображень).
<video>	Відео ролик до оголошення - вкажіть URL-адресу посилання на відеооголошення. Із сайту YouTube.com.
<period>	Термін оренди ("день" або "day", "місяць" або "month", "довгострокова" або "long-term").
<new-flat>	Параметр для квартир у новобудовах («так», «true», «1», «+») – для квартир, в яких не фігурує даний елемент за умовчанням буде застосовуватись значення «вторинний ринок».
<is-elite>	Елітність (так - "так", "true", "1", "+"; ні - "ні", "false", "0", "-").
<floor>	Поверх.
<floors-total>	Поверховість.
<building-type>	Тип будинку («панельний», «моноліт», «цегляний», «блоковий», «дерев'яний»).
<building-class>	Клас будівлі – для комерційної нерухомості («A», «B», «C», «D»)
<rooms>	Кількість кімнат.
<area>	Загальна площа об'єкту.
<living-space>	Житлова площа.
<room-space>	Площа кімнати – окремий тег для кожної кімнати.
<kitchen-space>	Площа кухні.
<lot-area>	Площа земельної ділянки.
<value>	Числове значення площі.
<unit>	Одиниця виміру площі: «кв. м», «м2», «sq.m», «ft2», «sq.ft», «cотка», «гектар», «hectare», «акр», «acre».
<ceiling-height>	Висота стель у метрах – роздільник крапка.
<balcony>	Наявність балкона чи лоджії («балкон», «лоджія»).
<bathroom>	Кількість санвузлів.
<phone>	Наявність телефону (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<internet>	Наявність інтернету (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<room-furniture>	Наявність меблів (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<kitchen-furniture>	Наявність кухонних меблів (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<television>	Наявність телевізора (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<washing-machine>	Наявність пральної машини (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<refrigerator>	Наявність холодильника (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<rubbish-chute>	Наявність сміттєпроводу (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<lift>	Наявність ліфта (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<heating-supply>	Опалення (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<аir-conditioning>	Кондиціонер (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<water-supply>	Водопровід (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<sewerage-supply>	Каналізація (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<gas-supply>	Газопровід (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<electricity-supply>	Електрика (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<concierge>	Консьєрж (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<parking>	Наявність паркування (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<parking-place>	Кількість машиномісць.
<alarm>	Наявність охорони (так - «так», «true», «1», «+»; ні -«ні», «false», «0», «-»).
<with-pets>	Для оренди: чи можна з тваринами («так»/«ні», «true»/«false», «1»/«0», «+»/«-»).
<sales-agent>	Набір елементів контактних даних ріелтора - Ви можете заповнити контактні дані для оголошень в особистому кабінеті користувача GVANGA, щоб вони фігурували у всіх завантажуваних оголошеннях без додаткового заповнення даних елементів у фіді. Якщо ж контакти агента відрізняються від зазначених раніше на нашому сайті, додайте цей елемент до вашого XML файлу.
<name>	Ім'я ріелтора
<email>	Електронна адреса
<phone>	Номер телефону агента
<country>	Країна
<locality-name>	Місто
<address>	Вулиця (або вулиця та будинок)

Приклад коректного XML фіда:

<?xml version="1.0" encoding="UTF-8"?>
<realty-feed>
    <generation-date>2015-12-29T12:00:00+04:00</generation-date>
    <offer internal-id="7">
        <type>продажа</type>
        <property-type>жилая</property-type>
        <category>дом</category>
        <url>https://gvanga.com/ad/vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.html</url>
        <creation-date>2015-12-05T00:00:00+04:00</creation-date>
        <expire-date>2015-12-12T00:00:00+04:00</expire-date>
        <last-update-date>2016-12-14T00:00:00+04:00</last-update-date>
        <location>
            <country>Россия</country>
            <locality-name>Вышний Волочек</locality-name>
            <address>Новая улица</address>
            <distance>1</distance>
            <latitude>53.56414</latitude>
            <longitude>35.84554</longitude>
        </location>
        <price>
            <value>2300000</value>
            <currency>RUB</currency>
        </price>
        <image>https://gvanga.com/img/a/original/71778_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <image>https://gvanga.com/img/a/original/71777_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <image>https://gvanga.com/img/a/original/71776_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <image>https://gvanga.com/img/a/original/71775_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <title>Продаю дом 80 кв.м с земельным участком 7 соток.</title>
        <description>Тверская область, г.Вышний Волочек (От МКАД 320км — по асфальтированной дороге.)
            Земельный участок разработан. На участке — гараж, баня, хоз.постройки.
        </description>
        <video>https://www.youtube.com/watch?v=y5SAqL7j8Yo</video>
        <is-elite>1</is-elite>
        <floor>1</floor>
        <floors-total>1</floors-total>
        <building-type>кирпичный</building-type>
        <rooms>2</rooms>
        <area>
            <value>80</value>
            <unit>кв.м</unit>
        </area>
        <kitchen-space>
            <value>9</value>
            <unit>кв.м</unit>
        </kitchen-space>
        <room-space>
            <value>20</value>
            <unit>кв.м</unit>
        </room-space>
        <room-space>
            <value>30</value>
            <unit>кв.м</unit>
        </room-space>
        <lot-area>
            <value>7</value>
            <unit>cот.</unit>
        </lot-area>
        <living-space>
            <value>61</value>
            <unit>кв.м</unit>
        </living-space>
        <ceiling-height>2.5</ceiling-height>
        <balcony>лоджия</balcony>
        <bathroom>2</bathroom>
        <phone>1</phone>
        <internet>1</internet>
        <room-furniture>1</room-furniture>
        <kitchen-furniture>1</kitchen-furniture>
        <television>1</television>
        <washing-machine>1</washing-machine>
        <refrigerator>1</refrigerator>
        <rubbish-chute>1</rubbish-chute>
        <heating-supply>1</heating-supply>
        <аir-conditioning>1</аir-conditioning>
        <water-supply>1</water-supply>
        <sewerage-supply>1</sewerage-supply>
        <gas-supply>1</gas-supply>
        <electricity-supply>1</electricity-supply>
        <parking-place>3</parking-place>
        <alarm>1</alarm>
        <sales-agent>
            <name>Алексей</name>
            <phone>8-903-000-00-53</phone>
            <organization>Агентство недвижимости РУССКИЙ ДОМ</organization>
            <url>http://agency.ru/</url>
            <email>rusdom@ya.ru</email>
            <country>Россия</country>
            <locality-name>Москва</locality-name>
            <address>Новая улица</address>
        </sales-agent>
    </offer>
</realty-feed>

Завантажити: https://gvanga.com/examples/xml/realty.xml

Крок 2 – Завантажте XML фід на GVANGA.COM

Щоб здійснити завантаження XML фіда Вам необхідно бути зареєстрованим користувачем нашого сайту Зверніть увагу, що сервіс XML завантаження оголошень доступний лише для організацій.

Після реєстрації Ви можете заповнити звернення для завантаження XML-фіда через форму зворотного зв’язку.

Ви також можете надіслати посилання на Ваш XML фід з Особистого кабінету – у розділі "XML фіди" - налаштування XML завантаження.

Після додавання Вашого XML фіда протягом 24 годин буде здійснено перевірку правильності створення файлу та передмодерація, потім Ваші оголошення почнуть проходити модерацію та публікуватись на порталі GVANGA.COM.

Зверніть увагу, що всі оголошення, що завантажуються з XML файлу, повинні відповідати Правилам розміщення оголошень на порталі. Не допускається дублювання контактних даних та посилань на інтернет ресурси в тексті оголошення (<description&qt;), а також наявність контактної інформації та фотографічних водяних знаків у зображеннях фіда.

Дані з Вашого XML-фіду будуть автоматично оновлюватися на нашому сайті один раз на день. У Вашому Особистому кабінеті Ви зможете відстежувати та редагувати опубліковані оголошення.

У разі виникнення запитань та пропозицій щодо XML завантаження оголошень на порталі GVANGA.COM, будь ласка, звертайтесь до нас через форму «Зворотній зв'язок» нижче і ми зв'яжемося з Вами найближчим часом.

Ви рієлтор і у Вас немає свого XML фіда, але Ви бажаєте автоматизувати розміщення оголошень на різні інтернет-ресурси? Скористайтеся послугою від GVANGA щодо формування XML файлу експорту для агентств нерухомості.

^{** Підключення автоматичного імпорту оголошень є платною послугою, вартість якої включає тариф за підключення та щомісячний платіж у період дії послуги (кожен фід оплачується окремо).}

^{*** Для агрегаторів та інформаційних CMS систем діють спеціальні платні умови підключення. Вартість щомісячного платежу залежить від загальної кількості активних для публікації оголошень.}