msYMarketFBS

Работа с Яндекс.Маркет по FBS модели
Автор дополнения
Prihod
Пакетов
38
Закачек
13 409
Обычно отвечает в течение суток
Автор дополнения
Пакетов
38
Закачек
13 409
Обычно отвечает в течение суток
Версия 1.0.4-beta
Дата выпуска 08.09.2022
Загрузки 16
Просмотры 3 815

Дополнение позволяет подключить Интернет-магазин к Яндекс.Маркету через 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

[1.0.4-beta] - 2022-09-08

Добавлено

  • Системное событие "ymfbsOnCart"

[1.0.3-beta] - 2022-03-28

Добавлено

  • Системная опция msymarketfbs_limit_offer_update_price

[1.0.2-beta] - 2021-12-11

Исправлено

  • Ошибка вывода больше 10 изображений товара

[1.0.1-beta] - 2021-12-08

Исправлено

  • Ошибка использования tv полей
  • Ошибка добавление информации о штрих коде

Последние обсуждения в сообществе MODX.pro