voinfo-logo

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


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

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

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

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

  • URL для запросов API - https://api.voinfo.ru/api/beru
  • Способ авторизации - "HEADER"
  • Формат данных - "JSON"

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

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

  • в поле Номер кампании настроек интеграции, копируем значение "Номер кампании"

Из ЛК продавца ЯндексМаркет , после перехода в раздел магазина копируем значение Номер кампании для интеграции

из ссылки например https://partner.market.yandex.ru/supplier/11111111/summary , где 11111111 это номер кампании

Вы можете скопировать ID бизнеса на странице «Подключение»: в правом верхнем углу. Эта информация так же отображается на некоторых других страницах в личном кабинете (например, «Товары» > «Ассортимент по магазинам»).

Внимание! Параметр актуален с 09.11.2024 года.

В "переключателе магазинов" идентификатор бизнеса первая строка без указания схемы логистики. В настоящий момент магазины Яндекс переключает постепенно. Если Яндекс сообщит что магазин переключен на новую схему в настройке параметров интеграции потребуется заполнить параметр Бизнес ID. Если такого оповещения со стороны Яндекс не получали, параметр пока что должен оставаться пустым, поскольку без миграции на стороне ЛК Яндекс новые методы не работают , следует использовать старые методы, которые используются без заполнения параметра Бизнес ID.

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

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

  • в поле Авторизационный код настройки интеграции, копируем значение "Авторизационный токен"

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

Для отправки запросов к ЯндексМаркет со стороны интеграции, в задачах:

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

После Сохранения настроек параметров интеграции, и повторного открытия окна настроек Параметры интеграции

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

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

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

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

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

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

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

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

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

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

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

Добавить интеграцию, подключение и настройка магазина
Инструкции по настройке и подключению
voinfo.ru
Инструкции по настройке
Настройка интеграции
E-commerce и маркетплейс
Настройка API интеграции

Параметры и опции

Доступные группы подключений

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

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

строка при интеграции с ЯMarket

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

  • в поле Авторизационный код настройки интеграции, копируем значение "Авторизационный токен"

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

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

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

строка при интеграции с ЯMarketпри интеграции с Яндекс FBY

Вы можете скопировать ID бизнеса на странице «Подключение»: в правом верхнем углу. Эта информация так же отображается на некоторых других страницах в личном кабинете (например, «Товары» → «Ассортимент по магазинам»).

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

Значение для листа сопоставления из поля

при интеграции с Озонпри интеграции с ЯMarketпри интеграции с Wildberriesпри интеграции с AliExpressпри интеграции с Avitoпри интеграции с Яндекс FBY

Для корректировки списка сопоставления - очистка значений для выбранных строк или подстановка значения при выборе параметра "карточки товара". Параметр из карточки товара маркета для автоматического создания листа сопоставления.

Тип операции

Тип операции начислений по услугам маркетплейс. Каждая услуга маркетплейс относится к определенному типу начислений например Логистика или Продвижение в акциях.

Номер кампании

строка при интеграции с ЯMarketпри интеграции с Яндекс FBY

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

  • в поле Номер кампании настроек интеграции, копируем значение "Номер кампании",

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

переключатель при интеграции с Озонпри интеграции с ЯMarketпри интеграции с Wildberriesпри интеграции с Яндекс FBY

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

Склад назначения

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

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

переключатель при интеграции с Мегамаркетпри интеграции с ЯMarket

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

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

переключатель при интеграции с ЯMarketпри интеграции с Яндекс FBY

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

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

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

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

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

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

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

Сервис (услуга) начисления

Услуга маркетплейс для начислений. С каждым типом операций соотносятся услуги маркетплейс, начисления для обработки заказа формируются со ссылкой на типы операций, тип услуги и значение начисления.

Накладные расходы

номер

Главный склад (группа склада)

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

при интеграции с Озонпри интеграции с ЯMarketпри интеграции с Wildberriesпри интеграции с AliExpressпри интеграции с Яндекс FBY

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

Товар / Поиск товара

Подбор товара по названию коду или артикулу.

  • для поиска по коду 123456 используйте префикс code~123456
  • для поиска по артикулу Новый товар используйте префикс article~Новый

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

строка при интеграции с ЯMarket

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

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

чекбокс

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

Ссылка на Google Sheets

строка

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

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

строка

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

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

чекбокс

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

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

действие при интеграции с ЯMarketпри интеграции с Avitoпри интеграции с Яндекс FBY

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

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

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

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

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

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

линк при интеграции с Озонпри интеграции с Мегамаркетпри интеграции с ЯMarketпри интеграции с Wildberriesпри интеграции с AliExpress

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

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

переключатель при интеграции с ЯMarket

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

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

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

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

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

строка при интеграции с Озонпри интеграции с Мегамаркетпри интеграции с ЯMarketпри интеграции с Wildberriesпри интеграции с AliExpressпри интеграции с Яндекс FBY

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