УЧАСТВУЙТЕ В ОПРОСАХ

Автоматическая 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

Адрес объекта

Атрибуты:
admin_area Числовой идентификатор административной области
Значение из справочника: административные области
locality Название населенного пункта или города (названия городов указываются без приставки «город» или «г.», названия населённых пунктов указываются включая район и его тип). Пример: Москва; Дзержинский район, поселок Суздальский.
street Название улицы населенного пункта или города (включая тип улицы, допускаются сокращения). Пример: Озерная аллея; ул. Строителей.
house_str Номер дома
lon Географические координаты (долгота)
lat Географические координаты (широта)
Географические координаты используются для определения местоположения объекта на карте. Значения координат должны содержать только числа с дробной частью, разделитель — точка. Если долгота и широта не указаны, то координаты объекта будут определены автоматически по указанному адресу.
metro

Числовой идентификатор станции метро (для Москвы и Санкт-Петербурга)

Атрибуты:
id Числовой идентификатор станции метро
Значение из справочника: для Москвы, для Санкт-Петербурга
wtime Расстояние до станции метро в минутах (пешком)
ttime Расстояние до станции метро в минутах (транспортом)
Допускается указывать только один из атрибутов wtime и ttime. Если указаны оба атрибута, то будет учтено только расстояние до метро пешком.
price

Цена объекта (число). Для объектов с типом Аренда указывается цена аренды квадратного метра объекта в год. Для объектов с типом Продажа — цена продажи всего объекта. В качестве исключения допускается не указывать цену объекта (в случае, если цена данного объекта является конфиденциальной информацией).

Атрибуты:
currency

Валюта

Возможные значения: USD, EUR, RUB или RUR
square Площадь объекта (число) в м2
description Описание объекта (символьные данные, максимальная длина 1000 символов). Текст описания объекта не должен быть написан ЗАГЛАВНЫМИ буквами. Не допускается указание контактной информации в описании объекта. Текст описания должен быть помещён внутрь конструкции CDATA. Пример:
<![CDATA[
Продается отдельно-стоящее здание офисного назначения площадью 753 кв.м,
класс B.
]]>
photo Список URL-адресов с фотографиями объекта в порядке их отображения (первое фото будет использоваться в списке объектов в соответствующем разделе, все последующие — на странице объекта). Возможно указание нескольких тегов (до 10). URL-адреса фотографий должны быть доступны по протоколу HTTP и иметь расширения jpg или png. На фото не должно быть каких-либо посторонних изображений (водяных знаков, логотипов и др.). Рекомендуемый размер изображений — 900x600 px, максимальный — 1200x800 px, минимальный — 570x380 px (изображения меньше максимального или больше максимального размера не будут загружены). В рамках одного объявления дубли изображений не принимаются. Как исключение, допускается публикация объектов без фото, но не более 10% от общего количества.
contacts

Элемент-контейнер, содержащий контактные данные по объекту. Допускается указывать только один набор контактов для каждого объекта.

Вложенные элементы:
email E-mail адрес для обратной связи
phone Контактные телефоны (допускается указание нескольких номеров через "точку с запятой")
name Контактное лицо
company

Наименование компании

Атрибуты:
status

Статус компании

Возможные значения: 0 - Собственник, 1 - Управляющая компания, 2 - Представитель собственника, 3 - Агентство недвижимости

Пример XML документа

<?xml version="1.0" encoding="utf-8" ?>
<commerce>
    <login email="example@mail.ru"/>
    <offer>
        <id>123</id>
        <contract_type>2</contract_type>
        <commerce_type>109</commerce_type>
        <address admin_area="1" locality="Москва" street="Верхняя Первомайская ул." house_str="7" lon="37.793624" lat="55.799254"/>
        <metro id="108" wtime="10"/>
        <price currency="USD">65000</price>
        <square>155</square>
        <description>
            <![CDATA[ Продается отдельно-стоящее здание офисного назначения площадью 155 кв.м, класс B. ]]>
        </description>
        <photo>http://lorempixel.com/output/city-q-c-900-600-1.jpg</photo>
        <photo>http://lorempixel.com/output/city-q-c-900-600-2.jpg</photo>
        <photo>http://lorempixel.com/output/city-q-c-900-600-3.jpg</photo>
        <photo>http://lorempixel.com/output/city-q-c-900-600-4.jpg</photo>
        <contacts>
            <company status="2">Наименование компании</company>
            <name>Владимир</name>
            <email>contact@mail.ru</email>
            <phone>+7 (123) 456-78-90; 8 (800) 543-76-98</phone>
        </contacts>
    </offer>
    <offer>
        <id>456</id>
        <contract_type>1</contract_type>
        <commerce_type>157</commerce_type>
        <address admin_area="1" locality="Москва" street="Шоссейная ул."/>
        <metro id="111" ttime="15"/>
        <price currency="RUB">9500</price>
        <square>370</square>
        <description>
            <![CDATA[ Собственник сдает в аренду отапливаемый склад в 10 минутах от метро Печатники, Текстильщики. Площадь склада 220 кв.м, площадь офиса (шоурума) 150 кв.м. ]]>
        </description>
        <photo>http://lorempixel.com/output/city-q-c-900-600-5.jpg</photo>
        <contacts>
            <email>contact@mail.ru</email>
            <phone>+7 (123) 456-78-90</phone>
        </contacts>
    </offer>
</commerce>

https://zdanie.info/sample_export.xml

подождите ...
HotLog