Импорт товаров из маркетплейсов

Для чего нужна интеграция

Интеграция нужна, когда карточки товаров уже заведены в маркетплейсе, а в Omniz их нужно быстро создать или сопоставить с существующим каталогом.

В текущем варианте Omniz использует маркетплейсы только как источник товарного контента:

• название
• описание
• бренд
• изображения
• характеристики
• внешние идентификаторы товара и варианта

Цены, себестоимость, остатки, поставки и списания не синхронизируются.

Это важно: маркетплейс не становится основным источником склада или цен. После импорта компания настраивает цены и остатки обычными инструментами Omniz.

Где находится

В разделе Настройки откройте Импорт из Wildberries, Импорт из Ozon или Импорт из Yandex Market.

В меню импорта отображаются отдельные разделы:

• Импорт товаров из Wildberries
• Импорт товаров из Ozon
• Импорт товаров из Yandex Market

Все три раздела доступны в Backoffice. Рабочий механизм у провайдеров общий: подключение доступа, импорт карточек, сопоставление с товарами Omniz и журнал событий.

Подключение

На вкладке Подключение пользователь вводит данные доступа конкретного маркетплейса.

Для WB используется API token продавца с доступом к чтению карточек товаров.

Для Ozon используются Client ID и API key.

Для Yandex Market используются Business ID и API key.

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

Кнопка Отключить доступна владельцу компании и переводит подключение в отключённое состояние. Незавершённые задания этого подключения останавливаются. Ранее импортированные сопоставления и товары при этом не удаляются. Замена данных доступа также прекращает работу заданий прежнего подключения.

Импорт

На вкладке Импорт кнопка Импортировать товары ставит загрузку в очередь. После запуска можно закрыть страницу: импорт продолжится в фоне. При возвращении на страницу появится текущее состояние работы.

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

Wildberries загружает карточки, доступные в списке товаров продавца. Ozon импортирует только неархивные товары. Yandex Market читает действующие и архивные позиции отдельными проходами. Характеристики Ozon и Yandex Market загружаются с названиями из справочников маркетплейса.

Если каталог Omniz полностью пуст, можно включить создание новых товаров при импорте. Неактивные товары также учитываются при этой проверке. Решение об автосоздании принимается при запуске и действует для всех страниц текущего импорта.

Если в каталоге Omniz уже есть товары, новые позиции маркетплейса попадают в сопоставления и ждут решения пользователя. Это снижает риск дублей.

Временные ошибки и ограничения частоты запросов обрабатываются автоматически. Если импорт остановился с ошибкой и доступен повтор, нажмите Повторить незавершённое: уже сохранённые товары сохранятся, а незавершённая работа будет продолжена. Повторный ввод действующего ключа не требуется. При ошибке доступа сначала проверьте ключ и его права в кабинете маркетплейса.

Сопоставление

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

Пользователь может:

• привязать внешний товар к существующему товару Omniz
• создать новый товар Omniz из внешней карточки
• применить данные маркетплейса к связанной карточке
• игнорировать внешнюю позицию

По умолчанию данные маркетплейса не перетирают уже существующий товар Omniz. Для перезаписи нужно явно включить переключатель Перезаписать контент в строке сопоставления.

Перезапись относится только к контенту карточки: изображениям, бренду, описанию и характеристикам. Цены и остатки не меняются.

В строке сопоставления отдельно показывается состояние изображений. Если они не загрузились и событие допускает повтор, используйте кнопку Повторить изображения. Сбой загрузки не создаёт второй товар. Прежняя галерея заменяется после успешной подготовки всех изображений; при неполной загрузке она сохраняется.

После игнорирования или перепривязки сопоставления прежнее задание изображений пропускается и не мешает загрузке остальных товаров. Ручные изменения товара и галереи защищены от позднего применения прежнего задания.

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

Журнал

На вкладке Журнал отображаются ход и результаты импорта и применения сопоставлений. Для события можно раскрыть технические данные, а длинный список догружается без сброса уже показанных записей. Для событий, допускающих восстановление, доступен повтор незавершённой работы.

Владелец или менеджер может очистить журнал после подтверждения. Очистка удаляет завершённые записи, которые больше не нужны для восстановления; задания в очереди, выполняющиеся и повторяемые задания сохраняются.

Что не делает эта интеграция

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

Интеграция не загружает остатки в складской контур Omniz. Остатки нужно заводить через поставки, складские операции или ручные инструменты анализа остатков.

Интеграция не отправляет списания или продажи обратно в маркетплейс.

Интеграция не меняет себестоимость по умолчанию и не создает поставщика.

Чем отличается от Yclients

Yclients может быть основным источником рабочих данных: услуг, товаров, расписания, записей, складов, остатков и финансов.

Импорт товаров из маркетплейсов работает иначе. Это не первичный источник правды, а инструмент переноса товарного контента и ведения внешних связок.