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

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

Вы можете экспортировать объявления о недвижимости в нашу базу, предоставив экспортный файл в формате 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>
<cadastral-number>
Формат: NN:NN:NN:NN
Кадастровый номер объекта (участка, сооружения, квартиры).
<cadastral-number>
    22:33:123456:44
</cadastral-number>
<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>
<plot-number>
Номер земельного участка.
Только для категории: земля.
<location>
    <plot-number>102</plot-number>
    ..
</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>
<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>
<ceiling-height>
Указывается в метрах.
Высота потолков для категорий: бизнес, квартира, дом.
<ceiling-height>4,25</ceiling-height>
<business-type>
Один из вариантов:
  • офис
  • магазин
  • производство
  • склад
  • питание
  • апартаменты
  • сфера услуг
  • другое
Назначение объекта. Обязательно для категории: бизнес.
<business-type>производство</business-type>
<land-type>
Один из вариантов:
  • коммерческая застройка
  • ИЖС
  • сельское хозяйство
  • дачное, подсобное хозяйство
Вид использования. Обязательно для категории: земля.
<land-type>ИЖС</land-type>
<property-type>
Один из вариантов:
  • в аренде
  • в собственности
Тип собственности (Земля). Обязательно для категорий: дом, дача, земля.
<property-type>в аренде</property-type>
<repair>
Один из вариантов:
  • требуется
  • косметический
  • евро
  • дизайнерский
Необходимость или вид ремонта для категорий: квартира, комната, дом.
<repair>требуется</repair>
<video>
URL
Ссылка на видеоролик с обзором объекта недвижимости на ресурсах: Sakhalin.tv или YouTube.com.
<video>https://youtu.be/ExampleVideoHash</video>
<balcony>
Один из вариантов:
  • один
  • лоджия
  • больше одного
Наличие балкона для категорий: квартира, дом, комната.
<balcony>один</balcony>
<phone>
Один из вариантов:
  • true
  • false
Наличие телефона для категорий: бизнес, квартира, дом, комната.
<phone>true</phone>
<internet>
Один из вариантов:
  • true
  • false
Наличие интернета для категорий: бизнес, квартира, дом, комната.
<internet>true</internet>
<television>
Один из вариантов:
  • true
  • false
Наличие кабельного телевидения для категорий: бизнес, квартира, дом, комната.
<television>true</television>
<news>
Варианты: север, юг, запад, восток.
Стороны света, можно указать несколько через запятую, для категорий: квартира, комната.
<news>север, восток</news>
<lift>
Варианты: пассажирский, грузовой.
Наличие и вид лифта, можно указать несколько через запятую, для категорий: квартира, комната.
<lift>пассажирский</lift>
<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>