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

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

Содержание:

• 1. Покупка и установка
• 2. Настройки API
• 3. Настройки экспорта
• 3.1. Выбор товаров
• 3.2. Сопоставление категорий
• 3.3. Настройка общих характеристик
• 3.3.1. ID товаров
• 3.3.2. Название товара
• 3.3.3. Цены
• 3.3.4. Вес и габариты товара в упаковке
• 3.3.5. Изображения
• 3.4. Сопоставление характеристик
• 3.4.1. Особенные характеристики
• 3.4.2. Как производится сопоставление характеристик
• 3.4.3. Как выбрать значения словаря без сопоставления
• 3.5. Экспорт товаров
• 3.6. Статус экспорта
• 4. Обновление остатков
• 4.1. Настройки
• 4.1.1. ID для сопоставления (поиска) товаров
• 4.1.2. Срок хранения истории обновления остатков
• 4.1.3 Выбор складов и товаров
• 4.1.4 Наличие для бесконечности
• 4.1.5. Обнуление ненайденных товаров.
• 4.1.6 Настройка подмены наличия
• 4.2. Запуск обновления остатков
• 4.3. История обновления остатков
• 5. Обновление цен
• 5.1. Настройки обновления цен
• 5.2. Запуск обновления цен
• 5.2.1. Отправка цен
• 5.2.2. Проверка цен
• 5.3. История обновления цен
• 6. Проверка данных
• 7. Частые вопросы

Настройка синхронизации и обработки заказов



Диагностика неисправностей

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

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

1. Покупка и установка

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

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

После установки приложения оно будет доступно в верхней части вашей админ-панели:

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

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

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

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

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

В правой части интерфейса появится возможность ввести название ключа и выбрать роль, нужно выбрать "Администратор"

После нажатия "Сгенерировать" появится API ключ, который нужно сохранить.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

Распределение по категориям в данном случае условное, оно может измениться при загрузке товаров в Ozon.

Частый вопрос: Категории не совпадают с сайтом Ozon / Не нахожу нужную категорию

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

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

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

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

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

3.3.1. ID товаров

Вы можете выбрать, какое именно значение указывать в качестве ID товаров (offer-id) при выгрузке товаров. Это могут быть:

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

В редактировании товаров эти поля отображаются так:

По умолчанию рекомендуем оставить "ID артикула". ID товаров будет показываться в личном кабинете Ozon в столбце "Артикул":

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

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

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

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

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

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

3.3.3. Цены

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

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

Справка OZON по ценам https://seller-edu.ozon.ru/work-with-goods/rabota-s-tsenami/price-control

Если вам нужно сделать наценку на какие-то категории, то это можно будет сделать позже, в разделе обновление цен.

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

Вы можете указать, из каких именно характеристик или свойств товара взять информацию о габаритах и весе. В случае, если выбранная характеристика имеет размерный тип, т.е. в вашей админке для неё можно выбрать единицу измерения (мм, см) то все значения будут автоматически конвертированы в те едининцы, которые нужны Ozon (мм, гр). Поддерживаются характеристики с типом "Объем, габариты", которые состоят из трёх: число х число х число. Каждое значение габаритов можно записать в своё поле.

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

Справка Ozon по объёмно-весовым характеристикам: https://docs.ozon.ru/global/products/requirements/volume-weight-characteristics/?country=OTHER

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

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

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

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

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

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

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

Внимание! Если вы выбрали "Изображение артикула", то все товары, у которых изображение артикула по какой-то причине не выбрано, не будут выгружены в Ozon.

Так выглядит артикул внутри редактирования товара, если у него не выбрано изображение:

Так выглядит выбранное изображение:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В выпадающем поле вы можете выбрать одно из значений.

После сопоставления обязательно нажимайте кнопку "Сохранить".

Если загрузка значений Ozon завершилась, но значения не появились на странице, пример:

, то вероятнее, всего у выбранных товаров ничего не заполнено для данной характеристики (нет значений в Shop-script), пример:

3.4.3 Как выбрать значения словаря без сопоставления

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

Для этого нужно выбрать в сопоставлении любую характеристику и перейти в сопоставление значений 

Скачайте словарь:

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

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

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

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

  

Если на странице будет написано "Не прошло проверки: ХХХ", то причину можно посмотреть в логе validate.log, предварительно включив логирование на первом экране.

3.6. Статус экспорта

В данном разделе можно проверить, сколько товаров было отправлено в Ozon и были ли какие-либо ошибки в ответе Ozon.

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

Внутри запуска перечислены товары, которые были отправлены в Ozon - их Offer ID, название, статус экспорта и кол-во ошибок. 

При успешном экспорте товару присваивается product ID в Ozon: 

Если Ozon в ответе прислал какую-либо ошибку, её можно посмотреть, кликнув на строку товара, пример:

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

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

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

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

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

Если у вас возникли проблемы с экпортом товаров, инструкция по диагностике причин есть здесь: https://bodysite.ru/help/2085/diagnostika-raboty-prilozheniya-integratsiya-s-ozon/#export

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

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

Раздел содержит несколько вкладок - Настройки, Запуск, История. Подробнее про них ниже:

4.1. Настройки

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

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

Выберите, по какому ID сопоставлять (сравнивать с вашим сайтом) товары - это может быть ID артикула / ID товара / Код артикула. Подробности, что это такое разбирали в пункте 3.3.1.

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

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

В личном кабинете Ozon у товаров данное значение отображается в столбце "Артикул": 

4.1.2. Срок хранения истории обновления остатков

Вы можете выбрать, как долго хранить историю обновления остатков (которая отображается в крайней вкладке). Подробнее про неё в отдельном пункте.

4.1.3 Выбор складов и товаров

В данном пункте вы можете сопоставить склады в Ozon с вашими внутренними складами для обновления остатков и для каждого из них выбрать товары. Склады Ozon загружаются автоматически по Api. 

Активируйте чекбокс "обновлять остатки" для отправки наличия на выбранный склад. 

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

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

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

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

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

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

4.1.5. Обнуление ненайденных товаров.

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

4.1.6 Настройка подмены наличия

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

Пример условий:

• Если товара >10, то отправить 10
• Если товара < 3, то отправить 0.
• Если товара = 1000, то отправить 0.

4.2. Запуск обновления остатков

Переходим на вторую вкладку - запуск обновления остатков.

Обновить остатки можно путем нажатия на кнопку "Запустить", либо настроить регулярные обновления, скопировав команду и добавив её в планировщик Cron в вашем хостинге.

Не рекомендуем ставить обновление слишком часто (не каждую минуту, пожалуйста!) - несколько раз в день будет достаточно, в зависимости от частоты обновления остатков на вашем сайте.

4.3. История обновления остатков

Третья вкладка - это история обновления остатков. Перед вами список товаров, по которым когда-либо была отправка остатков.

Здесь можно увидеть product_id из OZON, offer_id с вашего сайта и наименование товара. Есть поиск и фильтр по ненайденым товарам (товар из озон не сопоставился с вашим сайтом)

По клику на конкретный товар можно посмотреть когда и на какой склад какое кол-во товара было отправлено:

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

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

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

Перейдите в раздел "Обновление цен":

В данном разделе можно настроить регулярную отправку цен на ваши товары, которые уже присутствуют в Ozon. Раздел состоит из несколько вкладок:

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

5.1. Настройки обновления цен

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

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

Варианты:

• Из экспорта - это означает, что используется список товаров, выбранный в пункте 3.1. Настройки экспорта.
• Все - обновлять цены для всех товаров сайта.
• Выбрать - возможность выбрать отдельно, для каких товаров обновлять цены. Можно выбрать среди списков или категорий сайта.

5.1.2. Сопоставление товаров

Выберите, по какому ID сопоставлять (сравнивать с вашим сайтом) товары - это может быть ID артикула / ID товара / Код артикула. Подробности, что это такое разбирали в пункте 3.3.1.

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

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

В личном кабинете Ozon у товаров данное значение отображается в столбце "Артикул":

5.1.3. Хранить историю обновления цен

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

5.1.4. Выбор цен

Выберите, что именно использовать в качестве цен вашего сайта для отправки в Ozon. Это могут быть цены вашего сайта, какое-то значение характеристики или свойство товара, или же цены из плагина "Цены PRO".

Нужно выбрать цены для следующих полей:

• Цена - тоимость товара которую вы устанавливаете самостоятельно, без учёта акций.
• Цена до скидок - зачёркнутая цена, которую видят покупатели. Она должна быть выше вашей цены. Внимание! В ряде случаев зачеркнутая цена должна быть выше обычной цены не менее, чем на 5%. Если будет меньше, то цены не обновятся.
• Минимальная цена - порог, ниже которого не может опуститься стоимость вашего товара, если включены автоприменение акций или стратегии ценообразования. Покупатели не видят это значение.

► Справка Ozon про цены

5.1.5. Наценка

Для каждой из цены вы можете установить одну или несколько наценок. Пример:

Есть возможность указать несколько наценок по диапазону цены и добавить два элемента: умножить на процент и/или прибавить фиксированную сумму.

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

5.1.6. Наценка по категориям

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

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

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

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

Логика сложения наценок

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

2. Общая наценка (которая возле цен) складывается с наценкой по категориям.

5.2. Запуск обновления цен

5.2.1. Отправка цен

Обновить цены можно путем нажатия на кнопку "Запустить", либо настроить регулярные обновления, скопировав команду и добавив её в планировщик Cron в вашем хостинге.

Не рекомендуем ставить обновление слишком часто (не каждую минуту, пожалуйста!) - 1-2 раза в день будет достаточно, в зависимости от частоты обновления цен на вашем сайте.

Как добавить задание в Cron в "облаке"?

Внимание:

• Если товар не будет найден по признаку сопоставления на вашем сайте, то цена в Ozon не изменится.
• Если товар не присутствует в списке товаров, выбранном на первом экране, то он не будет обновлён.
• Если цена товара не изменилась, то никакая информация по нему не отправляется в Ozon.
• В некоторых случаях, если зачёркнутая цена товара отличается от обычной менее, чем на 5%, то она не будет обновлена.

5.2.2. Проверка цен

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

5.3. История обновления цен

Третья вкладка - это история обновления цен. Перед вами список товаров, по которым когда-либо была отправка цен.

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

➽ В случае обнаружения проблем с обновлением цен обратитесь к инструкции по диагностике - она здесь.

6. Проверка данных

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

Представлен список товаров и JSON объект выгружаемой информации. При нажатии на товар можно посмотреть подробности по элементам.

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

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

Да, инструкция доступна по этой ссылке

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

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

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

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

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

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

5. Я ранее уже выгрузил товары в OZON, будут ли они синхронизироваться?

6. Если ли лимиты на загрузку товаров в Ozon через приложение?

7. Категории не совпадают с сайтом Ozon / Не нахожу нужную категорию

8. Не нахожу нужный бренд, хотя на сайте Ozon он точно есть

9 . Как массово менять статусы заказов?

10. Где можно посмотреть другие вопросы или задать свой?

Вопросы и обсуждение работы приложения находятся в нашем публичном хабе.