XML-фид · ДОМ.РФ

Фид для ДОМ.РФ из шахматки ЖК

«Модуль продаж» ДОМ.РФ показывает квартиры застройщика на наш.дом.рф. DomXML собирает для него XML-фид из вашей шахматки: цены, статусы и планировки. Ссылку на фид вставляете в личном кабинете ДОМ.РФ один раз — дальше карточки на сайте обновляются сами.

Формат ДОМ.РФ в DomXML — бета: после первой загрузки проверьте карточки в кабинете «Модуля продаж».

Нужен договор с ДОМ.РФ на «Модуль продаж» — фид DomXML подключается к нему

Как подключить

4 шага до карточек на наш.дом.рф

1

Впишите ID домов

ID дома — число в адресе его страницы в каталоге новостроек наш.дом.рф. Впишите его корпусу: Настройки → Корпуса.

2

Сверьте квартиры с декларацией

Подъезд, этаж и номер — как в проектной декларации (раздел 15.2, у апартаментов — 15.3). Подъезд — поле «Секция (подъезд)», проставьте его массово: отметьте квартиры → «Массовое редактирование» → «Секция (подъезд)».

3

Создайте фид ДОМ.РФ

Вкладка «ФИД XML» → «Создать фид» → ДОМ.РФ. Проверка сразу покажет, каким квартирам чего не хватает, и даст исправить это в мастере.

4

Вставьте ссылку в кабинет ДОМ.РФ

Укажите ссылку на фид в личном кабинете «Модуля продаж» и включите загрузку. ДОМ.РФ забирает фид каждые 4 часа — карточка фида в панели покажет, когда он забрал его в последний раз.

Статусы

Продали квартиру — она уходит с сайта сама

Другие площадки просто не получают проданные квартиры. ДОМ.РФ устроен иначе: квартира, пропавшая из фида, осталась бы на наш.дом.рф «свободной». Поэтому в фид ДОМ.РФ уходят квартиры всех статусов, а снимает карточку с сайта статус «Продано».

«Продано» у ДОМ.РФ необратимо: вернуть квартиру в продажу уже не получится. Поэтому первые сутки после того, как проданная квартира впервые ушла в фид, она уходит «Готово к публикации» — снята с сайта, но это обратимо: ошибку в статусе или в ID дома успеете исправить, а проверка фида заранее покажет такие квартиры. Цена у ДОМ.РФ обязательна при любом статусе: если её стёрли у проданной, в фид уходит её последняя цена, а квартира в продаже или в брони без цены снимается с публикации — со старой ценой она принимала бы заявки.

Статус в шахматке → на наш.дом.рф

  • В продаже free · свободно, принимает заявки
  • Бронь booked · на сайте, без заявок
  • Продана sold · снята с сайта; первые сутки — ready-to-publish
  • В продаже или в брони без цены ready-to-publish · снята с сайта до появления цены
  • Снята с продажи ready-to-publish · не публикуется, вернуть можно

Свои статусы проекта переводятся по их признаку: «в продаже», «бронь» или «не в продаже»

Перед подключением

Что нужно ДОМ.РФ

ДОМ.РФ не создаёт квартиры из фида, а находит уже известные ему помещения из проектной декларации и обновляет их карточки. Поэтому ему важнее всего, чтобы дом и квартира совпали с декларацией.

  • Проверка называет каждую квартиру — без подъезда, без планировки, в корпусе без ID дома — и ведёт туда, где это исправить
  • Строгий порядок тегов — фид собирается ровно в той последовательности, которой требует ДОМ.РФ; пустые необязательные поля не выводятся
  • Изображения только по HTTPS — планировки, загруженные в DomXML, отдаются по HTTPS; чужие ссылки http:// в фид не попадают
  • Один фид на ЖК — ДОМ.РФ узнаёт дома по их ID, второй фид того же ЖК спорил бы с первым

Фид ДОМ.РФ — только для жилых комплексов: квартиры и апартаменты сверяются с декларацией дома. Коммерцию и машиноместа выгружайте на Яндекс, Циан и Авито.

Чек-лист ДОМ.РФ

  • ID дома на наш.дом.рф у жилого корпуса — без него фид не соберётся
  • Подъезд, этаж и номер — как в разделе 15.2 проектной декларации (апартаменты — 15.3): по ним ДОМ.РФ находит квартиру. Подъезд — поле «Секция (подъезд)». Квартира с ID ДОМ.РФ другой квартиры не уйдёт, а повтор номера в доме или чужой ID дома у корпуса остановят весь фид: статус лёг бы на чужую карточку
  • Цена и общая площадь — цена за м² считается из них; цена нужна при любом статусе
  • Планировка — у ДОМ.РФ это обязательное титульное изображение квартиры
  • ID ДОМ.РФ квартиры (ID ОДС, вида 55173/1/11) — с ним сопоставление надёжнее. Заполнить можно по одной квартире: остальные DomXML посчитает сам
  • Телефон отдела продаж — уходит телефоном дома, можно подменный номер

без этого квартира не попадёт в фиджелательно

Что получает ДОМ.РФ

Фид по требованиям ДОМ.РФ

Дом — с его ID на наш.дом.рф, названием, адресом и телефоном. Квартира — с подъездом, этажом и номером из декларации, статусом, ценой и ценой за м², площадями комнат и кухни, санузлами, балконами и лоджиями, отделкой, видом из окон и изображениями: первой идёт планировка, за ней фото квартиры.

Апартаменты уходят как нежилое помещение, студии — с отметкой студии. Отделка переводится в значения ДОМ.РФ: без отделки, черновая, предчистовая (white box), чистовая, под ключ.

Цены, статусы и планировки меняете в шахматке, вручную, Excel или по API — DomXML пересобирает фид сам, а ДОМ.РФ забирает его по расписанию. Сведения о ЖК ДОМ.РФ пока не обрабатывает, но они в фиде есть: так требует формат.

<complexes> <complex> <name>ЖК «Заречье»</name> <objects> <object> <external_id>55173</external_id> <name>ЖК «Заречье», Корпус 1</name> <phone>+78432000000</phone> <flats> <flat> <id_ods>55173/1/11</id_ods> <entrance>1</entrance> <floor>3</floor> <status>free</status> <living>true</living> <number>11</number> <is_studio>false</is_studio> <price>7708750</price> <price_per_square_meter>125000</price_per_square_meter> <state>white-box</state> <images> <image type="layout">https://…/plan.jpg</image> </images> </flat> </flats> </object> </objects> </complex> </complexes>

FAQ

Частые вопросы

Что такое «Модуль продаж» ДОМ.РФ?

Сервис ДОМ.РФ для застройщиков: квартиры из проектной декларации публикуются на наш.дом.рф с ценами и статусами, покупатели оставляют заявки. Подключение — по договору с ДОМ.РФ, а данные о квартирах ДОМ.РФ получает XML-фидом, который собирает DomXML.

Где взять ID дома на наш.дом.рф?

Откройте дом в каталоге новостроек наш.дом.рф: ID — число в адресе страницы дома. Впишите его корпусу в DomXML: Настройки → Корпуса → «Изменить» → «ID дома на наш.дом.рф». Если вы записываете ID квартир вида 55173/1/11 через окно «ID ДОМ.РФ», ID дома DomXML подставит корпусу сам.

Обязательно ли указывать подъезд и цену?

Да. ДОМ.РФ находит квартиру в проектной декларации по подъезду, этажу и номеру, а цена у него обязательна при любом статусе. Квартира без подъезда, площади или планировки в фид не попадёт — проверка фида покажет такие квартиры списком. Если цену стёрли, у проданной уйдёт её последняя цена, а квартира в продаже или в брони без цены снимется с публикации.

Что будет с проданными квартирами?

Они уходят в фид со статусом «Продано», и ДОМ.РФ снимает их с сайта. Статус необратим, поэтому первые сутки после того, как проданная квартира впервые ушла в фид, она уходит «Готово к публикации» — тоже снята с сайта, но обратимо: если продажу отметили по ошибке, верните статус, и карточка вернётся.

Как часто обновляются данные на наш.дом.рф?

DomXML пересобирает фид сам в течение трёх часов после изменений в шахматке, сразу — кнопкой «Сгенерировать». ДОМ.РФ забирает фид каждые 4 часа, а время его последней загрузки видно в карточке фида.

Что будет, если выключить фид или удалить квартиру?

Карточки на наш.дом.рф останутся с последними статусами: ДОМ.РФ снимает квартиру с сайта только по статусу в фиде. Чтобы убрать квартиру, поставьте ей статус «Продана» или снимите с продажи и дождитесь загрузки фида; чтобы остановить всё — выключите загрузку в кабинете ДОМ.РФ.

Приходят ли заявки с наш.дом.рф в CRM?

Фид передаёт ДОМ.РФ квартиры, цены и статусы — в обратную сторону он не работает. Заявки покупателей ДОМ.РФ передаёт застройщику после подключения к «Модулю продаж», в том числе по своему API. Если хотите получать их в CRM DomXML, напишите в поддержку.

Сколько это стоит?

В DomXML — бесплатно: ведение шахматки и сборка фида для ДОМ.РФ без ограничений по числу ЖК и квартир. Условия «Модуля продаж» — в договоре с ДОМ.РФ.

Подготовьте фид для ДОМ.РФ

Перенесите шахматку, впишите ID домов — проверка покажет, что ещё заполнить. Это бесплатно

Начать бесплатно