Импорт товаров
На Au.ru можно массово добавлять и обновлять товары с помощью универсальных файлов YML, CSV или посредством API.
Файлы формата YML или CSV могут быть экспортированы из систем управления товарами или платформ для создания интернет-магазинов, таких как 1С-Битрикс, inSales, Bazon, МойСклад и др. Помимо универсальных файлов мы поддерживаем специализированные файлы для различных площадок, категорий на площадках, таких как Auto.ru, Авито Недвижимость, Яндекс Недвижимость, автозапчасти на Drom.ru, шины Drom.ru.
Если ваша система не указана в списке или у вас возникли вопросы относительно импорта товаров, а также для предварительной проверки совместимости файла импорта - обратитесь в службу поддержки, мы с удовольствием поможем!
Структура файла CSV
Пример файла, который можно использовать как шаблон. Можно импортировать файлы своего формата, но с небольшими доработками.
Список и описание элементов.
Используется только один из вариантов (Ru или eng)
Элемент. Ru/ eng | Описание элемента |
код товара/ externalId | Обязательный Идентификатор товара. Должен быть уникальным. |
название/ name | Обязательный. Название товара. Должен быть уникальным. |
цена /price | Обязательный Цена в рублях. |
Категория | Рекомендуемый Название категории товара. . Важно называть столбец именно "Категория" и никак иначе. |
фотографии/ pictures | Рекомендуемый Ссылки на фото. Каждая ссылка на фото отдельным столбцом. Фото 1, Фото 2 и т.д. |
описание | Рекомендуемый Описание товара. Для форматирования текста используются основные html тэги: <ul>...</ul> — для создания маркированного списка, каждый пункт списка должен быть заключен в теги <li>...</li>; <p>...</p> — для нового абзаца текста; <br/> — для переноса текста на новую строку, но не более двух подряд; <b>...</b> -выделение жирным <i>...</i> — выделение текста курсивом Пример <p>Наполнители:</p> <ul> <li>пенополиуретан</li> <li>кокосовая</li> </ul> |
название параметра 1/ Param 1 | Рекомендуемый Параметры товара. Название параметра 1,2 и т.д.. У одного параметра есть только одно значение. Количество параметров и значений может быть любым, в разумных пределах - 20, 30. Может использоваться любое свое название, т.к этот столбец не определяется автоматически системой и потребуется вручную настраивать связи(см. Пользовательские наименования столбцов.) |
значение параметра 1/ Value 1 | Рекомендуемый Параметры товара. Значение параметра 1,2 и т.д. Может использоваться любое свое название, т.к этот столбец не определяется автоматически системой и потребуется вручную настраивать связи(см. Пользовательские наименования столбцов.) |
статус/available | Возможные значения "статуса" - true (активен), false (неактивен). Если не задан, то все товары в таблице считаются активными. |
долгота/ longitude | Координаты лота. Если не задано, то берутся значения из профиля https://au.ru/my/tariff/ |
Широта/ latitude | Координаты лота. Если не задано, то берутся значения из профиля https://au.ru/my/tariff/ |
Количество/ count | Если не задано, то проставляется 1 |
Доставка в другие города/ delivery | Если не задано, то берутся значения из профиля https://au.ru/my/tariff/ |
Контактная информация/ contactInfo | Если не задано, то берутся значения из профиля https://au.ru/my/tariff/ |
Условия передачи | Если не задано, то берется значения из профиля https://au.ru/my/tariff/ |
Код города | Код города в котором будет размещен лот. Если не задано, то берется значения из профиля https://au.ru/my/settings/ (Ваш город) коды городов - https://777999.au.ru/info/коды городов.csv |
Обязательные, рекомендуемые и необязательные столбцы
Обязательные
В таблице должны присутствовать минимальное количество столбцов с требуемой информацией(артикул, цена, название). Названия столбцов могут отличаться , т.к в интерфейсе возможна привязка столбцов с произвольным названием к указанным полям. С таким набором столбцов возможно создание товаров, но их качество будет минимальное.
Рекомендуемые
Наличие рекомендуемых столбцов(Фотографии, описание, параметры и категория) в таблице позволит создать товары с более качественным наполнением. Такие товары более привлекательны, предоставляют больше информации о товаре и повышают шансы на продажу.
Необязательные
Дополнительные столбцы могут пригодится в особых случаях. Большинство необязательных столбцов дублируют общие настройки аккаунта в личном кабинете. Например, не требуется указывать координаты местоположения для каждой позиции, если местоположение точки продаж одно и та же и задано в настройках личного кабинета. Индивидуальные координаты полезны при продаже недвижимости или при многофилиальной структуре торговых точек.
Пользовательские наименования столбцов
Возможно использования произвольного наименования столбцов. Например не "Цена", а Стоимость/розничная цена, не "код товара", а "Артикул". В этом случае все поля нужно будет связать с произвольными столбцами таблицы в интерфейсе импорта.
Импорт товаров из Google таблицы
Один из самых простых и удобных способов импорта товаров - загрузка и обновление их на Au.ru через Google таблицу.
Преимущества загрузки товаров с помощью онлайн таблицы:
- Отсутствует необходимость создания и хранения отдельных файлов на компьютере.
- Отсутствует возможность запутаться в версиях файла, так как таблица всегда актуальна.
- Возможность онлайн изменения товаров.
- Резервное копирование и история изменений от Google обеспечивают защиту от случайного удаления или искажения данных.
Как загрузить товар через онлайн-таблицу:
- Создайте таблицу с товарами с нуля или скопируйте наш шаблон. (ссылка)
Для копирования шаблона потребуется учетная запись Google. Чтобы скопировать перейдите «Файл» → «Создать копию».
По шаблону внесите свои данные в таблицу.
Справочно:
Обязательные столбцы таблицы: «Код товара», «Название», «Цена».
Дополнительные рекомендуемые поля таблицы: «Фото(ссылкой)», «Описание», «Категория», «Название свойства», «Значение свойства».
Поле «Статус» используется опционально, в зависимости от того содержит ли таблица данные только об активных товарах или в ней присутствуют отсутствующие товары(необходимо указать что они в статусе:false).Подробнее обо всех возможных полях таблицы - ссылка
- Опубликуйте и скопируйте ссылку на таблицу в формате CSV.
Перейдите «Файл» → «Поделиться» → «Опубликовать в интернете» → выберите формат «Файл CSV» → поставьте галочку на пункте «Автоматически публиковать после внесения изменений» → «Начать публикацию»
Скопируйте ссылку - Добавьте ссылку на Au.ru
Наведите на ваше имя пользователя на Ау.ру в правом верхнем углу, откроется «Меню Пользователя» → откройте «Импорт лотов» → выберите «Ссылка» → выберите разделитель CSV: «запятая» → вставьте ссылку скопированную ранее → нажмите «Добавить» → дождитесь загрузки предварительного просмотра.
- Настройте и запустите выгрузку.
Соотнесите свои категории с категориями Au.ru(Рекомендуется) или настройте автоопределение категорий → Проверьте корректность других данных(цены, фотографии, описания итд) на предварительном просмотре → сохраните изменения → нажмите «Выполнить» - Дождитесь завершения импорта.
Просмотрите отчет о выполнении. Выборочно откройте товары, проверьте все ли правильно.
Импорт товаров из файла CSV
Возможно загружать товары из локальной таблицы CSV или по ссылке на такую таблицу.
Добавление файла
Добавить Csv можно на странице Импорта товаров https://au.ru/my/import/.
Выберите тип загрузки(с локального файла или по ссылке) и разделитель. По умолчанию используется разделитель точка с запятой ;
Пример файла, который можно использовать как шаблон. Можно импортировать файлы своего формата, но с небольшими доработками.
Пользовательские наименования столбцов.
Если не используете шаблон, а загружаете произвольный файл, то возможно использовать свои наименования для свойств (например, не "название" а "наименование" или "имя"), а затем сопоставить их вручную в настройках импорта. Исключение столбец "категория" - он обязательный, причем именно с таким названием.
Пример сопоставления свойств вручную:
Как сформировать файл CSV из таблицы (например, Excel)
1. Создайте таблицу с необходимыми полями (минимум: код товара, название, цена, категория)
2. Выберите меню "Файл"-"Сохранить как" -"Другие форматы"
3. Сохраните в формате "CSV (разделители - запятые )"
4. Получившийся файл разместите в облаке или на сайте (см. ниже)
Повторная загрузка обновленных данных с офлайн CSV таблицы
Чтобы повторно загрузить обновленные данные из локальной таблицы требуется в разделе Импорт нажать кнопку "Изменить ссылку" и указать путь до обновленного файла.
YML импорт. Обновление и создание лотов
Удобный инструмент с помощью которого вы можете автоматически загружать и обновлять товары с вашего сайта или 1С (другой учетной системой) на аукционе.
Что такое YML и скачать пример или скопируйте ссылку https://777999.au.ru/info/2021.yml
У Вас 100, 1000 или 10 000 товаров? YML с лёгкостью обработает этот объем: создаст новые лоты, отредактирует цену, описание и т.д, снимет завершенные, если это необходимо. YML фид обновляет лоты не по названию, а по коду товара.
Перейдём к созданию лотов:
Откройте “Импорт” и добавьте ссылку на YML файл.
- Сопоставьте категории, проверьте остальные поля, при необходимости добавьте дополнительные. Проверьте предварительный результат. Возможна автоматическая синхронизация раз в сутки или вручную, по нажатию на кнопку "выполнить".
Требования к обновлению YML:
- Активный тариф «Стандарт» или «Премиум» https://au.ru/tariffs
- Кодировка файла UTF-8 / win1251
По всем вопросам и пожеланиям обращайтесь в службу поддержки.
Загрузка прайс-листов автомобилей формата Авто.ру
Мы принимаем к загрузке прайс-листы в формате Авто.ру. Потребуется ссылка на файл в формате XML и соответствующий структуре файла auto.ru.
Добавьте ссылку на файл на странице Импорта, система автоматически определит формат, заполнит категорию, характеристики автомобилей, и отобразит фотографии. Если на предпросмотре все верно, то определитесь с дополнительными настройками и нажмите последовательно кнопки «Сохранить» и «Выполнить».
API
Интегрируйте вашу информационную систему с аукционом. Создавайте и изменяйте лоты, отвечайте на вопросы по лотам, оценивайте сделки, получайте список категорий. API развивается и со временем мы добавим новые полезные методы.
«Недвижимость» - квартиры, участки и т.д. Поддержка формата Яндекс недвижимость.
Как указать местоположение на карте для каждого лота?
Ответ: Заполняйте среди прочих атрибутов широту и долготу. Обязательно пишите с маленькой буквы, используйте точку в качестве разделителя.
<latitude>55.57328111827621</latitude>
<longitude>42.05952065327788</longitude>
Я занимаюсь недвижимостью. Файл другой площадки можно загрузить к вам? Яндекс недвижимость поддерживаете?
Ответ: Мы используем стандартный YML формат для всех категорий, в том числе и для недвижимости, а также файлы формата Яндекс недвижимость.
В каждом лоте хотим показывать только номер менеджера, продающего эту квартиру
Ответ:
1. Номер телефона менеджера дублируйте в описание лота
2. При формировании YML добавляйте тег <sales_notes>имя менеджера и номер телефона</sales_notes> или <contacts>+7 999 999 77 77, Анастасия, ваш персональный риэлтор</contacts>.
Если добавили тег, то можете добавить контакты менеджера в специальное поле. Откройте "контактную информацию".
Выберите составное значение.
Пример: в переменные $1 и $2 нужно прописать теги из yml файла, в которых есть необходимые данные. В примере это <external_user> <phone> и <external_user><first_name>
Обратите внимание: в названии лота запрещено правилами публиковать номер телефона.
YML Вопросы-ответы
Как настроить время обновления автоматически? Мне нужно каждый день в 12 часов.
Установите и сохраните настройки импорта с галочкой "Автоматически запускать выполнение раз в сутки" в нужное вам время, например в 12 часов.
На какую длительность выставляются лоты?
Бесконечные торги или торги без ограничений. При этом лот будет активен в течение всего тарифа, пока весь товар не раскупят.
У меня есть шаблон для Яндекс-Маркета! На аукцион его можно загрузить?
Разумеется. Но некоторые элементы, например delivery, pickup, store можно добавить в параметры лотов, но на Аукционе покупатели не смогут отфильтровать товары с доставкой или без доставки и т.п. Есть элемент param - он предназначен для описания характеристик и параметров товара. Если ваши названия параметров и их значения совпадут с общепринятыми на аукционе: бренд, состояние и др , то покупатели легко найдут ваши товары не только по ключевым словам в названии или описании, но и с помощью выбора товара по параметрам.
В моём файле нет параметров(характеристик товара). Могу создать лот без них?
Да, но покупатель не найдёт лоты при поиске по параметрам.
У меня несколько файлов yml с разными товарами и нужно загружать их последовательно, чтобы один не замещал другой.
При загрузке выберите для каждого файла в Настройках => Параметрах файла => Лоты которых нет в файле => игнорируем и запускайте поочередно обновления.
Загрузил лоты, но вместо фотографий серые заглушки с изображением цепи.
Напишите в службу поддержки https://help.au.ru/support/ со ссылками на лоты.
Не хватает категорий / параметров
Напишите в службу поддержки какие параметры необходимы и в каком разделе, мы передадим ответственному менеджеру.
Как найти лоты без Кода товара и завершить их все?
Скачайте со страницы мини-аукциона (Магазина) список активных лотов в удобном формате. В файл CSV сохранятся только лоты по фиксированной цене.
В файле отсортируйте лоты по externalId . Сделайте копию файла, в ней будем работать.
В файле удалите все позиции, кроме тех, у которых нет Кода товара. Для каждого лота без Кода товара поставьте в поле count (количество) цифру 0. Сохраните файл.
Загрузите его на страницу https://au.ru/my/actualize/ , проставьте соответствие полей и Актуализируйте файлы. Лоты должны завершиться.
Ранее система проставляет код товара лота = ID , поэтому если видите одинаковые значения в ID и ExternalId, то смело снимайте их с торгов
Как проставить параметры в yml файл?
Параметры сможете добавить в yml файл. Справка https://yandex.ru/support/partnermarket/param.html
После этого в файле сможете выбрать параметры (открываются сразу после заполнения категории).
У меня создался лот, но тут же завершился.
В Yml выбрано значение false в теге avaliable.
Лот будет активным если available="true"
Как указать местоположение на карте для каждого лота?
Заполняйте среди прочих атрибутов широту и долготу. Обязательно пишите с маленькой буквы, используйте точку в качестве разделителя.
<latitude>55.57328111827621</latitude>
<longitude>42.05952065327788</longitude>
Как в каждом лоте хотим указывать телефон того менеджера, который отвечает за эту позицию? То есть у каждого лота - свой менеджер, со своим телефоном.
YML-файл добавьте тег <sales_notes>имя менеджера и номер телефона</sales_notes> или <contacts>+7 999 999 77 77, Анастасия, ваш персональный менеджер</contacts>.
Если добавили тег, то можете добавить контакты менеджера в специальное поле.
В настройках импорта, смотрите: Добавить поле → выбирайте «Контактная информация» → Составное значение.
Пример на картинке: в переменные $1 и $2 нужно прописать теги из yml файла, в которых есть необходимые данные. В примере это <external_user> <phone> и <external_user><first_name>
Особенности параметров. Чтобы передавать в yml табличные параметры, чтобы по ним работал поиск
<param name="5G">Да</param>
<param name="3G">Да</param>
<param name="Сканер лица">Да</param>
... и так для каждого параметра с галкой
Итог: в параметре "Дополнительно... 5G, 3G, Сканер лица".
Как загрузить лоты в разные города?
Для этого добавьте в файл импорта, в каждый товар тэги<cityid>код города</cityid> или другой подобный(потребуется ручная привязка). Список кодов городов
API ошибки и ответы на вопросы
Отличается название лота на аукционе от названия товара в базе. Это критично?
API проверяет только по Артикулу, уникальному коду, который вы присваиваете лоту при создании или редактировании.
В условиях передачи не работает HTML верстка?
В поле «Условия передачи» не поддерживаются HTML. Исключите все тэги, в том числе <i> <u> <b> . Для переноса строки используйте /n.
Как передать несколько свойств - параметров товара?
"properties" => [[
"key" => "Состояние",
"value" => "новый"
],[
"key"=> "Совместимость",
"value"=> "iPhone 5"
]]
В методе merge есть поле status, может этот метод присутствовать поле batch?
Статус в batch работает аналогично merge.
Если не указывать поле status, что произойдет с лотом?
Если не указать статус, то ничего не изменится. Завершенный лот не выставится на торги, а активный не завершится.
Что будет с лотами, которых нет в списке лотов?
Останутся без изменений.
Сколько лотов можно передать в метод batch? Например 5000 лотов возможно?
Да, если хотите передавать более 10000 позиций, пожалуйста, свяжитесь со Службой поддержки. Мы ещё тестируем систему на больших объемах.
Нужно ли дожидаться завершения процесса? Или можно запустить процесс и все.
Необязательно дожидаться завершения. Запущенный процесс можно остановить только запросом https://market-api.au.ru/doc.html#panel_items_merge_batch__pid__stop
У нас 2 торговые точки, можно указать 2 адреса?
Создайте лот, а в условиях передачи напишите адреса магазинов, где есть этот товар”
Мне нужно массово у всех лотов сделать одинаковое изменение в описании товара, не заменить текущее, а дополнить текст
Если пришлете новое описание, то оно заменит предыдущее. Но, есть способ добавить данные к уже имеющемуся описанию:
- запрос информации по конкретному лоту, запоминаем описание в переменную,
- в переменную добавляем новый кусок описания,
- обновляем лот с обновленным описанием,
- цикл по всем лотам.
Как изменить тип торгов в уже созданных лотах?
Сейчас это невозможно. В методах /items есть type: (string) Тип торгов (Возможные значения:) standard, fixed, reverse, но они доступны только при создании нового лота.
CSV и YML: ошибки при обновлении и как их устранить
На странице https://au.ru/my/import/ нажмите рядом с файлом CSV / YML "История", затем "Скачать".
Файл с результатами загрузится на Ваш компьютер. Откройте, отсортируйте по полю "ошибки" и просмотрите лоты.
(или, если скачать файл возможности нет, откройте "Подробней" и переключитесь на "С ошибками", дайте браузеру минут 5- 10 на загрузку данных. Номер выделенный желтым - номер из Вашей базы данных).
Как устранить любые виды ошибок. Разберём несколько причин сбоев на примерах:
Вы достигли лимита активных лотов. У вас 301 активных лотов при ограничении 300 |
Необходимо или убрать из выгрузки лишние позиции или купить больше количество лотов в тарифе https://au.ru/tariffs/?target=shop
Лот с таким названием уже выставлен / Имя уже используется |
Имя товара должно быть уникальным. С помощью YML Вы можете делать составное имя добавляя марку, модель или оригинальный номер запчасти, код товара. Скачайте GIF-инструкцию https://drive.google.com/open?id=1wR7eZ62HJFVZuRKKoK27Y3_czImMqeIk
Задача проигнорирована т.к. не указана категория |
Откройте https://au.ru/my/import/ , нажмите настроить. Найдите в первой строке таблицы "Категория", нажмите карандашик и сопоставьте.
Ваш лот подлежит модерации. Пожалуйста, отредактируйте категорию в соответствии с замечанием модератора |
К какой категории относится лот? Посмотрите в своей 1С или на своём сайте по коду товара - к какой категории он относится. Если такой возможности нет, то:
откройте файл выгрузки через программу или скопируйте YMl ссылку и откройте её в строке браузере.
Откроются данные по лотам, нажмите комбинацию Ctrl+F и введите номер артикула
В примере артикул отмечен жёлтым, категория - красным цветом.
В соседней вкладке браузера откройте лот, снятый модератором https://au.ru/my/items/?status=DISCONTINUED_MODERATOR в каждом лоте, который обновляется по YML есть артикул.
На странице YML выгрузки Нажмите Ctrl + F , введите артикул. найдите позиции и посмотрите какая категория для данного файла.
Откройте настройки импорта и измените категорию.
Будьте внимательны: если в одной Вашей категории есть неподходящие товары, то нужно разделить категории в 1С.
Например, если в вашем файле, в категории "Фрукты" есть и яблоки и кухонные ножи для нарезки яблок, то нужно создать новую категорию в 1с и перенести туда ножи. После этого сопоставьте правильно категории на Аукционе и нажмите Выполнить.
Обращайтесь по всем вопросам https://help.au.ru/support/
CSV импорт, форматирование текста в описании. Что делать если текст "слипается"
Посмотрите на примере лота https://krsk.au.ru/17176032-kruzhka-krasnaja/
Используйте следующие теги:
<ul>...</ul>
— для создания маркированного списка, каждый пункт списка должен быть заключен в теги <li>...</li>
;<p>...</p>
— для нового абзаца текста;<br/>
— для переноса текста на новую строку, но не более двух подряд;
Пример
<p>Наполнители:</p>
<ul>
<li>пенополиуретан</li>
<li>кокосовая</li>
</ul>
Цветом выделить нельзя. Разрешены те теги, которые есть в редакторе при создание лота https://au.ru/new/
Инструкция по шагам:
1. Скачайте пример https://777999.au.ru/info/import_example_ru.csv
2. Откройте его с такими настройками
3. Составьте подобное описание с помощью онлайн-конвертера подобного вида: https://htmled.it/redaktor/
4. Сохраните файл на свой сайт или на гугл диск (доступ: комментирование) и загрузите ссылку на https://au.ru/my/import/
5. Сопоставьте категории. Сохранить. Выполнить.
Внимательно повторяйте все этапы и всё получится. Если всё же не удается совладать с заполнением таблиц, то рекомендуем найти толкового специалиста в этой области. На Аукционе нет услуги по заполнению, но если у Вашего специалиста появляются вопросы, мы всегда готовы подсказать решение.
Создать лот - все способы
Создать товары на Au.ru можно несколькими способами:
Приложение Au.ru уже доступно в Google play и App Store.
Обычное создание https://au.ru/new/
Доступно Магазинам Стандарт и Премиум
YML https://au.ru/my/import/ справка https://help.au.ru/help/158/#199
API https://market-api.au.ru/doc.html
Похожий лот https://help.au.ru/help/17/#173