Интеграция с OZON

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

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

[SIZE=13pt] [/SIZE]

[SIZE=13pt]Возможности:[/SIZE]

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

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

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

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

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

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

7. Многофункциональный фильтр. Настройте фильтр на экспорт товаров, цен, остатков, который соответствует Вашим конкретным условиям

8. Высокая отказоустойчивость. Модуль будет пытаться автоматически обработать некорректные данные и возникающие ситуации как со стороны Битрикса, так и со стороны Озон (Ozon). Если автоматически не удастся решить проблему, то она будет зафиксирована в Журнале обмена, а работа модуля продолжится.

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

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

[SIZE=12pt]Алгоритм для базовой настройки экспорта товаров, цен, остатков:[/SIZE]

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

[SIZE=14pt] [/SIZE][SIZE=14pt][SIZE=12pt]Алгоритм для базовой настройки импорта заказов:[/SIZE] [/SIZE]

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

[SIZE=14pt] [/SIZE][SIZE=14pt]Важно: [/SIZE]

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

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

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

Нюансы:

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
5. Загрузка брендов /public_html/bitrix/tools/guryev.ozon/cron/import_brands.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

[SIZE=12pt] [/SIZE]

[SIZE=12pt]Обработчики событий:[/SIZE]

Доступны обработчики событий для программистов. Примеры обработчиков для 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"]);
Переопределить значения при загрузке заказа из Ozon (Озон): AddEventHandler("guryev.ozon", "OnImportOrder", ["MyClassGuryevOzon", "OnImportOrder"]);

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

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

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

[FONT="Courier New"]class MyClassGuryevOzon[/FONT]

[FONT="Courier New"]{[/FONT]

[FONT="Courier New"]// c версии 3.19.0: (array $profileData, array $preparedData)[/FONT]

[FONT="Courier New"]    public static function OnExportProduct(array $preparedData, array $profileData): array[/FONT]

[FONT="Courier New"]    {[/FONT]

[FONT="Courier New"]        foreach ($preparedData as $key => $value) {[/FONT]

[FONT="Courier New"]            $updPrice = $value['price'] + 100;[/FONT]

[FONT="Courier New"]            $preparedData[$key]['price'] = (string)$updPrice;[/FONT]

[FONT="Courier New"]        }[/FONT]

[FONT="Courier New"]        return $preparedData;[/FONT]

[FONT="Courier New"]    }[/FONT]

[FONT="Courier New"] [/FONT]

[FONT="Courier New"]// c версии 3.19.0: (array $profileData, array $preparedData)[/FONT]

[FONT="Courier New"]    public static function OnExportPrice(array $preparedData, array $profileData): array[/FONT]

[FONT="Courier New"]    {[/FONT]

[FONT="Courier New"]        foreach ($preparedData as $key => $value) {[/FONT]

[FONT="Courier New"]            $updPrice = $value['price'] + 200;[/FONT]

[FONT="Courier New"]            $preparedData[$key]['price'] = (string)$updPrice;[/FONT]

[FONT="Courier New"]        }[/FONT]

[FONT="Courier New"]        return $preparedData;[/FONT]

[FONT="Courier New"]    }[/FONT]

[FONT="Courier New"] [/FONT]

[FONT="Courier New"]// c версии 3.19.0: (array $profileData, array $preparedData)[/FONT]

[FONT="Courier New"]    public static function OnExportStock(array $preparedData, array $profileData): array[/FONT]

[FONT="Courier New"]    {[/FONT]

[FONT="Courier New"]        foreach ($preparedData as $key => $value) {[/FONT]

[FONT="Courier New"]            $updStock = $value['stock'] + 1;[/FONT]

[FONT="Courier New"]            $preparedData[$key]['stock'] = (int)$updStock;[/FONT]

[FONT="Courier New"]        }[/FONT]

[FONT="Courier New"]        return $preparedData;[/FONT]

[FONT="Courier New"]    }[/FONT]

[FONT="Courier New"] [/FONT]

[FONT="Courier New"]    public static function OnImportOrder(array $profileData, Bitrix\Sale\Order $bitrixOrder, array $ozonOrder): Bitrix\Sale\Order[/FONT]

[FONT="Courier New"]    {[/FONT]

[FONT="Courier New"]        $bitrixOrder->setField("STATUS_ID", 'N');[/FONT]

[FONT="Courier New"]        return $bitrixOrder;[/FONT]

[FONT="Courier New"]    }[/FONT]

[FONT="Courier New"]}[/FONT]

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

[SIZE=11pt] [/SIZE]

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

[SIZE=11pt] [/SIZE]

Промо-видео:

[VIDEO TYPE=VK WIDTH=325 HEIGHT=646]//vk.com/video_ext.php?oid=-227287205&id=456239020&hd=2&autoplay=1[/VIDEO]

[SIZE=14.6667px]Как пользоваться модулем:[/SIZE]

[VIDEO TYPE=VK WIDTH=1280 HEIGHT=720]//vk.com/video_ext.php?oid=-227287205&id=456239017&hd=3&autoplay=1[/VIDEO]

[SIZE=12pt] [/SIZE]

[SIZE=12pt]Программный вызов методов:[/SIZE]

Доступен программный вызов экспорта остатков (с версии 3.19.0). Пример:

/** [FONT="Courier New"] * Программный вызов Экспорта остатков товаров в Ozon[/FONT] [FONT="Courier New"] * 1. Логика отработки аналогична как будто это запуск на агенте/кроне, но с явно переданными id товаров (фильтр в Основных настройках не будет действовать)[/FONT] [FONT="Courier New"] * 2. Если реализован обработчик событий модуля OnExportStock, то он также будет срабатывать[/FONT] [FONT="Courier New"] * 3. Если кол-во значений в $productIds более 100, то необходимо сделать несколько вызовов метода, разбив данные порционно[/FONT] [FONT="Courier New"] *[/FONT] [FONT="Courier New"] * Параметры: [/FONT]*[FONT="Courier New"] 26 в [/FONT][FONT="Courier New"]GuryevOzonProgramCall - id профиля[/FONT] [FONT="Courier New"] * @param array $productIds - массив id товаров (не более 100 элементов)[/FONT] [FONT="Courier New"] * @return bool[/FONT] [FONT="Courier New"] * @throws JsonException[/FONT] */ [FONT="Courier New"]Пример вызова:[/FONT] [FONT="Courier New"]use Bitrix\Main\Loader;[/FONT] [FONT="Courier New"]Loader::includeSharewareModule('guryev.ozon');[/FONT] [FONT="Courier New"]$GuryevOzonProgramCall = new GuryevOzonProgramCall(26);[/FONT] [FONT="Courier New"]$GuryevOzonProgramCall->exportStocks([7,8,9]);[/FONT] Доступен программный вызов экспорта цен (с версии 3.20.0). Пример: [FONT="Courier New"] [/FONT][FONT="Courier New"][/FONT][FONT="Courier New"]/**[/FONT] [FONT="Courier New"] * Программный вызов Экспорта цен товаров в Ozon[/FONT] [FONT="Courier New"] * 1. Логика отработки аналогична как будто это запуск на агенте/кроне, но с явно переданными id товаров (фильтр в Основных настройках не будет действовать)[/FONT] [FONT="Courier New"] * 2. Если реализован обработчик событий модуля OnExportPrice, то он также будет срабатывать[/FONT] [FONT="Courier New"] * 3. Если кол-во значений в $productIds более 100, то необходимо сделать несколько вызовов метода, разбив данные порционно[/FONT] [FONT="Courier New"] *[/FONT] [FONT="Courier New"] * Параметры:[/FONT] [FONT="Courier New"] * 26 в GuryevOzonProgramCall - id профиля[/FONT] [FONT="Courier New"] * @param array $productIds - массив id товаров (не более 100 элементов)[/FONT] [FONT="Courier New"] * @return bool[/FONT] [FONT="Courier New"] * @t[/FONT]hrows JsonException */ [FONT="Courier New"]Пример вызова:[/FONT] [FONT="Courier New"]use Bitrix\Main\Loader;[/FONT] [FONT="Courier New"]Loader::includeSharewareModule('guryev.ozon');[/FONT] [FONT="Courier New"]$GuryevOzonProgramCall = new GuryevOzonProgramCall(26);[/FONT] [FONT="Courier New"]$GuryevOzonProgramCall->exportPrices([7,8,9]);[/FONT]