Интеграция с Яндекс.Маркет

Вы можете интегрировать между собой ваш сайт на платформе PARTS SOFT и аккаунт продавца на Яндекс.Маркет. Далее показано, как выгрузить товары в магазин на Яндекс.Маркет, обновлять их цены и остатки автоматически, а также настроить получение заказов по модели FBS.

Процесс интеграции происходит в три этапа:

1. Загрузка XLSX или YML-файла с товарами на Яндекс Маркет.

2. Загрузка YML-файла для обновления цен и остатков на Яндекс Маркет.

3. Получение заказов с маркетплейса в систему PARTS SOFT посредством API. Настройка возможна только при наличии старшего тарифа обслуживания/аренды.

1 Загрузка товаров на Яндекс Маркет

1.1 Способ первый: С помощью XLSX-шаблона с маркетплейса

1.1.1 Получение шаблона в личном кабинете Яндекс.Маркет

ШАГ 1. В разделе Товары → Каталог нажмите кнопку Загрузить товары.

Вход в каталог Яндекс.Маркет

ШАГ 2. В блоке Все товары разом нажмите кнопку Загрузить.

Загрузка товаров в каталог

ШАГ 3. Для получения файла шаблона нажмите кнопку Скачать шаблон.

Загрузка шаблона

1.1.2 Выгрузка данных для шаблона из системы PARTS SOFT

ШАГ 1. В разделе админпанели Выгрузки → Все нажмите кнопку Создать новую выгрузку.

ШАГ 2. На странице Создание выгрузки введите название и нажмите Перейти к настройке.

ШАГ 3. На вкладке Типы выгрузки произведите следующие настройки:

1. Если заполненный файл шаблона будет иметь размер больше 100 Мб, Яндекс.Маркет не загрузит его. В этом случае вы можете разделить файл на части:

• В поле Разбивать результат на части по N позиций укажите максимальное количество строк, которое будет в выходных файлах. Например, до 500 000.
• Включите галочку Упаковать все части в один архив, чтобы выходные файлы были в одном ZIP-архиве.

2. На вкладке Стандартный формат поставьте галочку Выгружать в формат XLSX. Галочку Выгружать в формат CSV можно снять.

3. В блоке Настроить порядок столбцов перенесите в колонку Активные элементы с названиями полей, обязательных для заполнения в шаблоне. Для удобства расположите их в том порядке, в каком они расположены в шаблоне:

• offer id (соответствует SKU)
• Название
• Ссылка на изображение
• Описание
• Категория
• Бренд
• EAN (соответствует штрихкоду/barcode)

Остальные элементы должны остаться в колонке Доступные.

Настройка стандартной выгрузки

ШАГ 4. На вкладке Настройка данных сделайте следующие настройки:

1. Выберите алгоритм Лучшие цены, чтобы в выгрузку попадали товары с наиболее выгодными предложениями.

2. Отметьте прайс-листы, товары из которых должны попасть в выгрузку.

3. В блоке Настройте параметры фильтрации позиций поставьте галочки:

• Исключать предложения для которых не найдены изображения в доступных источниках
• Исключать предложения без barcode

Это нужно, поскольку Яндекс.Маркет не загружает товары без изображений и barcode. При наличии таких товаров маркетплейс может отклонить выгрузку.

Настройка данных: фильтрация позиций, алгоритмы

4. В блоке Дополнение и модификация данных включите опцию Использовать распределение по категориям api.parts-soft.ru, чтобы для распределения по категориям использовались не только локальные правила, но и справочник PARTS SOFT.

5. В блоке Габариты по умолчанию заполните поля Вес товара, Длина товара, Ширина товара, Высота товара. Эти значения будут назначаться товарам, если параметры отсутствуют в прайс-листе.

6. В блоке Формирование Offer ID выберите алгоритм Базовый (по умолчанию, как сейчас для Яндекс.Маркета) .

7. В блоке Работа с изображениями включите опцию Выгружать логотип бренда, если нет изображения. Если у вас подключена услуга api.photo, можно также активировать загрузку изображений из системы parts-soft.ru. Для этого включите галочку Использовать фотографии из api.parts-soft.ru.

Настройка данных: габариты, offer id, изображения

ШАГ 5. На вкладке Цена продажи укажите:

• группу скидок, для которой должна рассчитываться цена в выгрузке;
• валюту, в которой должны быть цены в выгрузке;
• правила округления цены — в списках Округление цены и Алгоритм округления цены;
• отметьте галочкой пункт Зафиксировать цену предложения в ссылке, без которой товары не пройдут модерацию на Яндексе.

Цена продажи

ШАГ 6. При необходимости на вкладке Расписание настройте свой график обновления выгрузки.

ШАГ 7. Сохраните изменения и запустите формирование выгрузки кнопкой Пересобрать.

ШАГ 8. Перейдите в раздел админпанели Выгрузки → Все и скачайте сформированную выгрузку отдельными файлами XLSX или в виде архива.

Скачивание XLSX-файла выгрузки

1.1.3 Заполнение шаблона

ШАГ 1. Откройте шаблон, скачанный на этапе 1.1.1, и на листе Ассортимент удалите строку с образцом заполненного товара.

Шаблон каталога, лист Ассортимент

ШАГ 2. Откройте полученный на этапе 1.1.2 файл и скопируйте из него данные в шаблон:

• Из столбца offer id —  в столбец шаблона SKU
• Из столбца Название шаблона — в столбец шаблона Название товара
• Из столбца Ссылка на изображение — в столбец шаблона Ссылка на изображение
• Из столбца Описание — в столбец шаблона Описание товара
• Из столбца Категория — в столбец шаблона Категория в вашем магазине
• Из столбца Бренд — в столбец шаблона Бренд
• Из столбца EAN — в столбец шаблона Штрихкод

Копирование данных

1.1.4 Загрузка товаров в Яндекс.Маркет

Выполните действия описанные для этапа 1.1.1 в шагах 1 и 2. После этого:

ШАГ 1. Выберите файл, подготовленный на этапе 1.1.3.

ШАГ 2. Внизу страницы нажмите на кнопку Проверить файл.

Загрузка товаров из заполненного шаблона

ШАГ 3. Если файл был оформлен без ошибок, появится кнопка Загрузить. Нажмите на неё, чтобы добавить все товары в каталог.
В противном случае вы увидите сообщение о найденных в файле ошибках. Исправьте их и повторно загрузите файл.

ШАГ 4. Все загруженные товары будут добавлены в каталог. Разместите их в соответствующих магазинах Яндекс.Маркета, как показано в официальной инструкции маркетплейса.

Каталог Яндекс.Маркет

1.2 Способ второй: с помощью YML-файла из системы PARTS SOFT

Для успешной загрузки товаров на Яндекс Маркет необходимо подготовить выгрузку в специальном формате, который уже преднастроен в системе PARTS SOFT. С его помощью можно передавать характеристики товаров и основные цены. Для проверки своего YML-файла можно использовать шаблон от Яндекс Маркет для управления товарами.

1.2.1 Формирование YML-файла для управления товарами

ШАГ 1. В разделе админпанели Выгрузки → Все нажмите на кнопку Создать новую выгрузку.

ШАГ 2. Введите название выгрузки, например «Загрузка товаров на Яндекс.Маркет», и нажмите на кнопку Перейти к настройке.

ШАГ 3. На вкладке Типы выгрузки произведите следующие настройки:

1. Если подготовленный файл YML будет больше 100 мб, Яндекс Маркет не загрузит его. В этом случае вы можете разделить файл на части: 

• В поле Разбивать результат на части по N позиций укажите максимальное количество строк, которое будет в выходных файлах. Например, до 500 000.
• Включите галочку Упаковать все части в один архив, чтобы выходные файлы были в одном ZIP-архиве.

2. На вкладке Типы выгрузки → Стандартный формат снимите галочку Выгружать в формат CSV.

ШАГ 4. Откройте вкладку Типы выгрузки → YML (Яндекс), где:

• Включите галочку Выгружать в формат YML.
• Из выпадающего списка Категория по умолчанию Яндекс Маркет выберите вариант, который будет использоваться для всех товаров без назначенной категории. Обычно Все товары/Авто. Подробнее о распределении товаров по категориям в выгрузке.

Вкладка YML (Яндекс)

ШАГ 5. В блоке Опции выгрузки YML обязательно укажите необходимые для Яндекс Маркет параметры:

• Виды оплат
• Короткое название магазина
• Полное наименование компании владеющей магазином
• Выгружать barcode
• Выводить страну изготовителя
• Добавить в название номер детали

Опции выгрузки YML

ШАГ 6. Заполните на вкладке Настройка данных поля Вес товара, Длина товара, Ширина товара, Высота товара (см. блок Габариты по умолчанию). Эти значения будут назначаться товарам, если параметры отсутствуют в прайс-листе.

ШАГ 7. Выполните шаги 4-7, указанные для этапа 1.1.2.

ШАГ 8. Сохраните изменения и запустите формирование выгрузки кнопкой Пересобрать.

ШАГ 9. Перейдите в раздел админпанели Выгрузки → Все и скопируйте ссылку на сформированный YML-файл.

Копирование ссылки на YML-файл

ШАГ 10. Отредактируйте скопированную ссылку в любом текстовом редакторе:

Если вы используете свой домен, то:

• Удалите префикс admin. из адреса вашего сайта.
• Удалите часть ?rand=...
• Если у вас есть SSL-сертификат и в начале ссылки стоит протокол http, замените его на https

Подготовка ссылки на выгрузку, если домен свой

Если у вас нет своего домена и вы используете служебный, то:

• Замените префикс admin на www
• Удалите часть ?rand=...

Подготовка ссылки на выгрузку, если домен служебный

1.2.2 Загрузка YML-файла с товарами на Яндекс Маркет

ШАГ 1. В личном кабинете на Яндекс.Маркет откройте раздел Товары → Автообновление каталога и нажмите кнопку Добавить ссылку на файл.

Добавление ссылки на файл

ШАГ 2. В открывшемся окне:

1. Из выпадающего списка Что передаём выберите пункт Товары.

2. Вставьте ссылку, полученную на этапе 1.2.1 (см. шаг 10), в поле Ссылка на файл.

3. Нажмите кнопку Проверить файл и дождитесь окончания проверки.

Добавление ссылки на файл

ШАГ 3. Если Яндекс Маркет не найдёт ошибок в загруженном YML-фиде, появится соответствующее сообщение. Сохраните ссылку на выгрузку и дождитесь проверки товаров.

Добавление ссылки на файл

ШАГ 4. После проверки товары станут доступны в разделе Яндекс Маркета Товары → Ассортимент по магазинам.

2 Обновление цен и остатков

2.1 YML-файл для управления размещением на Яндекс Маркет

Для управления размещением на Яндекс Маркет нам понадобится еще один YML-файл. Через него мы сможем вносить данные о способах доставки и самовывозе, а также обновлять остатки и цены. Скачать YML-файл для проверки переменных можно тут.

Для создания выгрузки воспользуйтесь способом описанным для этапа 1.2.1. При ее настройке нужно указать в точности те же самые параметры, которые были использованы для формирования XLSX- или YML-файла для загрузки товаров на Яндекс Маркет: прайс-листы, алгоритм выгрузки, режим формирования offer id и др. Также на вкладке Настройка данных дополнительно выполните следующие действия:

ШАГ 1. В блоке Опции выгрузки YML отметьте следующие опции:

• Выгружать данные об остатках
• Выгружать мин. количество в тег step-quantity

ШАГ 2. В блоке Параметры доставки и ПВЗ заполните поля:

• Срок доставки в календарных днях (общий)
• Стоимость доставки в рублях (общая)

Параметры доставки в ПВЗ

ШАГ 3. Перейдите к блоку Дельта выгрузки (модуль расширения) и в выпадающем списке выберите пункт Без выгрузки нулевых остатков (для числового Offer ID).

Дельта выгрузки

В результате вы получите ссылку на файл для управления размещением, которую нужно будет добавить в Яндекс. Маркет.

2.2 Добавление YML-файла для управления размещением в Яндекс Маркет

ШАГ 1. В личном кабинете на Яндекс Маркет откройте раздел Товары → Автообновление каталога и нажмите кнопку Добавить ссылку на файл.

ШАГ 2. В открывшемся окне:

• Из выпадающего списка Что передаём выберите пункт Условия размещения в магазине.
• Выберите магазин для размещения товаров.
• Вставьте ссылку, полученную на этапе 2.1, в поле Ссылка на файл.
• Нажмите кнопку Проверить файл и дождитесь окончания проверки

Добавление YML-файла для управления размещением в Яндекс Маркет

ШАГ 3. Если Яндекс Маркет не найдёт ошибок в загруженном YML-фиде, появится соответствующее сообщение. Сохраните ссылку на выгрузку и дождитесь проверки товаров.

ШАГ 4. После проверки товары станут доступны в разделе Яндекс Маркета Товары → Ассортимент по магазинам.

3 Получение заказов с маркетплейса

3.1 Получение авторизационных данных на Яндекс Маркет

ШАГ 1. В личном кабинете на Яндекс.Маркет зайдите в раздел Настройки → Настройка API.

ШАГ 2. Скопируйте Номер кампании — начинается после дефиса.

Идентификатор кампании

ШАГ 3. Пройдите по ссылке: oauth.yandex.ru/authorize.

ШАГ 4. Авторизуйтесь на Яндексе, используя логин и пароль от своего аккаунта продавца.

ШАГ 5. Скопируйте токен на открывшейся странице.

OAuth-токен

3.2 Настройка интеграции на стороне системы PARTS SOFT

ШАГ 1. В разделе Справочники → Маркетплейсы нажмите на кнопку Яндекс Маркет и в открывшемся окне подтвердите подключение сервиса.

Подключение к Яндекс Маркет

ШАГ 2. В настройках интеграции с Яндекс.Маркетом сделайте следующее:

1. Укажите название интеграции.

2. Включите галочку Аккаунт активен.

3. Выберите регион подключения.

Настройки интеграции с Яндекс Маркет

ШАГ 3. Укажите авторизационные данные, полученные на Яндекс.Маркет в соответствующих полях:

1. В поле Идентификатор кампании введите номер, полученный на этапе 3.1 (см. шаг 2 ) .

2. В поле OAuth-токен введите авторизационный токен, полученный на этапе 3.1 (см. шаг 5 ).

3. Если нужно протестировать интеграцию с Яндекс.Маркет, включите галочку Тестовый режим получения заказов.

Авторизационные данные

ШАГ 4. Настройте связи с Яндекс.Маркет:

• Выберите выгрузку, которую создавали на этапе 1. Это необходимо, чтобы информация о заказах связывалась с товарами, выгруженными на маркетплейс.
• Из списка Связанный контрагент выберите клиента, на которого будут оформляться заказы в разделе Заказы → Все. Если нужного клиента нет в списке, то создайте его, как описано в нашей статье "Как добавить клиентов" (см. раздел «Добавление клиента вручную»).

Настройки связи с маркетплейсом

ШАГ 5. Для корректной автоматической обработки заказа необходимо:

• Из списка Статус позиции заказа, когда заказ маркетплейса ожидает оплаты выбрать статус из группы Обрабатывается, например Ожидает оплаты. В таком случае, автообработка не сработает до тех пор, пока заказ не будет оплачен или отменен.
• Из списка Статус позиции заказа, когда заказ маркетплейса перешел в отказ по причины неуплаты выбрать статус из группы Снят.
• Из списка Статус позиции заказа при получение запроса на отмену выбрать статус, в который будет переходить заказ при его отмене со стороны маркетплейса.

Настройки статусов и цены позиции

ШАГ 6. В выпадающем меню Цена позиции выберите по какому алгоритму будет приходить информация о цене позиции от Яндекс Маркета. До применения скидок Яндекс Маркета или после их применения.

ШАГ 7. Сохраните настройки интеграции.

ШАГ 8. Укажите требуемые параметры в появившемся блоке Настройка автоматической обработки заказа. Инструкцию по работе с ним вы можете посмотреть в нашей статье "Автоматическая обработка заказов". 

Список обработанных и распределенных позиций из заказов, загруженных с Яндекс.Маркета, будет доступен в разделе Заказы → Все. Они будут закреплены за клиентом, которого вы указали на шаге 4 .

Видео по теме