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

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

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

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

Внимание!

Модуль "Покупка на Яндекс.Маркете" может быть установлен только в магазине версии 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. Контрольный заказ;

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

Внимание!

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

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

Товары

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

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

Внимание!

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Внимание!

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

Прайс-лист

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

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

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

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

Настройка API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Скопированный ID вставляете на стороне модуля "Покупка на Яндекс.Маркете" в поле "Идентификатор приложения" (рис. 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):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Настройки выгрузки для Яндекс.Маркета
  • Выгрузка товаров на Яндекс.Маркет
  • Параметры экспорта в Яндекс.Маркет и Merchant Center
Как мы можем улучшить статью?

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

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

📎📎📎📎📎📎📎📎📎📎