Экспорт товаров в интернет-магазин OZON (Озон)
Технические данные
- Опубликовано:
- 27.03.2023
- Обновлено:
- 12.12.2024
- Версия:
- 4.2.0
- Установлено:
- 100 - 499 раз
- Подходящие редакции:
- «Старт», «Стандарт», «Малый бизнес», «Бизнес»
- Адаптивность:
- Нет
- Поддержка Композита:
- Нет
- Совместимо с Сайты24
- Нет
- Совместимо с PHP 8.1
- Да
Пользовательское соглашение
Описание
Модуль позволяет создавать карточки товаров на сайте Озон (OZON) и поддерживать актуальную информацию о товаре, его доступном количестве и цене в автоматическом режиме. Поддерживает работу с несколькими каталогами/инфоблоками сайта и несколькими профилями личного кабинета Озон.
Если редакция 1С-Битрикс не позволяет установить модуль "Интернет-магазин", то достаточно заполнить обычный инфоблок товарами и предусмотреть свойства, которые будут содержать цену и остаток товара на складе (при необходимости).
Возможности модуля:Создание новых карточек товара на сайте Озон. Поддерживаются торговые предложения.
Обновление информации о товаре на сайте Озон. Если установлен флаг "Обновлять информацию о товарах", то при изменении контекстной информации о товаре на сайте, эти изменения будут перенесены в карточку товара на сайте Озон.
Выбор значений для обязательных характеристик вес, высота, ширина и глубина упаковки из соответствующих свойств торгового каталога.
Загрузка цен на сайт Озон. Доступен выбор типа цены для торгового каталога и свойства инфоблока, если модуль интернет-магазин не используется на сайте.
Предусмотрена возможность установить наценку товара от исходной цены в %.
Управление остатками товаров на сайте Озон. Необходимое значение может быть выбрано как из свойства товара/торгового предложения/элемента инфоблока, так и из определенного склада интернет-магазина. Есть возможность установить минимальное значение остаточного количества. Если количество товара меньше минимального, то на сайт Озон будет передано нулевое значение. Актуально для схемы продажи FBS/realFBS.
Гибкая настройка выбора товаров и/или торговых предложений, которые необходимо экспортировать на сайт OZON. Фильтрация товаров осуществляется с помощью массива в формате JSON. Примеры наиболее часто используемых фильтров приведены на странице описания программного продукта. Если необходим более сложный или нестандартный фильтр, напишите нам на почту, и мы поможем его составить!
Отправка краткого отчета о каждой процедуре экспорта информации на указанный адрес электронной почты.
Экспорт товаров и обновление остатков/цен выполняется с помощью утилиты cron, которая позволяет гибко настраивать время и частоту запуска модуля.
Для интеграции модуля с сайтом Озон требуется ввести «Client ID» и сгенерировать «API key» с типом «Администратор» в личном кабинете OZON Seller.
Ответы на часто встречаемые вопросы можно посмотреть на странице описания продукта, вкладка "Частые вопросы".
Требования для работы модуля:
- PHP версия 7.3.0 или новее
- Библиотека cURL
5.0.0 (12.12.2024) (beta) |
|
4.2.0 (29.10.2024) |
|
4.1.3 (18.10.2024) |
|
4.1.2 (16.10.2024) |
|
4.1.1 (27.09.2024) |
|
4.1.0 (04.09.2024) |
|
4.0.1 (26.07.2024) |
|
4.0.0 (26.06.2024) |
|
3.2.1 (21.06.2024) |
|
3.2.0 (14.06.2024) |
|
3.1.0 (14.03.2024) |
|
3.0.1 (09.01.2024) |
|
3.0.0 (18.12.2023) |
|
2.2.0 (08.12.2023) |
|
2.1.1 (17.11.2023) |
|
2.1.0 (15.09.2023) |
|
2.0.0 (21.08.2023) |
|
1.3.0 (18.07.2023) |
|
1.2.1 (23.06.2023) |
|
1.2.0 (08.06.2023) |
|
1.1.0 (24.05.2023) |
|
1.0.2 (10.04.2023) |
|
Базовая настройка модуля
После установки модуля штатными средствами 1С-Битрикс, нужно настроить его интеграцию с сайтом Озон. Для этого потребуется «Client ID» и ключ для доступа к API с набором определенных прав.
Параметр «Client ID» указан в настройках личного кабинета OZON Seller в разделе Seller API -> API ключи.
Генерация ключа для доступа к API производится в том же разделе личного кабинета OZON Seller по нажатию на кнопку «Сгенерировать ключ».
Во всплывающем окне необходимо заполнить произвольное название, указать тип токена и нажать на кнопку «Сгенерировать». Для работы модуля необходимы следующие роли:
- Barcode – дает доступ к методам API для работы со штрихкодами товаров на сайте Озон: автоматическая генерация значений штрихкода или присвоение установленных значений.
- Description Category – позволяет работать с деревом категорий и типов товаров, использующимся для настройки модуля, создания и редактирования карточек товаров на сайте Озон.
- Product – предоставляет доступ к методам API для работы со списком товаров на сайте Озон. Без этой роли ни создание/редактирование карточек товаров на сайте Озон, ни обновление остатков и/или цен работать не будет.
- Warehouse – позволяет получить информация о складах продавца на сайте Озон. Данные сведения необходимы при обновлении остатков на сайте Озон для схемы продажи FBS/realFBS.
Поскольку модуль развивается и со временем в нем появляется новый функционал, то могут потребоваться и новые роли ключа API. Чтобы не отслеживать изменения в документации модуля, при генерации ключа можно отметить только одну роль - «Admin», она позволяет использовать все методы API без ограничений.
Полученные данные для интеграции с сайтом Озон необходимо внести в соответствующие поля на странице настройки модуля.
Затем нужно выбрать схему продажи:
- FBO (продажа со склада Озон), или
- FBS/realFBS (продажа с собственного склада).
Для схемы продажи FBS/realFBS необходимо добавить собственный склад/склады в личном кабинете OZON Seller в разделе FBS -> Логистика.
Затем необходимо выбрать инфоблок, являющийся торговым каталогом и/или содержащий товары, и отметить галочками, операции, которые будут выполнены во время процедуры экспорта:
- Создание карточек для новых товаров (включает создание карточки товара с нуля на сайте Озон);
- Обновление информации о товаре (включает в себя обновление всех характеристик в карточке товара на сайте Озон, цена и остаток товара – характеристиками не являются!).
- Загрузка информации о ценах
- Загрузка информации об остатках
После сохранения настроек станет доступна вкладка "Сопоставление разделов и свойств", переходим на нее. Здесь нужно установить соответствия между свойствами каталога/инфоблока и характеристиками интернет-магазина Озон; выбрать разделы, элементы которых должны быть экспортированы, и сопоставить их категориям и типам товаров на сайте Озон.
Для всех разделов каталога/инфоблока настраиваются следующие параметры:- Артикул товара / торгового предложения – идентификатор товара в системе Озон. Обязательное поле для работы модуля. Значение артикула у каждого товара должно быть уникальным в пределах продавца на сайте Озон. По значению данного параметра проводиться сопоставление товаров из торгового каталога/инфоблока и товаров на сайте Озон. Если каталог поддерживает торговые предложения, то поля будет два: в одном нужно указать свойство для простого товара, в другом - для торгового предложения. Подробнее об артикулах можно почитать здесь.
- Название товара отображается в карточке товара на сайте Озон. Значение данного параметра должно содержать тип, бренд, модель и важные для категории товара характеристики. Подробнее о формировании значения данного поля можно почитать здесь.
- Штрихкод товара обязателен только для схемы продажи FBO (со склада Озон). Можно использовать свои штрихкоды, если они соответствуют требованиям сервиса Озон, либо сгенерировать их автоматически. Подробнее о штрихкодах здесь.
- Основной раздел товара. Если товар принадлежит нескольким разделам каталога/инфоблока, то настройки сопоставления характеристик Озон будут сформированы на основе того раздела каталога, идентификатор которого указан в данном параметре!
Остаток товара на складе. Если выбранный в настройках инфоблок является торговым каталогом, то в качестве источника для выбора значения остатков может выступать общее количество товара на всех складах, на одном из складов или одно из свойств товара/торгового предложения. Для простого инфоблока доступны только его свойства. Заполнение данного параметра обязательно для схемы продажи FBS/realFBS, без него остатки выгружены не будут!
При установленном флаге «Обнулить остаток, если количество товаров меньше n шт.» на сайте Озон остаток товара будет принудительно обнулен, если значение в данном параметре, будет меньше, чем число n.
- Список товаров, выбранных из каталога/инфоблока при работе модуля, может не совпадать со списком товаров, загруженных на сайт Озон. Параметр "Остаток товаров на сайте OZON, которые не попали в выборку" позволяет определить поведение модуля при обновлении остатков.
- Значение "Не изменять" означает, что на сайте Озон будут обновлены только те остатки, товары/элементы которых попали в выборку модуля. Остальные товары затронуты не будут.
- Значение "Обнулять" позволяет принудительно установить нулевой остаток у тех товаров, которые загружены на сайт Озон, но не попали в выборку модуля.
- НДС – ставка налога на добавочную стоимость. Заполнение данного параметра обязательно для создания/обновления карточки товара на сайте Озон. Можно выбрать как фиксированное значение (не облагается, 10% или 20%), так и значение одного из свойств товаров/торговых предложений.
- Цена до скидки. Если на товар есть скидка, то можно указать цену товара до ее применения. Если выбранный инфоблок является торговым каталогом, то из выпадающего списка нужно выбрать тип цены или свойство товара/торгового предложения, значение которого будет конвертировано в русские рубли (при выборе типа цены для торгового каталога) и округлено до целого числа по математическим правилам. Для простого инфоблока доступны только его свойства, которые также будут округлены до целого числа по математическим правилам. Цена в RUB обязательно должна быть меньше, чем цена до скидки, в противном случае данный параметр лучше оставить пустым.
- Цена в RUB. Цена, которую покупатель увидит на сайте Озон. Если на товар есть скидка, необходимо указать цену после ее применения. Если выбранный инфоблок является торговым каталогом, то из выпадающего списка нужно выбрать тип цены или свойство товара/торгового предложения, значение которого будет участвовать в расчете стоимости товара на сайте Озон. Итоговая стоимость будет конвертирована в рубли (при выборе типа цены для торгового каталога) и округлена до целого числа по математическим правилам. Для простого инфоблока доступны только его свойства, которые также в итоге будут округлены до целого числа по математическим правилам.
- К выбранной цене в RUB можно установить наценку на товары в процентах. Для этого установите флаг «Увеличить стоимость товара на n%» и укажите нужное значение.
- Вес и габариты упаковки товара (длина, ширина, высота). Обязательные параметры для создания/обновления карточки товара на сайте Озон. Вес и габариты не могут быть пустыми, нулевыми, буквенными или написаны десятичными дробями. Кроме этого, есть максимальные и минимальные значения для каждой категории. Подробнее о объемно-весовых характеристиках здесь.
- Изображение товара. Необходимо указать свойство товара/торгового предложения, в котором содержится главное изображение товара или массив изображений. Обратите внимание, что товары без изображений не пройдут модерацию на сайте Озон, а значит, не будут доступны к продаже!
- Дополнительные изображения. Укажите свойство, содержащие дополнительные изображения товара. Не обязательный параметр.
- Видео. Для загрузки видео-роликов на сайт Озон, необходимо в данном параметре указать свойство каталога/инфоблока, содержащего или видео-файлы (тип свойства «Файл» или «Видео»), или ссылки на видео-файлы (тип свойства «Строка»), загруженные на сайт и/или сторонний сервис. Сервис Озон поддерживает видео в формате MP4 и MOV с разрешением от 1080 до 1920px по большей стороне и длительностью от 8 секунд до 5 минут. Подробнее о требованиях к видео можно почитать здесь.
- Массив фильтрации в формате JSON. При необходимости добавить дополнительные условия фильтрации товаров, например, по цене, по доступности и/или по значению одного из свойств, можно составить массив фильтра $arFilter и сконвертировать его в JSON-формат. Подробнее о массиве $arFilter можно узнать в документации 1С-Битрикс. Примеры наиболее часто-встречаемых фильтром можно посмотреть на сайте разработчика.
Теперь нужно добавить и настроить разделы каталога/инфоблока, товары которых будут экспортированы на сайт Озон.
Для добавления раздела каталога/инфоблока нужно кликнуть на кнопку «Добавить раздел» и выбрать из выпадающего списка нужный. Для удобства можно использовать поиск. Важно! Необходимо выбирать тот раздел, в котором товары находятся непосредственно, система подразделов модулем не учитывается!
Чтобы товары раздела попали в выборку модуля, нужно:
Установить флаг в поле «Экспорт»;
В поле "Название категории на сайте Озон" начать вводить название категории/типа товара на сайте Озон. В выпадающем списке будут отображаться категории/типы, доступные на сайте Озон и содержащие введенные символы. Выбираем нужную категорию/тип и сохраняем конфигурацию.
Если раздел каталога был добавлен по ошибке и его необходимо удалить, то нужно снять флаг «Экспорт» в соответствующей строке таблицы, очистить поле «Название категории на сайте Озон» и сохранить конфигурацию.
Для сопоставления свойств торгового каталога/инфоблока и характеристик Озон нужно загрузить справочники значений. После сохранения конфигурации начнется загрузка необходимых данных с сайта Озон, при этом в правой колонке отобразиться надпись «Загрузка справочников». Для каждого раздела каталога/инфоблока данный этап занимает 1-2 минуты, после чего надпись в правой колонке смениться на ссылку «Свойства».
При клике на ссылку «Свойства» откроется панель для сопоставления характеристик выбранной категории/типа на сайте Озон и свойств каталога/инфоблока. Для каждой категории/типа Озон набор характеристик свой. Обратите внимание на характеристики со звездочкой - они обязательны для заполнения!
Для любой характеристики Озон можно сопоставить свойство каталога/инфоблока, выбрав его из выпадающего списка, и/или задать фиксированное значение, которое будут иметь все товары раздела.
Необходимо внимательно отнестись к характеристикам с пометкой «Значение из справочника». Список значений таких характеристик строго ограничен сервисом Озон. Если значение характеристики не совпадает со справочным, то оно считается пустым. Указать фиксированное значение у таких характеристик можно только из соответствующего справочника, выбрав его из выпадающего списка.
Просим обратить внимание на свойства системы 1С-Битрикс типа справочник: значение для экспорта товаров выбирается из поля highload-блока с кодом UF_NAME. Если данное поле отсутствует, то значение выбирается из поля по умолчанию - UF_XML_ID.
Чтобы быстро настроить сопоставление свойств каталога и характеристик Озон у всех разделов, используйте кнопки «Скопировать настройки» и «Вставить настройки». Для этого заполните один из разделов «эталонными» значениями и нажмите на кнопку «Скопировать настройки». Затем перейдите в секцию настройки свойств и характеристик другого раздела и нажмите кнопку «Вставить настройки». Таблица сопоставления для текущего раздела будет заполнена «эталонными» значениями для тех характеристик, названия которых полностью совпадают с «эталонными» характеристиками. Просмотрите таблицу, заполните те параметры, которые необходимы, но которых не было в «эталонном» разделе и перейдите к следующему. Сохраняем изменения, кликнув на кнопку «Сохранить конфигурацию».
Работа с профилями модуля
Использование дополнительных профилей модуля позволяет:
Экспортировать товары из нескольких каталогов/инфоблоков 1С-Битрикс на сайт Озон.
Одновременно работать с несколькими компания в личном кабинете OZON Seller.
Каждый профиль содержит настройку для одного каталога/инфоблока 1С-Битрикс и одной компании OZON Seller. Управление профилями осуществляется на странице настройки модуля, где можно добавить новый профиль, изменить его или удалить.
При выборе профиля из выпадающего списка страница настройки будет перегружена с параметрами, относящимися к выбранному профилю. Для каждого добавленного профиля необходимо произвести базовую настройку.
Обратите, пожалуйста, внимание на параметр «Остаток товаров на сайте OZON, которые не попали в выборку» при работе с одной компанией OZON Seller в разных профилях модуля. Чтобы остатки товаров, выбранных в одном из профилей, не обнулялись при работе со вторым профилем, значения данного параметра должно быть «Не изменять» во всех профилях, использующих данную компанию OZON Seller.
Запуск процедуры экспорта
После того, как выполнены все настройки, необходимо запустить процедуру экспорта. Для этого нужно добавить исполняемый файл, указанный на вкладке «Основные настройки», в утилиту Сron. Как правильно настраивать Сron, можно узнать в техподдержке хостинга сайта.
Если исполняемый файл будет добавлен без аргументов, то все профили модуля будут выполняться поочередно. При больших объемах информации это может занят достаточно продолжительное время. Чтобы запустить экспорт для каждого профиля одновременно (параллельные процессы), нужно добавить исполняемый файл для каждого профиля отдельно, указав в качестве аргумента идентификатор профиля. Идентификатор профиля указан в начале его названия в квадратных скобках.
Например, на сайте используется два профиля с идентификаторами 0 и 1.
Настройка утилиты Cron для параллельного запуска процедуры экспорта обоих профилей будет выглядеть примерно так:
0 1 * * * /usr/bin/php /home/bitrix/www/bitrix/modules/dobrosite.exportozon/tools/cronExportOZON.php 0
0 2 * * * /usr/bin/php /home/bitrix/www/bitrix/modules/dobrosite.exportozon/tools/cronExportOZON.php 1
Таким образом, экспорт товаров для профиля «OZON одежда» будет запускаться ежедневно в 1 ночи, а для профиля «OZON обувь» - ежедневно в 2 часа ночи.
Информация о запуске утилиты Cron отображается на странице настройки модуля в параметре «Последний запуск утилиты Cron» для каждого профиля индивидуально. Если информации нет или дата/время запуска не актуальны, значит настройка утилиты Cron выполнена неверно.
Результаты экспорта и ошибки можно посмотреть на вкладке "Лог", выбрав необходимую дату.