Импорт / Экспорт объявлений

В этом подразделе можно выполнять пакетные действия по добавлению объявлений в базу и их выгрузке из нее.

В скрипте доски объявлений со стороны пользовательской части функция импорта доступна только в профиле типа Магазин (Бизнес).

1. Импорт объявлений

Для импорта объявлений, после выбора категории можно скачать XML или CSV шаблон, которому стоит следовать:

Также обязательно необходимо указать пользователя, которому эти объявления будут принадлежать.

После импорта объявлений данные отображаются в табличном виде в блоке ниже:

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

<?xml version="1.0" encoding="UTF-8"?>
<bbs type="items-import-export">
  <items>
    <item id="0" external="0" publicated="1">
      <title>Заголовок объявления</title>
      <description>Текст подробного описания объявления</description>
      <user id="10" shop="0">user@gmail.com</user>
      <category type="offer">31</category>
      <geo delivery="0">
        <city id="255">Киев</city>
        <station id="30">Площадь Независимости</station>
        <district>5</district>
        <addr>переулок Тараса Шевченко, 8б</addr>
        <lat>50.451099</lat>
        <lon>30.530300</lon>
      </geo>
      <price currency="1" 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>123 00 11 11</phone>
          <phone>123 00 22 22</phone>
        </phones>
        <skype>_Skype1_</skype>
        <icq>1234567890</icq>
      </contacts>
      <video></video>
    </item>
    <item id="0" external="0" publicated="1">...</item>
  </items>
</bbs>

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

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

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

• <title> - заголовок объявления (обязательный элемент)
• <description> - описание
• <user id="10" shop="0">Email пользователя</user> - пользователь, владелец создаваемого объявления, id - ID пользователя в базе, shop - ID магазина привязанного к данному пользователю либо 0.
• <category type="offer">31</category> - ID категории, в которой будет размещено объявление, в данной категории не должно быть подкатегорий (обязательный элемент).
  • атрибут type определяет тип объявления (версия 2.2.4+) и принимает следующие значения:
    • offer - предлагаю/продам (по-умолчанию)
    • seek - ищу/куплю
  • начиная с версии 2.2.4 данный тег не является обязательным, в случае его отсутствия будет использована категория указанная в настройках импорта.
• <geo delivery="0"> - гео. данные (обязательный элемент):
  • <city id="255">Киев</city> - ID города, название необязательно, главное указать атрибут id
  • <station id="30">Площадь Независимости</station> - ID станции метро, название необязательно
  • <district>5</district> - ID района города (версия 2.2.4+)
  • <addr>переулок Тараса Шевченко, 8б</addr> - адрес на карте
  • <lat>50.451099</lat> - координата Lat на карте
  • <lon>30.530300</lon> - координата Lon на карте
  • атрибут delivery - возможность доставки в регионы, варианты 1 или 0 (по-умолчанию). В случае если в категории, в которую добавляется объявление, настройка "Доставка в регионы" выключена - данный атрибут игнорируется. (версия 2.2.4+)
• <price currency="1" free="0" exchange="0" agreed="0" mod="1">1000.00</price> - цена указываемая в объявлении.
  • атрибут currency - ID валюты
  • атрибут free - пометка "Даром", 0/1
  • атрибут exchange - пометка "Обмен", 0/1
  • атрибут agreed - пометка "Договорная", 0/1 (версия 2.3+)
  • атрибут mod - пометка "Торг возможен", 0/1
  • Значение - стоимость
• <images> - изображения, прикрепляемые к объявлению
  • <image id="8">http://example.com/files/image1.jpg</image>
  • Атрибут "id" - ID изображение в таблице bff_bbs_items_images на случай если оно уже было загруженно ранее или 0
  • Значение - URL изображения для загрузки
• <contacts> - контакты владельца объявления, указываются в каждом объявлении
  • <name> - имя
  • <phones> - телефоны
  • <skype> - skype
  • <icq> - icq
• <video> - видео-ссылка(url) на ролик youtube / vimeo

Краткое описание структуры CSV файла импорта (версия 2.3.0+):
item-id - 0 (добавить новое объявление), ID (обновить данные об объявлении)
item-external - ID во внешнем источнике
item-publicated - Статус публикации, 0 - снято с публикации, 1 - опубликовано (версия 2.4.3+)
user - ID существующего пользователя или Email существующего/нового пользователя
title - заголовок объявления (обязательный элемент)
description - описание
category-id - ID категории, в которой будет размещено объявление
category-type - тип объявления: offer, seek
geo-delivery - возможность доставки в регионы, варианты 1 или 0 (по-умолчанию)
geo-city-id - ID города (обязательный элемент)
geo-station-id - ID станции метро
geo-district-id - ID района города
geo-addr - адрес на карте (улица, дом)
geo-lat - координата Lat на карте
geo-lon - координата Lon на карте
price - цена указываемая в объявлении
price-currency - ID валюты
price-free - пометка "Даром", 0/1
price-exchange - пометка "Обмен", 0/1
price-mod - пометка "Торг возможен", 0/1
price-agreed - пометка "Договорная", 0/1
images - изображения, URL разделяемые 1 пробельным символом
contacts-name - имя владельца
contacts-phones - телефоны, разделителем является символ ;
contacts-skype - skype
contacts-icq - icq
video - видео-ссылка на ролик youtube / vimeo

Дополнительные контактные поля, реализованные в версии 2.3.3 можно указывать следующим образом:
contacts-telegram, contacts-whatsapp, contacts-viber и другие добавленные вами по схожему принципу

2. Экспорт объявлений

Для экспорта объявлений необходимо обязательно выбрать категорию:

3. Экспорт объявлений в Яндекс.Маркет

Перейдите во вкладку Яндекс.Маркет.

Выполните настройку параметров экспорта объявлений в Яндекс.Маркет:

1. Чтобы получить доступ к настройкам экспорта объявлений в Яндекс.Маркет, Установите флажок Формировать выгрузку.

2. В поле Наименование магазина введите короткое название своего магазина, соответствующее следующим требованиям:

• до 20 символов;
• не содержит слова, которые не имеют к нему отношения, например «лучший», «дешевый» и т. п.
• совпадает с фактическим названием, опубликованным на сайте.

3. В поле Наименование компании введите полное название своей компании.

4. С помощью блока Валюты задайте свой список курсов валют для отображения в Яндекс.Маркете.

5. Из выпадающего списка Основная валюта выберите валюту, которая будет взята за единицу при расчёте курса других валют.

6. Настройте опцию Категории, выбрав одно из следующих действий:

• Установите флажок все категории, чтобы выбрать все категории объявлений.
• Укажите конкретные категории объявлений с помощью выпадающего списка.

7. Используйте опцию Загрузка, чтобы автоматизировать процесс загрузки прайс-листа на Яндекс.Маркет:

• Установите флажок разрешить Яндекс.Маркету автоматически загружать прайс лист.
• Если доступ к файлу прайс-листа требует настройки доступа, то установите флажок требовать авторизацию.

8. Нажмите кнопку Сохранить.

Примечание:

Прайс-лист формируется в формате YML раз в сутки. Чтобы обновить прайс-лист принудительно, нажмите кнопку Сформировать принудительно. Чтобы скачать прайс-лист, нажмите ссылку скачать в верхней части окна настроек.