Подключение сервиса "Покупка на Маркете"

Рассмотрим как настроить интеграцию с сервисом Яндекс.Маркет с помощью модуля "Яндекс.Маркет 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.

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

Рисунок 2.

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

Рисунок 3.

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

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

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

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

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

Рисунок 4.

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

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

Рисунок 5.

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

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

Рисунок 6.

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

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

Рисунок 7.

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

Рисунок 8.

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

В кабинете Яндекс.Маркета в разделе Товары - Автообновление каталога добавьте ссылку на файл.

Рисунок 9.

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

Рисунок 10.

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

Внимание!

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

Рисунок 11.

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

Рисунок 12.

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

Рисунок 13.

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

Рисунок 14.

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

Рисунок 15.

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

Далее нужно разместить ссылку на автообновление каталога. Чтобы товары, которые выходят из ассортимента магазина, автоматически скрывались с витрины Маркета, а при возвращении к продаже, появлялись вновь. В разделе Товары - Автообновление каталога добавьте ссылку на файл. Там уже будет ссылка, которую мы добавили ранее, для загрузки товаров. Для автообновления условий размещения нужна дополнительная настройка. Если у вас несколько компаний, для каждой компании добавьте свою. При этом ссылки могут быть одинаковыми. Т.е. те же самые товары вы можете продавать как по модели FBS, так и по DBS.

Рисунок 16.

Рисунок 17.

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

Рисунок 17.1.

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

 

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

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

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

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

Рисунок 18.

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

Рисунок 19.

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

Рисунок 20.

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

Рисунок 21.

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

Рисунок 22.

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

Рисунок 23.

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

Рисунок 24.

 

4. Автоматическое обновление данных об остатках.

После того, как первоначальные настройки выполнены, можно переключить режим работы на API. Обратите внимание на способ авторизации - должен быть выбран вариант HEADER. Все настройки показаны на рисунке ниже.

Рисунок 25.

Теперь можем проверить, отвечает ли магазин на запрос Маркета об остатках. В блоке Обновление данных об остатках нажмите Проверить запрос.

Рисунок 26.

В правом верхнем углу появится уведомление, что сервер ответил правильно.

Рисунок 27.

В кабинете Маркета настройки по синхронизации на этом завершены. В кабинет Маркета вернемся на одном из следующих этапов настройки.

 

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

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

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

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

Рисунок 28.

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

Рисунок 29.

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

Рисунок 30.

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

Рисунок 31.

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

Внимание!

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

Рисунок 32.

Рисунок 33.

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

Рисунок 34.

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

Рисунок 35.

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

Рисунок 36.

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

Рисунок 37.

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

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

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

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

Внимание!

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

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

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

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

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

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

Рисунок 38.

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

Рисунок 39.

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

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

Рисунок 40.

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

Рисунок 41.

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

Рисунок 42.

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

Рисунок 43.

 

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

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

 

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

 

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

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

Рисунок 44.

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

Рисунок 45.

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

Рисунок 46.

 

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

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

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

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

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

 

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

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

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