Плагин устанавливается через "инсталлер".
Для его настроек вам будет нужен доступ к личному кабинету Яндекс.Маркет, в котором находится магазин (минимальный уровень доступа - "администратор").
Все настройки доступны в самом плагине, в разделе Магазин - Плагины - "Интеграция с Яндекс.Маркет".
После установки вам доступны три фиксировнных профиля на выбор, для разных моделей - DBS / FBS / FBS Express. Для большинства магазинов достаточно одного или двух профилей, но если у вас есть задача подключить обработку заказов из нескольких дополнительных магазинов Яндекс.Маркет, вы можете создать новые профили в неограниченном количестве:
Напомним, что:
Включите работу данного профиля:
Откройте личный кабинет Яндекс Маркет вашего магазина.
Левое меню, наведите на название вашего магазина - в открывшемся подменю выберите пункт Модули и API.
На открывшейся странице скопируйте номер кампании и вписываем в настройках плагина.
На той же странице личного кабинета нужно создать токен. Нажмите кнопку "Создать новый токен", укажите название и выберите роль "полное управление кабинетом".
В результате будет выдан токен в формате ACMA:...
Впишите его в настройки плагина:
Поле URL API (устарело).
В данном пункте нужно выбрать по какому ID искать товар в магазине, это могут быть: ID товара / ID артикула / "Код артикула" / ID товара + s + ID артикула.
Подробнее про них:
ID товара и ID артикула - это системные значения Shop-script, они формируются при создании товара и никогда не изменяются.
Отображается на странице редактирования товара:
Отображается при редактировании артикулов:
Это произвольное значение, которое можно заполнить внутри редактирования товара:
Данный формат применяется при выгрузке товаров через штатный плагин "Яндекс.Маркет". В этом случае в качестве offerID для артикулов применяется, например: 1234s4567. Если у товара нет артикулов, то просто ID товара - 1234.
Выбранные значения должны соответствовать с теми, что у вас уже загружены в Яндекс.Маркет ранее.
Если для выгрузки товаров используется плагин "Яндекс.Маркет PRO", то в стандартном варианте используется ID товара, а если активна галочка "Экспортировать каждый артикул как отдельную позицию", то ID артикула.
Данное поле используется только при самостоятельных отправках остатков товаров в Яндекс.Маркет. У некоторых магазинов используются буквенные "приставки" к offerID, например fbs1234, где "fbs" - произвольная приставка, а "1234" - ID артикула. В данном пункте можно указать подобную приставку, чтобы корректно отправить наличие для товара с таким offerID.
При активации данной опции в информационном блоке заказа из Яндекс.Маркета появляется кнопка для отправки кодов идентификации товаров системы "Честный знак".
Передача кодов "Честный знак" возможна при использовании бесплатного плагина от Webasyst https://www.webasyst.ru/store/plugin/shop/chestnyznak
Вы вводите коды идентификации для каждого товара, для которого это необходимо, и нажимаете на кнопку "Честный знак", данные будут отправлены в маркет.
В случае возникновения ошибки она будет выведена в этом же окне и записана в логи.
В данном пункте вы можете выбрать группу товаров, по которым будет определяться наличие для данного магазина. Это могут быть категории / списки / типы товаров. Если Яндекс.Маркет запросит наличие по товару, которого нет среди выбранных вами, то по нему не будет отправлены остатки. При исходящих отправках остатков также будет учитываться только выбранный массив товаров.
В данном пункте вы можете выбрать склады, по которым будет определяться наличие товара для данного магазина.
В данном пункте вы можете указать любое значение кол-ва товара "в наличии", вместо реальных значений. При API запросах из Яндекс.Маркета реальное наличие будет подменяться вашими значениями. Например, вместо 2000 можно ответить 0. Либо, если у товара наличие "бесконечность", но вы понимаете, что больше 30 штук не сможете продать. Укажите inf = 30.
Используется только для самостоятельной отправки остатков по товарам в Яндекс.Маркет. Его можно взять из личного кабинета Яндекс.Маркет, левое меню, "Логистика" - "Склады":
Укажите в настройках Id именно того склада, на который вы хотите отправить остатки для данного профиля
На момент 2025 года остатки обновляются только по инициативе сайта. Вы можете добавить автоматическую команду на регулярное обновление остатков, либо разово нажимать на кнопку "Обновить сейчас".
Ручное обновление остатков:
Еще остатки можно обновить из списка товаров:
Выберите профиль магазина, для которого нужно отправить остатки и нажмите "Обновить"
Если выведено предупреждение "В профиле не заполнен ID склада в Яндекс.Маркет", то нужно ввести этот ID для данного профиля в настройках плагина.
После отправки остатков будет выведена информация, для скольких позиций удалось обновить остатки.
Автоматическое обновление остатков:
Для этого нужно скопировать команду из настроек и добавить в Cron. Способов это сделать множество, для каждого хостинга по разному. Если испытываете сложности - обратитесь в поддержку хостинга.
Частоту запуска следует выбирать исходя из частоты обновления остатков на вашем сайте.
Что такое Сron и как добавлять команды?
Передаётся ли наличие скрытых товаров?
Диагностика проблем с передачей остатков
В Яндекс Маркете вы можете обновить цены для конкретного магазина, либо для всего бизнес кабинета (для всех магазинов сразу). Активируйте чекбокс, если нужно обновить во всех магазинах сразу.
В настройках личного кабинета Маркета может быть уже выбрано обновление для всего кабинета, в этом случае обновить для отдельного магазина не получится, выдаст ошибку.
Выберите откуда брать информацию о ценах, передаваемых в Маркет. Дополнительно можно использовать плагин Цены Про для гибких наценок.
Для каждой из цен можно указать наценку. Доступен выбор диапазона цена и две наценки, например +10% + 100 руб. Можно указать с минусом, если нужна не наценка, а скидка.
Цены можно обновлять только по инициативе сайта. Магазин сам отправляет информацию о том, какие цены нужно обновить. Вы можете добавить автоматическую команду на регулярное обновление цен, либо разово нажимать на кнопку "Обновить сейчас".
Автоматическое обновление цен:
Для этого нужно скопировать команду из настроек и добавить в Cron. Способов это сделать множество, для каждого хостинга по разному. Если испытываете сложности - обратитесь в поддержку хостинга.
Частоту запуска следует выбирать исходя из частоты обновления цен на вашем сайте.
Что такое Сron и как добавлять команды?
Вынесено в отдельную инструкцию => Как настроить передачу заказов из Яндекс Маркета
Внимание! В 2025 году Яндекс.Маркет постепенно откзывается от PUSH модели (отправки запросов в ваш магазин). Вы можете не настраивать условия доставки в плагине, для этого в личном кабинете поставьте галочку «Не использовать метод POST cart» на странице Настройки API → Получение запросов от Маркета. В этом случае будут учитываться те условия, которые вы указали в личном кабинете Маркета.
Если вам вдруг надо настроить в плагине - смотрите здесь.
Сопоставление статусов нужно для синхронизации обычного процесса работы магазина со сменой статусов в Яндекс.Маркет. Допустим, магазин всегда нажимает кнопку "Отправлен" в момент передачи заказа в доставку. В сопоставлении статусов он может указать, чтобы при нажатии этой кнопки в Яндекс.Маркет менялся статус на "передан в доставку".
Желательно уточнить процесс работы со статусами у сотрудников магазина, либо дать им самостоятельно определить нужные действия. Для моделей DBS/FBS нужно отправлять разные смены статусов при обработке заказов.
В данном случае настраивается автоматическое выполнение какого-либо действия в вашем магазине, если из Яндекс.Маркета пришла информация о смене статуса.
Сопоставление статусов нужно для синхронизации обычного процесса работы магазина со сменой статусов в Яндекс.Маркет. Допустим, магазин всегда нажимает кнопку "Отправлен" в момент передачи заказа в доставку. В сопоставлении статусов он может указать, чтобы при нажатии этой кнопки в Яндекс.Маркет менялся статус на "передан в доставку".
Желательно уточнить процесс работы со статусами у сотрудников магазина, либо дать им самостоятельно определить нужные действия. Для моделей DBS/FBS нужно отправлять разные смены статусов при обработке заказов.
В данном случае настраивается автоматическое выполнение какого-либо действия в вашем магазине, если из Яндекс.Маркета пришла информация о смене статуса. Пример: вы можете настроить, чтобы при передаче заказа клиенту в вашем магазине заказ перешел в статус "Выполнен". Для этого в пункте "Заказ доставлен покупателю" выберите действие "Выполнен.
Сами действия и статусы в магазине настраиваются стандартными средствами Shop-script:
После любых внесённых изменений обязательно нажимайте кнопку "Сохранить".
Теперь плагин готов к работе. Читайте, как обрабатывать заказы здесь для DBS или здесь для FBS / FBS экспресс
В личном кабинете Яндекс.Маркет вы можете проверить работу API и плагина с помощью интерфейса тестовых заказов или логов. Они доступны магазинам, загрузившим товары и прошедшим проверку документов.
Первая вкладка плагина - общие настройки.
Смотрите также: