Инструкция по подготовке файла для пакетной выгрузки

Для автоматического импорта предложений с вашего сайта необходимо подготовить файл прайс-листа в формате .xml. 

Если вы размещаете предложения на Яндекс.Маркет, то у вас уже есть подходящий файл, его остается только подключить в разделе «Настройки» личного кабинета.

Требования к файлу и его содержимому

  1. Файл должен быть доступен по протоколу HTTP или HTTPS. На данный момент не допускается использование авторизации для доступа к файлу, но в ближайшее время такая возможность будет реализована.
  2. Наименования предложений должны быть составлены по схеме: тип техники + марка + модель. Например, «Бортовой автомобиль Урал 4320-4971-80М».
  3. Запрещено использовать в наименованиях предложений только заглавные буквы, а также лишнюю информацию, например, стоимость, условия продажи и другое.
  4. В описании техники укажите ключевые характеристики и особенности комплектации, можно также указать условия продажи и доставки.
  5. Регулярно обновляйте цену в прайс-листе — актуальные цены повышают доверие покупателей.

Пример файла прайс-листа

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
    <shop>
    <offers>
      <offer id="12346">
        <price>4450000</price>
        <picture>http://gruzovik.bizhttps://gruzovik.biz/sites/default/files/unit_technic/1-sin-35-b_0_8.jpg</picture>
        <picture>http://gruzovik.bizhttps://gruzovik.biz/sites/default/files/unit_technic/1-sin-35-b_0_9.jpg</picture>
        <picture>http://gruzovik.bizhttps://gruzovik.biz/sites/default/files/unit_technic/1-sin-35-b_0_7.jpg</picture>
        <name>Цементировочный агрегат ЦА Урал 4320</name>
        <description>
        <p>6×6, V 6 куб.м, г/п 12/12,5, без с/м, насос ЦА 320/32, ДВ ЯМЗ-65654 (230 л.с.)/ЯМЗ-53622-10 (240 л.с)/ЯМЗ-53642-10 (285 л.с.), Евро-4, КПП ЯМЗ-2361 (5 ст.)/0905 (5 ст.)/1105 (5 ст.), шины 425/85 R21</p>
        </description>
      </offer>
      <offer id="9012">
        <price>3650000</price>
        <picture>http://gruzovik.bizhttps://gruzovik.biz/sites/default/files/unit_technic/IMG_4350.jpg</picture>
        <name>АТЗ Камаз 65115</name>
        <description>
          <h3>Основные характеристики</h3>
          <ul>          
             <li>Объем цистерны: 12 куб. м</li>
             <li>Кол-во отсеков: 3</li>
             <li>УВТ: за кабиной или в заднем отсеке</li>
             <li>Шасси: КАМАЗ 65115 (6*4, 280 (300) л/с, Е4)</li>
        </description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Скачать пример XML файла

Описание элементов

Название элемента Описание элемента
xml header Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа. Допустимые кодировки YML-файла: UTF-8, windows-1251
yml_catalog Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент . Атрибут date элемента должен соответствовать дате и времени генерации YML-файла. Дата должна иметь формат YYYY-MM-DD hh:mm.
shop Элемент содержит описание товарных предложений.
offers Список предложений магазина. Каждое предложение описывается в отдельном элементе offer.
id Идентификатор (артикул) товарного предложения, является атрибутом для offer. Может состоять только из цифр или латинских букв, максимальная длина — 20 символов.
price Цена, по которой можно приобрести данную технику.
picture URL-ссылка на фотографию техники. Можно указать до 10 ссылок на изображение техники, изображением по умолчанию будет считаться первое изображение, оно же будет показываться в разделе и в результатах поиска.

Требование к ссылкам:
  • Допустимые протоколы URL изображения — HTTP или HTTPS.
  • Ссылка на изображение должна быть абсолютной. Относительные ссылки недопустимы.
  • Допускаются кириллические ссылки.
  • По указанной ссылке должно размещаться изображение техники, соответствующего описанию товарного предложения.
  • Нельзя использовать изображение другого автомобиля.
  • Запрещено использовать ссылку на одно и то же изображение в описании разных автомобилей. Исключение — модификации одной модели, которые внешне не отличаются, например, Урал 4320-1912-60 и Урал 4320-1951-60.
  • Недопустима ссылка на HTML-страницу, содержащую изображение.
  • Недопустима ссылка на логотип магазина или «заглушку» (изображение, где написано «фото отсутствует» и т. п.).
  • Максимальная длина URL — 512 символов.

Требования к изображениям: 

  • Изображение должно быть формата JPEG, GIF или PNG.
  • Рекомендуемый размер изображения — не менее 700 пикселей по меньшей из сторон.
  • В качестве основной (первой) фотографии выбирайте ту, где снят общий план машины.
name Название товарного предложения. Формируйте названия по схеме: тип техники + марка + модель.
description Описание товарного предложения. Длина текста не более 3000 символов, включая знаки препинания. В описании укажите ключевые характеристики и особенности комплектации. Допускается использование xhtml-тегов, но только в виде блока символьных данных — CDATA.        
<![CDATA[
          <h3>Основные характеристики</h3>
          <ul>          
             <li>Объем цистерны: 12 куб. м</li>
             <li>Кол-во отсеков: 3</li>
             <li>УВТ: за кабиной или в заднем отсеке</li>
             <li>Шасси: КАМАЗ 65115 (6*4, 280 (300) л/с, Е4)</li>
]]>

Рекомендации по использованию xhtml-тегов:
  1. Используйте следующие xhtml-теги:
    • <h3>...</h3> — для выделения заголовка;
    • <ul>...</ul> — для создания маркированного списка, каждый пункт списка должен быть заключен в теги <li>...</li>;
    • <p>...</p> — для нового абзаца текста;
    • <br/> — для переноса текста на новую строку, но не более двух подряд;
  2. Соблюдайте общие правила XHTML, в том числе:
    • Всегда должен присутствовать закрывающий тег.
    • Теги должны быть корректно вложены друг в друга.
    • Должна соблюдаться корректная последовательность тегов.
  3. Не используйте стили, они не поддерживаются.