Настройка интеграции Яндекс.Маркет (FBS)

Интеграция с Яндекс маркет настраивается в ЛК Яндекс маркет и приложения Пакетная интеграция.

ЛК Яндекс.Маркета (Шаг 1) В ЛК Яндекс маркет следует указать адрес для отправки запросов к серверу интеграции,
В настройке интеграции (Шаг 2 и Шаг 3) вносится информация о номере кампании магазина и ключ для доступа серверу Яндекс.Маркета к серверу интеграции
После сохранения настроек параметров интеграции и повторного открытия окна настроек интеграции (Шаг 4) подтвердите доступ приложения Пакетная интеграция к информации магазина Яндекс.Маркет через API. Добавьте задачу Обновления списка Карточек товаров для получения Карточек товаров.
После добавления задач синхронизации остатков проверки передачи остатков и синхронизации заказов, в ЛК Яндекс.Маркета (Шаг 5) включите интеграцию на стороне Яндекс.Маркета

Шаг 1. Настройки в ЛК ЯндексМаркет для запросов к API интеграции

Из ЛК продавца ЯндексМаркет, в меню слева ЛК ЯМаркет [название магазина]/Настройка API bp на вкладке "Получение запросов от Маркета"/параметры настройки:

проверьте наименование магазина в правом верхнем углу ЛК
Авторизационный токен - создаем, копируем в Параметры настройки интеграции значение из поля Авторизационный токен (Шаг 3)
URL для запросов API - заполняем значение для API интеграции https://api.voinfo.ru/api/beru
Способ авторизации - включить параметр "HEADER"
Формат данных - "JSON"

Шаг 2. Настройки подключения к ЯндексМаркет

Из ЛК продавца ЯндексМаркет, в меню слева ЛК ЯМаркет [название магазина]/Настройка API bp на вкладке "Отправка запросов Маркету" копируем значение ID кампании:

проверьте наименование магазина в правом верхнем углу ЛК
в поле ID кампании, campaign_id настроек интеграции, копируем значение "ID кампании, campaign_id"
в поле ID кабинета, business_id настроек интеграции, копируем значение "ID кабинета, business_id".

Для отправки запросов к ЯндексМаркет со стороны интеграции, для синхронизации заказов и цен, учета начислений и комиссий, обновления "Карточек товаров" и распечатки этикеток - необходимо сформировать запрос на доступ через Ссылку открытия окна запроса авторизации OAuth (Авторизация OAuth для запросов интеграции к ЯМаркет - Шаг 4).

Шаг 3. Получение Авторизационного токена для запросов Яндекс.Маркет к серверу интеграции

проверьте наименование магазина в правом верхнем углу ЛК
Авторизационный токен - создаем, копируем в Параметры настройки интеграции значение из поля Авторизационный токен

Шаг 4. Авторизация OAuth для запросов интеграции к ЯМаркет

Для отправки запросов к ЯндексМаркет со стороны интеграции, для синхронизации заказов и цен, учета начислений и комиссий, обновления "Карточек товаров" и распечатки этикеток

необходимо сформировать запрос на доступ через Ссылку открытия окна запроса авторизации OAuth.

Запрос на доступ к ЛК Яндекс.Маркет

После Сохранения настроек параметров интеграции (Шаг 1, 2, 3), и повторного открытия окна настроек Параметры интеграции

кнопка Редактировать Ямаркет ####### на вкладке магазина

Открыть окно по ссылке "Авторизация для запросов к Яндекс маркет": Открыть окно для получения токена авторизации
В открывшемся окне после авторизации в ЛК Яндекс, подтвердить предоставление прав приложению Пакетная интеграция.
После сохранения ключа, вернутся в основное Окно настроек интеграции.

Шаг 5. Включение интеграции на стороне ЯндексМаркет

В меню слева ЛК ЯМаркет [название магазина]/Настройка API

В разделе Обновление данных об остатках товаров

При нажатии "Проверить запрос", в сообщении от ЛК ЯндексМаркет - информация по остаткам.
Включаем параметр: "Обновлять данные автоматически".

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

Идентификатор склада
Оперативно обновить в Маркете

Идентификатор склада

Обязательный параметр только при исполоьзовании параметра "Оперативно обновить в Маркете".
Узнать идентификатор склада вы можете в личном кабинете в разделе Логистика > Склады. Он указан в поле ID склада.

Если вы работаете с общими остатками, вы можете посмотреть идентификатор склада в личном кабинете в разделе Настройки > Настройки API в блоке Вы работаете с общими остатками.

Внимание! Этот параметр обязательный только при использовании параметра задачи: "Оперативно обновить в Маркете".

Узнать идентификатор склада вы можете в личном кабинете в разделе Логистика > Склады. Он указан в поле ID склада.

Оперативно обновить в Маркете

Для формирования запросов в Маркет для оперативного дополнительного обновления остатка, в случае если запросы на обновление маркет формирует на своей стороне (ЯндексМаркет)

Дополнительная проверка "заказов" в маркет

Дополнительно для оперативного получения информации по изменениям, например расширенному обновлению статусов заказов на Яндекс и СберМегаМаркет. По остальным маркетам Озон, Wildberries и AliExpress, для проверки заказов включение функции не требуется поскольку опрос заказов на стороне маркетов используется постоянно.

Оптимизация функций интеграции ЯндексМаркет

Передача заказов и информации по остаткам с ЯндексМаркет традиционно происходит передачей запросов к серверу магазина (интеграции), т.е. запросы к API для

подтверждения остатка товара для помещения в корзину
создания заказа покупателя
изменение статуса или отмены заказа покупателя
всех остатков, для витрины, пакетами по 100 - 500 запросов

Заказы - после передачи заказа или отмены статуса подтвердить текущую информацию по списку заказов невозможно. Поэтому специально для настройки Яндекс FBS используйте дополнительный параметр опроса списка заказов на стороне Яндекс.

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

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

Параметры Идентификатор склада и Оперативно обновить в Маркете в Задаче синхронизации остатка, позволят оперативно передавать все остатки в течении нескольких секунд или принудительно при выполнеии задачи синхронизации остатка.

Добавить интеграцию, подключение и настройка магазина

Инструкции по настройке и подключению

voinfo.ru

Инструкции по настройке

Настройка интеграции

E-commerce и маркетплейс

Настройка API интеграции

Параметры и опции для настройки

Авторизационный токен

строка

проверьте наименование магазина в правом верхнем углу ЛК
Авторизационный токен - создаем, копируем в Параметры настройки интеграции значение из поля Авторизационный токен

Параметр "товара" Склада соответствия "карточки" Маркета

выбор одного значения

Выбор поля (артикул или код) Номенклатуры системы Склада для сопоставления с артикулом поставщика "Карточки товара" в маркетплейс.

ID кабинета, business_id

строка

проверьте наименование магазина в правом верхнем углу ЛК
в поле ID кабинета, business_id настроек интеграции, копируем значение "ID кабинета, business_id".

ID кампании, campaign_id

строка

проверьте наименование магазина в правом верхнем углу ЛК
в поле ID кампании, campaign_id настроек интеграции, копируем значение "ID кампании, campaign_id"

Автоподбор по штрихкоду

переключатель

Автоматическое сопоставление Карточки товара Маркета и товара из Номенклатуры Склада по штрихкоду товара.

Дополнительная проверка "заказов" в маркет

переключатель

Приоритетная обработка субстатусов

переключатель

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

Рассчитать цену товара с учетом начислений

переключатель

Рассчитать цену товара в документах Заказ Покупателя и связанной Отгрузке за вычетом затрат - начислений по услугам маркета, разнесением затрат пропорционально цены продажи строки заказа.

Включение параметра заменяет функцию передачи суммы начислений в раздел Накладные расходы документа Отгрузка. При включении учета комиссий и начислений, комиссия маркетплейс учитывается в цене товара всегда при появлении значения комиссии по заказу независимо от состояния данного параметра.

Группа подключений

выбор нескольких значений

Группа подключений служит для разделения доступа пользователей по фильтру для интеграций и задач. Является дополнительным параметром настройки. Справочник Групп подключений на вкладке Настройка.

Параметр для фильтра Номенклатуры

выбор одного значения

параметр фильтрации справочника Номенклатуры из системы Склада, для ограничения ассортимента

Общий Лист сопоставления товаров

строка

Укажите номер настроек существующей интеграции магазина для совместного использования сохраненного Листа сопоставления Карточек товаров и Номенклатуры в нескольких интеграциях.

Включить обработку комплектов и модификаций

чекбокс

Включить обработку комплектов при формировании документов МойСклад, проводить калькуляцию остатков комплектов для передачи на маркеты на основании данных о товарах и модификациях составляющих комплекты

Ссылка на Google Sheets

строка

Ссылка на Ссылка на Google таблицу Sheets, для хранения справочника значений сопоставления Карточек товаров и Номенклатуры, если артикулы Карточек товаров из маркетплейс отличаются от сохраненных в Номенклатуре системы Склада

Наименование магазина для сохранения

строка

Дополнительное имя, которое заменит номер интеграции на Вкладке приложения.

Скрыть логотип маркетплейс

чекбокс

Показывать логотип маркетплейс на ярлыке магазина

Авторизация для запросов к маркетплейс

действие

Для отправки запросов к ЛК продавца со стороны приложения Пакетная интеграция, в задачах:

синхронизации цен
получения "карточек товаров"
распечатки этикеток

Необходимо сформировать запрос на доступ OAuth.

Для этого, после сохранения параметров интеграции,

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

Адрес для получения YML feed

линк

URL адрес для получения и использования YML или XML фида в маркетплейс или других системах. Время хранения и обновления фида зависит от типа фида, используемого тарифного пакета и параметров настройки задачи создания фида. Сохраните данную ссылку в ЛК системы назначения фида, ссылка меняется в случае удаления интеграции или задачи формирования фида.

Подбор по Id Номенклатуры Склада

переключатель

Подбор сопоставления по соответствию значения артикула Карточки товара и системного Id Номенклатуры Склада

Предварительное резервирование

переключатель

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

Внешний YML источник сопоставления товаров

строка

url YML источника (feed) для обновления идентификаторов сопоставления товаров, справочника товаров