Доступна новая версия 12.0!
Подробнее

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

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

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

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

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

Внимание!

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

Внимание!

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

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

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

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

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

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

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

  1. Регистрация;
  2. Заключение договора;
  3. Товары;
  4. Прайс-лист;
  5. Настройка API;
  6. Склад и настройки отгрузки;
  7. Обработка запросов об остатках;
  8. Автоматическое обновление данных об остатках;
  9. Настройка обработки заказов;
  10. Самопроверка;
  11. Контрольный заказ;

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

Внимание!

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

Из перечисленных выше этапов мы отметим именно те, которые решаются на стороне интернет магазина, а именно этапы: 

  1. Товары

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

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

    1. Выбор и настройка нужной модели;

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

    3. Сопоставление статусов со стороны "Покупка на Маркете" со статусами интернет магазина;

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

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

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

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

 

Товары

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

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

Внимание!

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

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

Подключение сервиса "Покупка на Маркете" - 5769
Рисунок 1.

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

Подключение сервиса "Покупка на Маркете" - 5908
Рисунок 2.

Подключение сервиса "Покупка на Маркете" - 2797
Рисунок 3.

Подключение сервиса "Покупка на Маркете" - 6151
Рисунок 4.

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

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

Подключение сервиса "Покупка на Маркете" - 8475
Рисунок 5.

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

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

Подключение сервиса "Покупка на Маркете" - 1928
Рисунок 6.

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

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

Подключение сервиса "Покупка на Маркете" - 2138
Рисунок 7.

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

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

Подключение сервиса "Покупка на Маркете" - 6077
Рисунок 8.

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

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

Подключение сервиса "Покупка на Маркете" - 6373
Рисунок 9.

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

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

Подключение сервиса "Покупка на Маркете" - 9863
Рисунок 10.

Подключение сервиса "Покупка на Маркете" - 4930
Рисунок 11.

Внимание!

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

 

Прайс-лист

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

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

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

Подключение сервиса "Покупка на Маркете" - 6211
Рисунок 12.

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

 

Настройка API

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

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

Подключение сервиса "Покупка на Маркете" - 6458
Рисунок 13.

Выбор и настройка нужной модели

После установки модуля, Вам нужно будет с помощью галочек выбрать модель или модели, по которым будет работать модуль (рис. 14). Настройки API для каждой модели будут отдельные. О том, как их получить на стороне кабинета Яндекс.Маркета, мы рассмотрим ниже.

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

Настройки модуля можно разделить на три блока (рис. 15):

Подключение сервиса "Покупка на Маркете" - 8515
Рисунок 15.

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

 

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

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

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

Подключение сервиса "Покупка на Маркете" - 8901
Рисунок 16.

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

Подключение сервиса "Покупка на Маркете" - 8690
Рисунок 17.

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

Важно

SHA1-отпечаток SSL-сертификата нужен в случае если устанавливается самоподписанный SSL-сертификат, как правило, для разработчиков для отладки. Для настройки в рабочем режиме он не требуется.

Подключение сервиса "Покупка на Маркете" - 7677
Рисунок 18.

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

Подключение сервиса "Покупка на Маркете" - 2300
Рисунок 19.

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

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

Подключение сервиса "Покупка на Маркете" - 7995
Рисунок 20.

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

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

Подключение сервиса "Покупка на Маркете" - 5890
Рисунок 21.

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

Подключение сервиса "Покупка на Маркете" - 6662
Рисунок 22.

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

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

Подключение сервиса "Покупка на Маркете" - 4015
Рисунок 23.

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

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

Подключение сервиса "Покупка на Маркете" - 6825
Рисунок 24.

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

Подключение сервиса "Покупка на Маркете" - 7494
Рисунок 25.

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

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

Подключение сервиса "Покупка на Маркете" - 7390
Рисунок 26.

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

Подключение сервиса "Покупка на Маркете" - 4527
Рисунок 27.

Для DBS-модели после указания API-токенов потребуется произвести дополнительные настройки, специфические для данной модели работы. В первую очередь, нужно будет в таблице сопоставить способы доставки, заведённые в интернет-магазине со способами доставки, предложенные Яндекс.Маркетом (рис. 28):

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

Внимание!

При работе по модели DBS "id метода доставки Самовывоз" из модуля необходимо прописать в личном кабинете Яндекс Маркета в качестве "Идентификатора точки продаж" в разделе "Настройки"-"Пункты самовывоза". 
Обновление id метода доставки на стороне Яндекс Маркета занимает некоторое время.

Важно

Работа методов доставки по модели DBS производится следующим образом:

При оформлении заказа (как покупатель) на стороне Я.Маркета можно выбрать один из 3-х вариантов: Самовывоз, Курьер или Почта.

Причем действует единый тариф, выбор метода доставки СДЭКом или Грастином недоступен.

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

2. ​Аналогичная работа с Курьером: стоимость заложена по единому тарифу, курьер любой службы, на усмотрение продавца, будет доставлять заказ.

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

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

После этого заполните настройки ниже: выходные дни недели доставки; время, до которого должен быть оформлен заказ, чтобы его дата не сдвигалась на день вперёд; доступные методы оплаты.
Подключение сервиса "Покупка на Маркете" - 4527
Рисунок 28А

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

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

Подключение сервиса "Покупка на Маркете" - 4348
Рисунок 29.

  1. Номер заказа как в Яндекс.Маркете. Если эта опция активирована, то при получении заказа из "Покупка на Маркете" интернет магазин присвоит ему такой же номер, как и "Покупка на Маркете";
  2. Отдавать нулевые остатки, если товара меньше чем. Эта опция позволяет контролировать количество товаров. Если указано количество больше 0, то магазин будет проверять количество товара. Если товара меньше чем указано, то в Маркет вернется 0.
  3. Уведомлять о смене статуса по e-mail. 

 

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

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

Подключение сервиса "Покупка на Маркете" - 2584
Рисунок 30.

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

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

 

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

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

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

Подключение сервиса "Покупка на Маркете" - 7770
Рисунок 31.

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

Подключение сервиса "Покупка на Маркете" - 5215
Рисунок 32.

 

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

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

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

Подключение сервиса "Покупка на Маркете" - 4167
Рисунок 33.

 

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

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

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

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

Подключение сервиса "Покупка на Маркете" - 5844
Рисунок 34.

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

Подключение сервиса "Покупка на Маркете" - 2428
Рисунок 35.

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

Подключение сервиса "Покупка на Маркете" - 7840
Рисунок 36.

 

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

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

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

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

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

Все готово.

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

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

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

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

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

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

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

Мы используем cookies. Подробнее...
0