Импорт лотов

CSV импорт. Обновление и создание лотов
YML импорт. Обновление и создание лотов
YML Недвижимость. Особенности создания лотов
YML Вопросы-ответы
API
API ошибки и ответы на вопросы
CSV и YML: ошибки при обновлении и как их устранить
CSV импорт. Что делать если текст "слипается"

Пользователям с подключенным тарифом Премиум  или Стандарт  доступны удобные инструменты для работы с большим количеством товаров: YML, CSV (excel)  https://au.ru/my/import/ и API  https://market-api.au.ru/doc.html .


CSV импорт. Обновление и создание лотов

CSV это  формат предназначенный для представления табличных данных и используется, если вы генерируете  прайс-лист в виде таблицы(Exсel, OpenOffice или из какой-либо учетной системы, например 1с) .

Файлы импорта csv обрабатываются только по ссылкам. Добавить ссылку на файл формата csv можно на странице https://au.ru/my/import/


Пример файла, который можно использовать как шаблон. Можно импортировать файлы своего формата, но с небольшими доработками. 


Список и описание элементов. Используется только один из вариантов(Ru или eng)

Элемент. Ru/ eng
Описание элемента
код товара/ externalId
Идентификатор товара. Должен быть уникальным. Обязательный
название/ name
Название товара. Обязательный.
цена /price
Цена в рублях. Обязательный.
категория
Название категории товара. Обязательный
фотографии/ pictures
Ссылки на фото. Каждая ссылка на фото отдельным столбцом. Фото 1, Фото 2 и т.д.
описание
Описание товара.
автоперевыставление/ autorepeat
Возможные значения "Автоперевыставления" - true (включено), false (выключено). Если не заданы, то берутся значения из настроек

название параметра 1/ Param 1
Параметры товара. Название параметра 1,2 итд
значение параметра 1/ Value 1
Параметры товара. Значение параметра 1,2 итд
статус/available
Возможные значения "статуса" - true (активен), false (неактивен). Если не задан, то берутся значения из настроек

долгота/ longitude
Координаты лота. Если не задано, то берутся значения из профиля
Широта/ latitude
Координаты лота. Если не задано, то берутся значения из профиля
Количество/ count
Если не задано, то берутся значения из профиля
Доставка в другие города/ delivery
Если не задано, то берутся значения из профиля
Контактная информация/ contactInfo
Если не задано, то берутся значения из профиля
Условия передачи
Если не задано, то берется значения из профиля


Возможно использовать и свои наименования для свойств(например, не "название" а "наименование") и затем сопоставить их вручную в настройках импорта. Исключение столбец "категория" - он обязательный, причем именно с таким названием. 

Пример сопоставления свойств вручную:


Как сформировать файл CSV из таблицы(Например, Excel)

1. Создайте таблицу с необходимыми полями(минимум: код товара, название, цена, категория)

2. Выберите меню "файл"-"сохранить как" -"другие форматы"

3. Сохраните в формате "CSV (разделители - запятые )"

4. Получившийся файл разместите в облаке или на сайте(см. ниже)


Как разместить файл импорта, если нет своего сайта?

1. Загрузите Ваш файл на облачное хранилище с прямым доступом к фалу (например Гуглдиск), 

2. Откройте доступ для чтения(разрешить доступ всем у кого есть ссылка). Скопируйте ссылку,

3. Скопируйте получившуюся ссылку и вставьте на страницу https://au.ru/my/import/ .


YML импорт. Обновление и создание лотов

Удобный инструмент с помощью которого вы можете автоматически загружать и обновлять товары с вашего сайта или 1С (другой учетной системой) на аукционе.

Что такое YML и скачать пример

У Вас 100, 1000 или 10 000 товаров? YML с лёгкостью обработает этот объем: создаст новые лоты, отредактирует цену, описание и т.д, снимет завершенные, если это необходимо. YML фид обновляет лоты не по названию, а по коду товара. 


Перейдём к созданию лотов:

  1. Откройте “Импорт yml” и добавьте ссылку на YML файл.    


  2. Сопоставьте категории, проверьте остальные поля, при необходимости добавьте дополнительные. Проверьте предварительный результат. Возможна автоматическая синхронизация раз в сутки или вручную, по нажатию на кнопку "выполнить".  


Требования к обновлению YML:

  • Активный тариф «Стандарт» или «Премиум» https://au.ru/tariffs
  • Кодировка файла UTF-8 / win1251

По всем вопросам и пожеланиям обращайтесь в службу поддержки.  

YML Недвижимость. Особенности создания лотов


Как указать местоположение на карте для каждого лота?

Ответ: Заполняйте среди прочих атрибутов широту и долготу. Обязательно пишите с маленькой буквы, используйте точку в качестве  разделителя.

<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>

API

Интегрируйте вашу информационную систему с аукционом. Создавайте и изменяйте лоты, отвечайте на вопросы по лотам, оценивайте сделки, получайте список категорий. API развивается и со временем мы добавим новые полезные методы. 

Документация по api  


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 адреса?

Создайте лот, а в условиях передачи напишите адреса магазинов, где есть этот товар”

Мне нужно массово у всех лотов сделать одинаковое изменение в описании товара, не заменить текущее, а дополнить текст

Если пришлете новое описание, то оно заменит предыдущее. Но, есть способ добавить данные к уже имеющемуся описанию:

  1. запрос информации по конкретному лоту, запоминаем описание в переменную,
  2. в переменную добавляем новый кусок описания,
  3. обновляем лот с обновленным описанием,
  4. цикл по всем лотам.

Как изменить тип торгов в уже созданных лотах?

Сейчас это невозможно. В методах /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/

Используйте следующие теги:

<h3>...</h3> — для выделения заголовка;
<ul>...</ul> — для создания маркированного списка, каждый пункт списка должен быть заключен в теги <li>...</li>;
<p>...</p> — для нового абзаца текста;
<br/> — для переноса текста на новую строку, но не более двух подряд;

Список:

<h3>Односторонний матрас средней жесткости на основе блока независимых пружин EVS 500</h3>
        <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. Сопоставьте категории. Сохранить. Выполнить. 

Внимательно повторяйте все этапы и всё получится. Если всё же не удается совладать с заполнением таблиц, то рекомендуем найти толкового специалиста в этой области. На Аукционе нет услуги по заполнению, но если у Вашего специалиста появляются вопросы, мы всегда готовы подсказать решение.

Полезна ли информация на данной странице?