УЧАСТВУЙТЕ В ОПРОСАХ
Автоматическая XML выгрузка объявлений
Профессиональным участникам рынка коммерческой недвижимости Москвы и всех регионов России доступен быстрый и удобный способ размещения на Zdanie.info – отправка информации об объектах через XML-выгрузку. Это избавит Вас от необходимости добавления каждого объявления вручную через форму размещения объектов и даёт возможность ежедневного обновления и поднятия ваших объявлений выше в тематическом разделе.
XML-выгрузка осуществляется бесплатно и только в формате «Пробный» (подробнее о форматах).
Вы можете отправить запрос на адрес info@zdanie.info, указав сайт вашей компании и планируемое количество выгружаемых объявлений. Ваша заявка будет рассмотрена и в случае положительного решения вам будет необходимо подготовить файл для выгрузки согласно нижеприведенным требованиям, затем проверить ваш файл, нажав кнопку «Проверить», и если файл соответствует требованиям, нажать кнопку «Добавить». В течение суток все объекты из вашего файла будут выгружены на Zdanie.info.
Обратите внимание: при подготовке XML-файла, помимо нижеприведённых технических требований, необходимо соблюдать требования к оформлению объявлений.
URL-адрес XML документа должен быть постоянным и доступным по протоколу HTTP. Максимальное время установления соединения и ожидания ответа от сервера, на котором расположен XML документ — 30 секунд.
Технические требования
Общие требования
Максимальное количество объектов в одном документе — 300 штук. Использование HTML-тегов в описании объектов запрещено. Все числовые значения не должны содержать десятичных знаков, точек и запятых, только целые числа (кроме значений географических координат объекта).
Заголовок документа
XML-документ должен начинаться с первой строки, с нулевого символа и содержать стандартный XML-заголовок. Допускается использование только кодировки UTF-8.
<?xml version="1.0" encoding="utf-8">
Корневой элемент
Корневой элемент документа <commerce>
должен содержать объекты вашей выгрузки сгруппированные в элементы
<offer>
.
Перед первым элементом с описанием объекта зарегистрированные пользователи сайта могут указать свой логин (e-mail адрес указанный при регистрации) в теге <login>
, атрибут email
.
Этот e-mail адрес используется для идентификации вас (как владельца Личного кабинета) с объектами вашей выгрузки и не будет публиковаться на страницах выгружаемых объектов.
<commerce>
<login email="example@mail.ru"/>
<offer>
...
</offer>
...
</commerce>
Описание выгружаемых объектов
Описание каждого объекта должно входить в элемент <offer>
.
Жирным выделены обязательные к заполнению элементы и атрибуты.
Первым элементом описания объекта должен следовать элемент <id>
. Порядок следования других элементов не имеет значения.
Если в описании объекта хотя бы один из обязательных параметров будет отсутствовать или содержать недопустимое значение, то этот объект будет пропущен.
Отсутствующие в выгрузке объекты, которые были добавлены на сайт из вашего XML ранее, будут автоматически удалены.
Элемент | Описание | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | уникальный для каждого объявления идентификатор (число, может быть одинаковым для нескольких объектов, при условии что объекты будут относится к разному типу сделки <contract_type> ) |
|||||||||||||
contract_type | Тип сделки Возможные значения: 1 – аренда, 2 – продажа |
|||||||||||||
commerce_type | Тип объекта Значение из справочника: типы объектов |
|||||||||||||
address | Адрес объекта Атрибуты: |
|||||||||||||
|
||||||||||||||
metro | Числовой идентификатор станции метро (для Москвы и Санкт-Петербурга) Атрибуты: |
|||||||||||||
|
||||||||||||||
price |
Цена объекта (число). Для объектов с типом Аренда указывается цена аренды квадратного метра объекта в год. Для объектов с типом Продажа — цена продажи всего объекта. В качестве исключения допускается не указывать цену объекта (в случае, если цена данного объекта является конфиденциальной информацией). Атрибуты: |
|||||||||||||
|
||||||||||||||
square | Площадь объекта (число) в м2 | |||||||||||||
description | Описание объекта (символьные данные, максимальная длина 1000 символов). Текст описания объекта не должен быть написан ЗАГЛАВНЫМИ буквами. Не допускается указание контактной информации в описании объекта. Текст описания должен быть помещён внутрь конструкции CDATA. Пример:
<![CDATA[ Продается отдельно-стоящее здание офисного назначения площадью 753 кв.м, класс B. ]]> |
|||||||||||||
photo | Список URL-адресов с фотографиями объекта в порядке их отображения (первое фото будет использоваться в списке объектов в соответствующем разделе, все последующие — на странице объекта). Возможно указание нескольких тегов (до 10). URL-адреса фотографий должны быть доступны по протоколу HTTP и иметь расширения jpg или png. На фото не должно быть каких-либо посторонних изображений (водяных знаков, логотипов и др.). Рекомендуемый размер изображений — 900x600 px, максимальный — 1200x800 px, минимальный — 570x380 px (изображения меньше максимального или больше максимального размера не будут загружены). В рамках одного объявления дубли изображений не принимаются. Как исключение, допускается публикация объектов без фото, но не более 10% от общего количества. | |||||||||||||
contacts | Элемент-контейнер, содержащий контактные данные по объекту. Допускается указывать только один набор контактов для каждого объекта. Вложенные элементы: |
|||||||||||||
|