БазараНЕТ
XML · BazarraNET

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

Соберите пример для своей категории, заполните данные объявлений и загрузите файл на площадку.

Перейти к импортуСкачать базовый пример

До 20 МБ · 10 000 объявлений · 10 фото на объявление · UTF-8

  1. 1Выберите категорию
  2. 2Заполните характеристики
  3. 3Скачайте пример XML

Конструктор примера XML

Выберите поля и укажите значения. Готовый пример обновляется автоматически.

Загружаем схему…

Справка по формату

Как работает импорт

1. BazarraNET забирает XML

По HTTPS URL по расписанию или по кнопке.

2. Проверяет

Категории, поля, справочники и ссылки на фото.

3. Показывает изменения

Новые и изменённые объявления идут на модерацию.

Структура XML

Корневой элемент — <Ads>. Каждое объявление помещается в отдельный <Ad>. Для новых интеграций используйте собственный формат BazarraNET и точный <CategoryCode>.

<?xml version="1.0" encoding="UTF-8"?>
<Ads formatVersion="1" target="BazarraNET">
  <Ad>
    <Id>item-001</Id>
    <Title>Название товара</Title>
    <Price>1000</Price>
    <Address>Москва</Address>
    <CategoryCode>electronics/smartphones</CategoryCode>
    <Condition>как новый</Condition>
  </Ad>
</Ads>
Обязательные и дополнительные теги

Обязательные для каждого Ad

<Id>Уникальный ID в вашей системе. Повторный ID обновляет объявление.sku-1042
<Title>Заголовок объявления.Apple iPhone 15 Pro 256 ГБ
<CategoryCode>Однозначный код конечной категории BazarraNET. Скопируйте его из конструктора выше.electronics/smartphones
<Condition>Состояние объявления. Обязательное поле; выберите значение из справочника категории.как новый
<Address>Город или полный адрес. Первая часть до запятой используется как город.Москва, Тверская улица, 1
<Price>Цена: число 0 или больше. Дробная часть — точка или запятая.89990

Дополнительные и служебные

<Description>Описание; можно CDATA. HTML-разметка удаляется.
<Images>Контейнер до 10 тегов Image с публичными HTTPS URL.
Коды категорий

Найдите конечную категорию в конструкторе выше и скопируйте её код. Глубину и внутреннее устройство дерева знать не нужно.

<CategoryCode>electronics/smartphones</CategoryCode>
Типы характеристик
SELECT

Пишите одно значение из справочника: <color>Чёрный</color>.

MULTISELECT

Повторите XML-тег для каждого значения: <interfaces>Wi-Fi</interfaces> <interfaces>Bluetooth</interfaces>.

NUMBER

Только число, без единицы в тексте: <power>1500</power>.

BOOLEAN / DATE

true / false; дата в ISO-формате YYYY-MM-DD.

Совместимость с Avito XML
Поля существующих Avito-совместимых выгрузок

Существующие фиды продолжат работать. Поля Category, GoodsType, GoodsSubType, ProductType, ProductSubType, ServiceType, ServiceSubtype и ServiceSubspecies используются только compatibility layer для сопоставления с единым каталогом BazarraNET.

Служебные AllowEmail, ManagerName и ContactPhone распознаются, но не становятся характеристиками объявления. Для новых интеграций используйте CategoryCode и canonical XML-теги характеристик из справочника.

<Ads formatVersion="3" target="Avito.ru">
  <Ad>
    <Category>Электроника</Category>
    <GoodsType>Мобильные телефоны</GoodsType>
    <!-- остальные поля объявления -->
  </Ad>
</Ads>
Требования к фотографиям
<Images>
  <Image url="https://cdn.example.com/items/001/front.webp"/>
  <Image url="https://cdn.example.com/items/001/back.webp"/>
</Images>
  • До 10 URL на объявление
  • Первое фото становится главным
  • Публичный HTTPS URL
  • Дубли URL удаляются
Полный пример XML
<?xml version="1.0" encoding="UTF-8"?>
<Ads formatVersion="1" target="BazarraNET">
  <Ad>
    <Id>phone-001</Id>
    <Title>Apple iPhone 15 Pro 256 ГБ</Title>
    <Description><![CDATA[Отличное состояние, полный комплект.]]></Description>
    <Price>89990</Price>
    <Address>Москва, Тверская улица, 1</Address>

    <CategoryCode>electronics/smartphones</CategoryCode>
    <Condition>как новый</Condition>

    <brend-281677275999>Apple</brend-281677275999>
    <model-e42993f81878>iPhone 15 Pro</model-e42993f81878>
    <built-in-storage-capacity>256</built-in-storage-capacity>
    <color>Титан натуральный</color>

    <Images>
      <Image url="https://example.com/phone/front.webp"/>
      <Image url="https://example.com/phone/back.webp"/>
    </Images>
  </Ad>
</Ads>
Автозагрузка по URL

1. Опубликуйте XML

На постоянном HTTPS URL. HTTP и URL с логином/паролем в строке адреса запрещены.

2. Добавьте источник

Откройте «Импорт XML» → «Автозагрузка по URL», укажите URL, авторизацию и расписание.

3. Проверьте dry-run

Первый запуск покажет новые, изменённые, неизменные, ошибочные и пропавшие позиции.

4. Подтвердите

Изменения не применяются вслепую. Пропавшие позиции не удаляются — архивация запускается отдельно.

Перейти к импорту
Частые ошибки

Нет Id, Title, CategoryCode, Condition или Address

Добавьте обязательный тег внутрь Ad. Для legacy XML вместо CategoryCode допускаются классификационные поля площадки.

CategoryCode не найден

Выберите точный код конечной категории в справочнике выше.

Price не число или меньше 0

Передавайте 0 или положительное число без символа валюты.

Id повторяется в одном XML

Каждый Id внутри файла должен быть уникален.

Значение не входит в справочник

Возьмите точное допустимое значение характеристики из выбранной категории.

DTD или ENTITY

Из соображений безопасности они запрещены.