MACRO

YGroup

Фид YGroup передаёт на площадку данные в формате JSON. Перейдите Компания → Экспорт → Конструкторе фидов:

После сохранения MACRO формирует постоянную публичную ссылку с расширением .json.

#Как создать фид

  1. Нажмите Создать фид и выберите формат YGroup.
  2. Укажите название фида.
  3. Выберите жилые комплексы и дома, данные которых нужно передавать.
  4. При необходимости настройте:
    • телефон отдела продаж;
    • вариант изображения планировки;
    • режим цены: обычная, акционная или цена с максимальной скидкой.
  5. Включите опцию «Выгружать объекты во всех статусах» — это необходимо так как площадка формирует свою шахматку по всем объектам в доме.
  6. Сохраните фид.
  7. Скопируйте появившуюся публичную ссылку .json и откройте её в браузере для проверки:

В YGroup квартиры, которые имеют активность «Продажа» и находятся в статусе «Подбор» (опубликованы) — в JSON статус такой квартиры всегда передаётся как for_sale.

#Обязательные поля

Если обязательного значения нет, MACRO исключает не весь фид, а минимальную невалидную часть: сначала квартиру, затем дом, затем жилой комплекс. Остальные корректные данные продолжают выгружаться.

#Жилой комплекс (complex)

ПолеЧто передаётся
unique_complex_nameНазвание жилого комплекса, уникальное в пределах фида.
clustersМассив домов или секций жилого комплекса.

#Дом или секция (cluster)

ПолеЧто передаётся
unique_cluster_nameНазвание дома, уникальное в пределах жилого комплекса.
total_floorsОбщее количество этажей.
apartments_per_floorМаксимальное количество позиций квартир на одном этаже во всём доме. Расчёт учитывает все квартиры и подъезды, а также пустые позиции шахматки.
lotsМассив квартир.

#Квартира (lot)

ПолеЧто передаётся
unique_lot_nameНомер квартиры, уникальный в пределах дома или секции.
area_m2Общая площадь квартиры в м².
priceАктуальная цена в рублях по выбранному в настройках фида режиму цены.
floor_numberЭтаж квартиры.
floor_lots_orderПозиция квартиры слева направо на этаже — номер стояка в шахматке MACRO. Пустые позиции не сжимаются.

#Условно обязательные вложенные поля

  • Если передаётся phone_contact, внутри обязательно поле phone_number.
  • Если массив expl_images не пуст, каждый его элемент содержит:
    • floor_number — номер этажа;
    • expl_image — публичную ссылку на план этажа.

#Необязательные поля

Необязательные поля присутствуют в ответе всегда. Если значения нет, значение в поле передаётся как null, массив — как [].

#Жилой комплекс (complex)

ПолеЧто передаётся
complex_typeapartment-complex.
addressПроизвольный адрес ЖК или адрес, собранный из заполненных адресных полей.
descriptionПолное описание жилого комплекса.
latitude, longitudeКоординаты жилого комплекса.
classКласс жилья: economy, comfort, business или elite. Для «другого» заполненного значения используется comfort.
imagesПубличные ссылки на изображения из галереи жилого комплекса.
phone_contactКонтакт отдела продаж. Если телефон не найден, передаётся null.

Объект phone_contact дополнительно содержит:

  • phone_owner_type — sales_department;
  • phone_owner_name — «Отдел продаж <название жилого комплекса>».

#Дом или секция (cluster)

ПолеЧто передаётся
stateready для сданного или готового дома, not_ready для проекта или строящегося дома.
finished_yearГод завершения строительства.
finished_quarterКвартал завершения строительства от 1 до 4.
total_ground_floorsКоличество подземных этажей.
expl_imagesМассив планов этажей.

#Квартира (lot)

ПолеЧто передаётся
statusfor_sale.
layout_typestudio, one_room, two_rooms, three_rooms или four_and_more.
layout_imagesПубличные ссылки на выбранные в настройках фида изображения планировки.

#Быстрая проверка

После создания откройте ссылку фида и проверьте:

  1. В корне есть массив complexes.
  2. В нужном ЖК есть массив clusters с выбранными домами.
  3. В доме есть массив lots с опубликованными квартирами «Продажа / Подбор».
  4. У квартиры заполнены номер, площадь, цена, этаж и позиция на этаже.
  5. Цена соответствует выбранному режиму, а layout_images — выбранному варианту планировки.
  6. Телефон взят из ожидаемого источника либо phone_contact равен null.

Если нужной квартиры нет, сначала проверьте её публикацию, активность, статус, принадлежность к выбранному дому и обязательные поля всех трёх уровней.