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

• синхронизация заказов FBS, Express FBS (FBY - отдельный тип интеграции)
• управляемая обработка основных и суб.статусов заказов
• автоподтверждение заказов
• синхронизация остатков по одному или нескольким складам
• принудительная оперативная передача остатков
• дополнительная проверка заказов в маркетплейс
• передача значения цены продажи, перечеркнутой цены
• синхронизация универсальных цен для магазинов
• учет значений комиссии и начислений по услугам маркетплейс в цене или накладных расходах
• управление резервом, списание остатков
• автосоздание по статусу заказа документов Отгрузка, Вх.платеж, Возврат покупателя, Перемещение
• защита от парсеров - минимальный и максимальный остаток
• предварительное резервирование - моментальное обновление остатка при заказе
• автозагрузка сопоставления товаров из-yml фида или Google Sheets
• распечатка этикетки отправления в ленту
• создание акта поставки
• смена статусов поставки, отправка кодов маркировки Честный знак в маркетплейс
• сопоставление Номенклатуры и Карточки товара по коду, артикулу или автоподбор по штрихкоду
• автосоздание YML фида для создания Карточек товаров

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

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

Начиная с 2024 года, В ЛК Партнера Яндекс.Маркет, для новых магазинах, данная вкладка может отсутствовать. В этом случае для обновления остатка обязательно в задаче синхронизации остатков включите параметр Оперативно обновить в Маркете и добавьте значение Идентификатор склада для оперативного обновления, а для получения заказов в настройке интеграции магазина параметр Проверять заказы в API маркетплейса.

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

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

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

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

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

Начиная с 2024 года, В ЛК Партнера Яндекс.Маркет, для новых магазинах, данная вкладка может отсутствовать. В этом случае для обновления остатка обязательно в задаче синхронизации остатков включите параметр Оперативно обновить в Маркете и добавьте значение Идентификатор склада для оперативного обновления, а для получения заказов в настройке интеграции магазина параметр Проверять заказы в API маркетплейса.

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

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

Замена для функций обработки заказов и синхронизации остатков при отсутствии в ЛК Яндекс маркет Авторизационного токена.

Для Яндекс Маркет часть магазинов подключается по новой схеме, где Авторизационный токен отсутствует в разделе настройка API ЛК Яндекс.Маркет, т.е. для запросов на сервер интеграции в настройке интеграции магазина Авторизационный токен заполнять не требуется. Для данной инструкции - Шаг 3 и Шаг 5 игнорируется.

• для функции обработки заказов - в настройке магазина (параметры интеграции) - Дополнительная проверка "заказов" в маркет = включить запросы к маркетплейс
• для обработки остатков - в задаче - Синхронизация Остатков (после создания), заполнить параметр Идентификатор склада и включить параметр Оперативно обновить в Маркете

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

• Для получения значения Токен для авторизации в Личном кабинете Яндекс.Маркет
  • В ЛК партнера Яндекс.Маркет, в левом меню, в разделе магазина Модули и API

1. Выбрать вкладку - Отправка запросов Маркету
2. Нажать кнопку - Создать с полным доступом

В настройке параметров интеграции магазина - приложения Пакетная интеграция:

1. Скопировать и вставить значение токена в поле настройки интеграции магазина приложения
   • Токен для авторизации (для запросов к Маркету) настройки интеграции магазина.
2. Сохранить в приложении настройку интеграции магазина.

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

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

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

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

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

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

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

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

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

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

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

При настройке интеграции Яндекс Маркет по функциям оперативного обновления остатка и дополнительной синхронизации заказов:

• используются дополнительно к стандартным функциям обновления остатка, где доступен раздел Настройка API - получение запросов от Маркета
• используются обязательно для новых версий ЛК, где в ЛК Яндекс отсутствует раздел Настройка API - получение запросов от Маркета

Управление соответствием статусов документов Заказ покупателя учетной системы и статусов Яндекс.маркет доступно

• из настройки магазина - соответствие статусов
• в настройке задачи синхронизации заказов, если требуется отдельное соответствие для задачи

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

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

• При настройке соответствия статусов рекомендуется использовать только основные статусы заказов Яндекс.Маркет.

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

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

Например,

• если указать в настройке создания документов суб.статус USER_NOT_PAID - статуса CANCELLED,

  • все заказы с статусом CANCELLED и суб.статусом USER_NOT_PAID не будут обрабатываться по основному статусу CANCELLED, а только по статусу USER_NOT_PAID

• если в соответствии статусов и правилах создания документов будет указан только статус CANCELLED

  • все заказы с статусом CANCELLED и суб.статусом USER_NOT_PAID будут обработаны по основному статусу CANCELLED