Выгрузка склада в формате XML

Zovars позволяет создать постоянную XML-ссылку для передачи опубликованных автомобилей во внешнюю систему, на другой сайт или в интеграционный сервис.

Как создать XML-фид

1. Откройте административную панель своего сайта.
2. В левом меню перейдите в раздел «Обмен и интеграции».
3. Откройте пункт «Экспорт в zovars.xml».
4. Нажмите «Создать фид».
5. Укажите понятное название, например «Склад Краснодар» или «Все автомобили».
6. Выберите один или несколько складов. Доступны собственные склады и склады, автомобили которых опубликованы на вашем сайте.
7. Если склады не выбраны, в XML попадут все доступные вашему сайту опубликованные автомобили.
8. Сохраните фид и скопируйте постоянную ссылку из столбца «Ссылка».

Фид можно открыть в новой вкладке, изменить его название и набор складов либо удалить. Для разных получателей можно создать несколько независимых фидов.

Какие автомобили попадают в выгрузку

• собственные автомобили партнёра;
• автомобили других партнёров, добавленные на сайт;
• только автомобили со статусом published;
• архивные автомобили не выгружаются;
• при выборе складов выгружаются только автомобили выбранных складов с учётом склада, назначенного партнёром.

Если автомобиль снят с публикации, перенесён в архив либо удалён из выбранного склада, при следующем запросе ссылки он исчезнет из XML. После публикации или возврата в выбранный склад он снова появится.

Структура XML

<zovars schema="zovars.cars.v1" generated_at="2026-07-14T17:00:00+03:00">
  <partner>...</partner>
  <filters>...</filters>
  <cars count="383">
    <car id="123" updated_at="2026-07-14T16:30:00+03:00">
      <external_id>zovars-123</external_id>
      <title>Kia Sportage 2022</title>
      <url>https://site.ru/cars/123-kia-sportage-2022</url>
      <brand>Kia</brand>
      <model>Sportage</model>
      <fields>...</fields>
      <prices currency="RUB">...</prices>
      <warehouse>...</warehouse>
      <owner>...</owner>
      <partner_data>...</partner_data>
      <media>...</media>
      <catalog>...</catalog>
    </car>
  </cars>
</zovars>

Корневые данные

Поле	Описание
zovars/@schema	Версия схемы фида: zovars.cars.v1.
zovars/@generated_at	Дата и время формирования XML в ISO 8601.
partner	Партнёр, для которого создан фид: id, name, domain, city, phone, email.
filters/status	Статус автомобилей, включённых в выдачу: published.
filters/warehouse_ids/item	Идентификаторы выбранных складов. Пустой список означает все склады.
cars/@count	Фактическое количество автомобилей в текущей выгрузке.

Основные данные автомобиля

Поле	Описание
car/@id	Внутренний идентификатор автомобиля в Zovars.
car/@updated_at	Время последнего изменения автомобиля.
external_id	Стабильный идентификатор для синхронизации в формате zovars-{id}.
title	Название объявления.
url	Ссылка на публичную карточку автомобиля на сайте партнёра.
brand, model	Нормализованные название марки и модели.

Блок fields

В блоке fields передаются все сохранённые поля автомобиля. Набор разбит ниже по назначению.

Идентификаторы и состояние

id, partner_id, title, article, ad_code, status, shared, archived, warehouse_id, created_at, updated_at.

Основные характеристики

brand, brand_id, model, model_id, year, month, mileage, body_type, color, fuel_type, transmission, drive_type, engine_power, engine_volume, steering_side, condition, owners_count, vin.

Документы и состояние автомобиля

damaged, pts, maintenance, is_reserved, reserved_by_partner_id, reserved_by_user_id, reserved_at.

Комплектация и опции

options, power_steering, climate_control, interior_material, interior_color, power_windows, audio_system, headlights, wheel_size, leather_steering_wheel, sunroof, panoramic_roof, heating_features, power_features, memory_settings, driving_assist, multimedia, antitheft, airbags, active_safety, headlights_extra.

Цены и расчёт стоимости

price_b2c, price_b2b, price_b2c_currency, price_b2c_note, extra_prices, dealer_mode, dealer_currency, dealer_price_b2c, dealer_price_b2b, price_input_amount, broker_fee, delivery_fee, dealer_services_fee, margin_mode, margin_value, customs_enabled, customs_force_passable, customs_sbor, customs_duty, customs_util, customs_total, car_plus_customs, pricing_manual_override.

Медиа и служебные данные импорта

image_path, photos, photos_original, photos_buffer, photos_total, photos_processed, photos_ready, videos, source_media_url, partners_description, is_imported, last_imported_at, last_import_id, last_import_source, external_source, external_id, external_images_hash, external_feed_id.

Справочники площадок

avito_generation_id, avito_modification_id, avito_complectation_id, drom_origin_country, drom_location, drom_delivery_time, drom_delivery_terms.

Цены

Поле	Описание
prices/@currency	Валюта итоговой цены.
author_b2c	Розничная цена автора автомобиля.
author_b2b	Дилерская цена автора.
partner_b2c	Собственная розничная цена партнёра, если она задана.
partner_b2b	Собственная дилерская цена партнёра, если она задана.
dealer_b2c, dealer_b2b	Рассчитанные дилерские цены из карточки автомобиля.
effective_b2c	Фактическая розничная цена для текущего сайта. Она не может быть ниже розничной цены автора.
effective_b2b	Фактическая дилерская цена для текущего сайта.
margin	Разница между effective_b2c и effective_b2b.
extra_prices	Дополнительные цены автомобиля или партнёра.

Склад и владелец

warehouse/source содержит исходный склад автора, а warehouse/effective — склад, под которым автомобиль показывается у получателя фида.

Для склада передаются: id, partner_id, address, exact_address, is_default, company_description, настройки расчёта pricing_enabled, dealer_services_fee, customs_enabled, customs_force_passable, broker_fee, delivery_fee, margin_mode, margin_value, а также даты создания и изменения.

В эффективном складе дополнительно передаются:

• display_name — название склада с учётом собственного переименования партнёром;
• display_description — описание склада, предназначенное для текущего партнёра.

owner содержит данные автора автомобиля: id, name, domain, phone, city, callback_email.

partner_data содержит индивидуальные данные текущего партнёра: id, car_id, partner_id, description, price_b2c, price_b2c_currency, price_b2c_note, price_b2b, price_b2b_note, extra_prices, description_blocks_order, videos, warehouse_id, description_touched_at, created_at, updated_at.

Фотографии и видео

Поле	Описание
media/main_photo_url	Полная HTTPS-ссылка на главное фото.
media/photo_urls/item	Полные HTTPS-ссылки на все фотографии в порядке отображения.
media/photos	Исходный массив фотографий из карточки автомобиля.
media/photos_editor	Порядок и данные фотографий, заданные в редакторе.
media/videos	Ссылки или данные видео автомобиля с учётом настроек партнёра.
media/source_media_url	Исходная ссылка на материалы, если она сохранена.

Обработанные изображения Zovars обычно отдаются в формате WebP по адресу https://zovars.ru/storage/.... Если изображение пока хранится у внешнего источника, в photo_urls передаётся его полная HTTPS-ссылка.

Комплектация и модификация

В блоке catalog передаются связанные справочные данные:

• avito_modification/id и avito_modification/name — модификация;
• avito_complectation/id и avito_complectation/name — комплектация.

Формат значений

• пустое значение передаётся с атрибутом nil="true";
• логические значения передаются как true или false;
• элементы массивов передаются повторяющимися тегами item;
• даты передаются в ISO 8601 либо в исходном формате поля;
• денежные значения передаются числами без форматирования пробелами.

Обновление и использование ссылки

Получатель должен периодически запрашивать одну и ту же ссылку и синхронизировать автомобили по external_id. Для определения изменений можно использовать car/@updated_at. Если ранее полученный external_id отсутствует в новом XML, автомобиль больше не входит в текущую опубликованную выборку.

Одновременная повторная генерация одного фида ограничена. При ответе 429 следует подождать время из заголовка Retry-After и повторить запрос. Рекомендуемый интервал плановой синхронизации — не чаще одного раза в час, если более частое обновление не требуется бизнес-процессом.