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

Описание:
Стандартный XML-заголовок файла.

Требования:

• Должен быть первой строкой файла
• Начинаться с нулевого символа
• Допустимые кодировки:
  • UTF-8 (рекомендуется)
  • windows-1251

Пример:

<?xml version="1.0" encoding="UTF-8"?>

Описание:
Корневой элемент XML-документа. В одном файле может быть только один yml_catalog.

Атрибуты:

• date — дата и время генерации фида

Формат даты:
YYYY-MM-DD hh:mm

Пример:

<yml_catalog date="2026-02-24 12:00">

Описание:
Товарное предложение.

Атрибуты:

• id — уникальный идентификатор предложения

Требования к id:

• Только цифры или латинские буквы
• Максимум 20 символов

Пример:

<offer id="12346">

offer_code

Описание:
Внешний код предложения продавца.

Допустимые значения:
Произвольная непустая строка (обычно цифры или буквенно-цифровой код).

Пример:

<offer_code>132843</offer_code>

Описание:
Название товарного предложения.

Рекомендация по формированию:
тип техники + марка + модель

Пример:

<title>АТЗ КамАЗ 65115</title>

Описание:
Марка техники для первой группы модельных полей.

Использование:

• Передаётся вместе с <model>.
• Используется для заполнения первой пары марка/модель.

Пример:

<mark>FAW</mark><br>
<model>J6</model>

Описание:
Марка/группа оборудования для второй группы модельных полей.

Использование:

• Передаётся вместе с <model_eq>.
• Используется для заполнения второй пары марка/модель.

Пример:

<mark_eq>FAW</mark_eq><br>
<model_eq>J6</model_eq>

Описание:
VIN-номер техники.

Если VIN отсутствует:

• Можно указать номер кузова
• Или оставить поле пустым

Пример:

<vin>X1X65115ABC7654321</vin>

Описание:
Таможенный статус. По умолчанию растаможен

Допустимые значения:

• Не растаможен
• Растаможен

Пример:

<custom>растаможен</custom>

Описание:
Тип ПТС.

Допустимые значения:

• Оригинал
• Дубликат
• Электронный
• Нет

Пример:

<pts>оригинал</pts>

Описание:
Год выпуска техники.

Тип значения:
Целое число больше 0.

Требования и рекомендации:

• Указывается полный год в формате YYYY
• Год выпуска не должен превышать текущий календарный год

Пример:

<year>2022</year>

Описание:
Цена, по которой продаётся техника.

Тип значения:
Целое число (без пробелов и валюты)

Пример:

<price>3650000</price>

Описание:
Показывает, включён ли НДС в цену.

Допустимые значения:

• true — цена указана с НДС
• false — цена без НДС

Пример:

<with_nds>true</with_nds>

Описание:
Возможность торга.

Допустимые значения:

• возможен
• не возможен

Пример:

<haggle>возможен</haggle>

Описание:
Возможность приобретения в лизинг.

Допустимые значения:

• возможен
• не возможен

Пример:

<leasing>не возможен</leasing>

Описание:
Возможность обмена.

Допустимые значения:

• Рассмотрю варианты
• Нет

Пример:

<exchange>Нет</exchange>

Описание:
Статус наличия техники.

Допустимые значения:

• В наличии
• На заказ
• Ожидается

Пример:

<availability>На заказ</availability>

Описание:
Количество техники в наличии или ожидаемое количество.

Тип значения:
Целое число

Пример:

<availability_quantity>3</availability_quantity>

Описание:
Срок поставки техники на заказ.

Тип значения:
Количество дней (целое число)

Пример:

<delivery_timeframe>30</delivery_timeframe>

Описание:
Ожидаемая дата поступления техники.

Формат:
YYYY-MM-DD

Пример:

<expected_date>2025-12-24</expected_date>

Описание:
Состояние техники.

Допустимые значения:

• Новый
• С пробегом
• Отличное
• Хорошее
• Среднее
• Требует ремонта
• На запчасти

Пример:

<state>Хорошее</state>

Описание:
Пробег техники в километрах. Указывается фактический пробег на момент публикации объявления.

Тип значения:
Целое число больше 0.

Требования и рекомендации:

• Не используйте пробелы, единицы измерения («км») или разделители
• Для новой техники с нулевым пробегом поле можно не передавать

Пример:

<run>85000</run>

Описание:
Количество моточасов наработки техники. Используется для спецтехники и оборудования, где пробег в километрах не отражает фактический износ.

Тип значения:
Целое число больше или равно 0.

Требования и рекомендации:

• Не указывайте единицы измерения («м/ч», «часов»)
• Если значение неизвестно — поле можно не передавать

Пример:

<operating_hours>2400</operating_hours>

Описание:
Срок гарантии на технику в месяцах.

Тип значения:
Целое число.

Требования и рекомендации:

• Указывайте только числовое значение без текста
• Если гарантия отсутствует — поле можно не передавать или указать 0

Пример:

<warranty>12</warranty>

Описание:
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>

Описание:
Описание товарного предложения. Длина текста не более 3000 символов, включая знаки препинания. В описании укажите ключевые характеристики и особенности комплектации. Допускается использование xhtml-тегов, но только в виде блока символьных данных — CDATA.

Рекомендации по использованию xhtml-тегов:

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

Пример:

<description><![CDATA[
<h3>Основные характеристики</h3>
<ul>
  <li>Объем цистерны: 12 куб. м</li>
  <li>Кол-во отсеков: 3</li>
</ul>
]]></description>

Описание: 
Блок дополнительных параметров техники. Позволяет передавать произвольные характеристики в формате «название — значение», с возможностью указания единиц измерения.

Элемент <params> содержит список параметров <param>.

name — название параметра (обязательный параметр);
unit — единицы измерения (необязательный параметр);
value — значение параметра (обязательный параметр)

Пример:

<params>
 <param name="Грузоподъемность" unit="кг">12000</param>
 <param name="Объем кузова" unit="м3">18</param>
 <param name="Тип двигателя">Дизельный</param> 
</params>

Описание:
Место размещения или осмотра техники.

Тип значения:
Строка.

Требования и рекомендации:

• Указывайте населённый пункт (город) и регион

Пример:

<geo>Тюмень, Тюменская область</geo>

Описание:
URL страницы с объявлением на сайте продавца.

Тип значения:
Строка (URL).

Требования:

• Ссылка должна быть абсолютной
• Допустимые протоколы: http или https
• Ссылка должна вести непосредственно на страницу объявления

Пример:

<url>https://example.ru/catalog/atz-kamaz-65115</url>