Экспорт объявлений

Условия предоставления

Вы можете экспортировать объявления о недвижимости в нашу базу, предоставив экспортный файл в формате XML. Файл должен содержать все актуальные объявления. Передаваемые в объявлениях данные должны соответствовать реальным объектам, запрещено тиражирование объектов (передача нескольких объявлений об одном и том же объекте). Проверка экспортного файла будет осуществляться ежедневно в 10 утра.

Формат экспортного файла

Экспортный файл должен содержать стандартный XML-заголовок, с первой строки. Используемая кодировка: UTF-8. Обязательный корневой элемент: dom-sakh-com, содержащий дату генерации файла generation-date в формате YYYY-MM-DDTHH:mm:ss+11:00 и контейнеры объявлений offer.
<?xml version="1.0" encoding="UTF-8"?>
<dom-sakh-com xmlns="http://sakh.com/schemas/feed/dom/2013-11">
    <generation-date>
        2010-10-05T16:36:00+11:00
    </generation-date>
    ..
</dom-sakh-com>
В тексте в обязательном порядке должны быть заменены следущие символы на соответствующие HTML-сущности: " (&quot;), & (&amp;), > (&gt;), < (&lt;), ' (&apos;).

Описание элементов

Оранжевым отмечены обязательные элементы.
Элемент
Значения
Описание
Пример
<offer>
Контейнер объявления, обязательный атрибут internal-id - код объявления в базе партнера (код обязательно должен быть уникальным).
<offer internal-id="123">
    ..
</offer>
<type>
Один из вариантов: продажа, покупка, сдача, съем, обмен.
Тип сделки обязателен для всех объектов.
<type>продажа</type>
<category>
Один из вариантов: бизнес, дача, гараж, дом, земля, квартира, комната.
Категория объекта.
<category>квартира</category>
<creation-date>
Формат: YYYY-MM-DDTHH:mm:ss+11:00
Дата создания объявления в указанном формате.
<creation-date>
    2010-10-05T16:36:00+11:00
</creation-date>
<last-update-date>
Формат: YYYY-MM-DDTHH:mm:ss+11:00
Дата последнего обновления объявления в указанном формате. Если не указан, датой последнего обновления считается дата создания.
<last-update-date>
    2010-10-05T16:36:00+11:00
</last-update-date>
<expire-date>
Формат: YYYY-MM-DDTHH:mm:ss+11:00
Дата и время, до которых объявление актуально. Если не указан, считается дата +1 месяц с даты создания.
<expire-date>
    2010-10-05T16:36:00+11:00
</expire-date>
<location>
Контейнер, содержащий описание местоположения объекта.
<location>
    ..
</location>
<locality-name>
Город.
Город или административный центр округа, в котором находится объект.
<location>
    <locality-name>Оха</locality-name>
    ..
</location>
<sub-locality-name>
Район города.
Планировочный район, село, ориентир, неадминистративный район города. Районы доступны только для Южно-Сахалинска.
<location>
    <sub-locality-name>1 мкр.</sub-locality-name>
    ..
</location>
<address>
Улица, номер дома.
Улица и номер дома через запятую. Номер дома необязателен. Улица обязательна для категорий: бизнес, квартира, комната.
<location>
    <address>ул. Заречная, 10</address>
    ..
</location>
<group>
Название, ДНТ, СНТ, ЖК.
Название жилого комплекса или СНТ/ДНТ, гаражного кооператива.
<location>
    <group>Малиновка, ЖК</group>
    ..
</location>
<latitude>
<longitude>
Координаты.
Географические координаты (широта и долгота).
<location>
    <latitude>46.952766</latitude>
    <longitude>142.739532</longitude>
    ..
</location>
<sales-agent>
Контейнер, содержащий описание продавца/агента.
<sales-agent>
    ..
</sales-agent>
<nick>
Ник.
Ник продавца/агента на портале Sakh.com. От этого значения зависит какой пользователь получит доступ к объявлениям в экспорте.
<sales-agent>
    <nick>Agency</nick>
    ..
</sales-agent>
<phone>
Номер телефона.
Контактный номер продавца/агента. Может быть указано несколько, каждый в отдельном элементе.
<sales-agent>
    <phone>+89520000000</phone>
    <phone>(4242)700000</phone>
    ..
</sales-agent>
<email>
Электронный адрес.
Контактный адрес продавца/агента.
<sales-agent>
    <email>mail@agency.ru</email>
    ..
</sales-agent>
<jabber>
Один из вариантов: true, false.
Отметка о необходимости отправки уведомлений на jabber продавца/клиента Agency@sakhalin.name.
<sales-agent>
    <jabber>true</jabber>
    ..
</sales-agent>
<price>
Контейнер, содержащий описание цены объекта.
<price>
    ..
</price>
<value>
Сумма в рублях.
Значение цены, без пробелов. Обязателен для всех типов сделок, кроме: съем, обмен.
<price>
    <value>400000</value>
    ..
</price>
<period>
Один из вариантов: ежемесячно, посуточно.
Промежуток оплаты. Обязателен для типа сделок: сдача.
<price>
    <period>ежемесячно</period>
    ..
</price>
<description>
До трех тысяч символов.
Дополнительное описание объекта.
<description>
    Евро-ремонт, соединена с балконом, ПВХ,
    натяжные потолки, встроенный шкаф-купе..
</description>
<area>
Указывается в квадратных метрах.
Площадь общая. Обязательно для всех категорий, кроме: земля, комната.
<area>20</area>
<living-space>
Указывается в квадратных метрах.
Площадь жилая для категорий: дом, квартира, дача.
<living-space>20</living-space>
<kitchen-space>
Указывается в квадратных метрах.
Площадь кухни для категорий: дом, квартира, дача.
<kitchen-space>4</kitchen-space>
<land-space>
Указывается в квадратных метрах.
Площадь земельного участка. Обязательно для категорий: дача, дом, земля.
<land-space>500</land-space>
<image>
Ссылки на изображения в формате JPG, PNG.
Фотографии объекта, до 20 штук.
<image>http://agency.com/images/d19.jpg</image>
<image>http://agency.com/images/d21.jpg</image>
<image>http://agency.com/images/d23.jpg</image>
<rooms>
Целое число.
Количество комнат. Обязательно для категорий: дом, квартира.
<rooms>3</rooms>
<floor>
Целое число.
Номер этажа. Для цоколя -1. Обязательно для категорий: бизнес, квартира, комната.
<floor>3</floor>
<floors-total>
Целое число.
Всего этажей в здании. Обязательно для категорий: бизнес, дом, квартира, комната.
<floors-total>8</floors-total>
<built-year>
Формат: YYYY.
Год постройки в указанном формате, для новостроек - год сдачи.
<built-year>1972</built-year>
<building-series>
Один из вариантов: индивидуальная, брежневка, хрущевка, сталинка, новая пл., гостинка, новостройка, 138 серия, 97 серия, 97-С серия, 102 серия, 306 серия.
Серия дома для категорий: квартира, комната.
<building-series>138 серия</building-series>
<building-type>
Один из вариантов: панель, каркас, брус, монолит, шлакоблок, кирпич, газо,пеноблок.
Тип дома, материал стен для категорий: бизнес, квартира, дом.
<building-type>газо,пеноблок</building-type>
<business-type>
Один из вариантов: офис, магазин, производство, склад, питание, апартаменты, сфера услуг, другое.
Назначение объекта. Обязательно для категории: бизнес.
<business-type>производство</business-type>
<land-type>
Один из вариантов: коммерческая застройка, ИЖС, сельское хозяйство, дачное, подсобное хозяйство.
Тип земельного участка. Обязательно для категории: земля.
<land-type>ИЖС</land-type>
<property-type>
Один из вариантов: в аренде, в собственности.
Тип недвижимости. Обязательно для категорий: дом, дача, земля.
<property-type>в аренде</property-type>
<balcony>
Один из вариантов: один, лоджия, больше одного.
Наличие балкона для категорий: квартира, дом, комната.
<balcony>один</balcony>
<phone>
Один из вариантов: true, false.
Наличие телефона для категорий: бизнес, квартира, дом, комната.
<phone>true</phone>
<internet>
Один из вариантов: true, false.
Наличие интернета для категорий: бизнес, квартира, дом, комната.
<internet>true</internet>
<television>
Один из вариантов: true, false.
Наличие кабельного телевидения для категорий: бизнес, квартира, дом, комната.
<television>true</television>
<news>
Варианты: север, юг, запад, восток.
Стороны света, можно указать несколько через запятую, для категорий: квартира, комната.
<news>север, восток</news>
<alarm>
Один из вариантов: true, false.
Наличие охраны/сигнализации для категорий: бизнес, дача, квартира, дом.
<alarm>true</alarm>
<heating>
Один из вариантов: автономное, центральное.
Отопление, для категорий: бизнес, дача, дом.
<heating>центральное</heating>
<water>
Один из вариантов: центральное, скважина.
Водоснабжение, для категорий: бизнес, дача, земля, дом.
<water>центральное</water>
<sewerage>
Один из вариантов: центральное, септик.
Водоотведение, для категорий: бизнес, дача, земля, дом.
<sewerage>центральное</sewerage>
<electricity>
Один из вариантов: 220, 380.
Вольтаж, для категорий: бизнес, дача, земля, дом.
<electricity>220</electricity>
<gas>
Один из вариантов: true, false.
Наличие газоснабжения, для категорий: бизнес, квартира, земля, дом.
<gas>false</gas>
<mortgage>
Один из вариантов: true, false.
Возможность ипотеки, только для продажи.
<mortgage>true</mortgage>