Экспорт товаров в интернет-магазин OZON от разработчика «Добросайт»

Настройка модуля для создания карточек товаров, обновления информации, остатков и цен товаров в личном кабинете OZON Seller.

После установки модуля штатными средствами 1С-Битрикс, нужно настроить интеграцию с сайтом Озон. Для этого потребуется «Client ID» и ключ для доступа к API с типом «Администратор».

Параметр «Client ID» указан в настройках личного кабинета OZON Seller в разделе Seller API -> API ключи.

Генерация ключа для доступа к API производится в том же разделе личного кабинета OZON Seller. Необходимо указать тип токена «Администратор», заполнить произвольное название и нажать на кнопку «Создать ключ».



Данные вводятся в соответствующие поля в настройках модуля.



Затем нужно выбрать схему продажи:

• FBO (продажа со склада Озон), или
  
• FBS/realFBS (продажа с собственного склада).
  

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

Для схемы продажи FBS/realFBS необходимо добавить собственный склад/склады в личном кабинете OZON Seller в разделе FBS -> Логистика.



Если в личном кабине OZON Seller складов больше одного, то нужно узнать идентификатор того склада, на который будут выгружаться остатки товаров с сайта. Узнать это можно, скачав шаблон для обновления остатков со страницы FBS-> Обновить остатки на складах. Идентификатор склада будет указан в скобках рядом с его названием.







Затем в настройках модуля необходимо установить флаг «Количество складов больше одного» и внести значение идентификатора в поле «Идентификатор склада для обновления остатков».



Настраиваем торговый каталог/инфоблок для экспорта товаров на сайт Озон. Из выпадающего списка «Идентификатор торгового каталога» выбираем нужный и сохраняем настройки.



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

После сохранения настроек станет доступна вкладка "Сопоставление разделов и свойств", переходим на нее. Здесь нужно установить соответствия между настройками торгового каталога/инфоблока и параметрами Озон; выбрать разделы, элементы которых должны быть экспортированы, и сопоставить их категориям сайта Озон.

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

• Артикул товара / торгового предложения – идентификатор товара в системе Озон. Обязательное поле при создании карточки товара. Значение артикула у каждой товарной позиции должно быть уникальным в пределах продавца на сайте Озон. По значению данного поля проводиться сопоставление товаров из торгового каталога и товаров на сайте Озон. Если каталог поддерживает торговые предложения, то поля будет два: в одном нужно указать свойство для простого товара, в другом - для торгового предложения. Подробнее об артикулах можно почитать здесь.
  

• Название товара отображается в карточке товара на сайте Озон. Значение данного параметра должно содержать тип, бренд, модель и важные для категории товара характеристики. Подробнее о формировании значения данного поля можно почитать  здесь.
  

• Штрихкод товара обязателен только для схемы продажи FBO (со склада Озон). Можно использовать свои штрихкоды, если они соответствуют требованиям сервиса Озон, либо сгенерировать их автоматически в личном кабинете OZON Seller. Подробнее о штрихкодах здесь.
  

• Остаток товара на складе. Если выбранный в настройках инфоблок является торговым каталогом, то в качестве источника для выбора значения остатков может выступать общее количество товара на всех складах, на одном из складов или одно из свойств товара/торгового предложения. Для простого инфоблока доступны только его свойства. Заполнение данного параметра обязательно для схемы продажи FBS/realFBS, без него остатки выгружены не будут!
  

• При установленном флаге «Обнулить остаток, если количество товаров меньше n шт.» на сайте Озон остаток товара будет принудительно обнулен, если значение в указанном выше параметре, будет меньше, чем число n.
  

• НДС – ставка налога на добавочную стоимость. Заполнение данного параметра обязательно для создания/обновления карточки товара на сайте Озон. Можно выбрать как фиксированное значение (не облагается, 10% или 20%), так и значение одного из свойств товаров/торговых предложений.
  

• Цена до скидки. Если на товар есть скидка, то можно указать цену товара до ее применения. Если выбранный инфоблок является торговым каталогом, то из выпадающего списка нужно выбрать тип цены или свойство товара/торгового предложения, значение которого будет конвертировано в русские рубли (при выборе типа цены для торгового каталога) и округлено до целого числа по математическим правилам. Для простого инфоблока доступны только его свойства, которые также будут округлены до целого числа по математическим правилам.
  

• Цена в RUB. Цена, которую покупатель увидит на сайте Озон. Если на товар есть скидка, необходимо указать цену после ее применения. Если выбранный инфоблок является торговым каталогом, то из выпадающего списка нужно выбрать тип цены или свойство товара/торгового предложения, значение которого будет участвовать в расчете стоимости товара на сайте Озон. Итоговая стоимость будет конвертирована в рубли (при выборе типа цены для торгового каталога) и округлена до целого числа по математическим правилам. Для простого инфоблока доступны только его свойства, которые также в итоге будут округлены до целого числа по математическим правилам.
  

• К выбранной цене можно установить наценку на товары в процентах. Для этого установите флаг «Увеличить стоимость товара на n%» и укажите нужное значение.
  

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

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

• Дополнительные изображения. Укажите свойство, содержащие дополнительные изображения товара. Не обязательный параметр.
  

• Массив фильтрации в формате JSON. При необходимости добавить дополнительные условия фильтрации товаров, например, по бренду, можно составить массив фильтра $arFilter и сконвертировать его в JSON-формат. Подробнее о массиве $arFilter можно узнать в документации 1С-Битрикс. Например, нужно экспортировать только те товары, у которых свойство с кодом «BRAND» равно «M&B». Строка в JSON-формате будет выглядеть так: {"PROPERTY_BRAND": " M&B"}
  

Чтобы выбрать разделы, товары которых будут экспортированы на сайт Озон, нужно:

1. Установить флаг в поле «Экспорт»;
   
2. В поле "Название категории на сайте Озон" начать вводить название категории. В выпадающем списке будут отображаться категории, доступные на сайте Озон и содержащие введенные символы. Выбираем нужную категорию и сохраняем конфигурацию.
   

Для сопоставления свойств торгового каталога/инфоблока и характеристик категорий Озон нужно загрузить справочники значений. После сохранения конфигурации начнется загрузка необходимых данных с сайта Озон, при этом в правой колонке отобразиться надпись «Загрузка справочников». Для каждого раздела каталога/инфоблока данный этап занимает 1-2 минуты, после чего надпись в правой колонке смениться на ссылку «Свойства».




При клике на ссылку «Свойства» откроется панель для сопоставления характеристик выбранной категории на сайте Озон и свойств каталога/инфоблока. Для каждой категории Озон набор характеристик свой. Обратите внимание на характеристики со звездочкой - они обязательны для заполнения!

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



Необходимо внимательно отнестись к характеристикам с пометкой «Значение из справочника». Список значений таких характеристик строго ограничен сервисом Озон. Если значение характеристики не совпадает со справочным, то оно считается пустым. Выбрать фиксированное значение у таких характеристик можно только из справочника, выбрав его из выпадающего списка. Исключение составляет только свойство «Бренд», для него доступно одно фиксированное, не справочное значение: «Нет бренда».







Также стоит обратить внимание на свойства системы 1С-Битрикс типа справочник: значение для экспорта товаров выбирается из поля highload-блока с кодом UF_NAME. Если данное поле отсутствует, то значение выбирается из поля по умолчанию - UF_XML_ID.

Сохраняем изменения, кликнув на кнопку «Сохранить конфигурацию».

После того, как выполнены все настройки, необходимо запустить процедуру экспорта. Для этого нужно добавить исполняемый файл, указанный на вкладке «Основные настройки», в утилиту cron. Как правильно настраивать cron, можно узнать в техподдержке хостинга сайта.



Результаты экспорта и ошибки можно посмотреть на вкладке "Лог", выбрав необходимую дату.

• Добавлена возможность выгружать товары из разных разделов на разные склады OZON.
• Внедрена поддержка кодировки Windows-1251.

• Оптимизировано потребление процессорного времени и оперативной памяти для обработки больших объемов данных.

• Оптимизирован алгоритм выбора товаров для обновления карточек на сайте Озон.
• Добавлено визуальное отображение ожидания ответа от сервера у операций, требующих времени на странице настройки модуля.
• Добавлена возможность скачать лог-файл большого размера.
• Добавлена возможность скачать файл с отладочной информацие для обращения в тех. поддержку разработчика модуля.
• На страницу настроек модуля добавлена информация о времени последнего запуска утилиты cron и состоянии процедуры экспорта товаров на сайт Озон.
• Обновление справочников Озон сокращено до 1 раза в сутки, чтобы уменьшить время выполнения процедуры экспорта товаров на сайт Озон.

• Оптимизирован вывод лог-файла, повышена его читаемость.
• Внесены мелкие исправления в работу модуля, учитывающие особенности сервиса Озон.

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

• Добавлена возможность отключить обнуление остатков на сайте ozon.ru для товаров, не попавших в выборку модуля;
• Добавлен поиск по свойствам каталога/инфоблока при сопоставлении свойств и характеристик категорий Озон;
• Оптимизированы запросы к БД;
• Ускорена загрузка страницы настройки модуля. Особенно актуально для каталогов с большим количеством разделов;
• Добавлена возможность выгрузить список товаров, входящих в выборку при текущих настройках модуля, в формате CSV. Товары, которые входят в выборку учавствуют в обмене информации с сайтом Озон: создание/обновление карточек товаров, загрузка остатков и цен.

• Обеспечена совместимость модуля с PHP 8.