Кнопки в API-каталоге маркетплейса

Кнопки API-каталога переносят товары и данные с маркетплейса в МПФИТ. Работают они после того, как в настройках API указаны доступы к маркетплейсу.

Где найти: Компании → Список компаний → нужная компания → Маркетплейсы → иконка площадки → вкладка «Каталог».

На всех кнопках написано «Обновить», различаются они описанием над кнопкой. В статье кнопки названы по этим описаниям.

Перенос идёт в два этапа:

• Блок «Добавить/обновить товары» — загружает данные с маркетплейса в API-каталог.
• Блок «Синхронизация» — переносит их из API-каталога в мастер-каталог: ставит связки, обновляет баркоды и параметры, создаёт карточки.

Сам по себе мастер-каталог не меняется: данные в нём обновляются только по кнопкам блока «Синхронизация» или при ручной правке карточки.

Нажимать кнопки могут все, у кого есть доступ к разделу «Компании»: руководитель, менеджер и клиент (селлер). Сотруднику склада кнопки недоступны.

После нажатия появляется окно со временем, через которое стоит проверить результат:

• Блок «Добавить/обновить товары» — через 30 минут.
• Блок «Синхронизация» — через 5 минут, для любой кнопки.

Изменения, которые сделали на маркетплейсе, площадка отдаёт не раньше чем через 2 часа.

У WB и Ozon кнопки одинаковые, у WB есть ещё загрузка файла. У Яндекс Маркета есть «Загрузить товары по API» и «Обновить баркоды» — они работают так же, как у WB и Ozon.

Блок «Добавить/обновить товары»

Загрузить товары по API

Забирает с маркетплейса актуальные данные в API-каталог: новые карточки и изменения в существующих.

Когда нажимать

Завели товар или изменили карточку на маркетплейсе, прошло больше 2 часов, а в API-каталоге изменений нет.

Кнопка обновляет только API-каталог. Карточки в мастер-каталоге от неё не меняются и не создаются — для этого нужны кнопки блока «Синхронизация».

Загрузка файла с товарами (только WB)

Догружает в API-каталог товары, которые WB не отдал по API, и связывает их с мастер-каталогом. Файл скачивают в кабинете WB по ссылке в блоке, затем нажимают «Выберите файл» и «Загрузить».

Когда использовать

После «Загрузить товары по API» часть товаров WB так и не появилась в API-каталоге. Сейчас такое почти не случается.

Блок «Синхронизация»

Обновить баркоды

Первая кнопка блока. Делает две вещи:

• Ставит связки — привязывает товары площадки к карточкам мастер-каталога, в которых заполнен баркод этой площадки и он совпадает с баркодом на маркетплейсе. Например, нажали кнопку у Ozon — связки встанут на карточки, где поле «Баркоды Ozon» совпадает с баркодом товара на Ozon.
• Обновляет баркоды — записывает в связанные карточки все актуальные баркоды товара с маркетплейса.

Баркод площадки в карточке можно заполнить заранее, например через Excel, даже если токен маркетплейса ещё не подключён. После подключения нажмите «Обновить баркоды» — связки встанут на карточки с совпадающими баркодами. Так работает у WB, Ozon и Яндекс Маркета.

Когда нажимать

• Связываете вторую площадку — после того как дописали её баркоды в карточки мастер-каталога через Excel. Подробнее: Как связать товары между Ozon и Wildberries.
• Заполнили баркоды площадки в мастер-каталоге до подключения токена — после подключения нажмите кнопку у этой площадки.
• Добавили или изменили баркод на маркетплейсе — чтобы перенести его в связанную карточку мастер-каталога.
• Связка есть, а поле «Баркоды WB» или «Баркоды Ozon» в карточке пустое — нажмите ещё раз: при повторном нажатии баркоды подтянутся в связанные карточки.

Загрузить параметры и картинки

Вторая кнопка блока. Переносит в связанные карточки мастер-каталога фото, габариты, признак «КИЗ/Акциз» и другие параметры. Артикул, баркоды и название кнопка не меняет.

Если вы правили эти поля вручную в мастер-каталоге, кнопка перезапишет их данными с маркетплейса.

Когда нажимать

На маркетплейсе изменили фото или габариты, и нужно обновить их в мастер-каталоге.

Добавить товар во внутренний каталог

Третья кнопка блока. Создаёт карточки в мастер-каталоге для всех товаров площадки, у которых ещё нет связки.

Нажимайте кнопку один раз и дождитесь окончания загрузки. Повторное нажатие запустит процесс заново, и часть карточек задублируется. У второй площадки не нажимайте её, пока не связали товары с уже созданными карточками, — иначе для них создадутся дубли.

Когда нажимать

• Первая выгрузка — товары есть в API-каталоге, а мастер-каталог пустой.
• Новые товары — после «Загрузить товары по API» в API-каталоге появились позиции без связки.
• Товары только одной площадки — после того как связали общие товары второй площадки, добавьте те, которых нет на первой.

Частые вопросы

В каком порядке нажимать кнопки при подключении маркетплейса?

Первая площадка — «Добавить товар во внутренний каталог», чтобы создать карточки в мастер-каталоге. Вторая площадка — сначала «Обновить баркоды», чтобы связать её товары с уже созданными карточками. Если баркоды на площадках разные, перед этим допишите их в Excel по инструкции Как связать товары между Ozon и Wildberries. Потом «Добавить товар во внутренний каталог» один раз — для товаров, которых нет на первой площадке.

Как добавить товары Яндекс Маркета в мастер-каталог?

Кнопки массовой выгрузки у Яндекс Маркета нет. Есть три способа:

• Связать с карточками другой площадки — допишите баркоды Яндекс Маркета в уже созданные карточки, например через Excel, и нажмите «Обновить баркоды» у Яндекс Маркета.
• Создать карточки через Excel — с баркодами Яндекс Маркета, затем нажать «Обновить баркоды», чтобы проставить привязки.
• Выгрузить по одному товару — кнопкой «Создать товар в каталоге» в API-каталоге.

Подробнее — в статье Интеграция с Яндекс Маркетом.

Новый товар с маркетплейса не появился в мастер-каталоге — что нажать?

Если товара нет в API-каталоге — «Загрузить товары по API». Когда он появится там — «Добавить товар во внутренний каталог».

Баркод с маркетплейса не появился в карточке — что нажать?

Нажмите кнопку под «Обновить баркоды». Если баркод добавили на маркетплейсе меньше 2 часов назад, сначала подождите, затем нажмите «Загрузить товары по API» и снова «Обновить баркоды».

Изменили фото на маркетплейсе — как обновить карточку?

Нажмите «Загрузить параметры и картинки». Ручные правки этих полей в мастер-каталоге перезапишутся. Название и артикул кнопка не обновляет — их меняют вручную в карточке мастер-каталога.

Нужно ли связывать товары вручную, если баркоды на WB и Ozon одинаковые?

Нет. Нажмите «Обновить баркоды» у второй площадки — связки встанут сами. Если не встали, значит баркоды разные: допишите их в Excel по инструкции Как связать товары между Ozon и Wildberries.

Почему в мастер-каталоге у товара виден только штрихкод WB?

Если баркоды WB и Ozon совпадают, в списке мастер-каталога у товара показывается один штрихкод.

Через сколько изменения с маркетплейса появятся в МПФИТ?

Маркетплейс отдаёт новые данные не раньше чем через 2 часа после изменения. Обычно МПФИТ забирает их в API-каталог сам. Если данных нет и через 2 часа, нажмите «Загрузить товары по API». В мастер-каталог изменения попадут после нажатия кнопок блока «Синхронизация».

Как посмотреть, кто и когда нажимал кнопки и менял привязки в API-каталоге?

Откройте историю — значок в правом верхнем углу вкладки «Маркетплейсы».
В истории видно, какое действие выполнено, на какой площадке, кем и когда.

Возможные ошибки

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

Причина: «Добавить товар во внутренний каталог» нажали несколько раз подряд или у второй площадки до связки.

Решение: удалите дубли по инструкции Как удалить товар из мастер-каталога. Затем свяжите товары второй площадки по инструкции Как связать товары между Ozon и Wildberries.

Нажали «Обновить баркоды», но баркод в карточке не появился

Причина: обновление ещё идёт, баркод появился на маркетплейсе меньше 2 часов назад или его ещё нет в API-каталоге.

Решение: проверьте карточку через 5 минут. Если баркод добавили недавно, через 2 часа нажмите «Загрузить товары по API», через 30 минут — снова «Обновить баркоды». Если не помогло, пришлите в поддержку артикул и скрин карточки из кабинета маркетплейса с баркодом.