Требования к передаче данных

Чтобы настроить импорт данных склада через фид, обратитесь к своему аккаунт-менеджеру в Авто.ру Бизнес.

Поддерживаемые форматы фидов

  • XML-формат Авто.ру Бизнес
    Автосалон определяется по 3 полям: dealerId, dealerName или isNew. Если у API-пары единственный активный автосалон со складом, эти поля необязательные.

  • CSV-формат Авто.ру Бизнес
    Поля такие же, как у XML-формата.

    • Поддерживаются кодировки файла: UTF-8 (с BOM и без), Windows-1251 и Mac OS Cyrillic. Рекомендуем использовать UTF-8.
    • Поддерживаются разделители: ; (по умолчанию для Excel с русским языком), , и табуляция.
    • Несколько фотографий указываются через ;.
    • Автосалон определяется как в XML-формате.
    • Пример файла:
      csv-stock-import-example.csv
  • Формат автомобильного сайта auto.ru
    Можно передавать теги:

    • выбытие — <action>out</action>;
    • удаление — <action>delete</action>;
    • снятие с продажи — <action>hide</action>;
    • возврат в продажу — <action>show</action>;
    • короткое видео на Авито — <avito_ru_video_file_ur>https://disk.yandex.ru/i/s0ciOIMZ-oHsqQ</avito_ru_video_file_url>.

    Добавлен тег <section> со значениями: Новые, С пробегом.
    Автосалон определяется по атрибутам section, poi_id и contact_info/contact/phone.

  • Формат avito.ru
    Для указания состояния автомобиля добавлено поле <State> со значениями: Отличное, Хорошее, Среднее, Требует ремонта.
    Атрибуты, по которым определяется автосалон:

    • адрес автосалона <Address>;
    • пара атрубутов: <Latitude> и <Longitude>;
    • телефон <ContactPhone>;
    • тип склада <CarType>.
  • Формат экспорта maxposter.ru
    Атрибуты, по которым определяется автосалон:

    • название автосалона <dealer>;
    • телефон <phones>;
    • тип склада <type>.
  • Формат импорта maxposter.ru
    Атрибуты, по которым определяется автосалон:

    • название автосалона <sales-point>;
    • тип склада <type>.

Важно

В одном XML-фиде не может быть обработано более 2500 карточек автомобилей. Если вам требуется загрузить данные о большем количестве автомобилей одного автосалона, обратитесь в поддержку.

Часто задаваемые вопросы

Где можно разместить фид?
  • На HTTP-сервере

    • Поддерживается опциональная Basic-авторизация.
    • Использование TLS (ссылки вида https://) необязательно. Если вы используете TLS, проверьте, что сервер правильно сконфигурирован.
    • Можно настроить доступ с определенных IP-адресов.
  • На FTP-серевере

    • Авторизация необязательна.
    • Поддерживаются только FTP без TLS (ссылки вида ftps:// не поддерживаются).
    • Можно настроить доступ с определенных IP-адресов.
  • На Яндекс Диске

    • Опция Запретить скачивание у ссылки должна быть отключена.
    • Ссылка может быть защищена паролем.
Как посмотреть историю обработки фидов?

На почту, которая указана в фиде, при каждом обновлении придет отчет по результатам обработки.

Можно ли передать фид со ссылкой на ftp?

Да, мы поддерживаем это.