Как вам помочь ?
Подключение сервиса "Покупка на Маркете"
Рассмотрим как настроить модуль интеграции с сервисом Яндекс.Маркета "Покупка на Маркете".
Модуль "Яндекс.Маркет 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 недоступна.
"Покупка на Маркете" от Яндекс.Маркета - это бывший "Беру", совместного проекта Яндекса и Сбербанка. Напомним, что сервис позволяет покупать товары от проверенных поставщиков прямо на Яндекс.Маркете. Вы сможете добавить в корзину товары из разных магазинов и заказать их в один прием. Вам не потребуется переходить на сайты магазинов. Доставку также будет осуществлять сама торговая площадка.
Подключение к программе "Покупка на Маркете" состоит из следующих этапов:
- Регистрация;
- Заключение договора;
- Товары;
- Прайс-лист;
- Настройка API;
- Склад и настройки отгрузки;
- Обработка запросов об остатках;
- Автоматическое обновление данных об остатках;
- Настройка обработки заказов;
- Самопроверка;
- Контрольный заказ;
Начать регистрацию и посмотреть возможные варианты работы программы "Покупка на Маркете" Вы можете по ссылке.
Внимание!
Модуль Яндекс.Маркет Pro позволяет работать с программой "Покупка на Маркете" только по модели FBS/FBY/FBY+ и DBS.
Из перечисленных выше этапов мы отметим именно те, которые решаются на стороне интернет магазина, а именно этапы:
Товары
Этап "Товары" предполагает выгрузку товаров на Я.Маркет по программе "Покупка на Маркете".
Выгрузка на сервис "Покупка на Маркете" поддерживается в формате YML.
Внимание!
Функционал канал продаж "Яндекс.Маркет Pro", который позволяет выгружать каталог в формате "YML", доступен для интернет магазинов в облаке с тарифа "Профи".
Для настройки выгузки в формате YML зайдите в панель администрирования, пункт меню "Каналы продаж" и нажмите на "+", во всплывающем окне выберите "Яндекс.Маркет Pro" (рис. 1).
Рисунок 1.
На открывшейся странице, если выгрузки нет, создайте (рис.2), либо выберете уже существующую. Далее во вкладке “Выбор товаров” можно выбрать, какие категории/подкатегории товаров выгружать в Яндекс.Маркет - все сразу или только выбранные (рис. 3, 4).
Рисунок 2.
Рисунок 3.
Рисунок 4.
Обратите внимание на вкладку "Параметры выгрузки". В ней необходимо указать основные и дополнительные настройки Вашей выгрузки товаров на Яндекс.Маркет.
В дополнение нужно будет активировать во вкладке "Параметры" выгрузки следующие опции (рис. 5):
Рисунок 5.
- В качестве артикула идентификатора товарного предложения рекомендуем выбрать "Артикул модификации";
- Отметить для выгрузки габариты товара, количество, тег shop-sku. Без них Вы не сможете загрузить файл в "Покупку на Маркете".
Потом, как выставите остальные необходимые опции, нажимаете "Экспортировать". Загрузить прайс-лист в "Покупка на Маркете" можно следующим образом (рис. 6):
Рисунок 6.
- После экспорта под названием выгрузки появится ссылка на этот прайс-лист;
- Кликаете правой кнопкой мыши по ссылке;
- Выбираете вариант "Копировать адрес ссылки".
Далее вставляете эту ссылку на стороне "Покупки на Маркете" (рис. 7):
Рисунок 7.
- Переходите в меню "Товары";
- Подпункт "Каталог".
Далее нажимаете на кнопку "Передать файл". После её нажатия в появившемся окне (рис. 8):
Рисунок 8.
- Нужно выбрать "Файл по шаблону Маркета";
- Нажимаете "Выберите файл";
- В появившемся окне устанавливаете курсор на поле "Имя файла", нажимаете левой кнопкой мыши;
- Вставляете ссылку, которую получили на рис. 6 выше;
- Нажимаете "Открыть";
- Нажимаете "Загрузить".
После загрузки каталога "Покупка на Маркете" у Вас отобразится окошко примерно следующего вида (рис. 9):
Рисунок 9.
- Указано, сколько товаров можно добавить в каталог;
- Указано, какое количество товаров с ошибками;
- Можно скачать файл в формате Excel, в котором можно будет посмотреть комментарии по ошибкам.
В данном файле открываете вкладку "Ассортимент" и в поле "Комментарий по результатам обработки файла" можно узнать причину (рис. 10, 11):
Рисунок 10.
Рисунок 11.
Внимание!
После выгрузки каталога в "Покупка на Маркете" Вам необходимо будет сопоставить карточки товаров, которые Вы загрузили, с теми товарами, что уже есть на "Покупка на Маркете". Сервис "Покупка на Маркете" предварительно сопоставляет карточки по своим алгоритмам, но дальнейшее подтверждение и сопоставление Вам необходимо будет осуществить вручную.
Прайс-лист
На этом этапе Вы указываете, как будет обновляться цена на сервисе "Покупка на Маркете". Есть возможность делать это автоматически.
Для настройки этого этапа Вам потребуется ссылка на прайс-лист, который выгружали ранее (рис. 6).
Далее эту ссылку нужно будет сохранить в ЛК "Покупка на Маркете". Для этого проходите в меню "Цены" далее (рис. 12):
Рисунок 12.
- Переключаетесь на вкладку "Ссылка";
- Указываете ссылку на прайс-лист в поле "Укажите прямую ссылку на файл";
- Нажимаете "Сохранить".
Настройка API
Этап "Настройка API" необходим, чтобы Вы могли принимать заказы из сервиса "Покупка на Маркете", обрабатывать их и автоматически обновлять остатки у товаров.
Для настройки интеграции и управлением "Покупка на Маркете" через API Вам нужно будет в административной панели во вкладке "Модули" в магазине модулей необходимо найти и установить модуль "Яндекс.Маркет Pro"(рис. 13).
Рисунок 13.
Выбор и настройка нужной модели
После установки модуля, Вам нужно будет с помощью галочек выбрать модель или модели, по которым будет работать модуль (рис. 14). Настройки API для каждой модели будут отдельные. О том, как их получить на стороне кабинета Яндекс.Маркета, мы рассмотрим ниже.
Рисунок 14
Настройки модуля можно разделить на три блока (рис. 15):
Рисунок 15.
- Выбор и настройка нужной модели;
- Настройки взаимодействия по API;
- Сопоставление статусов со стороны "Покупка на Маркете" со статусами интернет магазина;
Настройки взаимодействия по API
Сначала произведем настройки взаимодействия по API. Данные будем собирать последовательно.
Для включения работы с "Покупка на Маркете" по API на стороне ЛК "Покупка на Маркете" переходите в меню "Настройки"-"Выбор способа подтверждения", и выбираете "Через API" (рис. 16):
Рисунок 16.
Затем кликаете на ссылку ниже "Настройки", или переходите в меню "Настройки"-"Настройки API". На открывшейся странице (рис. 15):
Рисунок 17.
- Копируете "Авторизационный токен" в настройки модуля (рис.17);
- В поле "URL для запросов по API" вставляете адрес, который получается следующим образом: домен Вашего магазина + /yamarketbuying. Например, если адрес Вашего магазина http://test.ru, то адрес будет выглядеть так: http://test.ru/yamarketbuying ;
- "Способ авторизации" - выбираете "Header".
Важно
SHA1-отпечаток SSL-сертификата нужен в случае если устанавливается самоподписанный SSL-сертификат, как правило, для разработчиков для отладки. Для настройки в рабочем режиме он не требуется.
Рисунок 18.
Идентификатор компании - это номер вида 11-ХХХХХХХХ в ЛК "Покупка на Маркете". Уточнить его можно в ЛК "Покупка на Маркете"(рис. 19):
Рисунок 19.
- В шапке ЛК "Покупка на Маркете" кликаете на стрелку;
- Копируете номер без 11-.
Вставляете скопированный идентификатор на стороне модуля "Покупка на Яндекс.Маркете" в поле "Идентификатор кампании" (рис. 20):
Рисунок 20.
Для получения идентификатора приложения Вам нужно будет зарегистрировать приложение https://oauth.yandex.ru/client/new
После перехода по ссылке заполняете название (рис. 21):
Рисунок 21.
Далее в блоке "Платформы" (рис. 22):
Рисунок 22.
- Отмечаете "Веб-сервисы";
- Нажимаете на "Подставить 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.
- Номер заказа как в Яндекс.Маркете. Если эта опция активирована, то при получении заказа из "Покупка на Маркете" интернет магазин присвоит ему такой же номер, как и "Покупка на Маркете";
- Отдавать нулевые остатки, если товара меньше чем. Эта опция позволяет контролировать количество товаров. Если указано количество больше 0, то магазин будет проверять количество товара. Если товара меньше чем указано, то в Маркет вернется 0.
- Уведомлять о смене статуса по 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.
Контрольный заказ
После прохождения всех этапов подключения и самопроверки Вы будете допущены до контрольного заказа.
Это заказ, который обрабатывается по похожим заданиям самопроверки, но в настоящих условиях.
Это означает, что помимо действий со стороны интернет магазина по обработке заказов Вам нужно будет физически отправить этот заказ. Подробности и детали заказа будут указаны на стороне "Покупка на Маркете".
После прохождения всех этапов Вы будете подключены к программе "Покупка на Маркете" и сможете обрабатывать поступающие из него заказы.
Все готово.
Посмотрите дополнительно
- Настройки выгрузки для Яндекс.Маркета
- Выгрузка товаров на Яндекс.Маркет
- Параметры экспорта в Яндекс.Маркет и Merchant Center
Тэги: Покупка на Яндекс.Маркете, яндекс маркет, покупка на маркете, yml, yam, модуль, модуль маркет, маркет,vfhrtn, market, маркетплейс, яндекс, fbs