Интеграция с Яндекс.Маркет
- Подключение магазина к Яндекс.Маркету
- Настройки личного кабинета Яндекс.Маркета
- Настройка Яндекс.OAuth-сервера
- Экспорт товаров
- Способ доставки
Важно! Для работы с Яндекс.Маркет API вашему интернет-магазину необходимо использование SSL-сертификата и протокола HTTPS.
Приобрести SSL-сертификат можно у любого издателя сертификатов.
Как подключить SSL-сертификат к сайту читайте в инструкции.
Подключение магазина к Яндекс.Маркету
Чтобы зарегистрировать магазин перейдите по ссылке https://partner.market.yandex.ru/. Укажите общую информацию, контактные данные и нажмите Зарегистрироваться.
Также перед подключением изучите Условия и требования.
Настройки личного кабинета Яндекс.Маркета
В личном кабинете Яндекс.Маркета нужно указать настройки доступа. В раздел "Маркет для магазинов" Яндекса нажмите на имя вашего магазина. В меню с лева выбираем Работа с API -> Настройки API заказа:
На открывшейся странице задаем следующие настройки:
- Авторизационный токен - это ключ доступа к Яндекс.Маркету. Чтобы получить его, нажмите "изменить" рядом с полем, и система сгенерирует его.
- URL API - адрес, на который магазин принимает запросы от Яндекс.Маркета. URL должен быть в формате: https://SITE/shop/yandexapi. Точное значение можно взять из настроек модуля в интернет-магазине. (как все настроить в магазине см. ниже)
- SHA1 fingerprint - указываем fingerprint SSL-сертификата, подключенного на сайте. Узнать информацию о нем можно из настроек SSL-сертификата в панели управления сайтом -> Безопасность -> Настройки SSL - /panel/security/ssl_cert:
- Тип авторизации - тип получения доступа к данным с Яндекс.Маркета. Выбираем URL.
- Формат данных - выбираем JSON.
Настройка Яндекс.OAuth-сервера
Далее сайт необходимо зарегистрировать на OAuth-сервере Яндекса для передачи запросов от магазина к Яндексу. На странице OAuth-приложений нажимаем Зарегистрировать новое приложение:
В открывшемся окне заполняем следующие поля, которые несут информативный характер:
Платформы - ставим галочку Веб-сервисы. Для поля Callback URL нажимаем ссылку Подставить URL для разработки:
Доступы - выбираем Яндекс.Маркет и ставим галочку API Яндекс.Маркета для партнеров:
Нажимаем Создать приложение. Откроется страница с данными созданного приложения. Полученный ID нужно скопировать:
Далее переходим по ссылке https://oauth.yandex.ru/authorize?response_type=token&client_id=APP_ID, где в качестве APP_ID указываем ID созданного приложения.
При запросе доступа к приложению нажимаем "Разрешить".
Экспорт товаров
Теперь настраиваем экспорт товаров в панели управления интернет-магазина. Заходим в настройки экспорта -> YML формат - /panel/?a=shop;l=export;r=exp_yml:
Переходим к Настройки Яндекс.Маркет API и активируем опцию Включить обработку запросов от API Яндекс.Маркет:
- Авторизационный токен API Яндекс.Маркет - указываем значение токена из поля Авторизационный токен на странице настроек Яндекс.Маркет.
- URL для API Яндекс.Маркет - адрес, который используем на странице настроек Яндекс.Маркет в поле URL API.
- Поле заказа для сохранения номера заказа в "Яндекс.Маркет" - настраиваем если нужно, чтобы на странице управления заказа и на странице просмотра заказа отображался номер заказа на стороне Яндекс.Маркет.
- Поле заказа для сохранения информации о доставке от "Яндекс.Маркет" - настраиваем если нужно, чтобы на странице управления заказа и на странице просмотра заказа отображалась информация об адресе доставки, который пользователь указал при оформлении заказа на стороне Яндекс.Маркет.
- ID компании в Яндекс.Маркет - указываем ID нашего магазина в Яндекс.Маркет. ID магазина можно посмотреть на странице магазинов в колонке "Магазин" под ссылкой перехода на страницу магазина. Например, под ссылкой значится "№ 12-34567890", соответственно, ID компании будет "34567890".
- Callback OAuth-ID приложения - указываем ID созданного ранее OAuth-приложения.
- Callback OAuth-токен - указываем полученный ранее на странице "https://oauth.yandex.ru/authorize?response_type=token&client_id=APP_ID" ключ приложения.
Способов доставки
В панели управления интернет-магазина на странице Способы оплаты, доставки, валюты и курсы настраиваем способы доставки, которые должны быть доступными для заказов, оформляемых через Яндекс.Маркет API.
Переходим к Способам доставки. После активации опции Включить обработку запросов от API Яндекс.Маркет на странице настроек YML-экспорта, у каждого способа доставки появится блок настроек Настройки для Яндекс.Маркет API.
- Использовать способ доставки для Яндекс.Маркет API - активируем если способ доставки должен быть доступен для заказов от API Яндекс.Маркет.
- Тип доставки - выбираем необходимый. Если указан тип самовывоз - то также обязательно нужно указать и список идентификаторов пунктов самовывоза (о чем система заблаговременно предупреждает).
- Способ оплаты для данного способа доставки - указываем какие способы оплаты доступны для выбранного типа доставки.
- Стоимость доставки в базовой валюте магазина, Количество дней до ближайшей возможной доставки, Количество дней до самой поздней даты доставки - указываем настройки, которые должны быть в рамках гранично-допустимых значений, указанных на странице настроек YML-экспорта в поле Cтоимость и сроки курьерской доставки по своему региону для Яндекс.Маркета, иначе Яндекс.Маркет не позволит оформить заказ.
В случае необходимости указываем настройки и для оставшихся полей.