Общие требования к передаче данных

# Общие требования к передаче данных

- Формат передачи данныхКодировка
- Заголовок
- Корневой элемент
- Формат даты
- Требования к фиду и объявлениям в немОсновные требования
- Актуальность
- Сроки публикации
- Цена объекта
- Требования к объявлениям по типам недвижимости

Чтобы объявления попали в базу сервиса Яндекс Недвижимость, подготовьте фид с данными по приведенным ниже требованиям.

## Формат передачи данных

Фид с объявлениями для Яндекс Недвижимости составляется на языке YRL (Yandex Realty Language), разработанном в Яндексе. YRL основан на стандарте XML (Extensible Markup Language).

Ограничения:

Нельзя использовать первые 32 ASCII‑символа в текстовых полях.

Исключения: табуляция, перевод строки, возврат каретки.

Необходимо кодировать определенные символы:

Таблица замены символов в YRL‑файле

**Символ, который нужно заменить**
**Код для YRL‑файла**

"
&quot;

&
&amp;

&gt;

<
&lt;

'
&apos;

<br>
&lt;br&gt;

### Кодировка

Кодировка фида — UTF‑8.

### Заголовок

YRL‑документ должен начинаться со стандартного XML‑заголовка — нулевого символа первой строки:

<?xml version="1.0" encoding="utf-8"?>

### Корневой элемент

Корневой элемент YRL‑фида — <realty-feed>. Он должен содержать:

- элемент <generation-date> с датой создания фида;

- элементы <offer>, в каждом из которых — информация из одного объявления.

Чтобы указать пространство имен, используйте атрибут xmlns:

<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">
<generation-date>2010-10-05T16:36:00+04:00</generation-date>
<offer>
...
</offer>
...
</realty-feed>

### Формат даты

Все даты и время указывайте по стандарту ISO 8601 — в формате YYYY-MM-DDTHH:mm:ss+00:00, где:

- YYYY — год;

- MM — месяц;

- DD — день;

- HH — час;

- mm — минута;

- ss — секунда;

- +00:00 — указание часового пояса (для Москвы — +03:00).

## Требования к фиду и объявлениям в нем

### Основные требования

Размещение и доступ:

- фид размещен на вашем домене;

- предоставлен в виде URL‑ссылки;

- доступ к фиду постоянно открыт по протоколу HTTP;

- фид доступен круглосуточно.

Формат и структура:

- структура фида соответствует формату YRL;

- фид содержит только валидные объявления (все поля заполнены согласно формату YRL);

- в фиде передются только те параметры, которые указаны в объявлении;

- для нескольких значений одного параметра (например, фотографий) используется несколько одинаковых тегов.

Содержание:

- каждое объявление посвящено одному объекту недвижимости;

- каждое объявление уникально;

- в объявлениях от агентств недвижимости явно указано агентство.

Оформление текстов:

- для оформления текстов объявлений и характеристик объектов разрешено истользовать только тег <br>, при этом символы < и > следует кодировать соответственно таблице замены символов в YRL‑файле;

- другие HTML-теги не поддерживаются.

Обновление:

- чтобы изменить объявление, обновите текущее — не удаляйте его и не создавайте дубликат;

- обновленное объявление должно иметь тот же internal‑id.

### Актуальность

Фид должен содержать актуальные объявления — с достоверной информацией о реальном объекте, доступном для покупки или аренды.

Минимальные доли актуальных объявлений:

- 80 % — для объявлений о продаже недвижимости;

- 70 % — для объявлений об аренде недвижимости.

Объявление считается неактуальным, если:

- объект уже продан или сдан в аренду;

- по указанному телефонному номеру невозможно дозвониться;

- цена в объявлении существенно отличается от запрашиваемой;

- не совпадает адрес или другие параметры.

### Сроки публикации

Для разных типов объявлений действуют свои ограничения по срокам создания и обновления:

**Тип объявления**

**Min с момента создания**

**Min с момента обновления**

О продаже квартиры на вторичном рынке

90 дней

45 дней

О продаже комнаты

120 дней

45 дней

О длительной аренде квартиры

7 дней

14 дней

О длительной аренде комнаты

25 дней

24 дня

О длительной аренде дома

30 дней

30 дней

О продаже гаража или машиноместа

90 дней

45 дней

О длительной аренде гаража

30 дней

30 дней

О посуточной аренде гаражей, а также о продаже и посуточной аренде домов, участков и квартир в новостройках

Не влияет на валидность объявления

### Цена объекта

- Цена объекта должна быть выше минимальной цены в соответствующем сегменте в регионе.

- Яндекс Недвижимость вычисляет диапазон цен на объекты разной площади:

отдельно для продажи;

- отдельно для аренды.

- Учитываются различные факторы: привлекательность района, транспортная доступность, социальная инфраструктура.

## Требования к объявлениям по типам недвижимости

Подробные описания обязательных и необязательных элементов фида для разных типов недвижимости, особенности значений и их использования описаны отдельно.

См. в разделах:

- Технические требования к XML-фиду для жилой недвижимости

- Технические требования к XML-фиду для коммерческой недвижимости

- Технические требования к XML-фиду для новостроек

### Была ли статья полезна?
ДаНет