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

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

Модуль "Яндекс.Маркет 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).

Рисунок 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).

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

Рисунок 12.

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

 

Настройка API

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

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

Рисунок 13.

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

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

Рисунок 14

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

Рисунок 15.

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

 

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

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

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

Рисунок 16.

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

Рисунок 17.

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

Важно

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

Рисунок 18.

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

Рисунок 19.

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

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

Рисунок 20.

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

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

Рисунок 21.

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

Рисунок 22.

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

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

Рисунок 23.

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

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

Рисунок 24.

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

Рисунок 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):

Рисунок 26.

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

Рисунок 27.

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

Рисунок 28

Внимание!

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

Важно

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

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

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

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

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

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

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

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

Рисунок 28А

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

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

Рисунок 29.

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

 

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

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

Рисунок 30.

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

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

 

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

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

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

Рисунок 31.

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

Рисунок 32.

 

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

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

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

Рисунок 33.

 

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

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

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

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

Рисунок 34.

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

Рисунок 35.

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

Рисунок 36.

 

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

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

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

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

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

Все готово.