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

Вы можете интегрировать между собой ваш сайт на платформе 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. В поле Разбивать результат на части по N позиций укажите максимальное число строк в заполненном файле (например, 500 000). Разбивать файл необходимо, если размер заполненного файла больше 100 Мб, иначе Яндекс.Маркет не загрузит его;

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

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

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

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

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

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

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

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

Настройки на вкладке Цена продажи

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

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

Настройки на вкладке Настройка данных

3. В блоке Настройте параметры фильтрации позиций активируйте опцию Исключать предложения для которых не найдены изображения в доступных источниках;
4. В блоке Настройте параметры фильтрации позиций активируйте опцию Исключать предложения без barcode;

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

ШАГ 7. На вкладке Расписание:

1. Отключите автоматическую ночную выгрузку, если требуется проводить выгрузку только по заданному расписанию. По умолчанию выгрузка обновляется автоматически около 2:00 по московскому времени.
2. Настройте собственный график выгрузки, если требуется. Для этого выберите дни недели, время и нажмите кнопку добавить. Заданные временные слоты будут указаны в списке выше.

Настройки на вкладке Расписание

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

Обновление выгрузки

ШАГ 9. Скопируйте ссылку на 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. В поле Разбивать результат на части по N позиций укажите максимальное число строк в заполненном файле (например, 500 000). Разбивать файл необходимо, если размер заполненного файла больше 100 Мб, иначе Яндекс.Маркет не загрузит его;

Если вы разделяете выгрузку на части, для каждой из них необходимо будет заполнить отдельный файл XLSX-шаблона (этап 1.1.3), а затем загрузить на Яндекс.Маркет получившиеся части каталога по очереди (этап 1.1.4).

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

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

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

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

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

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

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

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

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

Цена продажи

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

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

Настройки на вкладке настройка данных

3. В блоке Настройте параметры фильтрации позиций активируйте опцию Исключать предложения для которых не найдены изображения в доступных источниках;
4. В блоке Настройте параметры фильтрации позиций активируйте опцию Исключать предложения без barcode;

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

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

Настройки на вкладке Настройка данных

ШАГ 8. На вкладке Расписание:

1. Отключите автоматическую ночную выгрузку, если требуется проводить выгрузку только по заданному расписанию. По умолчанию выгрузка обновляется автоматически около 2:00 по московскому времени.
2. Настройте собственный график выгрузки, если требуется. Для этого выберите дни недели, время и нажмите кнопку добавить. Заданные временные слоты будут указаны в списке выше.

Настройки на вкладке Расписание

ШАГ 9. Сохраните изменения и запустите формирование выгрузки с помощью кнопки Обновить. Сформированная выгрузка будет доступна в общем списке выгрузок.

Обновление выгрузки

ШАГ 10. Скопируйте ссылку на YML-файл.

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

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

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

1. Замените http на https;
2. Уберите префикс admin.;
3. Уберите часть ссылки начиная с ?rand.

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

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

• Замените префикс admin на www;
• Уберите часть ссылки начиная с ?rand.

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

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

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

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

ШАГ 2. В открывшемся окне выполните следующие действия:

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

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

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

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

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

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

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

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

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

Также на вкладке Настройка данных дополнительно выполните следующие действия:

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

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

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

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

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

Настройки доставки и ПВЗ

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

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

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

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

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

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

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

Добавление 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. В поле OAuth-токен введите авторизационный токен, полученный на этапе 3.1.
3. Если нужно протестировать интеграцию с Яндекс.Маркет, включите галочку Тестовый режим получения заказов.

Подробнее о том, как работают тестовые заказы, вы можете прочитать в справке Яндекса.

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

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

1. Введите названия или ID складов в Яндекс.Маркет если требуется, чтобы заказы приходили только с указанных складов. Перечислите требуемые склады через знак вертикальной черты |, без пробелов.
2. Выберите выгрузку, которую создавали на этапе 1. Это необходимо, чтобы информация о заказах связывалась с товарами, выгруженными на маркетплейс.
3. Из списка Связанный контрагент выберите клиента, на которого будут оформляться заказы в разделе Заказы → Все. Если нужного клиента нет в списке, создайте его.

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

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

1. Из списка Статус позиции заказа, когда заказ маркетплейса ожидает оплаты выберите статус из группы Обрабатывается, например Ожидает оплаты. В таком случае, автообработка не сработает до тех пор, пока заказ не будет оплачен или отменен.
2. Активируйте опцию Запустить автоматическую обработку заказа даже если статус маркетплейса ожидает оплаты чтобы позиции в статусе Ожидает оплаты обрабатывались автоматически.
3. Из списка Статус позиции заказа, когда заказ маркетплейса перешел в отказ по причины неуплаты выберите статус из группы Снят.
4. Из списка Статус позиции заказа при получение запроса на отмену выберите статус, в который будет переходить заказ при его отмене со стороны маркетплейса.
5. Из списка Цена позиции выберите алгоритм, по которому от Яндекс Маркета будет приходить информация о цене позиции. Доступные варианты:

• До применения скидок – будет показываться цена без учета скидок (полная цена);
• До применения скидок с учетом вознаграждения партнеру – будет показываться полная цена (без учета скидок), включающая также сумму вознаграждения партнеру; 
• После применения скидок – будет показываться цена с учетом скидок.

Сохраните изменения.

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

ШАГ 6. После сохранения настроек станет доступен блок Настройка автоматической обработки заказа. Для настройки автоматической обработки заказов, поступающих с Яндекс.Маркета, воспользуйтесь инструкцией Автоматическая обработка заказов.

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

Видео по теме

YouTube

RuTube