new

msYMarketFBS

Работа с Яндекс.Маркет по FBS модели
Автор дополнения
Prihod
Пакетов
20
Закачек
6 084
Автор дополнения
Пакетов
20
Закачек
6 084
Обычно отвечает в течение суток
Версия 1.0.0-beta
Дата выпуска 30.09.2021
Загрузки 0
Просмотры 148
Внимание, этот компонент требует версию PHP 5.6 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.
Внимание, этот компонент требует версию MODX не ниже 2.7 !

Дополнение позволяет подключить Интернет-магазин к Яндекс.Маркету через API по модели FBS


Основные возможности:

  • установка связи между вашим товарами и карточками товаров на маркетплейсе;
  • устанавливать и передавать цены на товары;
  • передача актуальной информации о доступном количестве товаров;
  • изменение количество товаров на сайте при совершении покупки на маркетплейсе;
  • генерация YML-файлов каталога товаров;

C чего начать:

Настройка API

В личном кабинете Яндекс.Маркет открыть Настройки/Настройка API


  • сгенерируйте Авторизационный токен;
  • укажите в поле URL для запросов API ссылку на страницу Яндекс.Маркета FBS API, которая должна появиться у вас после установки модуля. Убедитесь, что к url этой странице у вас не происходит добавления в конец слеша;
  • способ авторизации выберете URL;



В системных настройках компонента заполните опции данными, взятыми на странице Настройки API в Яндекс.Маркет



ID кампании (ключ msymarketfbs_api_campaign_id) укажите числа после дефиса из Номер кампании


Токен авторизации для модели FBS (ключ msymarketfbs_api_auth_token) значение из Авторизационный токен


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


В системных настройках компонента также укажите свои значения для опций Название поля с количеством товара (ключ msymarketfbs_field_count)
Название поля c уникальным идентификатором товара SKU (ключ msymarketfbs_field_sku) и Статус
успешного заказа
(ключ msymarketfbs_order_success_status)


Для того чтобы иметь возможность устанавливать связи между вашим товарами и карточками товаров на маркетплейсе, а также устанавливать и передавать цены на товары, необходимо
зарегистрировать свое приложение. Обязательно необходимо ввести название приложения, оно может быть любым. В разделе
Платформы установить галочку Веб-сервисы, под полем Callback URI #1 нажать Подставить URL для разработки. В разделе
Доступы выбрать Яндекс.Маркет и установить галочку API Яндекс.Маркета для партнеров. Нажать
Создать приложение. После создания приложения, вам будет доступен идентификатор приложения client_id. Необходимо перейти по ссылке oauth.yandex.ru/authorize?response_type=token&client_id=ваш client_id заменив в ней
ваш client_id на полученный client_id. Полученный client_id вписать в опцию
Client ID (ключ msymarketfbs_api_client_id), а OAuth-токен в опцию
OAuth-токен (ключ msymarketfbs_api_oauth_token)





Если вы хотите, чтобы при изменении цены в админке сайта она автоматически обновляется на Яндекс.Маркет, то включите опцию
Автоматически обновлять цену на Яндекс.Маркет (ключ msymarketfbs_auto_update_price)
Важно! данный функционал будет работать только в том случае, если у товара есть значение Яндекс.Маркета SKU


Яндекс.Маркета SKU

Значение Яндекс.Маркета SKU для товара можно указать как вручную, взяв его из Яндекс.Маркета, так и автоматически, кликнув по соответствующей кнопке. При сохранении новых товаров можно автоматически получать значение Маркета SKU, для этого в системных настройках компонента необходимо включить опцию
Получать Market SKU для новых товаров (ключ msymarketfbs_auto_receive_market_sku)
Примечание! Поиск подходящего Маркета SKU на Яндекс.Маркет происходит на основании название товара из поля pagetitle.


Генерация XML файла каталога товаров

На странице Прайс-листы можно создать и настроить генерацию XML файла каталога товара. Прайс лист может создаваться как вручную, так и через cron Для того, чтобы прайс лист создавался по cron в настройке
Способ генерации файла выберите Cron и в настройке Расписание для CRON укажите нужное время в классическом для cron формате.


Важно! Для создания файлов по cron на сервере в задания для cron необходимо добавить выполнение каждую минуту скрипта

core/components/msymarketfbs/cron/generate.php


Чтобы получить ссылку на скачивания прайс-листа кликните по кнопке


Ошибки дополнения, а также лог отладки можно смотреть на странице


Полезные консольные скрипты

  • получение для всех товаров Маркета SKU
    core/components/msymarketfbs/scripts/marketsku.php
  • обновление цен для всех товаров на Маркете
    core/components/msymarketfbs/scripts/updateprice.php