«Black Friday + Cyber Monday 2021». Скидки до 42%!Перейти
Полезная информация

Инструкция по настройке приложения "Интеграция с OZON"

Поддержка Bodysite
Поддержка Bodysite
1 сентября 2021 16:57
+1

Приложение "Интеграция с OZON" создано для удобной выгрузки товаров с вашего интернет-магазина на Webasyst в маркетплейс OZON. Вы сможете выбрать конкретные позиции, сопоставить с каталогом маркетплейса, указать обязательные характеристики и отправить товары по API. В приложении реализовано сопоставление цен и остатков через API, в том числе в автоматическом режиме (по CRON).

Содержание:

1. Проверка системных требований
   1.1. Версия фремворка
   1.2. Версия Shop-script
   1.3. Версия PHP
2. Настройки API
3. Настройки экспорта
   3.1. Выбор товаров
   3.2. Сопоставление категорий
   3.3. Настройка общих характеристик
      3.3.1. Название товара
      3.3.2. Цены
      3.3.3. Вес и габариты товара в упаковке
      3.3.4. Изображения
   3.4. Сопоставление характеристик
      3.4.1. Особенные характеристики
      3.4.2. Как производится сопоставление характеристик
   3.5. Экспорт товаров
4. Обновление остатков и цен
   4.1. ID для сопоставления (поиска) товаров
   4.2. Выбор складов
   4.3. Склад в OZON
   4.4. Наличие для бесконечности
   4.5. Обновление остатков
   4.6. Обновление цен
5. Частые вопросы

Обзор приложения в видео формате:


Минимальные требования:

  • Фреймворк Webasyst версии >= 2.0
  • Shop-Script версии >= 8.14
  • PHP >= 7.3

1. Проверка системных требований

1.1 Версия фреймворка

Внимание! Фреймворк Webasyst должен быть выше версии 2.0 для корректной работы данного приложения. 

Как проверить: зайдите в приложение "Инсталлер", пункт "Установлено".

Найдите в списке "Инсталлер", посмотрите его версию:

Цифры должны быть не ниже 2.0. Если это не так, обновите фреймворк, это бесплатно.

1.2 Версия Shop-Script

Версию Shop-script тоже можно проверить в инсталлере. 

1.3 Версия PHP

Актуальную версию PHP вашего сайта вы можете посмотреть в приложении "Настройки". 

2. Настройки API

Приложение работает через Ozon Seller API — программный интерфейс для работы с маркетплейсом Ozon для обмена информацией между системой продавца и Ozon. 

На вкладке "Настройки API" нужно ввести Client id и Api-Key. Предполагается, что вы уже зарегистрировались в Ozon как продавец, у вас проверили документы и создали личный кабинет.

В отдельном окне откройте личный кабинет OZON и зайдите в настройки:

В левом столбце выберите пункт "API ключи". Откроется страница, на которой будет виден Client ID и можно создать API-Key:

Введите для ключа любое название и нажмите "Создать ключ"

Появится комбинация символов, которые нужно скопировать, вернуться в окно с настройками приложения "Интеграция с OZON"  и вставить в соответствующие поля:

Нажмите кнопку "Авторизоваться". Если все данные введены верно, то появится сообщение "Удалось успешно авторизоваться, загружено категорий:... ":


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

3. Настройки экспорта

В данном разделе приложения вы можете отправить товары из админ-панели магазина на Shop-script в маркетплейс OZON.

Выберите в приложении в левом столбце пункт "Экспорт товаров". Появится еще один столбец с подменю этого пункта:

Разберем эти строчки подробно:

3.1. Выбор товаров

Выборка товаров может быть осуществлена следующим образом:

  • Все товары магазина
  • Конкретные категории товаров
  • Конкретные списки товаров

Можно комбинировать категории и списки, то есть выбрать, например, несколько категорий и 1-2 списка одновременно.

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

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

Выбрав товары нажмите кнопку "Далее" для перехода на следующий шаг.

3.2. Сопоставление категорий

Категории у экспортируемых товаров должны соответствовать каталогу OZON, поэтому в этом разделе происходит сопоставление внутренних категорий магазина с разделами OZON.

Слева вы видите родительские категории товаров, выбранных на предыдущем шаге. (Примечание: Родительская категория товара в магазине Webasyst - это та, которая находится первая в списке при редактировании товара).

В скобках выводится кол-во товаров, принадлежащих этой категории, а рядом ссылка на быстрый переход на неё в админ-панели сайта.

Справа нужно выбрать подходящую категорию в OZON. Плагин автоматически подбирает похожие варианты, но стоит их проверить вручную.

3.3. Настройка общих характеристик

У абсолютно всех товаров, загружаемых в OZON, должен быть заполнен набор базовых характеристик, без которых товары не примут. В этом разделе вы можете сопоставить внутренние характеристики магазина для заполнения нужных полей.

При вводе осуществляется поиск среди доступных полей, а если нажать "Enter" - можно сохранить фиксированное значение.

3.3.1. Название товара

Справка OZON по наименованию товаров: https://seller-edu.ozon.ru/docs/nazvanie.html

В первом пункте вы можете выбрать шаблон формирования названия товара. Это может быть просто "Название", может быть "Название, артикул", либо артикул указывается в скобках:

Сами значения для элементов "Название" и "Артикул" можно выбрать из существующих свойств или характеристик товара, либо указать статичные данные

Обратите внимание, что не смотря на указание конкретного наименования, не во всех категориях оно будет принято OZON. В некоторых случаях название маркетплейсом формируется автоматически, и продавцу его изменять нельзя.

3.3.2. Цены

Вы можете указать из каких именно полей брать те или иные цены для товаров. 

"Цена до скидок" и "Premium цена" являются необязательными, но с помощью них вы можете продвигать товары.

Справка OZON по специальным ценам https://seller-edu.ozon.ru/docs/how-to-sell-effectively/special-prices.html

3.3.3. Вес и габариты товара в упаковке

Вы можете указать, из каких именно характеристик или свойств товара взять информацию о габаритах и весе. Здесь очень важно выбрать единицы измерения, например сантиметры это или метры, граммы или килограммы. OZON автоматически конвертирует размеры в нужный ему формат.

3.3.4. Изображения

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

В одном товаре у разных артикулов могут быть разные фотографии, например по цветам - Красный/Синий/Желтый. Если вы хотите, чтобы у товара (артикула) первым было прикреплено изображение, принадлежащее только этому артикулу, выберите соответствующую настройку:

Можно настроить размеры выгружаемых изображений:

И их количество:

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

  • Выгружаемые изображения: Только изображение артикула
  • Кол-во изображений: 1.

3.4. Сопоставление характеристик

Для передачи любой характеристики товара она должна быть сопоставлена с характеристиками OZON. 

В этом разделе на первом экране вы видите ранее выбранные категории OZON, количество сопоставленных обязательных характеристик и количество товаров, присутствующих в выгрузке.

При экспорте товаров в OZON есть особенность - некоторые характеристики уже созданы в маркетплейсе, у них есть "справочник" - набор фиксированных вариантов. Это означает, что вы не можете добавить своё значение в список, а лишь выбрать уже существующие. Пример такой характеристики - "бренд".

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

Сопоставление обязательных характеристик является необходимым минимумом для загрузки своих товаров в маркетплейс OZON. Остальные характеристики заполняются по желанию, но благодаря ним товар может попадать в фильтры подбора.

3.4.1 Особенные характеристики:

  • Тип товара - по значению из данного пункта товары распределяются по категориям на сайте Ozon. Можно выбрать только вариант из словаря.
  • Объединить на одной карточке - нужно выбрать какое-то уникальное значение, через которое товары будут объединяться на одной странице в маркетплейсе OZON. Например, можно объединить разные артикулы по ID товара.

Некоторые характеристики OZON имеют подсказки, которые можно увидеть при наведении на иконку знака вопроса:

3.4.2 Как производится сопоставление характеристик:

В выпадающем поле напротив характеристики OZON вы выбираете подходящую характеристику вашего магазина:

Если данная характеристика является "словарём", то появится кнопка "Сопоставить значения":

При клике на данную кнопку вы попадёте на экран сопоставления значений характеристики из вашего магазина с набором значений из OZON:

Нажмите "Загрузить значения OZON". Загрузка может занимать продолжительное время, поскольку словарь может содержать несколько десятков тысяч значений.

После загрузки появляется таблица для сопоставления:

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

3.5. Экспорт товаров

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

В случае каких-либо ошибок, они будут выведены на этой странице, например:

Результат можно посмотреть в личном кабинете OZON, в разделе Товары - История обновлений

Отображается кол-во успешно обработанных товаров и кол-во ошибок:

Новые товары будут отправлены на модерацию. 

4. Обновление остатков и цен

После того, как ваши товары пройдут модерацию и перейдут в статус "Готовы к продаже", для них можно вручную передать остатки или актуальные цены, либо настроить регулярное автоматическое обновление. 

4.1. ID для сопоставления (поиска) товаров

Выберите, по какому ID сопоставлять предложения - это может быть ID артикула или товара. Если вы выгрузили товары через функционал этого приложения (разбирали в предыдущих пунктах), то оставьте значение по умолчанию - "ID артикула".

Другой пункт "ID товара" может быть полезен тем пользователем, кто ранее загрузил товары в маркетплейс самостоятельно и использовал ID товара.

4.2. Выбор складов

В данном пункте нужно выбрать склады, по которым будет определяться наличие товаров для Ozon.

Это может быть сумма по всем складам, либо конкретные:

4.3. Склад в OZON

Здесь нужно ввести ID склада в маркетплейсе Ozon. Переходим к окну, где у вас открыт личный кабинет Ozon. К сожалению, ID не указан где-либо в личном кабинете, его нужно взять из URL страницы. Как это сделать:

Перейдите на вкладку "Логистика":

Далее, в блоке нужного склада, нажимаем на "три точки" и выбираем пункт "Управление остатками"

Из URL адреса открывшейся страницы нужно скопировать ID, пример:

Возвращаемся в настройки приложения и вставляем скопированный ID:

4.4. Наличие для бесконечности

В данном пункте вы можете указать любое значение, которое будет использоваться в качестве количества в наличии для тех товаров, у которых в админ-панели сайта указано "бесконечность" (∞)

4.5. Обновление остатков

Для обновления остатков существует две команды.

  • syncStock - просто отправляет остатки для выбранных товаров, не сверяя и не проверяя их присутствие на маркетплейсе. Может быть полезной, если товары были загружены из разных источников, и не нужно снимать с продажи отсутствующие позиции.
  • updateStocksByOzonProducts  - запрашивает актуальный список товаров, находящихся в статусе "готов к продаже" в Ozon, сверяет с выбранными на предыдущих шагах и отправляет актуальные остатки только для совпадающих позиций. Если какая-то позиция из Ozon не присутствует в списке, по ней будет отправлено наличие ноль. Тем самым, если нужно снять какой-то товар с продажи в Ozon, его нужно просто убрать из списка выгрузки.

В большинстве случаев рекомендуется использовать именно вторую команду updateStocksByOzonProducts.

4.6. Обновление цен

Наценка

Приложение позволяет гибко применить наценки на товары:

Наценка может быть фиксированной суммой, либо процентом от стоимости:

Наценка может быть настроена для всех категорий сразу, для этого установите значение в строке "Все" и нажмите кнопку "Применить к подкатегориям":

Либо укажите наценку для конкретных разделов:

Для обновления цен запустите вручную команду syncPrice, либо настройте автоматическое обновление через Cron

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

1. Плагин умеет обрабатывать заказы из OZON?

Пока нет, но разработка этого функционала в ближайших планах.

2. Если я уберу товар из списка для выгрузки, он пропадёт из продажи на OZON?

Да, если вы для обновления остатков пользуетесь командой №2 (updateStocksByOzonProducts). При использовании этой команды товары сопоставляются с присутствующими в вашем списке. Если товар пропал из списка, то по нему отправляется наличие ноль.

3. Если у меня на сайте закончится товар, который присутствует в выгрузке, он снимется с продажи на OZON?

Да, при передаче остатков в Ozon количество по этому товару будет 0, и товар не будет продаваться.

4. Какую частоту запуска нужно указываться при создании Cron команды?

Частота настраивается индивидуально и зависит от частоты обновления информации на вашем сайте. Если у вас много заказов, товар часто заканчивается, то остатки можно обновлять два раза в день, либо чаще. Цены обновляйте в соответствии с частотой их изменения на сайте.