XML-импорт объявлений на SLANET.by | Беларусь

Вы гость | войти | регистрация
Беларусь - Доска объявлений городов Беларуси. Бесплатные частные и коммерческие объявления
Беларусь
найти в объявлениях или в товарах например, детская коляска в Витебске
SLANET > XML-импорт объявлений на SLANET.by

Пакетная загрузка (импорт) объявлений на сайт SLANET.by


Мы предоставляем две возможности для импорта рекламных объявлений тематики "недвижимость":

Вариант 1: страница загрузки

  • 1) Составить xml-файл по стандарту, описанному далее в "Требования к XML-файлу"
  • 2) Загрузить xml-файл на странице автоматической загрузки: http://slanet.by/import/
  • 3) При необходимости загрузить на этой же странице фото для объявлений, запаковав их в один архив
Загруженный файл будет автоматически обработан роботом приёма объявлений по недвижимости для SLANET.by
Внимание! Для того чтобы осуществлять автоматический импорт объявлений, необходимо предварительно согласовать эту возможность. Для этого обратитесь в службу поддержки SLANET.by и укажите, что хотели бы загружать объявления через страницу автоматической загрузки.



Вариант 2: предоставление файла по ссылке

  • 1) Составить xml-файл по стандарту, описанному далее в "Требования к XML-файлу"
  • 2) Выложить этот файл на свой сервер так, чтобы этот файл можно было получить по протоколу HTTP
  • 3) Предоставить ссылку на этот файл
Можно изменять содержимое файла, однако ссылка на него должна оставаться постоянной.
Выложенный файл будет забран и обработан по предоставленной ссылке, отчет можно посмотреть в личном кабинете.


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



Требования к XML-файлу

Файл данных XML содержит описание рекламных объявлений, предназначенных для подачи на сайт SLANET.by
Файл данных должен:
- иметь кодировку UTF-8
- быть правильно построенным (well-formed), то есть, иметь правильный синтаксис и действительным (valid), то есть, соответствовать определенному далее "Описанию структуры и состава файла данных XML".


Описание структуры и состава файла данных XML

Общие положения
xml-файл импортируемых данных обязательно должен содержать корневой элемент <Ads> с атрибутом account_by_slanet="--ИМЯ_ЗАРЕГИСТРИРОВАННОГО_ПОЛьЗОВАТЕЛЯ--"
Корневой элемент <Ads> может содержать одно или несколько объявлений, каждое из которых должно быть описано элементом <Ad>. Имена элементов чувствительны к регистру и состоят из букв латинского алфавита.

Общие атрибуты объявления
Для всех объявлений существует неизменный набор атрибутов, вне зависимости от типа объявления. Данные атрибуты описаны в разделе "Общие атрибуты для всех категорий".

Специфические атрибуты для категорий
Каждый тип объявлений выделен в отдельную категорию. Категория объявления указывается элементом <Category> внутри каждого элемента <Ad>. В зависимости от категории к заполнению данных объявления предъявляются разные требования к набору специфических атрибутов. Эти требования представлены в таблицах атрибутов по категориям, см. "Атрибуты по категориям".


Типы данных


В описании атрибутов приняты следующие обозначения типов данных:

  • Строка — произвольная последовательность символов, возможные ограничения по длине указываются рядом.
  • Строка, одно из перечисленных значений — в атрибуте требуется указать строковое значение, одно из возможных значений, перечисленных рядом.
  • Integer — целое число
  • Decimal — число с дробной частью. Целая и дробная части разделяются точкой.
  • Дата — дата в формате ISO 8601 для дат: ГГГГ-MM-ДД, например, 2013-03-31, 2014-12-18.


Идентификатор


Каждое объявление должно обязательно иметь элемент <SourceId>, в котором содержится уникальный идентификатор объявления в вашей базе. У одного и того же объявления в разных письмах должен быть один и тот же идентификатор, у разных объявлений — разные.
Идентификатором может быть любая строка до 100 символов, например:

  • простой номер объявления: 52, 1181
  • составной номер объявления: 1-515, 10_9023
  • составной буквенно-цифровой номер: АБ-23, XYZ-817
  • md5 объявления: BCF55961-FE70-4374-A918-E26E778BE6DF
  • другие варианты.


Даты показа (экспозиции) объявления на сайте


Если дата начала экспозиции не указана, началом считается день приема объявления. Если дата окончания экспозиции не указана, концом считается конец 28-го дня, начиная с даты начала экспозиции, т.е. объявление размещается на 28 дней.
Дата окончания включается в срок экспозиции, т.е. окончанием экспозиции считается конец дня, указанного этой датой.
Даты указываются в формате ISO 8601 для дат: ГГГГ-MM-ДД, например, 2016-03-31, 2015-12-18.
Часовой пояс, в котором указываются даты, считается одним для всех объявлений от одного клиента и принимается по согласованию с клиентом.


Местоположение объявления


Местоположение объекта объявления указывается с помощью элементов <City> и <LocalityStreet>.
В элементе <City> указывается населенный пункт из списка городов.
Список городох содержит далеко не все города, поэтому если требуемый населенный пункт там отсутствует, то указывается ближайший к вашему объекту, а само название населенного пункта, где находится объект, указывается в элементе <LocalityStreet>. В поле <LocalityStreet> может также указываться раём, улица и номер дома.


Фотографии


Фотографии для объявления указываются внутри элемента <Images>, по одному элементу <Image> на каждую фотографию.
На файл изображения можно ссылаться следующим образом:

  • 1) Передать вместе с xml-файлом с данными. В элементе <Image> именем файла заполняется атрибут "name". Пример:
    <Image name="a3.jpg" />
  • 2) Передать в виде ссылки на ресурс в интернете. В элементе <Image> ссылкой на фото заполняется атрибут "url". Пример:
    <Image url="http://img.prodavay.by/591F0E40-2238-48DB-8F7B-4A4F3A0F2BA1.jpg" />
Указание обоих атрибутов не допускается.
Максимальное колличество фотографий, которые можно прикрепить к объявлению - пять. Все фотографии свыше этого колличества игнорируются.


Общие атрибуты объявлений


ЭлементОписание * Возможные значения параметраТип данных и ограничения
SourceIdУникальный идентификатор объявления
см. Идентификатор
* строка не более 100 символов
SourceUrlУникальный URL(ссылка) объявления http://... строка не более 100 символов
DateBeginДата начала экспозиции объявления Дата в формате ГГГГ-MM-ДД см. Даты экспозиции
DateEndДата конца экспозиции объявления Дата в формате ГГГГ-MM-ДД см. Даты экспозиции
CityГород, в котором находится объект
см. Местоположение объявления
*Значение из списка городовстрока, одно из перечисленных значений
LocalityStreetУточнение населенного пункта, район, улица, номер дома строка
OperationTypeТип объявления
(предложение, поиск)
*offer
search
строка, одно из перечисленных значений
OperationSectionРаздел объявлений
(коммерческие, частные)
*comm
priv
строка, одно из перечисленных значений
DescriptionОписание строка не более 10000 символов
PriceЦена в рублях строка
CurrencyВалюта цены BLR
EUR
USD
строка, одно из перечисленных значений
ContactPhoneКонтактный телефон строка, содержащая от 7 до 13 цифр
Images, ImageФото к объявлениям
см. Фотографии
строка


Специфические атрибуты для категорий


Дома, коттеджи
http://slanet.by/realt/dom/~215/
CategoryКатегория объекта недвижимости*
fe_house_areaПлощадь дома, (кв.м.) 
fe_house_landareaПлощадь участка, (в сотках) 
fe_house_typeТип дома дом, коттедж
домовладение, усадьба
новостройка
таунхаус, рядный дом
часть дома
fe_house_floorsВсего этажей в доме 
fe_house_wallsmaterialМатериалы постройки дома кирпич
монолит
дерево
блоки
панели, каркас
fe_house_citydistanceРасстояние до города, (км) 

Квартиры
http://slanet.by/realt/kvartiry/~220/
CategoryКатегория объекта недвижимости*
fe_flat_areaПлощадь квартиры, (кв.м.) 
fe_flat_floorЭтаж 
fe_flat_floorsВсего этажей в доме 
fe_flat_roomstypeТип комнат изолированные комнаты
смежно-изолир. комнаты
смежные комнаты
распашонка
студия
fe_flat_housetypeТип постройки дома новостройка
типовой дом
улучшенная планировка
сталинский дом
хрущевка
малосемейка
литовский проект
старый фонд
таунхаус

Дачи
http://slanet.by/realt/dachi/~225/
CategoryКатегория объекта недвижимости*
fe_holidayhouse_areaПлощадь дома, (кв.м.) 
fe_holidayhouse_landareaПлощадь участка, (в сотках) 
fe_holidayhouse_wallsmaterialМатериалы постройки дома кирпич
монолит
дерево
блоки
панели, каркас
fe_holidayhouse_citydistanceРасстояние до города, (км) 

Аренда комнат
http://slanet.by/realt/arenda-komnat/~230/
CategoryКатегория объекта недвижимости*
fe_room_renttypeТип аренды посуточная
долгосрочная
fe_room_areaПлощадь комнаты, (кв.м.)
fe_room_floorЭтаж
fe_room_floorsВсего этажей в доме
fe_room_roomstypeТип комнат изолированные комнаты
смежно-изолир. комнаты
смежные комнаты
распашонка
студия
fe_room_housetypeТип постройки дома новостройка
типовой дом
улучшенная планировка
сталинский дом
хрущевка
малосемейка
литовский проект
старый фонд
таунхаус

Офисы
http://slanet.by/realt/ofis/~231/
CategoryКатегория объекта недвижимости*

Земельные участки
http://slanet.by/realt/uchastki/~232/
CategoryКатегория объекта недвижимости*
fe_estate_areaОбщая площадь, (в сотках) 
fe_estate_typeТип, по назначению (под ...) индивидуальное жилищное строительство
личное подсобное хозяйство, дача
коммерческая застройка, МЖС
объекты производственного назначения
многоэтажное жилищное строительства
сельскохозяйственное назначение

Коммерческие помещения
http://slanet.by/realt/pomescheniya/~391/
CategoryКатегория объекта недвижимости*

Гаражи
http://slanet.by/realt/garazhi/~233/
CategoryКатегория объекта недвижимости*


Пример файла данных XML

Пример XML-описания объявлений находится здесь: (сорри, пока не выложили)

Правила автоматической обработки объявлений

Объявления для автоматического размещения принимаются только от коммерческих пользователей SLANET.by, согласовавших эту возможность.
Для этого нужно зарегистрировать аккаунт для коммерческих пользователей и сообщить в службу поддержки с запросом.
В запросе нужно указать свой е-майл адрес, с которого будет осуществляться отправка данных для загрузки. Объявления, пришедшие с незарегистрированных адресов e-mail адресов, будут проигнорированы.

Сроки показа (экспозиции) объявления на сайте

Для каждого объявления можно (но не обязательно) указывать диапазон дат от (<DateBegin>) и до (<DateEnd>), когда это объявление будет показано — это позволяет точно управлять периодом показа объявления. Если даты не указаны, для даты начала и срока выбираются значения по умолчанию, подробнее в разделе "Даты показа (экспозиции) объявления на сайте".
Сроки экспозиции можно изменить в любой момент, прислав в очередном файле с объявлениями другие даты. Можно остановить объявление раньше даты окончания, не указав его в очередном письме с объявлениями. Примечания:
- Указывайте сроки экспозиции, если у вас есть для них значения, например, если в вашей учетной системе имеется дата окончания для объявления, или пользователь системы может указать сроки, когда нужно показывать объявление.
- Укажите дату начала показа, чтобы объявление не начало показываться раньше этой даты.
- Укажите дату окончания показа, чтобы объявление не показывалось позже этой даты.
В остальных случаях подойдут значения по умолчанию.

Примеры использования

Если корневой элемент <Ads> не содержит вложенных элементов <Ad>, это означает, что все поданные ранее объявления от владельца магазина на SLANET.by необходимо снять с продажи на сайте.
Если необходимо остановить показ только некоторых объявлений, достаточно произвести повторную передачу данных в письме, при этом удалив из xml-файла данные о ненужных объявлениях. В этом случае объявления, поданные ранее, но не указанные в последнем xml-файле, будут удалены с сайта.
Если не требуется менять состав и данные объявлений на сайте, можно не присылать очередное письмо/файл. Ранее поданные заявки продолжат показываться согласно указанным периодам показа.

Порядок обработки

Если робот импорта обнаружит в файле XML ошибки (например, структура файла не соответствует требуемой), то импорт объявлений осуществлён не будет, а отправителю придёт отчет о неудачной загрузке объявлений.
Если робот импорта обнаружит в одном из объявлений ошибки (например, отсутствуют обязательные поля объявления), то импорт такого объявления осуществлён не будет, а отправителю придёт отчет о неудачной загрузке объявления. В то же время, все правильно описанные объявления из этого файла будут выгружены на сайт.
Если робот импорта обнаружит объявления, содержащие ссылки на фото, но сами фото не найдены, то такие объявления попадут на сайт без фото.
Отчет: после каждой автоматической загрузки объявлений владельцу аккаунта на SLANET.by будет выслан на электронную почту или доступен в личном кабинете отчет о загрузке объявлений, содержащий подробную информацию о принятых и ошибочных объявлениях.


Список возможных городов находится здесь:
http://slanet.by/regionset/

Список возможных категорий находится здесь:
http://slanet.by/catmap/


объявления | бесплатные объявления | доска объявлений
\u0420\u0435\u0439\u0442\u0438\u043d\u0433@Mail.ru
⇑ \u041d\u0430\u0432\u0435\u0440\u0445
⇓ \u0412\u043d\u0438\u0437