XML-импорт объявлений

Фид должен быть составлен на языке XML.

Общие технические требования к наполнению фида:
  • Не подавайте одно и то же объявление повторно; Почему?
  • В фиде должны передаваться все актуальные объявления, доступные на сайте;
  • Для каждого объявления следует передавать максимальный набор параметров;
  • В текстах объявлений и в описании характеристик не должно быть HTML-кода;
  • Стоимость предложения должна быть корректной и соответствовать действительности;
  • В фиде надо передавать только те параметры, которые ввел податель объявления. Например, если ваш сайт автоматически вычисляет географические координаты недвижимости, вычисленные параметры передавать не надо;
  • Если податель объявления не указал какого-либо параметра, то соответствующий тег передавать не следует.
  • ID номер объявления не указывается, оставьте кавычки пустыми либо поставьте«0», система сама присвоит номер объявлению.

Внимание!
Доступно только для «Магазины».
Для получения возможности «Импорта» объявлений необходимо обратиться с соответствующим запросом, указав тему «XML — импорт».

После проверки запроса модератором, в Вашем личном кабинете появится соответствующая вкладка. Ознакомиться с требуемым форматом фида можно скачав шаблон интересующей категории / подкатегории.

Краткое описание структуры XML файла импорта:

<code class="language-xml"><?xml version="1.0" encoding="UTF-8"?>
<bbs type="items-import-export">
  <items>
    <item id="0" external="0">
      <title>Заголовок объявления</title>
      <description>Текст подробного описания объявления</description>
      <user id="10" shop="0">user@gmail.com</user>
      <category type="offer">31</category>
      <geo delivery="0">
        <city id="3341">Новосибирск</city>
        <station id="423">Красный проспект</station>
        <district>5</district>
        <addr>Красный проспект, 25</addr>
        <lat>55.0296</lat>
        <lon>82.9191</lon>
      </geo>
      <price currency="2" free="0" exchange="0" agreed="0" mod="1">1000.00</price>
      <images>
        <image id="8">http://example.com/files/image1.jpg</image>
        <image id="4">http://example.com/files/image2.jpg</image>
      </images>
      <contacts>
        <name>Имя пользователя</name>
        <phones>
          <phone>+7 000 000 0000</phone>
          <phone>+7 000 000 0000</phone>
          <phone>+7 000 000 0000</phone>
        </phones>
        <skype>_Skype1_</skype>
        <icq>1234567890</icq>
      </contacts>
      <video></video>
    </item>
    <item id="0" external="0">...</item>
  </items>
</bbs></code>

Основной элемент <items> с вложенными <item>.

  • <item> включает в себя следующие атрибуты:
    • id который может быть равен нулю (0), в таком случае будет создано новое объявление, либо больше нуля, в таком случае будет выполнен поиск объявления по id в базе и если такое будет найдено, данные объявления будут обновлены.
    • external, при помощи которого доступна возможность указать ID во внешнем источнике, что позволяет в дальнейшем обновлять существующие объявления по указанному ID не привязываясь к ID в базе данных проекта. Данный атрибут принимает значения 0 или 1, в случае если указано значение 1, значение атрибута id обрабатывается как ID из внешнего источника.

В тег <item> входят следующие вложенные теги:

  • <title> — заголовок объявления (обязательный элемент)
  • <description> — описание
  • <user id="10" shop="0">Email пользователя</user> — пользователь, владелец создаваемого объявления, id — ID пользователя в базе, shop — ID магазина привязанного к данному пользователю либо 0.
  • <category type="offer">31</category> — ID категории, в которой будет размещено объявление, в данной категории не должно быть подкатегорий (обязательный элемент).
    • атрибут type определяет тип объявления и принимает следующие значения:
      • offer — предлагаю/продам (по-умолчанию)
      • seek — ищу/куплю
    • данный тег не является обязательным.
  • <geo delivery="0"> — гео. данные (обязательный элемент):
    • <city id="3341">Новосибирск</city> — ID города, название необязательно, главное указать атрибут id
    • <station id="423">Красный проспект</station> — ID станции метро, название необязательно
    • <district>5</district> — ID района города
    • <addr>Красный проспект, 25</addr> — адрес на карте
    • <lat>55.0296</lat> — координата Lat на карте
    • <lon>82.9191</lon> — координата Lon на карте
    • атрибут delivery — возможность доставки в регионы, варианты 1 или 0 (по-умолчанию). В случае если в категории, в которую добавляется объявление, настройка «Доставка в регионы» выключена — данный атрибут игнорируется.
  • <price currency="2" free="0" exchange="0" agreed="0" mod="1">1000.00</price> — цена указываемая в объявлении.
    • атрибут currency — ID валюты, 2 — Рубли, 3 — Доллары, 4 — Евро, 5 — Юань
    • атрибут free — пометка «Даром», 0/1
    • атрибут exchange — пометка «Обмен», 0/1
    • атрибут agreed — пометка «Договорная», 0/1
    • атрибут mod — пометка «Торг возможен», 0/1
    • Значение — стоимость
  • <images> — изображения, прикрепляемые к объявлению, максимум 12
    • <image id="8">http://example.com/files/image1.jpg</image>
    • Атрибут «id» — ID изображение на случай если оно уже было загруженно ранее или 0 для нового
    • Значение — URL изображения для загрузки
  • <contacts> — контакты владельца объявления, указываются в каждом объявлении
    • <name> — имя
    • <phones> — телефоны, максимум 5
    • <skype> — skype
    • <icq> — icq
  • <video> — видео-ссылка(url) на ролик youtube / vimeo