Какие способы интеграции есть у Яндекс Маркета
Способ интеграции выбирают по объему: до сотни товаров хватает кабинета и Excel, дальше нужен модуль или API. Сам доступ к API и модуль Маркета бесплатные, платить приходится за разработку или за сторонние решения.
| Способ | Что умеет | Кому подходит |
|---|---|---|
| Кабинет и Excel-шаблоны | каталог, цены, остатки вручную или файлом | до сотни товаров и редкие изменения |
| Интеграция с WB и Ozon | копирует карточки, цены и остатки с другой площадки раз в сутки | тем, кто уже продает на WB или Ozon |
| Модуль Маркета для 1С | каталог, цены, заказы, остатки, ярлыки из 1С | учет в 1С:ERP, УТ, КА, УНФ, Рознице |
| Встроенная интеграция фирмы 1С | каталог, цены, остатки, загрузка отчетов; заказы и возвраты 1С дорабатывала (данные 1С на февраль 2026 года) | 1С:ERP, КА и УТ: включается в самой программе, без отдельного модуля |
| Модули CMS и решения IT-партнеров | набор функций зависит от решения, часть платные | интернет-магазины на популярных CMS |
| Своя интеграция по API | все: товары, цены, заказы, отзывы, акции, отчеты, буст | тысячи товаров и сотни заказов в день |
| API-уведомления | Маркет сам сообщает о заказах, возвратах, отзывах и чатах | в дополнение к своей интеграции |
Каталог решений, построенных на API Маркета, - в справке, раздел «IT-партнеры Яндекс Маркета». Маркет требует от партнеров обновлять код не позже чем через 120 дней после изменений в API и отвечать продавцам за один рабочий день: эти условия полезно проверить у поставщика до оплаты.
Модуль 1С для Яндекс Маркета: версии и возможности
Модуль «Размещение на маркетплейсе Маркета» разработан самим Маркетом и бесплатен. Он ставится в конфигурацию 1С и позволяет управлять товарами и заказами, не заходя в кабинет.
| Конфигурация | Версия не ниже |
|---|---|
| 1С:ERP Управление предприятием 2 | 2.4.6.154 |
| 1С:Управление торговлей 11 | 11.4.5.111 |
| 1С:Комплексная автоматизация | 2.4.6.175 |
| 1С:Управление нашей фирмой | 1.6.16.120 |
| 1С:Розница | 3.0.1.193 |
Что модуль умеет по моделям работы:
| Возможность | FBY | FBS | DBS |
|---|---|---|---|
| Добавлять товары, сопоставлять с карточками, вести каталог | да | да | да |
| Цены и автоматическая передача цен | да | да | да |
| Заказы и статусы | нет | да | да |
| Остатки | нет | да | да |
| Грузовые места, ярлыки, акты приема-передачи | нет | да | нет |
Как установить модуль
Нужна лицензия платформы «1С:Предприятие» ПРОФ или КОРП. Базовая лицензия не подходит, даже если у вас базовая версия конфигурации.
- Сделайте резервную копию базы.
- Скачайте установочный файл модуля по ссылке из документации Маркета: для ERP, УТ и КА один архив, для УНФ и Розницы другой.
- В 1С откройте «Файл» → «Открыть» и выберите установочный файл. Если появится предупреждение, нажмите «Да» и откройте файл еще раз.
- Отметьте «Подтверждаю наличие резервной копии базы данных», примите лицензионное соглашение и нажмите «Установить».
- Нажмите «Перезапустить сеанс»: в меню слева появится раздел «Размещение на маркетплейсе Маркета».
1С:Бухгалтерии в списке конфигураций нет: модуль про торговые операции, а не про бухгалтерский учет. Если вы ведете только Бухгалтерию, отчет Маркета о продажах загружают в нее штатной командой, об этом ниже.
Учет операций Яндекс Маркета в 1С
Для учета берут три закрывающих документа Маркета и три финансовых отчета кабинета. С 1 сентября 2026 года пакет за месяц - УПД со статусом «1», сводный отчет по данным статистики и отчет агента. Как их читать и где скачать - в статье о выплатах и отчетах Маркета.
| Что отражаете | Откуда цифры |
|---|---|
| Выручку от продажи товаров покупателям | отчет «По реализации» и сводный отчет: передано в доставку, доставлено, невыкупы, возвраты |
| Услуги Маркета | УПД-1 и отчет «По стоимости услуг» с разбивкой по каждой услуге |
| Деньги от Маркета и зачеты | отчет агента и отчет «По платежам» |
Справка Маркета дает пошаговые проводки для 1С:УТ, КА, ERP и особенности Бухгалтерии 8.3, но эти статьи помечены как инструкции для периода до 1 октября 2024 года. В них выручка отражается как реализация розничному покупателю, а склад Маркета - как место отгрузки. Маркет прямо пишет, что это рекомендации, а не требование: схему на текущий период согласуйте со своим бухгалтером.
В самой 1С:Бухгалтерии 8 загрузка отчета Маркета о продажах есть с релиза 3.0.126: «Продажи» → «Маркетплейсы и комиссионеры». По отчету программа создает документы отгрузки, реализации и возврата, а передачу товара на склад Маркета фирма 1С советует отражать перемещением: Маркет не комиссионер. Эти данные 1С опубликовала в декабре 2022 года, до смены договоров Маркета в 2024 году, поэтому перед загрузкой проверьте свой релиз и сверьте итоги с отчетом «По реализации».
Как получить API-ключ Яндекс Маркета
Для API нужен токен Api-Key: его создает владелец или менеджер кабинета в разделе «Настройки» → «API и модули» → «Токены авторизации» → «Создать новый токен». Дальше задаете название, выбираете доступы и копируете ключ. Он передается в заголовке Api-Key, без него Маркет ответит ошибкой 401.
| Api-Key | OAuth (устаревший) | |
|---|---|---|
| Привязка | к кабинету | к сотруднику |
| Магазины | все магазины кабинета | только доступные сотруднику |
| Доступы по группам методов | да | нет |
| Срок действия | бессрочно, пока не удалите | 1 год |
Доступы выдают по группам: полное управление кабинетом, просмотр всех данных, обработка заказов и остатки, цены, товары и карточки, продвижение, финансы и отчетность, общение с покупателями, настройки магазинов, заявки FBY. У многих групп есть вариант только на чтение.
Правило безопасности простое: каждой программе свой ключ с минимальными доступами. Репрайсеру - только «Управление ценами», аналитике - «Просмотр всех данных», складской программе - заказы и остатки. Ключей в кабинете может быть до 30; если программа больше не нужна, ее ключ удаляют, и доступ пропадает сразу.
Ограничения API Маркета, о которые спотыкаются интеграции
Большая часть сбоев интеграций - это лимиты, а не ошибки Маркета. Их стоит заложить в код с первого дня.
- Не больше 4 одновременных запросов на магазин или кабинет. Пятый получит ответ
420 Enhance Your Calm. - Лимиты ресурсов: у каждого метода свой предел запросов или объема данных за период. Остаток видно в заголовках ответа
X-RateLimit-Resource-RemainingиX-RateLimit-Resource-Until. - Ошибки 4xx тоже тратят лимит, ошибки 5xx на стороне Маркета - нет. Цикл повторов неправильного запроса съест суточный лимит.
- Тело запроса - до 512 КБ. Большие обновления цен и остатков делят на пачки.
- Подписка Медиум расширяет лимиты: конкретные значения указаны у каждого метода.
- Цены обновляйте отдельным методом для цен: он принимает до 10 000 товаров в минуту и до 500 в запросе, а метод редактирования товаров - 5 000 товаров в минуту (10 000 с подпиской Медиум) и не больше 100 в запросе.
Почему API перестал работать
Статус доступа виден в кабинете на той же странице, где создают ключи, и в ответе методов списка магазинов. Причины отключения: интеграцию выключили вручную, магазин больше 90 дней не размещал товары на витрине, нет действующего договора, магазин не подключен к программе размещения. После 90 дней простоя нужно включить интеграцию, проверить логи, обновить цены и остатки и отправить магазин на проверку.
API-уведомления Маркета и чем они отличаются от push-api
API-уведомления избавляют от постоянного опроса Маркета: он сам отправляет запрос на ваш адрес, когда случается событие. Не путайте их с push-api: так называлась старая схема работы с Маркетом, и документация прямо пишет, что API-уведомления с ней не связаны. Подключение - в разделе ключей API, вкладка «API-уведомления» → «Подключить уведомления».
- События: создание, изменение и отмена заказа, смена статуса, заявка на отмену, возврат или невыкуп; для кабинета еще новый отзыв, комментарий, чат, сообщение и спор.
- Требования к серверу: HTTPS с сертификатом от официального центра сертификации, самоподписанный не подойдет.
- Безопасность: проверяйте, что запрос пришел с адресов Маркета 5.45.207.0/25, 141.8.142.0/25 или 5.255.253.0/25.
- Кабинет или магазин: если уведомление включено и там, и там, придет одно - на адрес магазина.
Для модели FBS (как она устроена - в статье о FBS на Маркете) это прямая защита индекса качества: заказ, о котором вы узнали через минуту, а не через час, реже собирают с опозданием. Как опоздания превращаются в доплаты - в статье об индексе качества Маркета.
Перенос каталога на Маркет с Wildberries и Ozon
Если вы уже продаете на WB или Ozon, каталог переносят без программиста, это самый быстрый старт из описанных в статье о том, как продавать на Маркете: «Товары» → «Каталог» → «Загрузить и обновить» → «С другого маркетплейса».
- Ключ другой площадки только на чтение. Ozon: «Настройки» → «Seller API», тип токена «Admin Read only», нужны Client ID и API key. WB: «Настройки» → «Доступ к API», категории «Контент», «Маркетплейс», «Цены и скидки», уровень «Только чтение».
- Товары и цены переносятся со скоростью около 1 000 товаров в минуту, потом проверьте статусы в каталоге.
- Остатки: для каждого склада Маркета выбирается один склад другой площадки.
- Регулярное обновление раз в сутки: новые товары, цены или описание, правило, чьи данные главнее при расхождении.
Три ловушки. Ключ Ozon действует 6 месяцев - не продлили, и данные перестанут обновляться. Артикул сопоставляется по артикулу продавца, а на WB вместе с размером: LO-2832-black размера 42 станет на Маркете LO-2832-black42, и если на Маркете у товара другой артикул, появится дубль. И главное: прежде чем скрыть товар на другой площадке, обнулите его остаток, иначе на Маркете он останется в продаже и заказ придется отменять.
Логи запросов и ошибки интеграции
Логи - первое место, куда смотреть, если цены или остатки не доходят до Маркета. Они в разделе ключей API, вкладки «Лог запросов» и «Лог уведомлений»: фильтр по ошибкам, по ресурсу, полный текст запроса и ответа. На «Сводке» есть виджет «Интеграции» с числом ошибок.
Что проверять раз в неделю:
- методы с ошибками и их доля - рост ошибок остатков ведет к продаже того, чего нет;
- ответы 420 - пора разносить запросы во времени;
- устаревшие методы из раздела документации «Устаревшие методы» - рано или поздно они перестанут отвечать.
Как подключить Маркет к кабинету SkuScan
Кабинету SkuScan нужен Api-Key с доступом «Просмотр всех данных»: он только читает данные и ничего не меняет в магазине. Ключ создается за минуту там же, где ключи для других программ, затем вставляется в кабинете SkuScan в «Подключения».
После подключения кабинет показывает «Прибыль» по заказам Маркета после удержаний площадки, буста, себестоимости и налога, «Товары» с прибылью с одной продажи, «Остатки» на сколько дней хватит товара, «Отзывы и вопросы» с черновиком ответа и «Новости» об изменениях правил Маркета. Если вы продаете еще на WB или Ozon, один товар сравнивается по прибыли на всех площадках. Кабинет - 14 дней бесплатно, тарифы - на странице тарифов.