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

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

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

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

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

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

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2026-02-24 12:00">
  <shop>
    <offers>
      <offer id="12346">
        <title>Цементировочный агрегат ЦА Урал 4320</title>
        <vin>X1X4320ABC1234567</vin>
        <year>2022</year>
        <price>4450000</price>
        <with_nds>true</with_nds>
        <haggle>возможен</haggle>
        <leasing>не возможен</leasing>
        <availability>В наличии</availability>
        <availability_quantity>2</availability_quantity>
        <state>Отличное</state>
        <run>15000</run>
        <operating_hours>1200</operating_hours>
        <warranty>24</warranty>
        <description><![CDATA[
          6×6, V 6 куб.м, насос ЦА 320/32, ДВ ЯМЗ-65654 (230 л.с.), Евро-4.
        ]]></description>
        <images>
          <image>https://example.ruhttps://gruzovik.biz/sites/default/files/unit_technic/1-sin-35-b_0_8.jpg</image>
          <image>https://example.ruhttps://gruzovik.biz/sites/default/files/unit_technic/1-sin-35-b_0_9.jpg</image>
        </images>
        <geo>Миасс, Челябинская область</geo>
        <url>https://example.ru/catalog/ca-ural-4320</url>
      </offer>

      <offer id="9012">
        <title>АТЗ Камаз 65115</title>
        <vin>X1X65115ABC7654321</vin>
        <year>2021</year>
        <price>3650000</price>
        <with_nds>false</with_nds>
        <haggle>не возможен</haggle>
        <leasing>возможен</leasing>
        <availability>На заказ</availability>
        <delivery_timeframe>30</delivery_timeframe>
        <state>Хорошее</state>
        <run>80000</run>
        <operating_hours>2500</operating_hours>
        <warranty>12</warranty>
        <description><![CDATA[
          Объем цистерны: 12 куб. м.
          Кол-во отсеков: 3.
          Шасси: КАМАЗ 65115 (6×4, 280 л.с., Е4).
        ]]></description>
        <images>
          <image>https://example.ruhttps://gruzovik.biz/sites/default/files/unit_technic/IMG_4350.jpg</image>
        </images>
        <geo>Златоуст, Челябинская область</geo>
        <url>https://example.ru/catalog/atz-kamaz-65115</url>
      </offer>

      <offer id="9013">
        <title>АТЗ Камаз 65115</title>
        <vin>X1X65115ABC7654321</vin>
        <year>2021</year>
        <price>3650000</price>
        <with_nds>false</with_nds>
        <haggle>не возможен</haggle>
        <leasing>не возможен</leasing>
        <availability>Ожидается</availability>
        <availability_quantity>2</availability_quantity>
        <expected_date>2026-04-01</expected_date>
        <state>Новый</state>
        <operating_hours>2500</operating_hours>
        <warranty>6</warranty>
        <description><![CDATA[
          Объем цистерны: 12 куб. м.
          Кол-во отсеков: 3.
          Шасси: КАМАЗ 65115 (6×4, 280 л.с., Е4).
        ]]></description>
        <images>
          <image>https://example.ruhttps://gruzovik.biz/sites/default/files/unit_technic/IMG_4350.jpg</image>
        </images>
        <geo>Челябинск, Челябинская область</geo>
        <url>https://example.ru/catalog/atz-kamaz-65115</url>
      </offer>
    </offers>
  </shop>
</yml_catalog>

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

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

Название элемента	Описание элемента
xml header	Описание: Стандартный XML-заголовок файла. Требования: Должен быть первой строкой файла Начинаться с нулевого символа Допустимые кодировки: `UTF-8` (рекомендуется) `windows-1251` Пример: <?xml version="1.0" encoding="UTF-8"?>
yml_catalog	Описание: Корневой элемент XML-документа. В одном файле может быть только один `yml_catalog`. Атрибуты: `date` — дата и время генерации фида Формат даты: `YYYY-MM-DD hh:mm` Пример: <yml_catalog date="2026-02-24 12:00">
shop	Описание: Контейнер с описанием магазина и его товарных предложений.
offers	Описание: Список всех товарных предложений магазина. Каждое предложение описывается отдельным элементом `<offer>`.
offer (id)	Описание: Товарное предложение. Атрибуты: `id` — уникальный идентификатор предложения Требования к id: Только цифры или латинские буквы Максимум 20 символов Пример: <offer id="12346">
title	Описание: Название товарного предложения. Рекомендация по формированию: тип техники + марка + модель Пример: <title>АТЗ КамАЗ 65115</title>
vin	Описание: VIN-номер техники. Если VIN отсутствует: Можно указать номер кузова Или оставить поле пустым Пример: <vin>X1X65115ABC7654321</vin>
year	Описание: Год выпуска техники. Тип значения: Целое число больше 0. Требования и рекомендации: Указывается полный год в формате `YYYY` Год выпуска не должен превышать текущий календарный год Пример: <year>2022</year>
price	Описание: Цена, по которой продаётся техника. Тип значения: Целое число (без пробелов и валюты) Пример: <price>3650000</price>
with_nds	Описание: Показывает, включён ли НДС в цену. Допустимые значения: `true` — цена указана с НДС `false` — цена без НДС Пример: <with_nds>true</with_nds>
haggle	Описание: Возможность торга. Допустимые значения: `возможен` `не возможен` Пример: <haggle>возможен</haggle>
leasing	Описание: Возможность приобретения в лизинг. Допустимые значения: `возможен` `не возможен` Пример: <leasing>не возможен</leasing>
availability	Описание: Статус наличия техники. Допустимые значения: `В наличии` `На заказ` `Ожидается` Пример: <availability>На заказ</availability>
availability_quantity	Описание: Количество техники в наличии или ожидаемое количество. Тип значения: Целое число Пример: <availability_quantity>3</availability_quantity>
delivery_timeframe	Описание: Срок поставки техники на заказ. Тип значения: Количество дней (целое число) Пример: <delivery_timeframe>30</delivery_timeframe>
expected_date	Описание: Ожидаемая дата поступления техники. Формат: `YYYY-MM-DD` Пример: <expected_date>2025-12-24</expected_date>
state	Описание: Состояние техники. Допустимые значения: `Новый` `Отличное` `Хорошее` `Среднее` `Требует ремонта` `На запчасти` Пример: <state>Хорошее</state>
run	Описание: Пробег техники в километрах. Указывается фактический пробег на момент публикации объявления. Тип значения: Целое число больше 0. Требования и рекомендации: Не используйте пробелы, единицы измерения («км») или разделители Для новой техники с нулевым пробегом поле можно не передавать Пример: <run>85000</run>
operating_hours	Описание: Количество моточасов наработки техники. Используется для спецтехники и оборудования, где пробег в километрах не отражает фактический износ. Тип значения: Целое число больше или равно 0. Требования и рекомендации: Не указывайте единицы измерения («м/ч», «часов») Если значение неизвестно — поле можно не передавать Пример: <operating_hours>2400</operating_hours>
warranty	Описание: Срок гарантии на технику в месяцах. Тип значения: Целое число. Требования и рекомендации: Указывайте только числовое значение без текста Если гарантия отсутствует — поле можно не передавать или указать 0 Пример: <warranty>12</warranty>
images, image	Описание: URL-ссылки на фотографии техники. Можно указать до 10 ссылок на изображение техники. Первое изображение будет основным и отображается в разделе и в результатах поиска. Требования к ссылкам: Ссылка должна вести только на изображение (недопустима ссылка на HTML-страницу) Ссылка на изображение должна быть абсолютной. Относительные ссылки недопустимы Допустимые протоколы: HTTP или HTTPS Максимальная длина URL — 512 символов Допускаются кириллические ссылки Изображение должно соответствовать описанию товарного предложения Недопустима ссылка на логотип магазина или «заглушку» (изображение, где написано «фото отсутствует» и т. п.) Требования к изображениям: Формат: JPEG, GIF или PNG Рекомендуемый размер — не менее 800 пикселей по меньшей из сторон Пример: <images> <image>https://example.ru/img/1.jpg</image> <image>https://example.ru/img/2.jpg</image> </images>
description	Описание: Описание товарного предложения. Длина текста не более 3000 символов, включая знаки препинания. В описании укажите ключевые характеристики и особенности комплектации. Допускается использование xhtml-тегов, но только в виде блока символьных данных — CDATA. Рекомендации по использованию xhtml-тегов: Используйте следующие xhtml-теги: `<h3>...</h3>` — для выделения заголовка `<ul>...</ul>` — для создания маркированного списка, каждый пункт списка должен быть заключен в теги `<li>...</li>` `<p>...</p>` — для нового абзаца текста `<br/>` — для переноса текста на новую строку, но не более двух подряд Соблюдайте общие правила XHTML: Всегда должен присутствовать закрывающий тег Теги должны быть корректно вложены друг в друга Должна соблюдаться корректная последовательность тегов Не используйте стили, они не поддерживаются Пример: <description><![CDATA[ <h3>Основные характеристики</h3> <ul> <li>Объем цистерны: 12 куб. м</li> <li>Кол-во отсеков: 3</li> </ul> ]]></description>
geo	Описание: Место размещения или осмотра техники. Тип значения: Строка. Требования и рекомендации: Указывайте населённый пункт (город) и регион Пример: <geo>Тюмень, Тюменская область</geo>
url	Описание: URL страницы с объявлением на сайте продавца. Тип значения: Строка (URL). Требования: Ссылка должна быть абсолютной Допустимые протоколы: http или https Ссылка должна вести непосредственно на страницу объявления Пример: <url>https://example.ru/catalog/atz-kamaz-65115</url>