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

Включить интеграцию можно двумя способами:

• в онбординге из вкладки «Документы и ЭДО» — «Покупки» — «Отчёты посредника»;
• в реквизитах, нажав на шестерёнку в правом верхнем углу, далее «Интеграция с партнёрами». 

Для включения интеграции нужно сформировать токен (API ключ). Либо вы формируете токен в сервисе, либо самостоятельно по инструкции Яндекса. 

Формат API-Key-токена

Полученный токен нужно вставить в заголовок Api-Key по следующей схеме: 

Api-Key: <token> 

В результате заголовок будет выглядеть так:

Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664

Важно. Первые ACMA должны быть именно заглавными.

Если запрос придёт без заголовка с действительным токеном, Маркет вернёт ошибку 401 Unauthorized.

Если токен будете формировать самостоятельно, то его обновление тоже вам придётся делать самостоятельно, в противном случае отчёты по реализации запросить будет невозможно.

Для формирования токена в сервисе Моё дело и включения интеграции:

1. Нажмите «Активировать» на плашке Яндекс Маркет.

2. Авторизация осуществляется по Oauth-токен (устаревший) или Api-key токен, который владелец личного кабинета (главный пользователь) самостоятельно генерирует в разделе Подготовка к работе — Авторизация.

OAuth-токен

При создании OAuth-токена он автоматически подставится в поле «Токен доступа» сервиса «Моё дело». 

В поле «Магазины» подставится магазин, если он единственный. Если магазинов у вас несколько, выберите те, по которым нужно импортировать данные в кабинет Моё дело.

Важно выбрать те магазины, которые относятся к вашему ИП или ООО, чтобы сведения по доходам в расчёте налога и декларации были верные. Иными словами, если у вас несколько магазинов, и в одном кабинете Яндекса вы ведёте и ИП и ООО (более одного юр. лица), то выбрать нужно только те магазины, которые относятся к юр. лицу кабинета Моё дело.

Способ авторизации OAuth-токен устарел, но вы можете использовать уже сгенерированный токен до конца его срока действия или создать API-Key-токен.

API-Key-токен

Чтобы сгенерировать API-Key-токен:

• авторизуйтесь в личном кабинете Яндекс Маркета;
• перейдите в раздел «Настройки (шестерёнка)» — «Модули и API»:

• нажмите «Создать новый токен», выберите «Полное управление кабинетом» и нажмите «Создать»:

Далее внесите сформировавшийся токен в сервис в поле «Токен доступа»:

Затем выберите магазины, по которым нужно импортировать данные в кабинет Моё дело.

Важно выбрать те магазины, которые относятся к вашему ИП или ООО, чтобы сведения по доходам в расчёте налога и декларации были верные. Иными словами, если у вас несколько магазинов, и в одном кабинете Яндекса вы ведёте и ИП и ООО (более одного юр. лица), то выбрать нужно только те магазины, которые относятся к юр. лицу кабинета Моё дело.

3. При подключении интеграции вы можете включить настройку «Автоматическая загрузка отчётов». С помощью данной настройки отчёты по реализации будут загружаться автоматически в сервисе в «Документы и ЭДО — Покупки — Отчёты посредника».

Отчёты автоматически будут поступать 7 числа каждого месяца. Например, 7 августа автоматически придут отчёты за июль.

Если вы в первый раз включаете интеграцию, то настройка по умолчанию будет включена:

Для тех, у кого интеграция с МП уже была включена, то нужно перейти по шестерёнке в раздел «Интеграция с партнёрами», далее у МП нажать «Открыть токены» и включить данную настройку.

4. Сохраните.

5. Синхронизация товаров. Этот пункт есть только в реквизитах и нужен только с открытым складом.

После сохранения ключа сервис предложит синхронизировать товары.

Если у вас нет товаров в сервисе, то можно провести синхронизацию, карточки товаров загрузится с названиями из Яндекса и артикулом.  

Если у вас заполнены товары и не вносили артикулы, а есть только названия товаров, то откажитесь от синхронизации, её можно пройти позже, сохранив токен заново или при импорте отчётов по продажам.

Если у вас заполнены товары, то рекомендуем проверить заполнение поля «Артикул». Если артикула нет, то его нужно указать во избежании дубликатов. 

Важно. Артикул должен быть одинаковым по всем маркетплейсам. Также артикул должен быть у каждой карточки свой и совпадать с данными в маркетплейсе.

 

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

Сервис ищет товары в первую очередь по артикулу, потом по названию. Если данные не совпадают, то создаётся новая карточка.

 

Примечание. В связи с изменением юр. лица Яндекс Маркет после сохранения токена с 02.12.2024 г. сервис автоматически создаст коммисионера ООО "ЯНДЕКС МАРКЕТ", договор с ним и правило импорта для поступлений на счёт. Если ранее уже был такой комиссионер ООО "ЯНДЕКС МАРКЕТ" (договор и правило импорта), то система повторно его не создаст. 

До 02.12.2024 г. после сохранения токена в сервисе автоматически создавался комиссионер ООО "ЯНДЕКС", договор с ним и правило импорта для поступлений на счёт.