Подключение сервиса "Покупка на Маркете" (модуль Яндекс.Маркет Pro)

Рассмотрим как настроить интеграцию с сервисом Яндекс.Маркет с помощью модуля "Яндекс.Маркет Pro".

Модуль "Яндекс.Маркет Pro" позволяет принимать заказы из маркетплейса "Яндекс.Маркет", обрабатывать их и автоматически обновлять остатки у товаров.

Внимание!

Модуль "Яндекс.Маркет Pro" поддерживается для магазинов версии 12.0.0 и выше. Если Ваш магазин версии ниже, пожалуйста, обновите магазин до 12.0.0 и выше до начала работы с модулем.

Внимание!

Для правильной работы интеграции нужен SSL-сертификат.

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

Если Вы используете лицензированную версию на хостинге с выделенным сервером и у Вас уже есть зарегистрированный сертификат, посмотрите инструкцию "Установка SSL сертификата на Microsoft IIS 7.x" либо воспользуйтесь услугой установки SSL: "Установка SSL сертификата"

Если необходима регистрация и установка нашими силами, воспользуйтесь услугами установки SSL под ключ: "Услуга регистрации SSL под ключ 1 год" или "Услуга регистрации SSL под ключ 2 года"

Если Вы используете лицензированную версию на shared хостинг, по данному вопросу обратитесь в поддержку Вашего хостинга.
Так же обратите внимание, что в данном случае услуга установки силами специалистов advantshop недоступна.

Подключение к продаже товаров на Яндекс.Маркете состоит из нескольких этапов:

1. Регистрация и заключение договора

2. Подготовка товаров к продаже

3. Настройка API

4. Уведомления

5. Настройка обработки заказов

   1. Создание приложения
   2. Синхронизация статусов между Я.Маркетом и магазином
   3. Особенности настройки по модели DBS

6. Настройка склада и указание данных для возвратов/невыкупов

7. Самопроверка

8. Контрольный заказ

• Продажа электронных товаров на Яндекс.Маркете

В процессе подключения по API магазин участвует на некоторых этапах. Далее мы рассмотрим настройку по шагам, на некоторых из них вы будете перенаправлены на дополнительные инструкции.

 

1. Регистрация.

Внимание!

Модуль  Яндекс.Маркет Pro  позволяет работать с программой "Покупка на Маркете" только по модели FBS/FBY/FBY+ и DBS.

Начать регистрацию и посмотреть возможные варианты работы программы "Покупка на Маркете" можно по ссылке.

 

2. Подготовка товаров к продаже.

На данном этапе потребуется сформировать выгрузку каталога со стороны магазина и разместить получившуюся ссылку на Маркете. В административной части магазина в меню слева нажимаем "Добавить канал продаж", в списке выбираем "Яндекс.Маркет Pro" (рис.1).

Рисунок 1.

При добавлении канала продаж в магазин добавляется модуль Яндекс.Маркет Pro. В модуле 2 блока настроек - "Каталог" и "Заказы и остатки". На этапе подготовки товаров нужно добавить выгрузку - кнопка "Добавить выгрузку". Заполняем название выгрузки и описание (при необходимости) (рис.2).

Рисунок 2.

Далее на открывшейся странице переходим в "Параметры выгрузки" и указываем настройки для выгрузки. При необходимости указываем наценку, настройки для выгрузки по расписанию. Ниже приведен пример настроек (рис.3).

Рисунок 3.

Далее рассмотрим параметры выгрузки, которые являются минимально необходимыми для того, чтобы Маркет принял файл с каталогом. С полным перечнем доступных настроек для yml вы можете ознакомиться в нашей статье.

В блоке "Настройки цен и валюты" поставим галочку "Не выгружать блок валют currencies" - в последнее время блок с валютами не требуется для Я.Маркета.

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

Тип цены - дает возможность выбрать тип цены товара для выгрузки на Яндекс.Маркет. Актуально, если в магазине несколько каналов продаж, и для каждого канала продаж стоимость товарного предложения уникальна. Подробнее о типах цен в статье.

Также есть возможность указать "Интервал цен для выгрузки товаров": предложение будет попадать в выгрузку только если цена попадает в указанный диапазон (рис.4).

Рисунок 4.

В блоке настройки товаров рекомендуемые настройки следующие:

Выгружать в качестве идентификатора товарного предложения и Выгружать в качестве vendorCode - Артикул модификации. Это артикул, который указан в карточке товара в таблице с ценами. Он же отображается в заказе при просмотре заказа в административной части (рис.5). Чаще всего более удобно, если именно "Артикул модификации" выступает в качестве SKU предложения на Маркете.

Рисунок 5.

Какое описание товара использовать - Краткое (если заполнено) или Полное, или можно выбрать вариант "Не выгружать".

Также указываем настройки для выгрузки Свойств, Штрихкода (для некоторых категорий на Маркете штрихкод является обязательным), Габариты товара, Количество товара, теги shop-sku и manufacturer (рис.6).

Рисунок 6.

Остальные настройки индивидуальны. Полное описание тегов, которые можно выгружать в yml файл на advantshop в статье.

Когда все настройки выбраны, выполняем сохранение (кнопка в правом верхнем углу). После чего можно переходить на вкладку "Выбор товаров" - там выбираем категории, которые будут выгружены на Маркет. Можно выбрать все товары или определенные категории из списка. Ниже показан вариант, когда на Маркет выгружается только категория Сумки и все вложенные в нее категории (рис.7).

Рисунок 7.

После нажатия на "Экспортировать" начнется процесс формирования файла. Когда процесс завершится, скопируем ссылку на файл (рис.8), она будет нужна на следующем шаге.

Рисунок 8.

Переходим в кабинет Маркета.

В кабинете Яндекс.Маркета в разделе "Товары" - "Автообновление каталога" добавляемссылку на файл (рис. 9).

Рисунок 9.

В поле "Ссылка на файл" добавляем скопированную ранее ссылку на получившийся файл с товарами (рис.10).

Рисунок 10.

Далее на стороне Маркета начнется обработка файла. Процесс занимает некоторое время, после чего будет возможность скачать файл с описанием предупреждений, которые Маркет определил для загруженных товаров. Сохранztv ссылку, список предупреждений можно скачать (рис.11).

Внимание!

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

Рисунок 11.

В течение некоторого времени товары проверяются и подготавливаются к публикации. Далее можно перейти в каталог и посмотреть получившиеся карточки (рис.12).

Рисунок 12.

Сначала карточки будут выглядеть пустыми, со временем Маркет дополнит информацию, свяжет с уже существующими карточками на маркетплейсе. Чем больше товаров в файле, тем дольше этот процесс (рис.13)..

Рисунок 13.

Чтобы добавить карточки к одной из ваших компаний на Маркете, переходим в раздел "Товары" - "Ассортимент по магазинам" - "Ожидают размещения" (рис.14).

Рисунок 14.

Далее выделяем все товары и нажимаем "Передать данные". Проверяем, что выбрана нужная компания (рис.15).

Рисунок 15.

Размещение занимает некоторое время. Нужно будет дождаться, чтобы товары появились в разделе "Товары".

Далее нужно разместить ссылку на автообновление каталога,чтобы товары, которые выходят из ассортимента магазина, автоматически скрывались с витрины Маркета, а при возвращении к продаже, появлялись вновь.

В разделе "Товары" - "Автообновление каталога", далее  "Добавьте ссылку на файл" (рис.16).

Рисунок 16.

Там уже будет ссылка, которую добавляли ранее, для загрузки товаров. Для автообновления условий размещения нужна дополнительная настройка. Если несколько компаний, для каждой компании необходимо добавьте свою. При этом ссылки могут быть одинаковыми. Т.е. те же самые товары  можно продавать как по модели FBS, так и по DBS (рис.17).

Рисунок 17.

Ссылки (или ссылку, если использовали одну и ту же ссылку) магазин обновляет по расписанию из настроек магазина (раздел Параметры выгрузки, рис. 3 выше). Как часто обращается Маркет к ссылке - зависит от собственного расписания Маркета. Если выполнялись сильные изменения в магазине, и нужно, чтобы Маркет скрыл вышедшие из ассортимента товары (те, которые перестали передаваться в фале от магазина) как можно скорее, на стороне Маркета можно принудительно отправить файл на обновление (рис. 18).

Рисунок 18.

С каталогом на этом все. Переходим к следующему шагу.

 

3. Настройка API.

Настройка синхронизации по API предполагает, что остатки Маркет будет проверять в магазине напрямую, минуя файл, а так же заказы с маркетплейса будут поступать в административную панель сайта - т.е. обработка заказов будет выполняться в административной части, а не в кабинете Маркета.

Далее рассмотрим настройки на примере модели FBS. Для модели DBS настройки аналогичны, но добавляется блок для настройки синхронизации доставки. О настройке синхронизации по доставкам поговорим далее.

В кабинете Я.Маркета переходим в раздел "Настройками" - "Настройки API" (рис.19).

Рисунок 19.

На открывшейся странице скопируем номер компании и разместим его в настройках канала продаж на стороне advantshop (рис.20).

Рисунок 20.

Далее сгенерируем "Авторизационный токен". Это ключ, с которым Я.Маркет будет обращаться к сайту при передаче данных по товарам и при запросе остатков (рис.21).

Рисунок 21.

После подтверждения генерации открывается окно с токеном и предложением "Применить". Скопируем строку с токеном. Кнопку "Применить" пока что не нажимаем (рис.22).

Рисунок 22.

Далее размещаем скопированный токен в модуле "Яндекс.Маркет Pro" в разделе настроек. Проверяем, что модуль Яндекс.Маркет Pro активен (рис.23).

Рисунок 23.

Далее на стороне Маркета нажимаем "Применить" (рис.24).

Рисунок 24.

Скопируем URL для запросов API из магазина и разместим в настройках Маркета (рис.25).

Рисунок 25.

Далее мы рассмотрим настройки уведомлений.

4. Уведомления по Api 

В кабинете Я.Маркета переходим в раздел  "Настройки" - "Модули и API" (рис.26). 

Рисунок 26.

Далее нажимаем "Создать с полным доступом" (рис.27).

Рисунок 27.

Созданный токен ставить в "Api-Key" для уведомлений в настройках канала продаж Яндекс.Маркет Pro и скопировать "URL для получения уведомлений" (рис.28).

Рисунок 28.

На стороне Яндекс Маркета подключаем уведомления в пункте "Настройки - API-уведомления" (рис.29).

Рисунок 29.

Указываем название, выбираем для всего кабинета или определенного магазина, из списка добавляем все типы уведомлений, связанные с заказами и вставляем ссылку на уведомления, ранее скопированную из магазина (рис.30).

Рисунок 30.

5. Настройка обработки заказов.

Создание приложения

Для того, чтобы магазин мог обращаться в Маркету, потребуется сформировать приложение для авторизации в сервисе Маркета, и прописать идентификационные данные приложения (id и токен) в модуле магазина. Рассмотрим процесс по шагам.

Шаг 1. Перейдите по ссылке. Заполните название вашего сервиса. Можно указать имя магазина или написать просто Магазин. Иконку загружать нет необходимости.

Рисунок 31.

Шаг 2. Поставьте галочку Веб-сервисы и в открывшемся поле Redirect URL добавьте URL для отладки - выберете вариант, который предлагает Яндекс Подставить URL для отладки.

Рисунок 31.

Шаг 3. В блоке Доступ к данным найдите АПИ Маркета.

Рисунок 33.

Шаг 4. Укажите почту для связи. Все настройки на одном рисунке ниже. Далее нажмите Создать приложение.

Рисунок 34.

Далее откроется страница с данными приложения. Понадобятся идентификатор ClientID, скопируйте его и разместите его в настройках модуля в поле Идентификатор приложения.

Внимание!

Обратите внимание, что время жизни ключа - 1 год. Т.е. через год нужно будет пересоздать приложение, и обновить ключи в настройках модуля на стороне административной панели.

Рисунок 35.

Рисунок 36.

Далее нужно сформировать токен, с которым магазин будет обращаться к Маркету. Сформируйте URL с началом "https://oauth.yandex.ru/authorize?response_type=token&client_id=ХХХХХХ". Вместо ХХХХХХ вставьте скопированный ранее ClientID. Откройте в браузере получившийся URL, далее нажмите Enter

Рисунок 37.

Откроется страница с Авторизационным токеном (возможно, будет предложено авторизоваться в аккаунте - проверьте, что аккаунт именно тот, с которого создан кабинет Маркета, и авторизуйтесь). Скопируйте токен.

Рисунок 38.

И разместите его в настройках магазина. Должно получиться следующим образом:

Рисунок 39.

Сразу посмотрим другие настройки в модуле.

Рисунок 40.

Учитывать скидку Я.Маркета в итоговой стоимости заказа - со стороны Яндекс.Маркета в качестве отдельного значения передается скидка самого маркетплейса. Величину этой скидки можно как загружать в магазин (галочка активна), так и игнорировать (галочка не активна). Настройка может быть полезна при построении аналитических отчетов.

Учитывать стоимость доставки в итоговой стоимости заказа - со стороны Яндекс.Маркета в качестве отдельного значения передается стоимость доставки. Величину доставки можно как загружать в магазин (галочка активна), так и игнорировать (галочка не активна). Настройка может быть полезна при построении аналитических отчетов.

Номер заказа как в Яндекс.Маркете - номера заказов для заказов, пришедших с Я.Маркета будут идти вразрез со стандартной нумерацией заказов из остальных каналов продаж, в списке всех заказов номер заказа будет таким же, как его видит покупатель на Маркете.

Отдавать нулевые остатки, если товара меньше чем - когда Маркет будет опрашивать магазин о остатках, при использовании этой настройки можно отдавать Маркету нулевой остаток, даже если в карточке товара не ноль. Например, если в настройках будет указано 1, то для всех товаров, у которых в остатке 0 или 1, магазин все равно будет отдавать Маркету 0. Это бывает полезно, когда остатки в магазине очень динамично меняются.

Внимание!

Между модулем и фидом с товарами должно совпадать значение в настройках "Отдавать нулевые остатки, если товара меньше чем" и "Не выгружать товар, если товара менее" (если они используются). Число, указанное в данных настройка должно совпадать. Если значения расходятся, Маркет выдаст ошибку о том, что "ответы при показе корзины и при поступлении заказа не совпадают с информацией на витрине".

Опрашивать поставщика о наличии - используется при работе магазина в связке с таким поставщиком как Сималенд. В модуле Сималенд должна быть активна настройка "Проверять остаток при оформлении заказа". Подробнее в статье.

Уведомлять о смене статуса по e-mail - администратору магазина будут приходить уведомления когда со стороны Маркета будут изменения статуса заказа в магазине. Иногда поток изменений слишком интенсивный, поэтому есть возможность отключить уведомления.

Email покупателя в заказе - Поскольку данные покупателя со стороны Маркета не передаются, рекомендуем все заказы собирать на одного покупателя в магазине. Создайте такого покупателя по инструкции, и e-mail этого искусственно созданного покупателя добавьте в настройках модуля в поле Email покупателя в заказе. Это простой метод для объединения заказов на одно лицо в магазине.

Синхронизация статусов между Я.Маркетом и магазином

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

Рисунок 41.

После завершения всех настроек нажмите кнопку Сохранить настройки внизу страницы.

Рисунок 42.

Особенности настройки по модели DBS

Модель DBS предполагает обмен по API не только по остаткам и заказам, но и по типу и сроку доставки. Если мы говорим о настройке обработки заказов по API по модели DBS, то поддерживаются только методы Курьерская доставка, Самовывоз, Почта. Если вы работаете по домашнему региону, и у вас несколько собственных пунктов выдачи и собственная курьерская служба, то для настроек достаточно в таблице соответствия методов настроить соответствие - Курьер для Курьерской службы, Самовывоз - для Самовывоза.

Рисунок 43.

В разделе Логистика - Доставка магазина - Ваши пункты выдачи добавьте пункт выдачи.

Рисунок 44.

При добавлении точки самовывоза в поле Идентификатор точки продаж укажите id точки самовывоза из таблицы в настройках модуля. Если точек самовывоза несколько, проверьте, чтобы между id точек и адресами не было путаницы.

Рисунок 45.

Дополнительно доступны настройки для рабочего времени: выходные дни можно отметить галочками и указать в блоке время, до какого нужно оформить заказ, чтобы сроки доставки не сдвинулись на 1 день. В блоке вариантов оплаты выберете методы, какими на стороне Маркета будет доступен прием платежей. Доступные варианты оплаты на рисунке ниже:

Рисунок 46.

 

6. Настройка склада и указание данных для возвратов/невыкупов.

Этот шаг настраивается полностью в кабинете Маркета, с магазином настройка не связана. Без выполнения этого пункта Самопроверку пройти не получится - Маркет просто не передаст тестовый заказ. Поэтому сначала завершите настройки Склада и укажите данные для возвратов/невыкупов, после этого переходите к следующему шагу.

 

7. Самопроверка.

 

К этому этапу стоит переходить только когда все остальные завершены. Если хотя бы один из предыдущих шагов не выполнен, Маркет не сможет сформировать тестовый заказ.

Самопроверка предполагает обработку тестовых заказов по разным сценариям (заданиям). Описание действий к заданию находится над кнопкой для запуска. Каждый из шагов самопроверки нужно выполнить, смоделировав действия в задании. Для запуска самопроверки на стороне Маркета нужно перейти в раздел "Настройки"-"Самопроверка", и последовательно выполнить каждое из заданий. Для запуска задания Вам нужно будет нажать на кнопку "Выполнить задание".

Рисунок 47.

Задание должно быть выполнено за отведенный интервал времени. На примере задания с Отменой заказа из-за повреждения товаров, рассмотрим, что нужно делать. В панели администрирования будет создан тестовый заказ, перейдите к этому заказу. Управление обработкой заказа находится в заказе в блоке справа. Выберете команду Отменить заказ.

Рисунок 48.

Также описание заказа и прочая информация записывается в комментарии к заказу. Это поле доступно только для сотрудников магазина.

Рисунок 49.

 

8. Контрольный заказ

После прохождения всех этапов подключения и самопроверки Вы будете допущены до контрольного заказа.

Это заказ, который обрабатывается по похожим заданиям самопроверки, но в настоящих условиях.

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

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

Продажа электронных товаров на Яндекс.Маркете.

Продажа электронных товаров на Яндекс.Маркете доступна на текущий момент только при работе по API, по модели DBS, сам электронный товар в кабинете Маркета не загружается. Поэтому без модуля здесь не обойтись. Настройки будут такими же, как предыдущие шаги, за исключением настроек доставки - поскольку товар будет отправляться на электронную почту. Поскольку маркетплейс не отдает контакты своих покупателей, вы не можете отправить электронный товар покупателям в ручном режиме: Яндекс.Маркет запрашивает заказанный покупателем электронный товар (например, книгу в электронном виде или код для активации программного продукта) в магазине, магазин передает данные в Маркет, и Маркет отправляет на почту покупателя электронный товар. Загрузить электронные товары в магазине можно с помощью модуля Электронные товары. Подробнее в инструкции.

Все готово. Мы рассмотрели настройки модуля Яндекс.Маркет Pro.