Как вам помочь ?

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

Статья актуальна для версии магазина: 8.5

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

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

Внимание!

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

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

Подключение к программе "Покупка на Маркете" состоит из следующих этапов:

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

  2. Заключение договора;

  3. Товары;

  4. Прайс-лист;

  5. Настройка API;

  6. Склад и настройки отгрузки;

  7. Обработка запросов об остатках;

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

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

  10. Самопроверка;

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

Начать регистрацию и посмотреть возможные варианты работы программы "Покупка на Маркете" Вы можете по ссылке https://yandex.ru/support/marketplace/get-started

Внимание!

Модуль  Покупка на Яндекс.Маркете  позволяет работать с программой "Покупка на Маркете" только по модели FBS. Подробнее об этой модели https://yandex.ru/support/marketplace/delivered-by-marketplace/how-to

Из перечисленных выше этапов мы отметим именно те, которые решаются на стороне интернет магазина, а именно этапы: Товары, Прайс-лист, Настройка API, Обработка запросов об остатках, Автоматическое обновление данных об остатках, Самопроверка, Контрольный заказ.

  1. Товары.

  2. Прайс-лист.

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

  4. Обработка запросов об остатках.

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

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

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

 

Товары.

Этап "Товары" предполагает выгрузку товаров на Я.Маркет по программе "Покупка на Маркете".

Выгрузка на сервис "Покупка на Маркете" поддерживается в формате YML.

Внимание!

Функционал канал продаж "Яндекс.Маркет", который позволяет выгружать каталог в формате "YML", доступен для интернет магазинов в облаке с тарифа "Профи".

Для настройки выгузки в формате YML зайдите в панель администрирования, пункт меню "Каналы продаж" и нажмите на "+", во всплывающем окне выберите "Яндекс.Маркет" (см. рис.1).


Рисунок 1.

На открывшейся странице, если выгрузки нет, создайте (см. рис.2), либо выберете уже существующую. Далее во вкладке “Выбор товаров” можно выбрать, какие категории/подкатегории товаров выгружать в Яндекс.Маркет - все сразу или только выбранные (см. рис. 3, 4).


Рисунок 2.


Рисунок 3.


Рисунок 4.

Обратите внимание на вкладку "Параметры выгрузки". В ней необходимо указать основные и дополнительные настройки Вашей выгрузки товаров на Яндекс.Маркет.

В дополнение нужно будет активировать во вкладке "Параметры" выгрузки следующие опции (см. рис. 5):


Рисунок 5.

  1. В качестве артикула идентификатора товарного предложения рекомендуем выбрать "Артикул модификации";
  2. Отметить для выгрузки габариты товара, количество, тег shop-sku. Без них Вы не сможете загрузить файл в "Покупку на Маркете".

Потом, как выставите остальные необходимые опции, нажимаете "Экспортировать". Загрузить прайс-лист в "Покупка на Маркете" можно следующим образом (см. рис. 6):


Рисунок 6.

  1. После экспорта под названием выгрузки появится ссылка на этот прайс-лист;
  2. Кликаете правой кнопкой мыши по ссылке;
  3. Выбираете вариант "Копировать адрес ссылки".

Далее вставляете эту ссылку на стороне "Покупки на Маркете" (см. рис. 7):


Рисунок 7.

  1. Переходите в меню "Товары";
  2. Подпункт "Каталог".

Далее нажимаете на кнопку "Передать файл". После её нажатия в появившемся окне (см. рис. 8):


Рисунок 8.

  1. Нужно выбрать "Файл по шаблону Маркета";
  2. Нажимаете "Выберите файл";
  3. В появившемся окне устанавливаете курсор на поле "Имя файла", нажимаете левой кнопкой мыши;
  4. Вставляете ссылку, которую получили на рис. 6 выше;
  5. Нажимаете "Открыть";
  6. Нажимаете "Загрузить".

После загрузки каталога "Покупка на Маркете" у Вас отобразится окошко примерно следующего вида (см. рис. 9):


Рисунок 9.

  1. Указано, сколько товаров можно добавить в каталог;
  2. Указано, какое количество товаров с ошибками;
  3. Можно скачать файл в формате Excel, в котором можно будет посмотреть комментарии по ошибкам.

В данном файле открываете вкладку "Ассортимент" и в поле "Комментарий по результатам обработки файла" можно узнать причину (см. рис. 10, 11):


Рисунок 10.


Рисунок 11.

Внимание!

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

 

Прайс-лист.

На этом этапе Вы указываете, как будет обновляться цена на сервисе "Покупка на Маркете". Есть возможность делать это автоматически.

Для настройки этого этапа Вам потребуется ссылка на прайс-лист, который выгружали ранее (см. рис. 6).

Далее эту ссылку нужно будет сохранить в ЛК "Покупка на Маркете". Для этого проходите в меню "Цены" далее (см. рис. 11):


Рисунок 11.

  1. Переключаетесь на вкладку "Ссылка";
  2. Указываете ссылку на прайс-лист в поле "Укажите прямую ссылку на файл";
  3. Нажимаете "Сохранить".

 

Настройка API.

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

Для настройки интеграции и управлением "Покупка на Маркете" через API Вам нужно будет в административной панели во вкладке "Модули" в магазине модулей необходимо найти и установить модуль "Покупка на Яндекс.Маркете"(см. рис. 12).


Рисунок 12.

После его установки продолжим настройки модуля. Их можно разделить на два блока (см. рис. 13):


Рисунок 13.

  1. Настройки взаимодействия по API;
  2. Сопоставление статусов со стороны "Покупка на Маркете" со статусами интернет магазина.

Настройки взаимодействия по API.

Сначала произведем настройки взаимодействия по API. Данные будем собирать последовательно.

Для включения работы с "Покупка на Маркте" по API на стороне ЛК "Покупка на Маркете" переходите в меню "Настройки"-"Выбор способа подтверждения", и выбираете "Через API" (см. рис. 14):


Рисунок 14.

Затем кликаете на ссылку ниже "Настройки", или переходите в меню "Настройки"-"Настройки API". На открывшейся странице (см. рис. 15):


Рисунок 15.

  1. Копируете "Авторизационный токен" в настройки модуля (см. рис.16);
  2. В поле "URL для запросов по API" вставляете адрес, который получается следующим образом: домен Вашего магазина + /yamarketbuying. Например, если адрес Вашего магазина http://test.ru, то адрес будет выглядеть так: http://test.ru/yamarketbuying ;
  3. "Способ авторизации" - выбираете "Header".


Рисунок 16.

Идентификатор компании - это номер вида 11-ХХХХХХХХ в ЛК "Покупка на Маркете". Уточнить его можно в ЛК "Покупка на Маркете"(см. рис. 17):


Рисунок 17.

  1. В шапке ЛК "Покупка на Маркете" кликаете на стрелку;
  2. Копируете номер без 11-.

Вставляете скопированный идентификатор на стороне модуля "Покупка на Яндекс.Маркете" в поле "Идентификатор кампании" (см. рис. 18):


Рисунок 18.

Для получения идентификатора приложения Вам нужно будет зарегистрировать приложение https://oauth.yandex.ru/client/new

После перехода по ссылке заполняете название (см. рис. 19):


Рисунок 19.

Далее в блоке "Платформы" (см. рис. 20):


Рисунок 20.

  1. Отмечаете "Веб-сервисы";
  2. Нажимаете на "Подставить URL для разработки".

Затем в блоке "Доступы" находите "Яндекс.Маркет" и активируете "API Яндекс.Маркета для партнеров" (см. рис. 21):


Рисунок 21.

И в самом низу страницы нажимаете на кнопку "Создать приложение".

У Вас создастся приложение, в нем нужно скопировать ID (см. рис. 22):


Рисунок 22.

Скопированный ID вставляете на стороне модуля "Покупка на Яндекс.Маркете" в поле "Идентификатор приложения" (см. рис. 23):


Рисунок 23.

Осталось получить авторизационный токен. Для этого нужно будет сформировать адрес. В адрес https://oauth.yandex.ru/authorize?response_type=token&client_id=<идентификатор приложения> вместо <идентификатор приложения> копируете ранее полученный ID.

У Вас получится ссылка вида: https://oauth.yandex.ru/authorize?response_type=token&client_id=65d0892b22804d7b80dc818af0aХХХХХ, где вместо 65d0892b22804d7b80dc818af0aХХХХХ - ID Вашего приложения (см. рис. 22). Переходите в браузере по получившейся ссылке. При переходе у Вас сгенерируется авторизационный токен (см. рис. 24):


Рисунок 24.

Вам нужно его скопировать и вставить в модуле "Покупка на Яндекс.Маркете" в поле "Авторизационный токен(от магазина к Яндекс.Маркету)" (см. рис. 25):


Рисунок 25.

Рассмотрим оставшиеся настройки на стороне модуля "Покупка на Яндекс.Маркете" из блока "Настройка API" (см. рис. 26):


Рисунок 26.

  1. Номер заказа как в Яндекс.Маркете. Если эта опция активирована, то при получении заказа из "Покупка на Маркете" интернет магазин присвоит ему такой же номер, как и "Покупка на Маркете";
  2. В качестве идентификатора используется артикул товара. Если эта опция активирована, то при работе по API идентификация товаров будет осуществляться по внутреннему ID товаров. Эту опцию следует выставить, если в качестве идентификатора предложения Вы выставили идентификатор модификации (см. рис. 5, п.1).

Статусы заказов.

Статусы заказов в модуле "Покупка на Яндекс.Маркете" выставляете в соответствии с статусами магазина, которые по смыслу подходят для статусов на стороне "Покупка на Маркете" или в соответствии с Ваши бизнес-процессами (см. рис. 27).


Рисунок 27.

При необходимости Вы можете отредактировать статусы на стороне интерне магазина по инструкции https://www.advantshop.net/help/pages/statusy-zakazov

После заполнения всех настроек нажимаете в модуле "Покупка на Яндекс.Маркете" в самом низу "Сохранить".

 

Обработка запросов об остатках.

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

Для этого в ЛК "Покупка на Маркете" заходите в меню "Настройки" - "Настройка API" нажимаете кнопку "Отправить запрос" (см. рис. 28):


Рисунок 28.

После этого в правом верхнем углу в ЛК "Покупка на Маркете" отобразится сообщение о успешном ответе магазина (см. рис. 29):


Рисунок 29.

 

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

В этом этапе необходимо настроить автоматическое обновление остатков.

Для этого в ЛК "Покупка на Маркете" заходите в меню "Настройки" - "Настройка API" нажимаете переключатель "Обновлять данные автоматически" (см. рис. 30):


Рисунок 30.

 

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

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

Описание действий к заданию находится под его запуском.

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


Рисунок 31.

После запуска "Покупка на Маркете" отправит по API заказ в интернет магазин. Управление обработкой заказа находится находится в заказе в блоке справа (см. рис. 32):


Рисунок 32.

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


Рисунок 33.

 

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

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

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

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

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

Все готово.

Посмотрите дополнительно

Другие статьи по теме

Статья оказалась полезной? Да Нет
Благодарим за отзыв.

Как мы можем улучшить статью?

Не нашли нужную статью? Предложить тему

Не нашли нужную статью?

Благодарим за отзыв.

Тэги: Покупка на Яндекс.Маркете, яндекс маркет, покупка на маркете, yml, yam, модуль, модуль маркет, маркет,vfhrtn, market, маркетплейс, яндекс