Настройка интеграции Яндекс.Маркет (FBS)
В этой инструкции мы подробно расскажем, как настроить интеграцию товарного учета с Яндекс.Маркет и синхронизировать информацию о товарах, остатках и заказах, настроить отчеты и аналитику для отслеживания продаж и остатков. Ваша система учета должна автоматически формировать отчеты по товарам, продажам и остаткам на Яндекс.Маркет. Это поможет вам принимать более обоснованные решения о пополнении ассортимента и управлении складом.
Интеграция с маркетплейсом Яндекс.Маркет (FBS, Express) - основные функции
- синхронизация заказов FBS, Express FBS (FBY - отдельный тип интеграции)
- управляемая обработка основных и суб.статусов заказов
- автоподтверждение заказов
- синхронизация остатков по одному или нескольким складам
- принудительная оперативная передача остатков
- дополнительная проверка заказов в маркетплейс
- передача значения цены продажи, перечеркнутой цены
- синхронизация универсальных цен для магазинов
- учет значений комиссии и начислений по услугам маркетплейс в цене или накладных расходах
- управление резервом, списание остатков
- автосоздание по статусу заказа документов Отгрузка, Вх.платеж, Возврат покупателя, Перемещение
- защита от парсеров - минимальный и максимальный остаток
- предварительное резервирование - моментальное обновление остатка при заказе
- автозагрузка сопоставления товаров из-yml фида или Google Sheets
- распечатка этикетки отправления в ленту
- создание акта поставки
- смена статусов поставки, отправка кодов маркировки Честный знак в маркетплейс
- сопоставление Номенклатуры и Карточки товара по коду, артикулу или автоподбор по штрихкоду
- автосоздание YML фида для создания Карточек товаров
Основные параметры настройки или создания интеграции магазина
Интеграция с Яндекс маркет настраивается в ЛК Яндекс маркет и в параметрах настройки магазина приложения Пакетная интеграция.
- ЛК Яндекс.Маркета (Шаг 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. Получение Авторизационного токена для запросов Яндекс.Маркет к серверу интеграции
Из ЛК продавца ЯндексМаркет, в меню слева ЛК ЯМаркет [название магазина]/Настройка API bp на вкладке "Получение запросов от Маркета"/параметры настройки:
- проверьте наименование магазина в правом верхнем углу ЛК
- Авторизационный токен - создаем, копируем в Параметры настройки интеграции значение из поля Авторизационный токен
Замена для функций обработки заказов и синхронизации остатков при отсутствии в ЛК Яндекс маркет Авторизационного токена.
Для Яндекс Маркет часть магазинов подключается по новой схеме, где Авторизационный токен отсутствует в разделе настройка API ЛК Яндекс.Маркет, т.е. для запросов на сервер интеграции в настройке интеграции магазина Авторизационный токен заполнять не требуется. Для данной инструкции - Шаг 3 и Шаг 5 игнорируется.
- для функции обработки заказов - в настройке магазина (параметры интеграции) - Дополнительная проверка "заказов" в маркет = включить запросы к маркетплейс
- для обработки остатков - в задаче - Синхронизация Остатков (после создания), заполнить параметр Идентификатор склада и включить параметр Оперативно обновить в Маркете
Шаг 4. Авторизация OAuth для запросов интеграции к ЯМаркет
Для отправки запросов к ЯндексМаркет со стороны интеграции, для синхронизации заказов и цен, учета начислений и комиссий, обновления "Карточек товаров" и распечатки этикеток
- необходимо сформировать запрос на доступ через Ссылку открытия окна запроса авторизации OAuth.
Запрос на доступ к ЛК Яндекс.Маркет
После Сохранения настроек параметров интеграции (Шаг 1, 2, 3), и повторного открытия окна настроек Параметры интеграции
кнопка Редактировать Ямаркет ####### на вкладке магазина
- Открыть окно по ссылке "Авторизация для запросов к Яндекс маркет": Открыть окно для получения токена авторизации
- В открывшемся окне после авторизации в ЛК Яндекс, подтвердить предоставление прав приложению Пакетная интеграция.
- После сохранения ключа, вернутся в основное Окно настроек интеграции.
Шаг 5. Включение интеграции на стороне Яндекс.Маркет
В меню слева ЛК ЯМаркет [название магазина]/Настройка API
- В разделе Обновление данных об остатках товаров
- При нажатии "Проверить запрос", в сообщении от ЛК ЯндексМаркет - информация по остаткам.
- Включаем параметр: "Обновлять данные автоматически".
- В разделе Получение запросов от маркета - "Получать запросы от маркета"
- Способ обновления данных об остатках - Маркет запрашивает остатки у вашего сервера каждый час - при недоступности данного параметра настройки в ЛК Яндекс.Маркет, настройте передачу остатка в задаче синхронизации остатков, раздел "Настройка параметров склада маркетплейс"
- Идентификатор склада
- Оперативно обновить в Маркете
Оперативно обновить в Маркете
Для формирования запросов в Маркет для оперативного дополнительного обновления остатка, в случае если запросы на обновление маркет формирует на своей стороне (ЯндексМаркет)
Для формирования запросов в Маркет по оперативному обновлению остатка
- дополнительно к стандартным функциям обновления остатка, где доступен раздел Настройка API - получение запросов от Маркета
- обязательно для новых версий ЛК, где в ЛК Яндекс отсутствует раздел Настройка API - получение запросов от Маркета
Проверять заказы в API маркетплейса
Дополнительно для оперативного получения информации по изменениям, например расширенному обновлению статусов заказов на Яндекс и МегаМаркет.
Оптимизация функций интеграции ЯндексМаркет
Передача заказов и информации по остаткам с Яндекс.Маркет стандартно происходит передачей запросов к серверу магазина (интеграции), т.е. запросы к API для
- подтверждения остатка товара для помещения в корзину
- создания заказа покупателя
- изменение статуса или отмены заказа покупателя
- всех остатков, для витрины, пакетами по 100 - 500 запросов
- Заказы - после передачи заказа или отмены статуса подтвердить текущую информацию по списку заказов невозможно. Поэтому специально для настройки Яндекс FBS используйте дополнительный параметр опроса списка заказов на стороне Яндекс.
Параметр Дополнительная проверка "заказов" в маркет дублирует функции обработки заказов в стандартном режиме, и включает дополнительную функцию опроса списка заказов со стороны интеграции на Яндекс.Маркет.
- Остатки по товарам, при массовом изменении, обновляются медленно, если количество товаров несколько тысяч и более. Данные на витрине ЯндексМаркета некоторое время вероятно будут неактуальными.
Параметры Идентификатор склада и Оперативно обновить в Маркете в Задаче синхронизации остатка, позволят оперативно передавать все остатки в течении нескольких секунд или принудительно при выполнеии задачи синхронизации остатка.
При настройке интеграции Яндекс Маркет по функциям оперативного обновления остатка и дополнительной синхронизации заказов:
- используются дополнительно к стандартным функциям обновления остатка, где доступен раздел Настройка API - получение запросов от Маркета
- используются обязательно для новых версий ЛК, где в ЛК Яндекс отсутствует раздел Настройка API - получение запросов от Маркета
Параметры и опции для настройки
Авторизационный токен
строка
Из ЛК продавца ЯндексМаркет, в меню слева ЛК ЯМаркет [название магазина]/Настройка API bp на вкладке "Получение запросов от Маркета"/параметры настройки:
- проверьте наименование магазина в правом верхнем углу ЛК
- Авторизационный токен - создаем, копируем в Параметры настройки интеграции значение из поля Авторизационный токен
Поле Номенклатуры учетной системы для соответствия "Карточке товара" маркетплейса
выбор одного значенияВыбор поля (артикул или код) товара Номенклатуры учетной системы для сопоставления с артикулом поставщика (кодом поставщика) в "Карточке товара" на маркетплейсе.
Цена закупки
выбор одного значенияВыбор Типа цены для расчета с учетом Цены закупки товара, расчета прибыли при продаже, с учетом комиссии маркетплейс и накладных расходов - услуги хранения, логистики и доставки.
ID кабинета, business_id
строка Из ЛК продавца ЯндексМаркет, в меню слева ЛК ЯМаркет [название магазина]/Настройка API bp на вкладке "Отправка запросов Маркету" копируем значение ID кампании:
- проверьте наименование магазина в правом верхнем углу ЛК
- в поле ID кабинета, business_id настроек интеграции, копируем значение "ID кабинета, business_id".
Обрабатывать начисления и комиссию маркетплейс
переключатель
Обрабатывать комиссию за размещение на витрине и начисления по услугам маркетплейса - логистика, последняя миля, продвижение для заказа, обработка отправления, эквайринг и пр.
ID кампании, campaign_id
строка Из ЛК продавца ЯндексМаркет, в меню слева ЛК ЯМаркет [название магазина]/Настройка API bp на вкладке "Отправка запросов Маркету" копируем значение ID кампании:
- проверьте наименование магазина в правом верхнем углу ЛК
- в поле ID кампании, campaign_id настроек интеграции, копируем значение "ID кампании, campaign_id"
Автоподбор по штрихкоду
переключатель Автоматическое сопоставление Карточки товара маркетплейса и товара из Номенклатуры учетной системы по штрихкоду товара.
Проверять заказы в API маркетплейса
переключатель
Дополнительно для оперативного получения информации по изменениям, например расширенному обновлению статусов заказов на Яндекс и МегаМаркет.
Приоритетная обработка субстатусов
переключатель Сначала для событий обработки и маппинга статусов учетной системы проверять субстатусы заказа, а далее статусы заказа
Группа подключений
выбор нескольких значенийГруппа подключений служит для разделения доступа пользователей по фильтру для интеграций и задач. Является дополнительным параметром настройки. Справочник Групп подключений на вкладке Настройка.
Очистить соответствие при удалении ШК
чекбоксОчистить сопоставление карточки товара и номенклатуры при удалении ШК, т.е. при удалении ШК в справочнике Номенклатуры в Карточке товара сопоставление будет удалено.
Параметр для фильтра Номенклатуры
выбор одного значения Параметр фильтрации ассортимента из справочника Номенклатуры системы учета, для ограничения ассортимента используемого в обработке задач-сервисов магазина.
Общий Лист сопоставления товаров
строка Укажите номер настроек существующей интеграции магазина для совместного использования сохраненного Листа сопоставления Карточек товаров и Номенклатуры в нескольких интеграциях.
Включить обработку комплектов и модификаций
чекбоксВключить обработку комплектов при формировании документов учетной системы, проводить калькуляцию остатков комплектов для передачи на маркетплейсы на основании данных о товарах и модификациях составляющих комплекты
Смещение периода обработки начислений
номер Количество дней для обработки отчета по начислениям маркетплейс, по -умолчанию это значение 2 недели, от текущей даты обработки отчета. Этот параметр используется в связи с тем что часть начислений на стороне маркетплейс меняется после появления в отчетах. Вероятность изменения данных начислений минимальна после 2-х недель появления в отчете начислений.
Наименование магазина для сохранения
строкаДополнительное имя, которое заменит номер интеграции на Вкладке приложения.
Скрыть логотип маркетплейс
чекбоксПоказывать логотип маркетплейс на ярлыке магазина
Авторизация для запросов к маркетплейс
действие
Для отправки запросов к ЛК продавца со стороны приложения Пакетная интеграция, в задачах:
- синхронизации цен
- получения "карточек товаров"
- распечатки этикеток
Необходимо сформировать запрос на доступ OAuth.
Для этого, после сохранения параметров интеграции,
- Включить режим настройки интеграции по кнопке Редактировать ... .
- Открыть окно по ссылке "Авторизация для запросов к маркетплейс": Открыть окно для получения токена авторизации
- В открывшемся окне после авторизации, подтвердить предоставление прав приложению Пакетная интеграция.
- После сообщения об успешном сохранении ключа, вернутся в основное Окно настроек интеграции.
Адрес для получения YML feed
линк URL адрес для получения и использования YML или XML фида в маркетплейс или других системах. Время хранения и обновления фида зависит от типа фида, используемого тарифного пакета и параметров настройки задачи создания фида. Сохраните данную ссылку в ЛК системы назначения фида, ссылка меняется в случае удаления интеграции или задачи формирования фида.
Подбор по Id Номенклатуры системы учета
переключатель Подбор сопоставления по соответствию значения артикула Карточки товара и системного Id (идентификатора) Номенклатуры системы учета
Предварительное резервирование
переключательФункция для оперативного обновления информации об остатках в маркетплейс.
При создании заказа, используется предварительный расчет остатка с учетом резервирования и моментально отправляется запрос на обновление информации в маркетплейс по отдельному товару.