Фид формата Домопланер JSON

ВАЖНО: ДАННЫЙ ФОРМАТ ФИДА - УСТАРЕВШИЙ! 

Делайте интеграцию сразу с новой версией нашего фида:
подробнее о структурном фиде Домопланера.

-----

Данный тип фида подойдет для синхронизации наличия с сайтом. Наши рекомендации по синхронизации с сайтом вы найдете вот в этом руководстве.

Фид отдает данные в формате JSON.

{
	v: 1 => обозначает версию, всегда 1 
	data:  => массив из предложений
	discounts: [Array] => массив акций
	decorations: [Array] => массив отделок
}

Каждый элемент массива data – помещений. Это объект со структурой:

// ID конкретного помещения 
"id": 5164 

// строковый ID конкретного помещения 
"sid": "f8fh9whakejbf89dfohjawfhbiu"

// название проекта и ID внутри ДП
"project": "Квартал у озера"
"project_id": 2144

// название дома и ID внутри ДП
"house": "Дом 1"
"house_id": 12564 

// название очереди и ID внутри ДП
// не выводятся, если не дом не привязан к очереди
"stage_title": "5 очередь"
"stage_id": 122 

// название секции и ID внутри ДП и номер секции
"section": "Секция Б"
"section_id": 6464 
"section_number": 2

// тип помещения, где 0 - квартира, 1 - машиноместо, 2 - кладовая, 3 - офисное помещение 
"type": 0 

// номер этажа и ID внутри ДП
"floor": 1 
"floor_id": 1212

// номер помещения, строка (иногда номера могут быть с буквами и дробями) 
"number": "1" 

// кол-во комнат - строковый параметр для отображения на плитке
// заведен как "Знак комнатности" в ДП
"rooms_sign": "3+"
"rooms": 2 // кол-во цифрой по документам

// позиция на этажа
"position_on_floor": 3 

// евроформат (студийность, где 1 - да, 0 - нет 
"is_studio": 0

// апартамент (где 1 - да, 0 - нет)
"is_apart": 0

//статус помещения, где 0 - свободна, 1 - бронь, 2 - оформление договора, 3 - продана, -1 - резерв, -2 - вне учета. Для отображения на сайте рекомендуем работать со статусами 0 - свободно, и 1 - бронь. Все остальные считать проданными
"status": 0 
 
// стоимость помещения, 0 если статус НЕ 0 и НЕ 1 
"price": 3990000 

// если переуступка, то 1. Если нет, то параметр вообще не передается 
"assign": 1 

// ID изображения планировки квартиры, возможно использоваться для группировок схожих квартир в единую карточку 
"plan_id": 883 

// поле из CRM, по которому задана группировка по схожести 
"flat_marketing_code": "2К-43,59-44,59" 

// площадь помещения 
"area": 48.64 

// описание к квартире, если выбрано в настройках фида
"description": "Эта квартира такая хорошая..."

// массив тегов к данной квартире 
"tags": ['Вид на реку', 'Вид во двор'] 

// массив акций к этому помещению. Если нет, то параметр не передается 
// Содержит номера – это параметр "id" объектов из массива discounts
"discounts": [44, 54]

// ID отделки. Это параметр ID объекта из массива decorations
// Параметр не передается вообще, если нет отделок 
"decoration_id": 39

// Название отделки
// Параметр не передается вообще, если нет отделок 
"decoration_name": "WhiteBox"

// Стоимость помещения без учета скидки. Появляется только в том случае
// когда на помещение действует скидка со снижением цены
"price_old": 3500400

// Размер скидки на помещения. Появляется только в том случае
// когда на помещение действует скидка со снижением цены
"discount_value": 144 000

// далее массив с изображениями
"images": [{
    // первое изображение всегда план с type="plan"
    "type": "plan", 
    "src": "https://storage.yandexcloud.net/.../xxx/yyy.jpg",
    // если у плана есть оригинал в SVG, то передаем параметр ниже
    "src_svg": "https://storage.yandexcloud.net/.../xxx/yyy.svg",
 },{
    // type="image" - дополнительные изображения к планировке
    "type": "image", 
    "src": "https://storage.yandexcloud.net/domoplaner/devmedia/xxx/yyy.jpg"
 }],

// далее информация о плане этажа, на котором находится помещение
"section_info": { 
    // ширина изображения этажа
    "width": 2200, 
    // высота изображения этажа
    "height": 1400, 
    // Изображение для этажа
    "src": "https://storage.yandexcloud.net/domoplaner/......",
    // если у плана этажа есть оригинал в SVG, то передаем параметр ниже
    "src_svg": "https://storage.yandexcloud.net/.../xxx/yyy.svg",
    // точки полигона, контура квартиры на изображении этажа*
    // расчет идет от jpg версии 
    "path": "300,500 390,500 390,595 300,595"
} 


* – Считается с левого нижнего угла изображения этажа, сначала Y, потом X (формат leaflet.js).
Для перегона в обычный svg path не забудьте поменять координаты местами, 
а координату Y рассчитать как (section_info.height - Y)

/*
Если в настройках фида в ДП включен расширенный режим, 
то к каждому помещению будут добавлены дополнительные поля
помещений (только еще проверьте, что включено отображение
этих полей для фидов)
+ список полей ниже
*/

// площадь с учетом коэф. лоджий
"area_koef": 56.32

// площадь без учета лоджий
"area_without": 56.32

// площадь с учетом полных лоджий
"area_full": 56.32

// площадь лоджий полная
"area_loggias": 3.45

// площадь лоджий с коэф
"area_loggias_k": 3.45

// площадь жилая
"area_living": 23.94

// площадь кухни
"area_living": 12.34

// высота потолка
"height": 2.7

// площадь по БТИ
"area_bti": 45.7

// площадь по БТИ жилая
"area_bti_living": 22.7

// площадь по БТИ вспомогательных помещений
"area_bti_add": 12.7

// площадь по БТИ лоджий и балконов
"area_bti_loggias": 4.7

Каждый элемент массива discounts – объект со следующим свойствами:

// ID акции
"id": 149

// Заголовок акции из Домопланера
"title": "Скидка 200 000 руб. на 1А и 1Е"

// Текст акции из Домопланера
"text": "Скидка 200 000 рублей на евродвушки типа 1А и 1Е до конца сентября!\nВыбирайте свой идеальный вариант и бронируйте в отделе продаж или по телефону!"

// Ссылка на подробности акции
"site_link": "https://shishkin.life/evro2ka"

// Дата окончания акции
"dt_end": "2022-09-30"

Каждый элемент массива decorations – объект со следующим свойствами:

// ID отделки
"id": 149

// Заголовок отделки из Домопланера
"title": "Под ключ"

// Является ли отделкой по умолчанию
"primary": 1