Интеграция с OZON (ОЗОН): товары, цены, остатки, заказы (гибкая настройка)

Модуль представляет собой интеграцию Вашего Битрикс (Bitrix) сайта с Маркетплейсом Ozon (Озон). Вы сможете автоматизировать экспорт товаров, цен, остатков и импорт заказов уже через 10 минут!

Возможности:

1. Выгрузка товаров в Ozon (Озон) (все поля и атрибуты), с возможностью опциональной настройки каждого поля или атрибута. Вы можете выгружать конкретный товар (через Тестирование Выгрузки), а также выгружать все допустимые товары через Агент или Cron.

2. Выгрузка цен товаров в Ozon (Озон). Вы можете выгружать цены для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron.

3. Выгрузка остатков товаров в Ozon (Озон). Вы можете выгружать остатки для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron. Также имеется возможность выбрать конкретный склад для выгрузки (необходимо для случая, если у вас более 1 склада в Ozon (Озон))

4. Загрузка заказов из Ozon (Озон). Вы можете загружать конкретные заказы (через Тестирование Выгрузки), а также загружать все подходящие заказы через Агент или Cron.

5. Просмотр информации об экспорте/импорте или ошибках в Журнале обмена

6. Настроить фильтр на экспорт товаров, цен, остатков,  соответствующих Вашим конкретным условиям

7. Для технических специалистов имеется возможность переопределить данные при экспорте товаров, цен, остатков, а также при импорте заказов через события модуля (список событий с примерами кода приводится далее в описании)

8. Многопрофильность. Поддержка неограниченного количества профилей Ozon (Озон). Поддержка неограниченного количества различных настроек под необходимый профиль Ozon (Озон).
   

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

1. В Основных настройках задать данные для подключения к API Ozon (Озон) и настроить соответствие основных полей товаров
   
2. В Управлении связями категорий соотнести Ваши категории с категориями Ozon (Озон), активировать нужные связи для последующей выгрузки (на этапе 5, 6)
   
3. В Управлении связями характеристик соотнести Ваши характеристики с характеристиками категории Ozon (Озон)
   
4. В Управлении связями значений характеристик соотнести значения Ваших характеристик с типом список (или справочник) со списочными значениями характеристик категории Ozon (Озон)
   
5. В Тестировании выгрузки можете проверить корректность выгрузки товаров, цен, остатков в Ozon (Озон)
   
6. Для массовой выгрузки необходимо активировать нужных агентов выгрузки (товаров, цен, остатков), либо поставить нужные скрипты выгрузок на cron (пути на скрипты описаны далее)
   
7. Наслаждаться автоматизированным экспортом в Ozon (Озон)
   

1. В Основных настройках задать данные для подключения к API Ozon (Озон) и настроить соответствие основных полей товаров
   
2. В Настройках заказов настроить основные поля для заказа, и по желанию соответствие статусов и флагов
   
3. Для массовой загрузки необходимо активировать агента загрузки заказов, либо поставить нужный скрипт загрузки на cron (путь на скрипт описан далее)
   
4. Наслаждаться автоматизированным импортом из Ozon (Озон)
   

1. Для успешной выгрузки полей, характеристик, цен, остатков: необходимо, чтобы у Вас были настроены связи на все обязательные поля (артикул, габариты и т.д.) и обязательные характеристики в категориях. Т.к если у Вас не настроено хоть 1 обязательное поле или 1 обязательная характеристика для связанных категорий, то в Ozon (Озон) может не обновится информация ни по полям, ни по каким-либо характеристикам у товаров определенной категории.

2. Если в Ozon (Озон) характеристика представляет собой список (например Пол: Мужской, Женский и т.д), то необходимо, чтобы на Вашем сайте данное св-во также было списочным (или справочником) и у вас была создана Связь характеристик в Управлении связями характеристик между (например Полом на Вашем сайте и Полом в Ozon (Озон)), а также задано соотношение (например Женский из вашего св-ва Пол со значением Женский из св-ва Ozon (Озон)) в связях значений характеристик в Управлении связями значений характеристик, т.к фактически в Ozon (Озон) будет выгружаться не строковое значение (например Женский), а специальный id из Ozon (Озон) - и чтобы оно правильно выгрузилось, надо как раз и настроить связи значений характеристик

3. У ваших свойств в настройках соответствующего инфоблока в Битриксе, должны быть заданы Коды (а не только Название)

Нюансы:

1. По умолчанию выгрузка товаров, цен, остатков, а также загрузка заказов доступны на Агентах, но их надо Активировать и при желании изменить периодичность запуска (НЕ рекомендуется ставить слишком часто). Крайне рекомендуется настроить экспорт/импорт не через Агенты, а с использование Cron. Если настроено через Агенты, то данные будут обрабатываться постепенно при каждом запуске агента (так необходимо, чтобы у клиентов не тормозил Ваш сайт), если настроено через Cron, то будет полная обработка необходимых данных.

2. Если в функции Агента в скобках () указано число, то это ID профиля, под который настраивается Агент. Если в скобках () нет числа, то это Агент под профиль с ID = 1
   

3. Если у св-ва в настройках Инфоблока задана подсказка, то при возможности будет происходить Автоматическая конвертация единиц измерения для Ozon (Озон). Например на сайте есть числовое св-во Ширина с подсказкой мм, а в Ozon (Озон) для определенной категории значения надо передавать в см, тогда значение на сайте Автоматически переведется в см. Доступные на данный момент величины для автоматической конвертации:

   1. Размеры (мм, см, м);

   2. Вес (г, кг, т);

   3. Объем жидкостей (мл, л);

   4. Пропускной объем жидкостей (л/с, л/мин, л/час);

Крайне рекомендуется поставить все экспорты и импорты на Сron. После перевода скриптов на Cron деактивируйте соответствующие Агенты модуля (если ранее их активировали). Пути скриптов (начало пути может отличаться от вашего - уточняйте у штатного программиста или в ТП хостера). Пример настроек для профиля с ID = 1:

1. Выгрузка товаров /public_html/bitrix/tools/guryev.ozon/cron/export_products.php
   
2. Выгрузка цен /public_html/bitrix/tools/guryev.ozon/cron/export_prices.php
   
3. Выгрузка остатков /public_html/bitrix/tools/guryev.ozon/cron/export_stocks.php
   
4. Загрузка заказов  /public_html/bitrix/tools/guryev.ozon/cron/import_orders.php
   

Примечание: для настройки Cron под профили с ID не равным 1 необходимо добавлять аргумент с id профиля (profile_id). Например, чтобы поставить на cron Выгрузку товаров для профиля с ID = 2, необходимо, чтобы после export_products.php было написано profile_id:2, т.е путь cron скрипта будет иметь примерно следующий вид: /public_html/bitrix/tools/guryev.ozon/cron/export_products.php profile_id:2

Обработчики событий:

Доступны обработчики событий для программистов. Примеры обработчиков для init.php:

1. Переопределить значения при выгрузке информации о товарах в Ozon (Озон) (название, ндс, аттрибуты и т.д):  AddEventHandler("guryev.ozon", "OnExportProduct", ["MyClassGuryevOzon", "OnExportProduct"]);
   
2. Переопределить значения при выгрузке цен товаров в Ozon (Озон): AddEventHandler("guryev.ozon", "OnExportPrice", ["MyClassGuryevOzon", "OnExportPrice"]);
   
3. Переопределить значения при выгрузке остатков товаров в Ozon (Озон): AddEventHandler("guryev.ozon", "OnExportStock", ["MyClassGuryevOzon", "OnExportStock"]);
   
4. Переопределить значения при загрузке заказа из Ozon (Озон): AddEventHandler("guryev.ozon", "OnImportOrder", ["MyClassGuryevOzon", "OnImportOrder"]);
   

Примечание к обработчикам: в OnExportProduct, OnExportPrice, OnExportStock собственная реализация фильтра/отсева товаров недопустима, и может повлечь отсутствие выгрузки данных. Для успешной выгрузки разрешено только переопределение значений!

Пример класса с обработчиками для init.php

*Не забудьте также подключить их через AddEventHandler

class MyClassGuryevOzon

{

   public static function OnExportProduct(array $preparedData, array $profileData): array

   {

       foreach ($preparedData as $key => $value) {

           $updPrice = $value['price'] + 100;

           $preparedData[$key]['price'] = (string)$updPrice;

       }

       return $preparedData;

   }

   public static function OnExportPrice(array $preparedData, array $profileData): array

   {

       foreach ($preparedData as $key => $value) {

           $updPrice = $value['price'] + 200;

           $preparedData[$key]['price'] = (string)$updPrice;

       }

       return $preparedData;

   }

   public static function OnExportStock(array $preparedData, array $profileData): array

   {

       foreach ($preparedData as $key => $value) {

           $updStock = $value['stock'] + 1;

           $preparedData[$key]['stock'] = (int)$updStock;

       }

       return $preparedData;

   }

   public static function OnImportOrder(Bitrix\Sale\Order $orderObject, array $profileData): Bitrix\Sale\Order

   {

       $orderObject->setField("STATUS_ID", 'N');

       return $orderObject;

   }

}

ВНИМАНИЕ! Для работы модуля необходимы ID и ключ API, которые можно получить в личном кабинете партнера на Ozon (Озон). Модуль выгружает товары, имеющие привязку к разделам (простые товары, sku простых товаров, sku с привязкой к разделам). Наборы и комплекты в выгрузке не участвуют.

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