XML-формат импорта объявлений на Avito.ru

Служба поддержки автозагрузки
Тел.: +7 (812) 385-50-85
supportrealtyload@avito.ru
supportautoload@avito.ru
XML-формат импорта объявлений на Avito.ru
История изменений формата ..............................................................................................2
Автоматическая загрузка объявлений на сайт Avito.ru .......................................3
Вариант 1: электронная почта ............................................................................................................ 3
Вариант 2: страница загрузки ............................................................................................................. 3
Вариант 3: предоставление файла по ссылке ................................................................................... 3
Требования к XML-файлу .......................................................................................................4
Описание структуры и состава файла данных XML ................................................5
Общие положения .....................................................................................................................5
Общие атрибуты объявления ............................................................................................................. 5
Специфические атрибуты для категорий .......................................................................................... 5
Типы данных ........................................................................................................................................ 5
Идентификатор .................................................................................................................................... 5
Статус объявления ............................................................................................................................... 6
Даты экспозиции ................................................................................................................................. 6
Местоположение объявления ........................................................................................................... 6
Фотографии .......................................................................................................................................... 7
Общие атрибуты объявлений ...................................................................................................8
Атрибуты по категориям............................................................................................................9
Комнаты................................................................................................................................................ 9
Пример xml-объявления ................................................................................................................................ 9
Квартиры ............................................................................................................................................11
Пример xml-объявления .............................................................................................................................. 11
Дома, дачи, коттеджи .......................................................................................................................13
Пример xml-объявления .............................................................................................................................. 14
Земельные участки ............................................................................................................................15
Пример xml-объявления .............................................................................................................................. 15
Гаражи и стоянки ...............................................................................................................................17
Пример xml-объявления .............................................................................................................................. 17
Недвижимость за рубежом ..............................................................................................................18
Пример xml-объявления .............................................................................................................................. 19
Коммерческая недвижимость ..........................................................................................................20
Пример xml-объявления .............................................................................................................................. 21
Пример файла данных XML ................................................................................................ 23
Правила автоматической обработки объявлений ............................................... 24
Сроки экспозиции ....................................................................................................................24
Примечание .......................................................................................................................................24
Примеры.............................................................................................................................................24
Активация дополнительных платных услуг ...........................................................................24
Реакция на ошибки ..................................................................................................................25
Отчет ..........................................................................................................................................25
Справочники значений ........................................................................................................ 26
Справочник регионов ........................................................................................................................26
Справочник городов ..........................................................................................................................26
Справочник метро .............................................................................................................................26
Справочник стран ..............................................................................................................................26
История изменений формата
2012-09-18
Описание варианта загрузки предоставление файла по ссылке
2012-08-31
Описание используемых типов данных
2012-05-03
Дано пояснение к значениям статусов объявлений, описаны правила активации
услуг.
2012-04-19
Изменен список значений для элемента AdStatus (статус объявления), добавлено его
описание
2012-04-07
Изменено значение по умолчанию для даты окончания экспозиции (Даты
экспозиции).
2
Автоматическая загрузка объявлений на сайт Avito.ru
Для того чтобы загрузить рекламные объявления недвижимости на сайт Avito, нужно:
Вариант 1: электронная почта
1) Составить xml-файл по описанным ниже Требованиям к XML-файлу
2) Создать e-mail сообщение, приложив к нему xml-файл. Если в одном из объявлений Вы
указали ссылку на файлы изображений во вложениях, то эти файлы тоже необходимо
приложить к письму.
3) Осуществить отправку e-mail сообщения на адрес realtyload@avito.ru. Сообщение
должно отправляться с адреса, согласованного с AVITO.
Письмо будет автоматически обработано роботом приёма объявлений по недвижимости для
AVITO.ru, а на электронный адрес отправителя поступит отчет о статусе загрузки объявления.
Подробнее порядок обработки электронных писем с заявками описан в разделе Правила
автоматической обработки объявлений.
Вариант 2: страница загрузки
1) Составить xml-файл по описанным ниже Требованиям к XML-файлу
2) Загрузить этот xml-файл с помощью страницы автоматической загрузки на сайте авито:
http://realtyload.avito.ru/
3) При необходимости загрузить на этой же странице картинки для объявлений,
запаковав их в один архив.
Загруженный файл будет автоматически обработан роботом приёма объявлений по
недвижимости для AVITO.ru. Отчет об обработке можно посмотреть на той же странице.
Внимание! Для того чтобы осуществлять автоматический импорт рекламных объявлений,
необходимо предварительно согласовать эту возможность. Для этого обратитесь в отдел продаж
AVITO.ru и укажите, что хотели бы загружать объявления с помощью автоматического импорта.
Вариант 3: предоставление файла по ссылке
1) Составить xml-файл по описанным ниже Требованиям к XML-файлу
2) Выложить этот файл на свой сервер, так чтобы этот файл можно было получить по
протоколу HTTP
3) Предоставить ссылку на этот файл своему менеджеру в авито.
Выложенный файл будет забираться по предоставленной ссылке не реже раза в день и после
этого обрабатываться, отчет о чем можно посмотреть в личном кабинете. Можно изменять
содержимое файла, однако ссылка на него должна оставаться постоянной.
3
Требования к XML-файлу
Файл данных XML содержит описание рекламных объявлений, предназначенных для подачи на
сайт AVITO.ru. Файл данных должен:


Иметь кодировку UTF-8.
Файл данных XML должен быть правильно построенным (well-formed), то есть, иметь
правильный синтаксис, и действительным (valid), то есть, соответствовать определенному
ниже Описанию структуры и состава файла данных XML.
4
Описание структуры и состава файла данных XML
Общие положения
Файл данных обязательно должен содержать корневой элемент Ads с атрибутами target="Avito.ru"
и formatVersion="1".
Корневой элемент Ads может содержать одно или несколько объявлений, каждое из которых
должно быть описано элементом Ad.
Имена элементов чувствительны к регистру и состоят из английских букв.
Общие атрибуты объявления
Для всех объявлений существует неизменный набор атрибутов, вне зависимости от типа
объявления. Данные атрибуты описаны в разделе Общие атрибуты для всех категорий.
Специфические атрибуты для категорий
Каждый тип объявлений выделен в отдельную категорию. Категория объявления указывается
элементом Category внутри каждого элемента Ad. В зависимости от категории к заполнению
данных объявления предъявляются разные требования к набору специфических атрибутов. Эти
требования представлены в таблицах атрибутов по категориям, см. Атрибуты по категориям.
Типы данных
В описании атрибутов приняты следующие обозначения типов данных:





Строка — произвольная последовательность символов, возможные ограничения по длине
указываются рядом.
Строка, одно из перечисленных значений — в атрибуте требуется указать строковое
значение, одно из возможных значений, перечисленных рядом.
Integer — целое число
Decimal — число с дробной частью. Целая и дробная части разделяются точкой.
Дата — дата в формате ISO 8601 для дат: ГГГГ-MM-ДД, например, 2013-03-31, 2014-12-18.
Идентификатор
Каждое объявление должно обязательно иметь элемент Id, в котором содержится уникальный
идентификатор объявления в вашей базе. У одного и того же объявления в разных письмах
должен быть один и тот же идентификатор, у разных объявлений — разные. Идентификатором
может быть любая строка до 100 символов, например:
 простой номер объявления: 52, 1181
 составной номер объявления: 1-515, 10_9023
 составной буквенно-цифровой номер: АБ-23, XYZ-817
 GUID объявления: BCF55961-FE70-4374-A918-E26E778BE6DF
 другие варианты.
5
Статус объявления
Объявление может иметь элемент AdStatus, в котором содержится информация о платной услуге,
которую нужно применить к объявлению. Если элемент пуст или отсутствует, то статус объявления
по умолчанию — Обычное (Free). Элемент AdStatus может иметь следующие значения:







Free — обычное объявление
Premium — премиум объявление
VIP — VIP объявление
Highlight — выделенное объявление
PushUp — поднятие объявления
QuickSale — применение пакета "Быстрая продажа"
TurboSale — применение пакета "Турбо продажа"
Правила применения услуг описаны в разделе Активация дополнительных платных услуг.
Даты экспозиции
Если дата начала экспозиции не указана, началом считается день приема объявления. Если дата
окончания экспозиции не указана, концом считается конец 30-го дня, начиная с даты начала
экспозиции, т.е. объявление получается на 30 дней.
Дата окончания включается в срок экспозиции, т.е. окончанием экспозиции считается конец дня,
указанного этой датой.
Даты указываются в формате ISO 8601 для дат: ГГГГ-MM-ДД, например, 2013-03-31, 2014-12-18.
Часовой пояс, в котором указываются даты, считается одним для всех объявлений от одного
клиента и принимается по согласованию с клиентом.
Местоположение объявления
Местоположение объекта объявления (за исключением категории «Недвижимость за рубежом»)
указывается с помощью элементов Region, City, Locality и Street.
В элементе Region указывается регион России из справочника регионов. Далее в элементе City
указывается населенный пункт из справочника городов в соответствии с указанным ранее
регионом. Этот справочник содержит далеко не все города, поэтому если требуемый населенный
пункт там отсутствует, то указывается ближайший к вашему объекту, а само название населенного
пункта, где находится объект, указывается в элементе Locality. В поле Street указывается улица и
опционально номер дома.
City не указывается для регионов Москва и Санкт-Петербург.
6
Фотографии
Фотографии для объявления указываются внутри элемента Images, по одному элементу Image на
каждую фотографию. На файл изображения можно ссылаться следующим образом.

Передать вместе с xml-файлом с данными. В элементе Image именем файла заполняется
атрибут name. Пример:
<Image name="a3.jpg"/>

Передать в виде ссылки на ресурс в интернете. В элементе Image ссылкой на фото
заполняется атрибут url. Пример:
<Image url="http://img.industry-soft.ru/591F0E40-2238-48DB-8F7B4A4F3A0F2BA1.jpg"/>
Указание обоих атрибутов не допускается.
Для каждой категории определено максимальное количество фотографий, которые можно
прикрепить к объявлению. Все фотографии свыше этого количества игнорируются.
7
Общие атрибуты объявлений
Название
элемента
Id
Category
Описание
Уникальный
идентификатор
объявления
см. Идентификатор
Категория объявления
DateBegin
Дата начала
экспозиции
объявления
DateEnd
Дата конца экспозиции
объявления
Region
Регион, в котором
находится объект
объявления.
Город или населенный
пункт, в котором
находится объект
объявления
см. Местоположение
объявления
City
Subway
Станция метро
Description
Описание
Price
Цена в рублях
ContactPhone
Контактный телефон,
если не указан,
подставляется из
данных клиента.
Статус объявления
AdStatus
Обязательное
Возможные значения
параметра
+
+
+
+
Тип данных
и ограничения
строка не более 100
символов
Значение категории
из списка (см.
Специфические
атрибуты)
Значение из
Справочника
регионов
Значение из
Справочника городов
(в соответствии с
выбранным
регионом).
строка, одно из
перечисленных
значений
Дата в формате
ГГГГ-MM-ДД
см. Даты
экспозиции
Дата в формате
ГГГГ-MM-ДД
см. Даты
экспозиции
строка, одно из
перечисленных
значений
строка, одно из
перечисленных
значений
Значение из
Cправочника метро
(в соответствии с
выбранным городом)
строка не более
1000 символов
decimal
строка, содержащая
от 5 до 13 цифр
Free
Premium
VIP
Highlight
PushUp
QuickSale
TurboSale
8
Атрибуты по категориям
Комнаты
Название
элемента
Category
OperationType
Locality
Street
SaleRooms
Rooms
Square
Описание
Категория объекта
недвижимости
Тип объявления
Город или населенный
пункт, уточнение.
Наименование улицы,
на которой находится
объект объявления
Количество комнат на
продажу / сдающихся
Количество комнат в
квартире
Площадь комнаты
(в м.кв.)
Обязательное
Возможные значения
параметра
Тип данных
и ограничения
+
Комнаты
строка
+
Продам
Сдам
строка, одно из
перечисленных
значений
строка
строка
+
integer
+
integer
+
decimal
Если продается/сдается
несколько комнат,
указывается их суммарная
площадь
Floor
Floors
Этаж, на котором
находится объект
Количество этажей в
доме
HouseType
Тип дома
LeaseType
Тип аренды,
только для типа
"Сдам"
Фотографии объекта
см. Фотографии
Images
integer
integer
Кирпичный
Панельный
Блочный
Монолит
Деревянный
Долгосрочная
Посуточная
вложенные
элементы Image
строка, одно из
перечисленных
значений
строка, одно из
перечисленных
значений
принимается
максимум 10 фото
Пример xml-объявления
<?xml version="1.0"?>
<Ads target="Avito.ru" formatVersion="1">
<Ad>
<Id>14</Id>
<Category>Комнаты</Category>
<OperationType>Сдам</OperationType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-07</DateEnd>
9
<Region>Ленинградская область</Region>
<City>Сертолово</City>
<Street>ул. Молодцова</Street>
<SaleRooms>1</SaleRooms>
<Rooms>3</Rooms>
<Square>20</Square>
<Floor>2</Floor>
<Floors>2</Floors>
<HouseType>Панельный</HouseType>
<Description>Сдаётся комната в отличной 3-х комнатной квартире
с хорошим ремонтом 56.6кв.м в микрорайоне Чёрная речка города
Сертолово. Крупнопанельный дом (коттедж), ст\пак., комнаты
изолированные, санузел раздельный в кафеле, застеклённый балкон.
Чистая парадная с большими лестничными проёмами. Большая
прихожая.</Description>
<ContactPhone>8 (911) 123-44-55</ContactPhone>
<Price>10000</Price>
<Images>
<Image name="Сертолово1.jpg"></Image>
<Image name="Сертолово2.jpg"></Image>
<Image name="Сертолово3.jpg"></Image>
<Image name="Сертолово4.jpg"></Image>
</Images>
<AdStatus>Premium</AdStatus>
</Ad>
<Ad>
<Id>К137</Id>
<Category>Комнаты</Category>
<OperationType>Продам</OperationType>
<!-- DateBegin и DateEnd не указаны - объявление будет
показано в течение 30 дней, начиная со дня приёма -->
<Region>Санкт-Петербург</Region>
<Subway>Парк Победы</Subway>
<SaleRooms>2</SaleRooms>
<Rooms>3</Rooms>
<Floor>3</Floor>
<Floors>5</Floors>
<HouseType>Кирпичный</HouseType>
<Square>25.5</Square>
<Description>Продаются 2 комнаты в 3-комнатной кв. Дом кирпичная хрущевка, вход со двора, окна на зеленый двор, сделан
ремонт, есть телефон, пол - паркет, с/у - раздельный, ванна отдельная.
Светлая комната, квадратная. 1 сосед - молодой человек, квартира
чистая, стеклопакеты. Зеленый двор, школа и детский сад рядом.
торг</Description>
<ContactPhone>293 45 45</ContactPhone>
<Price>2400000</Price>
<Images>
<Image url="http://img.industry-soft.ru/591F0E40-223848DB-8F7B-4A4F3A0F2BA1.jpg"></Image>
<Image url="http://img.industry-soft.ru/8F81612B-57424492-9CF3-ECF9DCBA0172.jpg"></Image>
<Image url="http://img.industry-soft.ru/95B5B3DA-2FCC4126-9CD0-BA0B1A000313.jpg"></Image>
</Images>
<AdStatus>Free</AdStatus>
</Ad>
</Ads>
10
Квартиры
Название
элемента
Category
OperationType
Locality
Street
Rooms
Описание
Категория объекта
недвижимости
Тип объявления
Город или населенный
пункт, уточнение.
Наименование улицы,
на которой находится
объект объявления
Количество комнат в
квартире
Обязательное
Возможные значения
параметра
+
Квартиры
+
Продам
Сдам
текст
текст
+
Студия
или целое число
Для квартиры-студии
укажите Студия.
Square
Floor
Общая площадь
квартиры (в м.кв.)
Этаж, на котором
находится объект
Floors
Количество этажей в
доме
HouseType
Тип дома
MarketType
Принадлежность
квартиры к рынку
новостроек или
вторичному,
только для типа
"Продам"
Тип аренды,
только для типа
"Сдам"
Фотографии объекта
см. Фотографии
LeaseType
Images
Тип данных
и ограничения
+
Текст «Студия»
или целое число
(integer)
decimal
integer
integer
+
+
Кирпичный
Панельный
Блочный
Монолит
Деревянный
Вторичка
Новостройка
строка, одно из
перечисленных
значений
Долгосрочная
Посуточная
строка, одно из
перечисленных
значений
принимается
максимум 20 фото
строка, одно из
перечисленных
значений
Пример xml-объявления
<?xml version="1.0"?>
<Ads target="Avito.ru" formatVersion="1">
<Ad>
<Id>5412</Id>
<Category>Квартиры</Category>
<OperationType>Сдам</OperationType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
11
<Region>Ленинградская область</Region>
<City>Левашово</City>
<Locality>Юкки</Locality>
<Street>Яблоневая</Street>
<Rooms>2</Rooms>
<Square>50</Square>
<Floor>1</Floor>
<Floors>2</Floors>
<HouseType>Панельный</HouseType>
<LeaseType>Долгосрочная</LeaseType>
<Description>Крупно-панельный дом (г.п. 2007); вход с улицы,
окна на улицу и во двор, с/у - совмещенный, 2-х комн. квартира. Дом
находится в живописном месте, пруд с форелью, лес, ягоды, грибы,
удобная транспортное сообщение с СПб, вся инфраструктура, хороший
подъезд круглый год.</Description>
<ContactPhone>921-25-55</ContactPhone>
<Price>20000</Price>
<Images>
<Image name="a1.jpg"/>
<Image name="a2.jpg"/>
<Image name="a3.jpg"/>
<Image name="a4.jpg"/>
</Images>
<AdStatus>Free</AdStatus>
</Ad>
<Ad>
<Id>5308</Id>
<Category>Квартиры</Category>
<OperationType>Продам</OperationType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Санкт-Петербург</Region>
<Street>Энгельса просп 93</Street>
<Subway>Удельная</Subway>
<Rooms>3</Rooms>
<Square>161.7</Square>
<MarketType>Вторичка</MarketType>
<Description>Элитный жилой комплекс «Живой родник». Неподалеку
находятся Поклонная гора, Сосновский лесопарк и Суздальские озера.
Квартира с удобной, современной планировкой, удовлетворяет всем
требованиям комфорта и качества. Очень светлая кухня-СТОЛОВАЯ 32,3
кв.м за счет трех окон с видом на водоем во дворе. Спальня правильной
планировки с двумя окнами с видом на парк Сосновка. Согласно
планировки в квартире 3 (три) ГАРДЕРОБНЫЕ, 2 с/у и просторная ГОСТИНАЯ
с кабинетом 54 кв.м. В комплексе есть подземные гаражи. Закрытая
охраняемая территория комплекса с видеонаблюдением, в середине
которого расположено чистое озеро. В подъезде консьерж. На территории
комплекса расположена бесплатная охраняемая парковка. В собственности
квартира более 3-х лет. Документы готовы к прямой продаже. Комплекс
«Живой Родник» построен в одном из экологически чистых районов СанктПетербурга – у подножия Поклонной горы, рядом со станциями метро
«Удельная» и «Озерки».</Description>
<ContactPhone>+7 (905) 207-04-90</ContactPhone>
<Price>13800000</Price>
<Images>
<Image url="http://img.industry-soft.ru/591F0E40-223848DB-8F7B-4A4F3A0F2BA1.jpg"/>
<Image url="http://img.industry-soft.ru/8F81612B-574212
4492-9CF3-ECF9DCBA0172.jpg"/>
<Image url="http://img.industry-soft.ru/95B5B3DA-2FCC4126-9CD0-BA0B1A000313.jpg"/>
</Images>
<AdStatus>Premium</AdStatus>
</Ad>
</Ads>
Дома, дачи, коттеджи
Название
элемента
Category
OperationType
Locality
Описание
Категория объекта
недвижимости
Тип объявления
Обязательное
Возможные значения
параметра
+
Дома, дачи,
коттеджи
Продам
Сдам
+
Square
Город или населенный
пункт, уточнение.
Наименование улицы,
на которой находится
объект объявления
Площадь дома в м. кв.
+
ObjectType
Вид объекта
+
LandArea
Площадь земли в
сотках
Расстояние до города в
км.
Примечание:
значение 0 означает,
что объект
находится в черте
города.
Материал стен
Street
DistanceToCity
WallsType
LeaseType
Images
Тип аренды
только для типа
"Сдам"
Фотографии объекта
см. Фотографии
Тип данных
и ограничения
текст
текст
decimal
Коттедж
Таунхаус
Дом
Дача
строка, одно из
перечисленных
значений
decimal
integer
+
Кирпич
Брус
Бревно
Металл
Пеноблоки
Сэндвич-панели
Ж/б панели
Экспериментальные
материалы
Долгосрочная
Посуточная
строка, одно из
перечисленных
значений
строка, одно из
перечисленных
значений
принимается
максимум 20 фото
13
Пример xml-объявления
<?xml version="1.0"?>
<Ads target="Avito.ru" formatVersion="1">
<Ad>
<Id>30154</Id>
<Category>Дома, дачи, коттеджи</Category>
<OperationType>Сдам</OperationType>
<ObjectType>Дом</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Ленинградская область</Region>
<City>Сестрорецк</City>
<Locality>п.Александровское</Locality>
<Street>Тарховская</Street>
<Square>90</Square>
<LandArea>3.8</LandArea>
<DistanceToCity>20</DistanceToCity>
<WallsType>Кирпич</WallsType>
<LeaseType>Долгосрочная</LeaseType>
<Description>Курортный район. до ж/д станции Александровская 5
минут пешком. До Разлива 10 минут пешком. Красивая природа, тихо.
Двухэтажный дом 60кв. м, два входа. В доме, на первом этаже: кухня
13кв. м, холл 11кв. м, спальня 15кв. м, открытая веранда. На втором
этаже: спальня 14кв. м, терраса. Мебель сборная 95-2000-ых годов.
Плита - газ (баллон). Участок 3,8 сотки, квадратный, разработан .На
участке плодовые деревья, ягодные кусты, парник, площадка для
автомобиля.</Description>
<ContactPhone>985-34-12</ContactPhone>
<Price>52000.00</Price>
<Images>
<Image name="IMG_0224.JPG"/>
<Image name="IMG_0301.JPG"/>
<Image name="IMG_0455.JPG"/>
<Image name="IMG_0502.JPG"/>
</Images>
<AdStatus>Premium</AdStatus>
</Ad>
<Ad>
<Id>30176</Id>
<Category>Дома, дачи, коттеджи</Category>
<OperationType>Продам</OperationType>
<ObjectType>Коттедж</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Ленинградская область</Region>
<City>Пушкин</City>
<Street>Восточная</Street>
<Square>280</Square>
<LandArea>12</LandArea>
<DistanceToCity>25</DistanceToCity>
<WallsType>Брус</WallsType>
<Description>Продается двухэтажный коттедж с мансардой в
Пушкинском районе города. Поселок активно развивается, до метро
Московская 15 мин транспортом. Дом общей площадью 280 кв. м. на
участке 12 соток, расчитан на две семьи. Выполнен по Шведской
технологии с применением экологически чистых, теплосберегающих
материалов, подготовлен под отделку, симметричная планировка.
14
Городская прописка. ПРЯМАЯ ПРОДАЖА</Description>
<ContactPhone>+7 (911) 247-04-11</ContactPhone>
<Price>6650000</Price>
<Images>
<Image url="http://img.industry-soft.ru/591F0E40-223848DB-8F7B-4A4F3A0F2BA1.jpg"/>
<Image url="http://img.industry-soft.ru/8F81612B-57424492-9CF3-ECF9DCBA0172.jpg"/>
<Image url="http://img.industry-soft.ru/95B5B3DA-2FCC4126-9CD0-BA0B1A000313.jpg"/>
</Images>
<AdStatus>Free</AdStatus>
</Ad>
</Ads>
Земельные участки
Название
элемента
Описание
Обязательное
Возможные значения
параметра
Тип данных
и ограничения
Category
Категория объекта
недвижимости
+
Земельные участки
OperationType
Тип объявления
+
Продам
Locality
Город или населенный
пункт, уточнение.
текст
Street
Наименование улицы,
на которой находится
объект объявления
Площадь участка в
сотках
текст
LandArea
+
ObjectType
Вид земельного
участка
+
DistanceToCity
Расстояние до города в
км
Примечание:
значение 0 означает,
что объект
находится в черте
города.
Фотографии объекта
см. Фотографии
+
Images
decimal
Поселений (ИЖС)
Сельхозназначения
(СНТ, ДНП)
Промназначения
строка, одно из
перечисленных
значений
integer
принимается
максимум 5 фото
Пример xml-объявления
<?xml version="1.0"?>
<Ads target="Avito.ru" formatVersion="1">
15
<Ad>
<Id>УЧ135-10</Id>
<Category>Земельные участки</Category>
<OperationType>Продам</OperationType>
<ObjectType>Поселений (ИЖС)</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Ленинградская область</Region>
<City>Приозерск</City>
<Locality>пос. Сосново</Locality>
<LandArea>10</LandArea>
<DistanceToCity>80</DistanceToCity>
<Description>Участок в поселке с развитой инфраструктурой.
ИЖС. Подведено электричество (15 кВт). В 300 метрах озеро, лес. Пляж в
1.5 км. Хорошее транспортное сообщение с С-Пб. Тихое экологически
чистое место. Рядом горнолыжный курорт «ИГОРА». Возможен
торг!</Description>
<ContactPhone>(81379)37835</ContactPhone>
<Price>950000</Price>
<Images>
<Image url="http://img.industry-soft.ru/591F0E40-223848DB-8F7B-4A4F3A0F2BA1.jpg"/>
<Image url="http://img.industry-soft.ru/95B5B3DA-2FCC4126-9CD0-BA0B1A000313.jpg"/>
</Images>
<AdStatus>Premium</AdStatus>
</Ad>
<Ad>
<Id>УЧ137-15</Id>
<Category>Земельные участки</Category>
<OperationType>Продам</OperationType>
<ObjectType>Поселений (ИЖС)</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Санкт-Петербург</Region>
<Subway>Ладожская</Subway>
<Locality>Янино-2</Locality>
<LandArea>15</LandArea>
<DistanceToCity>10</DistanceToCity>
<Description>Земельный участок ИЖС Всеволожский р-н, Янино-2,
12 сот, подъезд-асфальт. Подключено (оплачено) 9квт эл-ва. Городской
водопровод (есть ТУ), газ (есть ТУ), телефон - все по границе участка.
Собственность. 20 мин до Пл. Восстания на а/м. Торг.</Description>
<ContactPhone>+7 (911) 247-04-11</ContactPhone>
<Price>3400000</Price>
<Images>
<Image name="1.JPG"/>
<Image name="2.JPG"/>
<Image name="4.JPG"/>
<Image name="10.JPG"/>
</Images>
<AdStatus>Free</AdStatus>
</Ad>
</Ads>
16
Гаражи и стоянки
Название
элемента
Описание
Обязательное
Возможные значения
параметра
Тип данных
и ограничения
Category
Категория объекта
недвижимости
+
Гаражи и стоянки
OperationType
Тип объявления
+
Продам
Сдам
Locality
Город или населенный
пункт, уточнение.
текст
Street
текст
Square
Наименование улицы,
на которой находится
объект объявления
Площадь в кв. м.
+
ObjectType
Вид объекта
+
Images
Фотографии объекта
см. Фотографии
decimal
Гараж
Машиноместо
строка, одно из
перечисленных
значений
принимается
максимум 5 фото
Пример xml-объявления
<?xml version="1.0"?>
<Ads target="Avito.ru" formatVersion="1">
<Ad>
<Id>51</Id>
<Category>Гаражи и стоянки</Category>
<OperationType>Сдам</OperationType>
<ObjectType>Гараж</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Санкт-Петербург</Region>
<Subway>Парк Победы</Subway>
<Street>Витебский 16</Street>
<Square>20</Square>
<Description>Сдам бетонный гараж.
Отделка вагонкой, вентиляция, 220в, открытый стеллаж, хорошая охрана,
на подъездах везде ровный асфальт, зимой регулярная уборка снега.
Состояние гаража - отличное.</Description>
<ContactPhone>8 911 521-89-14</ContactPhone>
<Price>2000</Price>
<Images>
<Image url="http://img.industry-soft.ru/591F0E40-223848DB-8F7B-4A4F3A0F2BA1.jpg"/>
<Image url="http://img.industry-soft.ru/95B5B3DA-2FCC4126-9CD0-BA0B1A000313.jpg"/>
</Images>
<AdStatus>Premium</AdStatus>
</Ad>
17
<Ad>
<Id>17</Id>
<Category>Гаражи и стоянки</Category>
<OperationType>Продам</OperationType>
<ObjectType>Гараж</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Ленинградская область</Region>
<City>Гатчина</City>
<Locality>Малое Верево</Locality>
<Square>18</Square>
<Description>Продам металический гараж, удобное
расположение,сухой,обшит,пол деревянный,торг уместен</Description>
<ContactPhone>+7(812)476 44 77</ContactPhone>
<Price>70000</Price>
<Images>
<Image name="1.JPG"/>
<Image name="2.JPG"/>
<Image name="3.JPG"/>
<Image name="4.JPG"/>
</Images>
<AdStatus>Free</AdStatus>
</Ad>
</Ads>
Недвижимость за рубежом
Название
элемента
Описание
Обязательное
Возможные значения
параметра
Category
Категория объекта
недвижимости
+
Недвижимость за
рубежом
OperationType
Тип объявления
+
Продам
Сдам
Country
Страна, в которой
находится объект
объявления
Населенный пункт,
рядом с которым
находится объект
объявления
Количество комнат в
квартире
+
Значение из
справочника стран
Square
Площадь в кв. м.
+
ObjectType
Вид объекта
+
Locality
Rooms
Тип данных
и ограничения
текст
integer
decimal
Квартира, апартаменты
Дом, вилла
Другое
строка, одно из
перечисленных
значений
18
LeaseType
Images
Тип аренды,
только для типа
"Сдам"
Фотографии объекта
см. Фотографии
Долгосрочная
Посуточная
строка, одно из
перечисленных
значений
принимается
максимум 10 фото
Пример xml-объявления
<?xml version="1.0"?>
<Ads target="Avito.ru" formatVersion="1">
<Ad>
<Id>38</Id>
<Category>Недвижимость за рубежом</Category>
<OperationType>Продам</OperationType>
<ObjectType>Квартира, апартаменты</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Country>Болгария</Country>
<Locality>Приморско</Locality>
<Region>Москва</Region>
<Subway>Сокол</Subway>
<Rooms>1</Rooms>
<Square>40</Square>
<Description>В собственности с 2010г,акт 16, с мебелью
,кухонным уголком,балкон,окна на улицу, 300 м до пляжа(2 пляжа
северный и южный). Комплекс состоит из двух зданий, имеются также
бассейн, ресторан, фитнес, массаж, румсервис, бар, детская площадка и
бассейн, места отдыха, магазины, панорамный балкон, настольный теннис,
велосипеды, автостоянка и ряд развлекательных удобств располагаются на
территории общей площадью в 2500 кв.м.</Description>
<ContactPhone>+7 (495) 389-89-14</ContactPhone>
<Price>990000</Price>
<Images>
<Image url="http://img.industry-soft.ru/591F0E40-223848DB-8F7B-4A4F3A0F2BA1.jpg"/>
<Image url="http://img.industry-soft.ru/95B5B3DA-2FCC4126-9CD0-BA0B1A000313.jpg"/>
</Images>
<AdStatus>Premium</AdStatus>
</Ad>
<Ad>
<Id>19</Id>
<Category>Недвижимость за рубежом</Category>
<OperationType>Сдам</OperationType>
<ObjectType>Квартира, апартаменты</ObjectType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Country>Хорватия</Country>
<Region>Москва</Region>
<Rooms>3</Rooms>
<Square>47</Square>
<Description>Апартаменты в аренду в 100 м от пляжа в красивом
месте.
-спальня с двуспальной кроватью;
-ванная комната с душевой кабиной;
-кухня с гостиной и столовой (в гостиной раскладной диван);
-терраса с видом на море;
19
-спутниковое телевидение;
-интернет;
-телефон;
-кондиционер.
msk@rentcroatia.ru</Description>
<ContactPhone>980 44 77</ContactPhone>
<Price>2100</Price>
<Images>
<Image name="03.JPG"/>
<Image name="07.JPG"/>
<Image name="11.JPG"/>
<Image name="24.JPG"/>
</Images>
<AdStatus>Free</AdStatus>
</Ad>
</Ads>
Коммерческая недвижимость
Название
элемента
Описание
Обязательное
Возможные значения
параметра
Тип данных
и ограничения
Category
Категория объекта
недвижимости
+
Коммерческая
недвижимость
ObjectType
Вид объекта
+
Магазин
Офис
Производство
Склад
Ресторан, кафе
Салон красоты
Другое
строка, одно из
перечисленных
значений
BusinessForSale
Объект является
готовым бизнесом
Только для типа
"Продам"
Тип объявления
Да
Нет
строка, одно из
перечисленных
значений
OperationType
+
Продам
Сдам
Locality
Город или населенный
пункт, уточнение.
текст
Street
Наименование улицы,
на которой находится
объект объявления
текст
20
Square
Площадь помещения в
м.кв.
Images
Фотографии объекта
см. Фотографии
+
decimal
принимается
максимум 10 фото
Пример xml-объявления
<?xml version="1.0"?>
<Ads target="Avito.ru" formatVersion="1">
<Ad>
<Id>26</Id>
<Category>Коммерческая недвижимость</Category>
<ObjectType>Склад</ObjectType>
<OperationType>Сдам</OperationType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Московская область</Region>
<City>Жуковский</City>
<Square>700</Square>
<Description>Сдаётся складское помещение 700 м2 в Жуковском.
Потолки - 12 м, стеллажи, 5 автоматич. откатных ворот, охрана,
видеонаблюдение,пожарная сигнализация, полный комплекс услуг (отв.
хранение, сортировка, погрузочно-разгрузочн. работы, транспорт.
компания.). Офисные помещения. Интернет, МГТС.</Description>
<ContactPhone>8-921-655-23-03</ContactPhone>
<Price>294000</Price>
<Images>
<Image url="http://img.industry-soft.ru/591F0E40-223848DB-8F7B-4A4F3A0F2BA1.jpg"/>
<Image url="http://img.industry-soft.ru/95B5B3DA-2FCC4126-9CD0-BA0B1A000313.jpg"/>
</Images>
<AdStatus>Free</AdStatus>
</Ad>
<Ad>
<Id>48</Id>
<Category>Коммерческая недвижимость</Category>
<ObjectType>Магазин</ObjectType>
<OperationType>Продам</OperationType>
<DateBegin>2012-05-01</DateBegin>
<DateEnd>2012-05-14</DateEnd>
<Region>Москва</Region>
<Subway>Алтуфьево</Subway>
<Square>80</Square>
<Street>9-я Северная линия</Street>
<Description>Продам помещение в новом районе "Северный" под
размещение торговли (продовольственный и непродовольственный магазин)
в Москве на ул. 9-я Северная линия. Дом 2007 года постройки. Помещение
расположено на 1-м этаже 17-ти этажного панельного дома. Высота
потолков 2,65 м, площадь 79,9 кв.м. Имеется 2 входа.</Description>
<ContactPhone>8 (926) 601-18-81</ContactPhone>
<Price>900000</Price>
<Images>
<Image name="1.JPG"/>
<Image name="2.JPG"/>
21
<Image name="4.JPG"/>
<Image name="10.JPG"/>
</Images>
<AdStatus>Premium</AdStatus>
</Ad>
</Ads>
22
Пример файла данных XML
Пример XML-описания объявлений находится в файле avito_realty_example.xml.
23
Правила автоматической обработки объявлений
Объявления для автоматического размещения принимаются только от клиентов AVITO.ru,
согласовавших эту возможность. Для этого нужно заключить договор и заполнить анкету из его
приложения. В анкете нужно указать свой адрес, с которого будет осуществляться отправка
данных для загрузки. Объявления, пришедшие с незарегистрированных адресов e-mail, будут
проигнорированы.
Сроки экспозиции
Для каждого объявления можно (но не обязательно) указывать диапазон дат от (DateBegin) и до
(DateEnd), когда это объявление будет показано — это позволяет точно управлять периодом
показа объявления. Если даты не указаны, для даты начала и срока выбираются значения по
умолчанию, подробнее в разделе Даты экспозиции.
Даты экспозиции можно изменить в любой момент, прислав в очередном файле с объявлениями
другие даты. Можно остановить объявление раньше даты окончания, не указав его в очередном
письме с объявлениями.
Примечание
Указывайте сроки экспозиции, если у вас есть для них значения, например, если в вашей учетной
системе имеется дата окончания для объявления, или пользователь системы может указать сроки,
когда нужно показывать объявление.
Укажите дату начала показа, чтобы объявление не начало показываться раньше этой даты.
Укажите дату окончания показа, чтобы объявление не показывалось позже этой даты.
В остальных случаях подойдут значения по умолчанию.
Примеры



Если корневой элемент Ads не содержит вложенных элементов Ad, это означает, что все
поданные ранее объявления от владельца магазина на AVITO необходимо снять с
продажи на сайте.
Если необходимо остановить показ только некоторых объявлений, достаточно произвести
повторную передачу данных в письме, при этом удалив из xml-файла данные о ненужных
объявлениях. В этом случае объявления, поданные ранее, но не указанные в последнем
xml-файле, будут удалены с сайта.
Если не требуется менять состав и данные объявлений на сайте, можно не присылать
очередное письмо. Ранее поданные заявки продолжат показываться согласно указанным
периодам показа.
Активация дополнительных платных услуг
Если у объявления указан статус, отличный от Free, при его выгрузке на AVITO дополнительно
активируется платная услуга. Для успешного применения платной услуги необходимо наличие
денег на счету. Если денег на счету недостаточно для применения услуги, объявление
выгружается как обычное (Free).
24
Каждая платная услуга применяется не чаще чем один раз в определенный период: для услуг
Premium, VIP, Highlight, QuickSale, TurboSale это раз в 7 дней, для PushUp — раз в 2 дня. После того
как услуга активирована, объявление выгружается как обычное, пока не пройдет этот период и не
закончится действие этой услуги на сайте, после чего услуга может быть активирована повторно,
если статус объявления все еще отличается от Free.
Разные услуги для одного объявления активируются независимо друг от друга: одна услуга может
быть активирована, пока еще не закончился срок действия другой.
Реакция на ошибки
Если робот импорта обнаружит в файле XML ошибки (например, структура файла не соответствует
требуемой), то импорт объявлений осуществлён не будет, а отправителю придёт отчет о
неудачной загрузке объявлений.
Если робот импорта обнаружит в одном из объявлений какие-либо ошибки (например,
отсутствуют обязательные поля объявления), то импорт такого объявления осуществлён не будет,
а отправителю придёт отчет о неудачной загрузке объявления. В то же время, все правильно
описанные объявления из этого файла будут выгружены на сайт.
Если робот импорта обнаружит объявления, содержащие ссылки на изображения, но сами
изображения найдены им не будут, то такие объявления попадут на сайт без изображений.
Отчет
После каждой автоматической загрузки объявлений владельцу магазина на AVITO будет выслан
на электронную почту отчет о загрузке объявлений, содержащий подробную информацию о
принятых и ошибочных объявлениях.
25
Справочники значений
Справочник регионов
Список возможных значений регионов находится в файле dict_locations.xls, раздел «Справочник
регионов».
Справочник городов
Список возможных значений городов, разбитых по регионам, находится в файле dict_locations.xls,
раздел «Справочник городов».
Справочник метро
Список возможных значений городов, разбитых по регионам, находится в файле dict_locations.xls,
раздел «Справочник городов».
Справочник стран
Список возможных названий стран находится в файле dict_realty_countries.xls.
26