Описание формата XML

Начало работы

Для работы через XML-выгрузку, вам необходимо сформировать фид с объектами, которые хотели бы опубликовать в соответсвии с нашим форматом. После создания фида вам необходимо указать адрес фида в Настройках.

XSD схема фида доступна по адресу

https://zipal.ru/schemas/mass.xsd

Проверка фида на наличие ошибок

https://zipal.ru/import/validate

Передача адреса

Мы поддерживаем 4 способа передачи адреса:

  1. По коду КЛАДР (наиболее точный способ)
  2. В виде простой строки (наименее точный способ)
  3. В виде координат
  4. В виде адресной строки разбитой на элементы в соответствии с региональным делением (второй по точности способ)

Номер дома передается отдельным полем dom. В виде строки включающей корпус, строение и т.д.

Код КЛАДР

Передача адреса в виде кода КЛАДР KLADRStreetType2

Наиболее точный способ передачи адреса.

<address dom="20">
  <street xsi:type="KLADRStreetType2" 
    code="72000001000049300"
  ></street>
  <coordinates lat="55.962318" lon="37.525091"/>
</address>

Строкой

Передача адреса в виде простой строки.

<address dom="3">
  <street xsi:type="SimpleStreetType" name="Московская область, г. Долгопрудный, ул. Московская" />
</address>

По координатам

dom - указывать не обязательно

<address dom="3">
  <coordinates lat="55.962318" lon="37.525091"/>
</address>

Набор строк

Передача адреса в виде строки разбитой на логические части StringStreetType

type - тип географического объекта. Например: деревня, улица, город.

Второй по точности способ, после передачи по коду КЛАДР.

<address dom="3">
  <street xsi:type="StringStreetType">
    <region type="область">Московская</region>
    <part type="г.">Долгопрудный</part>
    <part type="ул.">Московская</part>
  </street>
  <coordinates lat="55.962318" lon="37.525091"/>
</address>

Справочники

Чаще всего мы можем определить нужные значения полей автоматически с достаточной точностью. Тем не менее ниже приводим список справочников, которыми вы можете воспользоваться для указания точных значений.

КЛАДР

Адреса можно передавать в соответствии с официальным государственным классификатором адресов Классификатор адресов России (КЛАДР). В этом случае в качестве адреса объекта необходимо передавать соответствующие коды КЛАДР.

Запроc

// Получение кода КЛАДР для адреса "город Красноярск, проспект Мира"
https://zipal.ru/kladr/address?term=город Красноярск, проспект Мира

Ответ

[
  {
    "code":"24000001000044300",
    "label":"Мира пр-кт, Красноярск г, Красноярский край, Россия",
    "lat":56.0116,
    "lon":92.8637
  }
]

Районы

Определяем автоматически

https://zipal.ru/import/districts.xml

Микрорайоны

Определяем автоматически

https://zipal.ru/import/sub_districts.xml

Шоссе

Определяем автоматически

https://zipal.ru/import/highways.xml

Метро

Определяем автоматически

https://zipal.ru/import/metros.xml

Новостройки

https://zipal.ru/import/buildings.xml

Примеры

Продажа квартиры

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MassUploadRequest xmlns="http://assis.ru/ws/api"
  timestamp="1381233468072">
  <object externalId="3319417933118894277" publish="false">
    <request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:type="FlatSellRequestType">
      <common 
      	name="Заголовок объявления" 
      	description="Текстовое описание объявления"
        ownership="AGENT" price="15372" currency="RUR" districtId="1"
        subDistrictId="1" distanceToMetro="1" distanceType="TRANSPORT"
        square="178.0" videoUrl="http://youtube.com/videoUrl" 
        commission="8" commissionType="PERCENT">
        <address dom="3">
          <street xsi:type="StringStreetType">
            <region>Московская</region>
            <part type="го">Долгопрудный</part>
            <part type="г.">Долгопрудный</part>
            <part type="ул.">Московская</part>
          </street>
          <coordinates lat="55.962318" lon="37.525091"/>
        </address>
        <photos description="Описание фото" url="http://photoUrl" />
        <photos description="Описание фото" url="http://photoUrl" />
        <photos description="Описание фото" url="http://photoUrl" />
        <metros>
            <metro name="Чертановская" distanceToMetro="10"/>
            <metro name="Кропоткинская" distanceToMetro="5" distanceType="WALK"/>
            <metro name="Партизанская"/>
        </metros>
        <contactInfo name="Иннокентий" phone="71231234567"
          email="jAjifovxDP@asdf" company="Корпорация добра"/>
      </common>
      <specific flatStatus="ALTERNATIVE" newFlat="READY" type="MALOSEMEIKA"
        developer="Монолит" buildingName="ЖК Новостройка"
        documentationUrl="https://zipal.ru" credit="true" mortgage="true"
        usefulSquare="12.0" kitchenSquare="19.0" roomsCount="1"
        roomsCountTotal="5" separatedRoomsCount="5" floorNumber="9"
        floorsNumber="10" ceilingHeight="353" renovation="NONE" number="75"
        toilet="JOINED" balcony="ONE" loggia="ONE" elevator="ONE"
        serviceElevator="ONE" material="PANEL"
        series="44П" heating="ELECTRICITY">
        <parking values="ON_GROUND" />
        <feature>INTERNET</feature>
        <feature>TELEPHONE</feature>
        <feature>TV</feature>
        <readyDate quarter="I" year="2020" />
      </specific>
    </request>
  </object>
</MassUploadRequest>

Общая структура данных

<!-- Корневой тэг -->
<MassUploadRequest>
    <!-- Соответствует одному объявлению -->
    <object>
        <!-- Характеризует тип объявления -->
        <request>
            <!-- Общие параметры объекта -->
            <common>
            	<!-- Адрес объекта -->
                <address>
                    <street/>
                    <coordinates/>
                </address>
                <!-- Опционально -->
                <photos/>
                <!-- Контактные данные -->
                <contactInfo/>
            </common>
            <!-- Специальные параметры объекта -->
            <specific>
            	<!-- Опционально, в зависимости от типа объявления -->
                <parking/>
                <feature/>
                <readyDate/>
            </specific>
        </request>
    </object>
    ...
</MassUploadRequest>

Описание XML тэгов

Корневой тэг

MassUploadRequest - корневой тэг
Обязательные аттрибуты Тип и описание
timestamp Long - Дата генерации фида (UNIX time) 
object - рекламируемый объект недвижимости
Обязательные аттрибуты Тип и описание
externalId String - Уникальный идентификатор объекта в Вашей базе
Дополнительные аттрибуты Тип и описание
publish Boolean" ," -

false - только создать/изменить объявление

true - создать/изменить объявление и опубликовать (для этого необходимо предварительно подключить Пакетное размещение)
limitId Long 
request - запрос на создание/изменение объявления
Обязательные аттрибуты Тип и описание
xmlns:xsi http://www.w3.org/2001/XMLSchema-instance
xsi:type PropertyRequestType - тип объявления

Общие параметры

common - общие параметры объекта
Обязательные аттрибуты Тип и описание
name String - Заголовок объявления (не более 1000 символов)
description String - Описание объекта (не более 4000 символов)
ownership Ownership - Собственность
price Long - Полная стоимость объекта (в рублях)
currency Currency - Валюта
square Double - Общая площадь объекта (в м2, для земли в сотках)
Дополнительные аттрибуты Тип и описание
additionalContactPhone String - Дополнительный контактный телефон
districtId Long - Определяется автоматически по адресу. Можно принудительно указать значение из справочника районов
districtName String - Также можно передать название района.
subDistrictId Long - Определяется автоматически по адресу. Можно принудительно указать значение из справочника микрорайонов
subDistrictName String - Также можно передать название микрорайона.
videoUrl String - Ссылка на видео, предварительно видео должно быть загружено на сервис http://youtube.com
commission Long - Комиссия для клентов (обязательно, если ownership=AGENT)
commissionType CommissionType" default="PERCENT - Тип комиссии (в рублях или процентах, по умолчанию - в процентах)
agentCommission Long - Комиссия для агентов (необязательно)
agentCommissionType CommissionType" default="PERCENT - Тип комиссии для агентов (в рублях или процентах, по умолчанию - в процентах)
exclusiveContract Boolean" default="false - Эксклюзивный договор с собственником
agency Long - ID агентства
url AnyURI - Ссылка на объявление на Вашем сайте. Пользователи будут перенаправлены по указанной ссылке.
externalId String - Идентификатор объекта во внешней системе
onlineShow OnlineShow - Онлайн-показ Возможен ли онлайн-показ
comment String - Комментарий (для внутреннего пользования)
cadastralNumber String - Кадастровый номер
cityForAvito String - Населенный пункт для Авито
subagentContactPhone String - Номер телефона субагента
subagentContactEmail String - E-mail субагента
subagentFirstName String - Имя субагента
subagentLastName String - Фамилия субагента
subagentPatronymic String - Отчество субагента
subagentAvatarUrl String - Аватар субагента
phoneEmployeeDomClick String - Телефон сотрудника DomClick
rosreestrRegistrationNumber String - Номер регистрации ДДУ в Росреестре
linkExtractEgrn String - Ссылка на выписку ЕГРН 
common - общие параметры объекта (дополнительно в случае аренды)
Дополнительные аттрибуты Тип и описание
deposit Long - Сумма депозита (в копейках)
prepayment Int - Предоплата (в месяцах)
priceType PriceType - Период оплаты (обязательно для квартир и домов)
period Period - Срок аренды (обязательно для квартир и домов) 
address - адрес объекта (можно получить используя наш сервис кодов КЛАДР, пример)
Дополнительные аттрибуты Тип и описание
dom String - Номер дома (обязательно для всех объектов, кроме Земли и Долевого). Необязательно если используется распознавание адреса по координатам
yandexAddress String - Полная адресная строка по Yandex (для передачи на площадки, которые принимают строку адреса по Yandex)

Передача адреса возможна в двух вариантах:

В виде строки разбитой на логические части StringStreetType

street - точный адрес объекта в виде StringStreetType
Обязательные аттрибуты Тип и описание
xsi:type StringStreetType 
region - Регион. Примеры: Москва, Московская область, Красноярский край. Обязательное поле
part - Части адреса, в порядке убывания масштаба. Например, Внуковское поселение, деревня Рассказовка
Обязательные аттрибуты Тип и описание
type Обозначение типа части адреса (ул, улица, го, р-н и т.д.). Необязательно, но желательно указывать.

В виде кодов КЛАДР KLADRStreetType2

street - точный адрес объекта в виде KLADRStreetType2
Обязательные аттрибуты Тип и описание
xsi:type KLADRStreetType2
code KLADRCode - Код КЛАДР города/населенного пункта 
coordinates - координаты объекта
Обязательные аттрибуты Тип и описание
lat Double - Широта
lon Double - Долгота 
photos - фотографии объекта (не более 40)
Обязательные аттрибуты Тип и описание
url AnyURI - Ссылка на фото на Вашем ресурсе
Дополнительные аттрибуты Тип и описание
description String - Описание фото 
contactInfo - Контактные данные
Обязательные аттрибуты Тип и описание
name String - Заголовок
phone String
email String
Дополнительные аттрибуты Тип и описание
company String

Квартиры

Вторичное жилье, новостройки, долевое, комнаты

specific - специальные параметры объекта (квартиры)
Обязательные аттрибуты Тип и описание
type FlatType - Тип квартиры
roomsCountTotal Int - Комнат всего (в соответствии с планировкой)
separatedRoomsCount Int - Комнат раздельно
floorNumber Int - Этаж
floorsNumber Int - Этажей
material FlatMaterial - Материал стен
Дополнительные аттрибуты Тип и описание
offerType OfferType - Тип предложения
apartments Boolean" default="false - Апартаменты
usefulSquare Double - Площадь жилая (м2)
kitchenSquare Double - Площадь кухни (м2)
roomsCount Int - Комнат на продажу
ceilingHeight Int - (см)
buildingName String - Название ЖК
buildingId String
cianBuildingId String
cianJkId String
yandexBuildingId String
yandexJkId String
yandexJkName String
emlsBuildingId String
avitoBuildingId String
renovation Renovation - Ремонт
toilet Toilet - Туалет
balcony Balcony - Количество балконов
loggia Loggia - Количество лоджий
elevator Elevator - Пассажирских лифтов
serviceElevator ServiceElevator - Грузовых лифтов
flatHouseType FlatHouseType - Тип дома
series String - Тип/Серия дома
heating Heating - Отопление
windowView WindowView - Вид из окна
chambers String - Площадь комнат
privatization Boolean - Приватизированная квартира
plumbing Plumbing - Водоснабжение
entrance Int - Подъезд

Квартиры - продажа

specific - специальные параметры объекта (квартиры - продажа)
Обязательные аттрибуты Тип и описание
credit Boolean - Рассрочка
mortgage Boolean - Ипотека
Дополнительные аттрибуты Тип и описание
flatStatus FlatStatus - Статус объекта
newFlat NewFlat - Новостройка
developer String - Застройщик
developerUrl String - Адрес сайта застройщика
developerPhone String - Телефон застройщика
developerLogoUrl String - URL логотипа застройщика
documentationUrl String - Проектная декларация
rosreestrRegistrationNumber String - Номер регистрации ДДУ в Росреестре
linkExtractEgrn String - Ссылка на выписку ЕГРН
cianPromoActionId String - ID акции на Циан
investorType InvestorType - Дольщик
investorInn String - Если дольщик юр. лицо
investorFirstName String - Если дольщик физ. лицо
investorLastName String - Если дольщик физ. лицо
investorPatronymic String - Если дольщик физ. лицо
number String - Номер квартиры
year Int - Год постройки полностью, например 2018
bathType BathType - Тип ванны
hotWater HotWater - Обеспечение горячей водой
reassignment Boolean" default="false - Переуступка
firstSale Boolean" default="false - Первичная продажа вторички
sharePercent Int - Размер доли
greedRedevelopment Boolean - Согласована перепланировка
rightOwnership Boolean - Есть право собственности
neighbor Int - Соседей в квартире
door DoorType -
flatFloor FlatFloorType -
windowMaterial WindowMaterialType -
apartmentPosition ApartmentPositionType - 
readyDate - дата завершения строительства (только для NewFlat)
Обязательные аттрибуты Тип и описание
quarter Quarter - Квартал
year Int - Год постройки 
feature - Feature - опции объекта (квартиры - продажа)
Допустимые значения
INTERNET, TELEPHONE, TV, INVALIDS, ELEVATOR, SERVICE_ELEVATOR, CONCIERGE, GUARDS, RUBBISH_CHUTE, GAS, FENCING, INTERCOM, WATER_METER, RAMP, HAS_BARRIED_YARD, HAS_CAR_FREE_COURT

Квартиры - аренда

specific - специальные параметры объекта (квартиры - аренда)
Дополнительные аттрибуты Тип и описание
maxPeople Int - Количество спальных мест
utilities Long - Коммунальные платежи
utilityMeters Boolean - Оплата по счетчикам производится арендатором
otherUtilities Boolean - Другие ЖКУ
otherUtilitiesPayment Long - Плата за другие ЖКУ 
feature - Feature - опции объекта (квартиры - аренда)
Допустимые значения
INTERNET, TELEPHONE, TV, INVALIDS, WASHING_MACHINE, DISHWASHER, FURNITURE, FRIDGE, WIRELESS_INTERNET, WITH_PETS, WITH_CHILDREN, ELEVATOR, SERVICE_ELEVATOR, CONCIERGE, GUARDS, RUBBISH_CHUTE, GAS, FENCING, CONDITIONER

Дома (коттеджи, дачи)

specific - специальные параметры объекта (дома)
Обязательные аттрибуты Тип и описание
distance LandDistanceType - Целое число от 0 до 10000 (расстояние до города в км)
burden Boolean - Есть Обременения
electricity Electricity - Электроснабжение
gas Gas - Газификация
plumbing Plumbing - Водоснабжение
sewerage Sewerage - Канализация
relief Relief - Рельеф
Дополнительные аттрибуты Тип и описание
highwayId Long - Определяется автоматически по адресу. Можно принудительно указать идентификатор шоссе из справочника шоссе
highwayName String - Определяется автоматически по адресу. Можно принудительно указать название шоссе из справочника шоссе
landUsageType LandUsageType - Использование земли Обязательно, если purpose - SETTLEMENTS или AGRICULTURAL
communityName String - Название коттеджного поселка
railway String - Ж/Д станция
railwayDistance Int - До станции
railwayDistanceType DistanceType - Тип расстояния
drivewayType DrivewayType - Подъездные пути
forestDistance Int - (км)
waterDistance Int - (км)
cianKpId String 
specific - специальные параметры объекта (дома)
Обязательные аттрибуты Тип и описание
landSquare Double - Площадь участка
houseType HouseType - Тип дома
furniture Furniture - Мебель
renovation Renovation - Ремонт
material HouseMaterial - Материал стен
heating Heating - Отопление
Дополнительные аттрибуты Тип и описание
floorsNumber PositiveInt - Этажей
landCadastralNumber String - Кадастровый номер земельного участка
newFlat NewFlat - Новостройка
toilet Toilet - Туалет
roomsCount PositiveInt - Комнат
sharePercent Int - Размер доли

Дома - продажа

specific - специальные параметры объекта (дома - продажа)
Обязательные аттрибуты Тип и описание
shape Shape - Форма участка
purpose Purpose - Назначение земли
credit Boolean - Рассрочка
mortgage Boolean - Ипотека
Дополнительные аттрибуты Тип и описание
flatStatus FlatStatus - Статус объекта
year Int - Год постройки полностью, например 2018 
feature - Feature - опции объекта (дома - продажа)
Допустимые значения
GUARDS, FENCING, ACCESS, TELEPHONE, INTERNET, TV, WIRELESS_INTERNET, GARAGE, SAUNA, POOL, BOILER, MANSARD, RESIDENCE, FOREST, WATER, TERRACE, CELLAR, SHOWER

Дома - аренда

feature - Feature - опции объекта (дома - аренда)
Допустимые значения
GUARDS, FENCING, ACCESS, TELEPHONE, INTERNET, TV, GARAGE, SAUNA, POOL, BOILER, MANSARD, FOREST, WATER, WITH_PETS, WITH_CHILDREN, CONDITIONER, WIRELESS_INTERNET, FRIDGE, WASHING_MACHINE, DISHWASHER

Земля (только продажа)

specific - специальные параметры объекта (земля)
Обязательные аттрибуты Тип и описание
distance LandDistanceType - Целое число от 0 до 10000 (расстояние до города в км)
burden Boolean - Есть Обременения
electricity Electricity - Электроснабжение
gas Gas - Газификация
plumbing Plumbing - Водоснабжение
sewerage Sewerage - Канализация
relief Relief - Рельеф
Дополнительные аттрибуты Тип и описание
highwayId Long - Определяется автоматически по адресу. Можно принудительно указать идентификатор шоссе из справочника шоссе
highwayName String - Определяется автоматически по адресу. Можно принудительно указать название шоссе из справочника шоссе
landUsageType LandUsageType - Использование земли Обязательно, если purpose - SETTLEMENTS или AGRICULTURAL
communityName String - Название коттеджного поселка
railway String - Ж/Д станция
railwayDistance Int - До станции
railwayDistanceType DistanceType - Тип расстояния
drivewayType DrivewayType - Подъездные пути
forestDistance Int - (км)
waterDistance Int - (км)
cianKpId String 
feature - Feature - опции объекта (земля)
Допустимые значения
GUARDS, FENCING, ACCESS, FOREST, WATER, GRACE_PERIOD

Земля - продажа

specific - специальные параметры объекта (земля - продажа)
Обязательные аттрибуты Тип и описание
shape Shape - Форма участка
purpose Purpose - Назначение земли
Дополнительные аттрибуты Тип и описание
flatStatus FlatStatus - Статус объекта

Офисы

specific - специальные параметры объекта (офисы)
Обязательные аттрибуты Тип и описание
buildingClass BuildingClass - Класс здания
layout Layout - Планировка
Дополнительные аттрибуты Тип и описание
officeType OfficeType - Тип использования офисного помещения 
feature - Feature - опции объекта (оффисы - продажа)
Допустимые значения
REPAIR_BY_OWNER, ANY_INET_PROVIDER, FIRST_LINE, RESTAURANT, FITNESS, BANK, ATM, SUPERMARKET, INTERNET, CLOCK_ACCESS, VIDEO_SURVEILLANCE, GUARDS, ACCESS_CONTROL, ELEVATOR, CLIENTS_ACCESS, CONDITIONER, HEATING, SEPARATE_ENTRY

Офисы (аренда)

specific - специальные параметры объекта (офисы - аренда)
Обязательные аттрибуты Тип и описание
sublease Boolean - Субаренда

Коммерческие помещения

specific - специальные параметры объекта (коммерческие помещения)
Обязательные аттрибуты Тип и описание
buildingType BuildingType - Тип здания
Дополнительные аттрибуты Тип и описание
standaloneBuilding Boolean" default="false - Отдельно стоящее здание
vatIncluded Boolean
vatType VatType - Налог
groundFloor Boolean" default="false - Цокольный этаж
floorNumber PositiveInt - Этаж
floorsNumber PositiveInt - Этажей
objectCondition Condition - Состояние коммерческого помещения
centerName String - Бизнес-центр
parkingPlaces Int - Парковочных мест
parkingType ParkingType - Тип парковки
ventilationType VentilationType - Тип вентиляции
conditioningType ConditioningType - Тип кондиционирования
ceilingHeight Int - Высота потолков
year Int - Год постройки полностью, например "2018"
entryType EntryType - Вход в объект
byPart Boolean" default="false - Можно частями
minSquare Double - Площадь от
readyBusiness Boolean" default="false - Готовый бизнес
rentalBusiness Boolean" default="false - Арендный бизнес
monthlyIncome Double - Месячная прибыль (в рублях)
buildingName String - Название ЖК
buildingId String
cianBuildingId String
cianJkId String
yandexBuildingId String
yandexJkId String
yandexJkName String

Коммерческие помещения (аренда)

specific - специальные параметры объекта (коммерческие помещения - аренда)
Обязательные аттрибуты Тип и описание
sublease Boolean - Субаренда

Коммерческие помещения (торговые помещения и прочее)

specific - специальные параметры объекта (торговые помещения и прочее)
Обязательные аттрибуты Тип и описание
businessUsageType BusinessUsageType - Тип использования коммерческого помещения
Дополнительные аттрибуты Тип и описание
hallSquare Double - Площадь зала 
feature - Feature - опции объекта (торговые помещения и прочее)
Допустимые значения
REPAIR_BY_OWNER, ANY_INET_PROVIDER, FIRST_LINE, RESTAURANT, FITNESS, BANK, ATM, SUPERMARKET, INTERNET, CLOCK_ACCESS, VIDEO_SURVEILLANCE, GUARDS, ACCESS_CONTROL, EQUIPMENT, SEPARATE_ENTRY

Склады

specific - специальные параметры объекта (склады)
Обязательные аттрибуты Тип и описание
sublease Boolean - Субаренда
warehouseType WarehouseType - Тип складского помещения
floorsNumber PositiveInt - Всего этажей, например 20
Дополнительные аттрибуты Тип и описание
vatIncluded Boolean
vatType VatType - Налог
conditioning Conditioning - Система контроля климата
heating Heating - Отопление
storageType StorageType - Тип хранения
floorPressure PositiveInt - Нагрузка на пол
floorNumber PositiveInt - Этаж, например 5
basementFloor Boolean - Подвал
groundFloor Boolean - Цокольный этаж
columnSpace PositiveInt - Шаг колонн
power PositiveInt - Подведенная мощность
floor WarehouseFloor - Покрытие полов
unloading Unloading - Разгрузка
gate Gate - Въезд
highwayAccess HighwayAccess - Транспортная доступность
ceilingHeight PositiveInt - Высота потолков
year PositiveInt - Год постройки полностью, например "2018"
entryType EntryType - Вход в объект
structureType StructureType - Тип здания
byPart Boolean" default="false - Можно частями
minSquare Double - Площадь от 
specific - специальные параметры объекта (склады)
Допустимые значения
CRANE, CUSTOMS, RAILWAY, TRUCK_PARKING, PORT, INTERNET, CLOCK_ACCESS, VIDEO_SURVEILLANCE, GUARDS, ACCESS_CONTROL

Земля коммерческого назначения (только продажа)

specific - специальные параметры объекта (земля коммерческого назначения)
Обязательные аттрибуты Тип и описание
distance LandDistanceType - Целое число от 0 до 10000 (расстояние до города в км)
burden Boolean - Есть Обременения
electricity Electricity - Электроснабжение
gas Gas - Газификация
plumbing Plumbing - Водоснабжение
sewerage Sewerage - Канализация
relief Relief - Рельеф
Дополнительные аттрибуты Тип и описание
highwayId Long - Определяется автоматически по адресу. Можно принудительно указать идентификатор шоссе из справочника шоссе
highwayName String - Определяется автоматически по адресу. Можно принудительно указать название шоссе из справочника шоссе
landUsageType LandUsageType - Использование земли Обязательно, если purpose - SETTLEMENTS или AGRICULTURAL
communityName String - Название коттеджного поселка
railway String - Ж/Д станция
railwayDistance Int - До станции
railwayDistanceType DistanceType - Тип расстояния
drivewayType DrivewayType - Подъездные пути
forestDistance Int - (км)
waterDistance Int - (км)
cianKpId String 
feature - Feature - опции объекта (земля коммерческого назначения)
Допустимые значения
GUARDS, FENCING, ACCESS, FOREST, WATER, GRACE_PERIOD

Земля коммерческого назначения - продажа

specific - специальные параметры объекта (земля коммерческого назначения - продажа)
Дополнительные аттрибуты Тип и описание
vatIncluded Boolean
vatType VatType - Налог
byPart Boolean" default="false - Можно частями
minSquare Double - Площадь от

Гаражи

specific - специальные параметры объекта (гаражи)
Обязательные аттрибуты Тип и описание
garageType GarageType - Тип гаража
stories Int - Этажность здания
Дополнительные аттрибуты Тип и описание
garageMaterial GarageMaterial - Материал стен
year Int - Год постройки полностью, например "2018"
totalParkingLots Int - Общее кол-во машиномест
ceilingHeight Int - Высота потолков 
feature - специальные параметры объекта (гаражи)
Допустимые значения
HEATING, ELECTRIC, CELLAR, INSPECTION_PIT

Гаражи - продажа

specific - специальные параметры объекта (гаражи - продажа)
Дополнительные аттрибуты Тип и описание
assignmentOfLeaseRights Boolean" default="false - Переуступка права аренды

Гаражи - аренда

specific - специальные параметры объекта (гаражи - аренда)
Дополнительные аттрибуты Тип и описание
sublease Boolean" default="false - Субаренда

Машиноместа

specific - специальные параметры объекта (машиноместа)
Обязательные аттрибуты Тип и описание
parkingLotType ParkingLotType - Тип стоянки 
specific - специальные параметры объекта (машиноместа)
Допустимые значения
HEATING, GSK

Машиноместа - продажа

specific - специальные параметры объекта (машиноместа - продажа)
Дополнительные аттрибуты Тип и описание
assignmentOfLeaseRights Boolean" default="false - Переуступка права аренды

Машиноместа - аренда

specific - специальные параметры объекта (машиноместа - аренда)
Дополнительные аттрибуты Тип и описание
sublease Boolean" default="false - Субаренда

Типы данных

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

PropertyRequestType - тип объявления
Допустимое значение Описание
FlatSellRequestType Продажа квартиры (включая новостройки, долевое, комнаты)
FlatRentRequestType Аренда квартиры (включая комнаты)
HouseSellRequestType Продажа дома
HouseRentRequestType Аренда дома
LandSellRequestType Продажа земли
OfficeSellRequestType Продажа офиса
OfficeRentRequestType Аренда офиса
BusinessSellRequestType Продажа коммерческого помещения
BusinessRentRequestType Аренда коммерческого помещения
WarehouseSellRequestType Продажа складского помещения
WarehouseRentRequestType Аренда складского помещения
CommLandSellRequestType Продажа земли коммерческого назначения
GarageSellRequestType Продажа гаража
GarageRentRequestType Аренда гаража
ParkingLotSellRequestType Продажа машиноместа
ParkingLotRentRequestType Аренда машиноместа

Количество балконов

Balcony - Количество балконов
Допустимое значение Описание
NONE Нет
ONE 1
TWO 2
THREE 3
FOUR 4

Количество лоджий

Loggia - Количество лоджий
Допустимое значение Описание
NONE Нет
ONE 1
TWO 2
THREE 3
FOUR 4

Класс здания

BuildingClass - Класс здания
Допустимое значение Описание
APLUS A+
A A
AMINUS A-
BPLUS B+
B B
C C

Тип здания

BuildingType - Тип здания
Допустимое значение Описание
ADMINISTRATIVE Административное
BANKING Банковское
BUSINESS_CENTER Бизнес-центр
BUSINESS_PARK Бизнес-парк
LIVING_HOUSE Жилой дом
INDUSTRIAL_COMPLEX Производственный комплекс
INDUSTRIAL_PARK Индустриальный парк
INDUSTRIAL_WAREHOUSE Производственно-складской комплекс
LOGISTIC_CENTER Логистический центр
LOGISTIC_COMPLEX Логистический комплекс
MIXED_COMPLEX Многофункциональный комплекс
MANSION Особняк
MODERN_MANSION Современный особняк
OLD_MANSION Старинный особняк
OUTLET Аутлет
OFFICE_BUILDING Офисное здание
OFFICE_HOTEL Офисно-гостиничный комплекс
OFFICE_INDUSTRIAL Офисно-производственный комплекс
OFFICE_RESIDENTIAL Офисно-жилой комплекс
OFFICE_WAREHOUSE Офисно-складской комплекс
WAREHOUSE_COMPLEX Складской комплекс
OFFICE_RETAIL Торгово-офисный комплекс
FREE Объект свободного назначения
TECHNOPARK Технопарк
TRADE_EXIBITION Торгово-выставочный комплекс
MALL ТРЦ

Тип использования коммерческого помещения

BusinessUsageType - Тип использования коммерческого помещения
Допустимое значение Описание
ANY Любой
OFFICE Офисное помещение
RETAIL Торговое помещение
PHARMACY Аптека
BEAUTY_SALON Салон красоты
RESTAURANT Ресторан
NIGHT_CLUB Ночной клуб
BAR Бар
GAS_STATION АЗС
WASH Мойка
HOTEL Гостиница
PARKING Парковка
CAR_SERVICE Автосервис

Тип комиссии

CommissionType - Тип комиссии
Допустимое значение Описание
PERCENT %
RUR руб

Состояние коммерческого помещения

Condition - Состояние коммерческого помещения
Допустимое значение Описание
BUSINESS_CLASS Бизнес-класс
READY Готово к въезду
NEED_COSMETIC Требуется косметический ремонт
NEED_OVERHAUL Требуется капитальный ремонт
NEED_RECONSTRUCTION Требуется ремонт здания

Система контроля климата

Conditioning - Система контроля климата
Допустимое значение Описание
NONE Неотапливаемый
HEATING Отапливаемый
COND_AND_VENT Склад-холодильник
CLIMATE_CONTROL Климат-контроль

Валюта

Currency - Валюта
Допустимое значение Описание
RUR руб
USD долл
EUR евро

Опции

Feature - Опции
Допустимое значение Описание
INTERNET Интернет
TELEPHONE Телефон
TV Спутниковое / Кабельное ТВ
ELEVATOR Лифт
SERVICE_ELEVATOR Грузовой лифт
CONCIERGE Консьерж
GUARDS Охраняемая территория
RUBBISH_CHUTE Мусоропровод
GAS Газ
FENCING Огороженная территория
INVALIDS Доступно людям с ограниченными возможностями
WASHING_MACHINE Стиральная машина
FURNITURE Мебель
FRIDGE Холодильник
CONDITIONER Кондиционер
WIRELESS_INTERNET Беспроводной интернет
WITH_PETS С животными
WITH_CHILDREN С детьми
ACCESS Круглогодичный доступ
GARAGE Гараж
SAUNA Баня / Сауна
POOL Бассейн
BOILER Бойлер
MANSARD Мансарда
RESIDENCE Возможна прописка
FOREST Лес
WATER Водоем
CLOCK_ACCESS Доступ 24 часа
VIDEO_SURVEILLANCE Видео-наблюдение
ACCESS_CONTROL Контроль доступа
CRANE Кран
CUSTOMS Таможня
RAILWAY Жд сообщение
TRUCK_PARKING Парковка для грузового транспорта
PORT Порт
ANY_INET_PROVIDER Возможность менять провайдера
FIRST_LINE Первая линия
RESTAURANT Ресторан
FITNESS Фитнес
BANK Банк
ATM Банкомат
SUPERMARKET Супермаркет
CLIENTS_ACCESS Доступ для клиентов
HEATING Отопление
SEPARATE_ENTRY Отдельный вход
EQUIPMENT Есть оборудование
REPAIR_BY_OWNER Ремонт за счет владельца
GSK На территории ГСК или ГК
DISHWASHER Посудомоечная машина
INTERCOM Домофон
WATER_METER Счетчики воды
ELECTRIC Электричество
GRACE_PERIOD Арендные каникулы
BUFFET Буфет
CANTEEN Столовая
CAFE Кафе
CINEMA Кинотеатр
NOTARY_OFFICE Нотариальная контора
CONFERENCE_ROOM Конференц-зал
MINIMARKET Минимаркет
RAMP Пандус
MEDICAL_CENTER Медицинский центр
TERRACE Терраса
CELLAR Погреб
INSPECTION_PIT Смотровая яма
SHOWER Душ
HAS_BARRIED_YARD Двор под шлагбаумом
HAS_CAR_FREE_COURT Двор без машин
SLAVIC

Тип расстояния

DistanceType - Тип расстояния
Допустимое значение Описание
WALK пешком
TRANSPORT транспортом

Электроснабжение

Electricity - Электроснабжение
Допустимое значение Описание
NO Отсутствует
YES Подключено
POSSIBLE Возможно подключение
AUTONOM Автономное

Статус объекта

FlatStatus - Статус объекта
Допустимое значение Описание
ALTERNATIVE Альтернатива
FREE Свободна

Тип квартиры

FlatType - Тип квартиры
Допустимое значение Описание
FLAT Типовая
STUDIO Студия
ELITE Элитная
TWO_LEVEL Двухуровневая
INDIVIDUAL Индивидуальная
IMPROVED Улучшенная планировка
PENTHOUSE Пентхаус
MALOSEMEIKA Малосемейка
GOSTINKA Гостинка

Мебель

Furniture - Мебель
Допустимое значение Описание
FULL Полностью мебелирован
PART Частично мебелирован
NONE Отсутствует

Газификация

Gas - Газификация
Допустимое значение Описание
NO Отсутствует
YES Подведен
BORDER По границе
POSSIBLE Возможно подключение
GASBOTTLE Газовый баллон
GASHOLDER Газгольдер
AUTONOM Автономная

Въезд

Gate - Въезд
Допустимое значение Описание
ZERO_POINT Ворота на нулевой отметке
HYUDRALIC_RAMPS Гидроаппарели и докшелтеры
RAMPANT Пандус или рампа

Отопление

Heating - Отопление
Допустимое значение Описание
CENTRAL Центральное
LOCAL Отдельное
GAS Газовое
ELECTRICITY Электрическое
LIQUID Жидкое топливо
FURNACE Печь
FIREPLACE Камин
SOLID_FUEL_BOILER Твердотопливный котел
NONE Отсутствует

Транспортная доступность

HighwayAccess - Транспортная доступность
Допустимое значение Описание
NONE Отсутствует
TWO_TURNS Не более двух поворотов
DIRECT_ACCESS Прямой доступ

Тип дома

HouseType - Тип дома
Допустимое значение Описание
DACHA Дача
COTTAGE Коттедж
TOWNHOUSE Таунхаус
DUPLEX Дуплекс
HOUSE Дом
HOUSESHARE Часть дома

Использование земли

LandUsageType - Использование земли
Допустимое значение Описание
IGS ИЖС(индивидуальное жилищное строительство)
LPH ЛПХ(личное подсобное хозяйство)
DNP ДНП(дачное некоммерческое партнерство)
SNT СНТ(садоводческое некоммерческое товарищество)
FARM Фермерское хозяйство
GARDEN Садоводство

Планировка

Layout - Планировка
Допустимое значение Описание
CORRIDOR Кабинетная
FREE Свободная
MIXED Смешанная

Материал стен

FlatMaterial - Материал стен
Допустимое значение Описание
BRICK Кирпич
PANEL Панель
MONOLITH Монолит
MONOBRICK Монолит-кирпич
WOOD Дерево
BOARDS Щитовой
FOAM Пенобетон
AEROCRETE Газобетон
GASSILICATE Газосиликат
WIREFRAME Каркасный
BLOCK Блок

Материал стен

HouseMaterial - Материал стен
Допустимое значение Описание
BRICK Кирпич
CONCRETE Железобетон
MONOLITH Монолит
TIMBER Брус
WOOD Дерево
BLOCK Блок
WIREFRAME Каркасный
BOARDS Щитовой
FOAM Пенобетон
AEROCRETE Газобетон
ARBOLIT Арболит
EXPANDEDCLAYCONCRETE Керамзитобетон
SIPPANELS Сип-панели
GASSILICATE Газосиликат
SLAGCONCRETE Шлакобетон
SANDWICH Сэндвич-панели

Материал стен

GarageMaterial - Материал стен
Допустимое значение Описание
BRICK Кирпич
CONCRETE Железобетон
METAL Металлоконструкции

Новостройка

NewFlat - Новостройка
Допустимое значение Описание
READY Новостройка
NOT_READY Долевое

Собственность

Ownership - Собственность
Допустимое значение Описание
OWNER Я являюсь собственником
AGENT Я являюсь агентом

Тип парковки

ParkingType - Тип парковки
Допустимое значение Описание
ON_GROUND Наземная
MULTILEVEL Многоуровневая
ROOF На крыше
UNDER_GROUND Подземная

Срок аренды

Period - Срок аренды
Допустимое значение Описание
SHORT Короткий
LONG Длительный
SEASON Сезонный
MORE_THAN_MONTH Месяц и более

Водоснабжение

Plumbing - Водоснабжение
Допустимое значение Описание
NO Отсутствует
CENTRAL Центральное
HOLE Скважина
WELL Колодец/колонка
BORDER По границе

Период оплаты

PriceType - Период оплаты
Допустимое значение Описание
MONTH месяц
DAY сутки

Назначение земли

Purpose - Назначение земли
Допустимое значение Описание
SETTLEMENTS Земли поселений
AGRICULTURAL Сельскохозяйственного назначения
INDUSTRIAL Промышленного назначения
FORESTS Земли лесного фонда
AQUA Земли водного фонда
GUARDED Особо охраняемых территорий
RESERVATIONS Запаса

Квартал

Quarter - Квартал
Допустимое значение Описание
I Первый квартал
II Второй квартал
III Третий квартал
IV Четвертый квартал

Рельеф

Relief - Рельеф
Допустимое значение Описание
FLAT Ровный
ELEVATIONS Значительные перепады высот
SLOPE Склон
HILLS Холмы

Ремонт

Renovation - Ремонт
Допустимое значение Описание
COSMETIC Косметический
EURO Евростандарт
NONE Под отделку
NEEDS_RENOVATION Требует ремонта
ROUGH_FINISH Черновая отделка
AUTHOR Авторский

Канализация

Sewerage - Канализация
Допустимое значение Описание
NO Отсутствует
CESSPOOL Выгребная яма
SEPTIC Септик
BIO Устройства биологической очистки
CENTRAL Центральная

Форма участка

Shape - Форма участка
Допустимое значение Описание
REGULAR Правильная
IRREGULAR Не правильная

Тип хранения

StorageType - Тип хранения
Допустимое значение Описание
FLOOR Напольное
RACK Стелажное
MIXED Смешанное

Туалет

Toilet - Туалет
Допустимое значение Описание
JOINED Совмещенный
SEPARATED Раздельный
OUTDOORS На улице
TWO 2
THREE 3
FOUR 4

Разгрузка

Unloading - Разгрузка
Допустимое значение Описание
RAMPANT Пандус
NON_RAMPANT Без пандуса
CAR_ENTRY Въезд на склад

Покрытие полов

WarehouseFloor - Покрытие полов
Допустимое значение Описание
LEVELCRETE Бетонный пол
LINOLEUM Линолеум
ASPHALT Асфальт
TILE Бетонная плитка
WOOD Дерево
LAMINATE Ламинат
REINFORCED_CONCRETE Железобетон
POLYMERIC Полимерный

Тип складского помещения

WarehouseType - Тип складского помещения
Допустимое значение Описание
WAREHOUSE Склад
CONSTRUCTION Производство
MIXED Смешанное

Вид из окна

WindowView - Вид из окна
Допустимое значение Описание
STREET На улицу
YARD Во двор
BOTH Во двор и на улицу

Вход в объект

EntryType - Вход в объект
Допустимое значение Описание
SEPARATE_FROM_YARD Отдельный со двора
SEPARATE_FROM_STREET Отдельный с улицы
JOINT_FROM_YARD Общий со двора
JOINT_FROM_STREET Общий с улицы
CHECKPOINT Через проходную
SEVERAL Несколько, включая отдельный
SEVERAL_JOINT Несколько, все общие

Тип ванны

BathType - Тип ванны
Допустимое значение Описание
SHOWER Душ
JOINED Совмещенная
SEPARATED Отдельная
CROSS Поперечная
LONGITUDINAL Продольная
SEDENTARY Сидячая
KITCHEN На кухне
CORRIDOR В коридоре
NO Нет ванны

Обеспечение горячей водой

HotWater - Обеспечение горячей водой
Допустимое значение Описание
CENTRAL Теплоцентр
BOILER Бойлер
GAS_COLUMN Газовая колонка
ELECTRICITY Электроводонагреватель
WOOD_STOVE Дровяная колонка
NONE Нет

Тип предложения

OfferType - Тип предложения
Допустимое значение Описание
FLAT Вся квартира
ROOM Комната
FLATSHARE Доля в квартире

Тип гаража

GarageType - Тип гаража
Допустимое значение Описание
STANDALONE Отдельный гараж
BOX Бокс
SHELL Ракушка
CASE Пенал
SUNSHADE Тент-укрытие

Тип стоянки

ParkingLotType - Тип стоянки
Допустимое значение Описание
OPEN Открытая
CLOSED Закрытая
MULTILEVEL Многоуровневая

Тип здания

StructureType - Тип здания
Допустимое значение Описание
DETACHED Отдельно стоящее здание

Налог

VatType - Налог
Допустимое значение Описание
VAT_NOT_INCLUDED НДС не включен
VAT_INCLUDED НДС включен
USN УСН

Дольщик

InvestorType - Дольщик
Допустимое значение Описание
INDIVIDUAL Физ. лицо
LEGAL Юр. лицо

Пассажирских лифтов

Elevator - Пассажирских лифтов
Допустимое значение Описание
NONE Нет
ONE 1
TWO 2
THREE 3
FOUR 4

Грузовых лифтов

ServiceElevator - Грузовых лифтов
Допустимое значение Описание
NONE Нет
ONE 1
TWO 2
THREE 3
FOUR 4

Тип дома

FlatHouseType - Тип дома
Допустимое значение Описание
BREZHNEVKA Брежневка
LOW_FLOOR Малоэтажка
HOSTEL Общежитие
SECTION Секционного типа
SPECIAL Спецпроект
STALINKA Сталинка
HRUSHEVKA Хрущевка
OLD_FUND Старый фонд
MODERN_HOUSE_BUILDING Современное домостроение

Входная дверь

Door - Входная дверь
Допустимое значение Описание
WOOD Деревянная
METAL Металлическая
METAL_WOOD Двойная металл-дерево
WOOD_METAL Двойная дерево-металл

Покрытие пола

FlatFloor - Покрытие пола
Допустимое значение Описание
LINOLEUM Линолеум
LAMINATE Ламинат
CARPETING Ковролин
PARQUET Паркет
BATTEN Половая доска
NO Без покрытия

Расположение в доме

ApartmentPosition - Расположение в доме
Допустимое значение Описание
CORNER Угловая квартира
NOT_CORNER Неугловая квартира

Окна

WindowMaterial - Окна
Допустимое значение Описание
WOOD Деревянные
PLASTIC Пластиковые ПВХ