# Работа с фидами для классифайдов

<mark style="background-color:yellow;">**Фиды**</mark> — это XML-файлы, которые содержат данные по объектам недвижимости, которые можно передавать на сайты — агрегаторы на площадки — такие как Авито, Яндекс, ЦИАН, ДомКлик для того, чтобы автоматически публиковать и обновлять там объявления о продаже.

Как правило, большинство агрегаторов поддерживают стандартные типы фидов (Яндекс или Авито или Циан), но отдавать всем подряд одну и ту же ссылку не получается, в силу разных задач. На один ресурс нужно выгружать только новостройки, на другой — только вторичку, на третий — только новостройки, но без броней, и т.д.

Для решения этих задач мы создали конструктор фидов, где вы сами можете создавать фиды с заложенной внутри конфигурацией. Ссылка на фид остается неизменной, и по однажды сгенерированной ссылке всегда можно получать данные. При этом набор этих данных можно продолжать конфигурировать в дальнейшем (например, добавить/убрать парковки из этого фида).

<mark style="background-color:purple;">**Конструктор фидов**</mark> расположен в разделе[^1]:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FuPhKWFpaCWFnc3UVAMTr%2Fkonstr_feed_1.png?alt=media&#x26;token=96217e59-81e8-4dd7-a5fd-2680134791db" alt=""><figcaption></figcaption></figure>

Для создания нового фида нажмите кнопку <kbd>**`Добавить`**</kbd>\
\
При создании фида его формат изначально всегда выбирается сразу, и поменять его потом уже будет нельзя:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2Ffn4iNTJtjj5vaogM9hN9%2Fs4PAnLTpBb.png?alt=media&#x26;token=899384ae-2ae4-4b84-990b-31735e92f12d" alt=""><figcaption></figcaption></figure>

Желательно использовать понятное название для всех участников системы. Например, если привязка к одному ЖК или группе домов, то лучше использовать **Название ЖК/группы домов+Название площадки (Формат)**, если нет привязки к конкретному ЖК, то **Название площадки (Фомат)**.

В поле **Формат** выберите площадку, для которой предназначен фид.

После ввода названия фида и выбора его формата открывается карточка редактирования:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FsfxeYx5HXb41e1zcosJo%2Fkonstr_feed_3.png?alt=media&#x26;token=6b4da64c-4ea8-4008-8da3-6b87d77014da" alt=""><figcaption></figcaption></figure>

### Общие опции

* **Название фида**\
  Вводится при создании фида, можно изменить.
* **Активность объектов**\
  На выбор: Только продажа, Только аренда, Продажа и аренда.
* **Тип объектов**\
  На выбор: Первичка и вторичка, Только первичка, Только вторичка.
* **Шаблон описания**\
  Без шаблона — описание берется из описания объекта недвижимости. \
  При включенной опции **Перезаписывать описание в объектах** описание копируется в описание объектов:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FCD4DBFGZZJ7Y3oK6k0la%2Fkonstr_feed_4.png?alt=media&#x26;token=1efff1f2-c1b1-4685-bc4a-fc228365ff47" alt=""><figcaption></figcaption></figure>

Также можно создавать шаблоны описания через <mark style="background-color:purple;">**Компания**</mark> → <mark style="background-color:purple;">**Шаблоны**</mark>  документов. \
Тип документа: **Описание объекта**:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2Fndfx4xWYOpdp75KmYpvo%2Fkonstr_feed_5.png?alt=media&#x26;token=9d3ba17d-9721-4b08-959a-56cb1267fd62" alt=""><figcaption></figcaption></figure>

* **Тип площади** \
  Не указан, Общая, Приведенная, Площадь без учета ЛП, Площадь БТИ, Полная \
  Обычно используется **Общая площадь**, остальные случаи частные.
* **Приоритет телефонов для вторички**\
  Можно выбрать чей телефон будет использован в фиде в первую очередь. \
  По умолчанию телефон менеджера.
* **Изображение планировки**\
  По умолчанию в фид уходит **Главное изображение.** \
  Если площадка допускает только одно изображение, тогда в фид уходит **Главное изображение**. Если площадка допускает разные изображения, то уходят все, при этом **Главное изображение** уходит первом, но с помощью этого фильтра можно выбирать какое изображение будет приоритетным.

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FIGseA5S3BppJrl980d3W%2Fkonstr_feed_6.png?alt=media&#x26;token=a9e4e0d8-9080-45c3-8dea-3c7288448000" alt=""><figcaption></figcaption></figure>

* **Категории**\
  Выбрать какие категории недвижимости попадают в фиды: \ <mark style="background-color:yellow;">**Квартира**</mark>, <mark style="background-color:yellow;">**Машино-место**</mark>, <mark style="background-color:yellow;">**Малоэтажка**</mark>, <mark style="background-color:yellow;">**Земельный участок**</mark>, <mark style="background-color:yellow;">**Кладовая**</mark> или <mark style="background-color:yellow;">**Коммерческая недвижимость**</mark>

{% hint style="warning" %} <mark style="color:orange;">**Важно!**</mark>\
При выборе определённой категории необходимо понимание, принимает ли ее площадка.
{% endhint %}

* **Дома** \
  Необходимо выбрать дом или ЖК
* **Название компании** \
  Официальное название компании, которое будет передаваться в фиде. \
  По умолчанию не заполнено и передается из раздела <mark style="background-color:purple;">**Компания**</mark> → <mark style="background-color:purple;">**Описание**</mark>
* **Телефон отдела продаж**\
  Контактный телефон для связи с менеджером.

  По умолчанию указан номер отдела продаж.
* **Имя менеджера** \
  Имя менеджера, который продает данный объект. \
  По умолчанию не задано. Чаще используется при продаже вторичного жилья.
* **Шаблон ссылки на страницу объекта** \
  Если у застройщика существует посадочная страница для продажи дома и у каждого объекта есть своя страница-презентация, то можно указать ссылку на нее. По умолчанию передается ссылка на презентацию объекта из MacroCRM.&#x20;

{% hint style="warning" %} <mark style="color:orange;">**Важно!**</mark> \
Данный шаблон доступен только для фидов Яндекс и Яндекс YML.
{% endhint %}

### Особые опции

* **Компактная выгрузка** \
  Если у нас внутри фида существуют объекты, которые одинаковые между собой, например, однокомнатные квартиры и различаются параметрами, например, номером объекта, номером этажа. Опция позволит объединить похожие объекты и создать уникальное объявление для всех, тем самым уменьшив общее число повторяющихся объявлений.\
  Опция оставляет в каждом Доме по одной квартире уникальной планировки (по привязанной планировке, либо по набору значений "кол-во комнат, площадь (округленная до 10)" и добавляет в описание квартиры таблицу, содержащую информацию об остальных подобных квартирах в доме. Эта мера позволяет серьезно сократить стоимость размещения на платных площадках, одновременно сохраняя разнообразие выгрузки.
* **Точечная выгрузка**

  Выберите только те объекты, которые должны попасть в фид.\
  При этом обязательно учитываются выбранные ранее фильтры, то есть нельзя, например, точечно указать объект, который не относится к выбранному дому.\
  \
  Как настраивается точечная выгрузка внутри фида:\
  1\. Включаем переключатель в карточке редактирования фида\
  2\. Затем переходим в раздел **Точечная выгрузка**.\
  Видим наш фид и отмечаем, что он использует точечную выгрузку.\
  Ниже станет доступен список из объектов дома указанных в фиде.

Тогда можно точечно указать активность объектов в нужном фиде:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FKvge1mdsMGQDAjFdPCCg%2Fkonstr_feed_7.png?alt=media&#x26;token=2ddf6724-fb06-4bf7-9e25-73eb5306fb0f" alt=""><figcaption></figcaption></figure>

Также доступен выбор объекта для **Точечной выгрузки** из режима **Редактирования** самого объекта.

{% hint style="warning" %} <mark style="color:orange;">**Важно!**</mark> \
Обязательное включение опции **Публикация разрешена**. \
Опция разрешает передавать данные по квартире по фиду.\
И выбрать в какой фид можно выгружать
{% endhint %}

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FVIVu1Zzzg958bBSmaDHm%2Fkonstr_feed_8.png?alt=media&#x26;token=cd9bb0b1-05c3-4bad-ab9c-213e3f9f39e2" alt=""><figcaption></figcaption></figure>

* **Выгружать брони** \
  Типы броней, которые можно выбрать для выгрузки:\
  \- Бесплатная бронь (обычная).\
  \- Платная бронь.\
  \- Маркетинговый резерв.

В фид выгружаются только те типы броней, которые отмечены в чек-боксе:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FoI1ZoJNmkRyzMMVkFqrv%2F24_07_7.png?alt=media&#x26;token=979073b6-64e9-41ff-816e-cdc232006a0f" alt=""><figcaption></figcaption></figure>

* **Выгружать сделки в работе** \
  По умолчанию в фиды попадают объекты в статусе <mark style="background-color:blue;">**Подбор**</mark>, но при включенной опции будут выгружаться объекты, по которым статус <mark style="background-color:blue;">**Сделка в работе**</mark>*.* \
  Также необходимо включить в <mark style="background-color:purple;">**Настройках компании**</mark> опцию <mark style="background-color:purple;">**Публиковать объекты, находящиеся в статусе "Сделка в работе"**</mark>, при включении которой во всех фидах будут автоматически выгружаться объекты со статусом <mark style="background-color:blue;">**Сделка в работе**</mark>*.*
* **Выгружать клоны** \
  **Клоны** — это объекты, которые перепродаются. \
  Такой объект не включен в состав дома. В шахматке обозначена пунктиром.
* **Скрывать цену** \
  Если нужно скрыть цену объекта. Редко применимый сценарий.
* **Скрывать логотип** \
  При активации в фид не передается логотип компании.
* **Не выгружать эксклюзивы**\
  Блокировка выгрузки эксклюзивных объектов.

  Напомним, эксклюзивные объекты — это те, у которых есть символ бриллианта и включена опция <mark style="background-color:yellow;">**Эксклюзив**</mark>:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2Fcf0Wbcawua97mDiq9xAh%2Fkonstr_feed_9.png?alt=media&#x26;token=76baac8f-4e00-445d-a574-e978f2840a71" alt=""><figcaption></figcaption></figure>

* **Выгружать мин. стоимость по акции**\
  Передает в фид минимальную расчетную стоимость по акции.
* **Только контакты менеджера**\
  Позволяет передать только контакты менеджера.
* **Объекты без привязки к дому**\
  Выгружаются объекты, которые не привязаны к дому, например, перепродажа.
* **Выгружать только свои объекты**\
  Используется редко.
* **Запретить сообщения через сайт**\
  Запрещает переписку на сайте, где будет опубликовано объявление.

После выбора нужных параметров сохраните фид и скопируйте ссылку на него. \
Ссылку нужно отдать на требуемую площадку, после чего эта площадка по своему расписанию начнет обращаться к MacroCRM за обновлениями.

Количество фидов, которые можно создавать не ограничено.\
Ссылка на фид всегда одна и не меняется.\
Фид можно удалить и пересоздать, ссылка станет новой.\
Фиды обновляются и передают новые данные на площадки публикации каждый день.

Также фиды можно провалидировать через валидаторы площадок, например:

* Яндекс  <https://webmaster.yandex.ru/tools/xml-validator/>
* Авито <https://autoload.avito.ru/format/xmlcheck/>
* ДомКлик <https://domclick.ru/validation/validator>
* ЦИАН <https://www.cian.ru/nd/validator/>

{% hint style="warning" %} <mark style="color:orange;">**Важно!**</mark> \
Для публикации объектов на площадках, необходима привязка в CRM объектов к внешним справочникам.
{% endhint %}

Указывается в редактировании дома в блоке **Привязка к внешним справочникам:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FKivb0WAScutmLwLU64lT%2Ffeed_.png?alt=media&#x26;token=ef324e26-340c-4627-8b90-5e2e1aa5efb5" alt=""><figcaption></figcaption></figure>

### \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

### Обновления

### Добавлены новые значения отделки в фид Яндекса XML

В каталоге **Стоимость ремонта** добавлено новое значение отделки **Whitebox** в колонку **Тип в фидах:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FSCfkM76cQPbYRXmkuZNB%2Ffeed_1.png?alt=media&#x26;token=589bc1a3-4946-46aa-9bfe-e50b9d52cbc1" alt=""><figcaption></figcaption></figure>

Ранее по спецификации были возможные значения:\
\- Чистовая\
\- Под ключ\
\- Черновая

Теперь, согласно спецификации Яндекса XML, добавились новые значения\
\- Без отделки (в списке **Тип в фидах** пункт **Не выбрано**)\
\- Предчистовая\
\- Whitebox

И теперь эти значения передаются в атрибуте **renovation** в фиде Яндекса XML:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FBgxbT6FHWuOTpazB5BX8%2Ffeed_2.png?alt=media&#x26;token=f70d0eef-d90f-45c9-b5d7-35a4aa966cae" alt=""><figcaption></figcaption></figure>

### Добавлен в фид Авито тег DduLink для передачи архива с документами по объектам переуступки

Согласно спецификации Авито принимает **ДДУ** в виде архива в теге **DduLink.**\
С 1 марта 2025 параметр должен быть включен в список обязательных для публикации на площадке.

Теперь в фиде Авито добавлен тег **DduLink**, в котором передается ссылка на zip-архив из папки объекта для объектов без привязки к дому.

Если в объекте нет такой папки или в папке не найден архив с расширением .zip, то тег **DduLink** не добавляется в фид.

При этом, если в папку в объекте будет загружено несколько архивов, то будет выбран первый архив из списка:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FmLTQhdrr6PGMQ8Z7wAhC%2Fddu_1.png?alt=media&#x26;token=56402525-3920-4de7-8b97-bf1bdd5c080e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2Fi4zNtHorJbn1U9L38hx8%2Fddu_2.png?alt=media&#x26;token=2c4066da-19a7-4429-a975-d58db0a135bb" alt=""><figcaption></figcaption></figure>

### Дополнительные атрибуты в фидах

**Яндекс XML:**

* Теперь передаем данные из поля **Станция метро** в массиве **metro** в теге **name.**
* Если заполнена **Площадь балкона**, то передаем значение **Балкон** в теге **balcony.**\
  Если заполнена **Площадь балкона** и указано количество в поле **Количество балконов**, то передаем в теге **balcony** значение “Балкон” и количество (1,2,3 .. балкона)

**ДомКлик(вторичка):**

* Если заполнена **Площадь балкона**, то передаем значение **Балкон** в теге **balcony.**\
  Если заполнена **Площадь балкона** и указано количество в поле **Количество балконов**, то передаем в теге **balcony** значение “Балкон” и количество (1,2,3 .. балкона).\
  Если в поле **Площадь балконов** ничего не указано — то в фид ДомКлик ничего не передается.

**Домклик:**

* При передаче ссылки на rutube в теге теперь тоже передается rutube.

###

### В фид Авито теперь передаем значение "Монолитно-кирпичный" в теге HouseType

Добавили в фид Авито значение <mark style="background-color:yellow;">**Монолитно-кирпичный**</mark> для тега HouseType, если это значение указано в поле **Материал дома.**

### Добавили  в фид Авито тег EgrnExtractionLink для передачи архива с выпиской из ЕГРН

Для объектов без привязки к дому добавили в **фид Авито** тег `“EgrnExtractionLink”`

В теге отправляется ссылка на zip-архив из папки объекта <mark style="background-color:yellow;">**Выписка из ЕГРН**</mark>.
\
При этом, если в папку в объекте будет загружено несколько архивов, то берётся первый архив из списка.&#x20;

{% hint style="info" %}
Если в объекте нет такой папки или в папке не найден архив с расширением .zip, то тег не добавляется в фид.
{% endhint %}

[^1]: **Компания -> Экспорт -> Конструктор фидов**