Интеграция с OZON (ОЗОН): товары, цены, остатки, заказы (гибкая настройка)
Технические данные
- Опубликовано:
- 29.03.2023
- Обновлено:
- 13.01.2025
- Версия:
- 3.10.0
- Установлено:
- 100 - 499 раз
- Подходящие редакции:
- «Первый сайт», «Старт», «Стандарт», «Малый бизнес», «Бизнес», «Корпоративный портал», «Энтерпрайз», «Интернет-магазин + CRM»
- Адаптивность:
- Нет
- Поддержка Композита:
- Нет
- Совместимо с Сайты24
- Нет
- Совместимо с PHP 8.1
- Да
Пользовательское соглашение
Описание
Модуль представляет собой интеграцию Вашего Битрикс (Bitrix) сайта с Маркетплейсом Ozon (Озон). Вы сможете автоматизировать экспорт товаров, цен, остатков и импорт заказов уже через 10 минут!
Модуль позволяет автоматизировать процессы синхронизации товаров, цен, остатков и управление заказами, что значительно экономит время и ресурсы Вашего бизнеса.
Возможности:
Выгрузка товаров в Ozon (Озон) (все поля и атрибуты), с возможностью опциональной настройки каждого поля или атрибута. Вы можете выгружать конкретный товар (через Тестирование Выгрузки), а также выгружать все допустимые товары через Агент или Cron.
Выгрузка цен товаров в Ozon (Озон). Вы можете выгружать цены для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron.
Выгрузка остатков товаров в Ozon (Озон). Вы можете выгружать остатки для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron. Также имеется возможность выбрать конкретный склад для выгрузки (необходимо для случая, если у вас более 1 склада в Ozon (Озон))
Загрузка заказов из Ozon (Озон). Вы можете загружать конкретные заказы (через Тестирование Выгрузки), а также загружать все подходящие заказы через Агент или Cron. Также Вы сможете настроить соответствие статусов заказов на вашем сайте и в Ozon (Озон)
Многопрофильность. Поддержка неограниченного количества профилей Ozon (Озон). Поддержка неограниченного количества различных настроек под необходимый профиль Ozon (Озон). Поддержка работы с неограниченным количеством складов Ozon (Озон)
Журнал обмена. Просматривайте информацию об экспорте/импорте или ошибках в Журнале обмена
Многофункциональный фильтр. Настройте фильтр на экспорт товаров, цен, остатков, который соответствует Вашим конкретным условиям
Высокая отказоустойчивость. Модуль будет пытаться автоматически обработать некорректные данные и возникающие ситуации как со стороны Битрикса, так и со стороны Озон (Ozon). Если автоматически не удастся решить проблему, то она будет зафиксирована в Журнале обмена, а работа модуля продолжится.
Обработчики событий модуля. Вы можете программно переопределить данные при экспорте товаров, цен, остатков, а также при импорте заказов через обработчики событий модуля (список событий с примерами кода приводится далее в описании)
Без ограничений в Демо-период. Без создания дополнительных шаблонов сайта. Без каких-либо изменений Ваших настроек или настроек Битрикса. Без возможности хоть как-то сломать функционал Вашего сайта.
Алгоритм для базовой настройки экспорта товаров, цен, остатков:
- В Основных настройках задать данные для подключения к API Ozon (Озон) и настроить соответствие основных полей товаров
- В Управлении связями категорий соотнести Ваши категории с категориями Ozon (Озон), активировать нужные связи для последующей выгрузки (на этапе 5, 6)
- В Управлении связями характеристик соотнести Ваши характеристики с характеристиками категории Ozon (Озон)
- В Управлении связями значений характеристик соотнести значения Ваших характеристик с типом список (или справочник) со списочными значениями характеристик категории Ozon (Озон)
- В Тестировании выгрузки можете проверить корректность выгрузки товаров, цен, остатков в Ozon (Озон)
- Для массовой выгрузки необходимо активировать нужных агентов выгрузки (товаров, цен, остатков), либо поставить нужные скрипты выгрузок на cron (пути на скрипты описаны далее)
- Наслаждаться автоматизированным экспортом в Ozon (Озон)
Алгоритм для базовой настройки импорта заказов:
- В Основных настройках задать данные для подключения к API Ozon (Озон) и настроить соответствие основных полей товаров
- В Настройках заказов настроить основные поля для заказа, и по желанию соответствие статусов заказов на вашем сайте и статусов в Ozon (Озон)
- Для массовой загрузки необходимо активировать агента загрузки заказов, либо поставить нужный скрипт загрузки на cron (путь на скрипт описан далее)
- Наслаждаться автоматизированным импортом из Ozon (Озон)
Важно:
1. Для успешной выгрузки полей, характеристик, цен, остатков: необходимо, чтобы у Вас были настроены связи на все обязательные поля (артикул, габариты и т.д.) и обязательные характеристики в категориях. Т.к если у Вас не настроено хоть 1 обязательное поле или 1 обязательная характеристика для связанных категорий, то в Ozon (Озон) может не обновится информация ни по полям, ни по каким-либо характеристикам у товаров определенной категории.
2. Если в Ozon (Озон) характеристика представляет собой список (например Пол: Мужской, Женский и т.д), то необходимо, чтобы на Вашем сайте данное св-во также было списочным (или справочником) и у вас была создана Связь характеристик в Управлении связями характеристик между (например Полом на Вашем сайте и Полом в Ozon (Озон)), а также задано соотношение (например Женский из вашего св-ва Пол со значением Женский из св-ва Ozon (Озон)) в связях значений характеристик в Управлении связями значений характеристик, т.к фактически в Ozon (Озон) будет выгружаться не строковое значение (например Женский), а специальный id из Ozon (Озон) - и чтобы оно правильно выгрузилось, надо как раз и настроить связи значений характеристик
3. У ваших свойств в настройках соответствующего инфоблока в Битриксе, должны быть заданы Коды (а не только Название)
Нюансы:
- По умолчанию выгрузка товаров, цен, остатков, а также загрузка заказов доступны на Агентах, но их надо Активировать и при желании изменить периодичность запуска (НЕ рекомендуется ставить слишком часто). Крайне рекомендуется настроить экспорт/импорт не через Агенты, а с использование Cron. Если настроено через Агенты, то данные будут обрабатываться постепенно при каждом запуске агента (так необходимо, чтобы у клиентов не тормозил Ваш сайт), если настроено через Cron, то будет полная обработка необходимых данных.
- Если в функции Агента в скобках () указано число, то это ID профиля, под который настраивается Агент. Если в скобках () нет числа, то это Агент под профиль с ID = 1
Если у св-ва в настройках Инфоблока задана подсказка, то при возможности будет происходить Автоматическая конвертация единиц измерения для Ozon (Озон). Например на сайте есть числовое св-во Ширина с подсказкой мм, а в Ozon (Озон) для определенной категории значения надо передавать в см, тогда значение на сайте Автоматически переведется в см. Доступные на данный момент величины для автоматической конвертации:
1. Размеры (мм, см, м);
2. Вес (г, кг, т);
3. Объем жидкостей (мл, л);
4. Пропускной объем жидкостей (л/с, л/мин, л/час);
Крайне рекомендуется поставить все экспорты и импорты на Сron. После перевода скриптов на Cron деактивируйте соответствующие Агенты модуля (если ранее их активировали). Пути скриптов (начало пути может отличаться от вашего - уточняйте у штатного программиста или в ТП хостера). Пример настроек для профиля с ID = 1:
- Выгрузка товаров /public_html/bitrix/tools/guryev.ozon/cron/export_products.php
- Выгрузка цен /public_html/bitrix/tools/guryev.ozon/cron/export_prices.php
- Выгрузка остатков /public_html/bitrix/tools/guryev.ozon/cron/export_stocks.php
- Загрузка заказов /public_html/bitrix/tools/guryev.ozon/cron/import_orders.php
- Загрузка брендов /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
Обработчики событий:
Доступны обработчики событий для программистов. Примеры обработчиков для init.php:
- Переопределить значения при выгрузке информации о товарах в Ozon (Озон) (название, ндс, аттрибуты и т.д): AddEventHandler("guryev.ozon", "OnExportProduct", ["MyClassGuryevOzon", "OnExportProduct"]);
- Переопределить значения при выгрузке цен товаров в Ozon (Озон): AddEventHandler("guryev.ozon", "OnExportPrice", ["MyClassGuryevOzon", "OnExportPrice"]);
- Переопределить значения при выгрузке остатков товаров в Ozon (Озон): AddEventHandler("guryev.ozon", "OnExportStock", ["MyClassGuryevOzon", "OnExportStock"]);
- Переопределить значения при загрузке заказа из 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.
3.11.0 (13.01.2025) (beta) |
|
3.10.0 (25.11.2024) |
|
3.9.0 (15.10.2024) |
|
3.8.0 (26.09.2024) |
|
3.7.0 (02.09.2024) |
|
3.6.0 (19.08.2024) |
|
3.5.0 (24.06.2024) |
|
3.4.0 (03.06.2024) |
|
3.3.0 (20.05.2024) |
|
3.2.0 (13.05.2024) |
|
3.1.0 (15.04.2024) |
|
3.0.0 (08.04.2024) |
|
2.9.0 (25.03.2024) |
|
2.8.0 (11.03.2024) |
|
2.7.0 (19.02.2024) |
|
2.6.0 (10.01.2024) |
|
2.5.3 (08.12.2023) | Добавлена возможность в Артикуле указать Внешний код |
2.5.2 (27.11.2023) | Исправления и улучшения |
2.5.1 (23.10.2023) | Редизайн страницы Тестирование выгрузки |
2.5.0 (16.10.2023) |
|
2.4.0 (09.10.2023) |
|
2.3.0 (25.09.2023) |
|
2.2.0 (11.09.2023) | Различные мелкие улучшения |
2.1.0 (05.09.2023) | Добавлен функционал для заказов: дублирование номера отправления и даты отгрузки |
2.0.0 (04.09.2023) | Добавлен функционал загрузки заказов из Ozon |
1.10.0 (10.08.2023) | Различные мелкие правки |
1.9.0 (19.07.2023) | Добавлена возможность работы с минимальной ценой для Озона. Различные мелкие улучшения. |
1.8.0 (17.07.2023) | Добавлено уведомление о новых версиях модуля |
1.7.1 (08.07.2023) | Актуализация АПИ метода для получения лимитов АПИ |
1.7.0 (08.07.2023) | Добавлена поддержка свойства с типом Привязка к элементу |
1.6.0 (01.07.2023) | Добавлена возможность через Дополнительные настройки переопределить значение Остатков в зависимости от значениях остатков или цены из БД |
1.5.2 (27.06.2023) | Исправления и улучшения |
1.5.1 (27.06.2023) | Обработка случая, когда Ozon не присылает type в характеристике |
1.5.0 (26.06.2023) | Исправления и улучшения |
1.4.0 (19.06.2023) | Добавлена возможность у Торговых предложений при необходимости наследовать значения Основных полей от Основного товара |
1.3.0 (13.06.2023) | Добавлена возможность использовать свойство с типом Справочник |
1.2.0 (29.05.2023) | Добавлен функционал соответствия выгрузки остатков со склада(ов) Сайта на склад(ы) Ozon |
1.1.14 (22.05.2023) | Исправления ошибок |
1.1.13 (19.05.2023) |
|
1.1.12 (17.05.2023) | Исправления ошибок |
1.1.11 (12.05.2023) | Доработка экспортов |
1.1.10 (24.04.2023) | Добавлена возможность через Дополнительные настройки переопределить значение Цены и Цены до скидок, доработка вывода информации в Журнале обмена |
1.1.9 (19.04.2023) | Доработка экспорта остатков |
1.1.8 (19.04.2023) | Доработка экспорта информации о товарах |
1.1.7 (17.04.2023) | Доработки в управлениях связями |
1.1.6 (14.04.2023) | Доработка описаний к настройкам |
1.1.5 (13.04.2023) | Добавлена возможность в выгрузке Артикула использовать ID |
1.1.4 (13.04.2023) | Доработка под кодировку windows-1251 |
1.1.3 (11.04.2023) | Доработка языковых файлов |
1.1.2 (10.04.2023) | В основных настройках добавлены списочные свойства, рефактор |
1.1.1 (09.04.2023) | Обновление языковых файлов, правка багов |
1.1.0 (07.04.2023) | Добавлена поддержка SKU, теперь можно выбирать откуда будет выгружаться информация: из простых товаров, или из товаров с торговыми предложениями |
1.0.2 (04.04.2023) | Добавлена возможность обновить статус записи в Журнале обмена для Экспорт товаров в статусе pending |
1.0.1 (31.03.2023) | Доработка текстового описания Типа в Журнале обмена |
Рекомендуемая версия php - 7.4
Минимальная рекомендуемая версия БУС - 18.0.0
Наличие подключенной серверной библиотеки cURL
Алгоритм для базовой настройки экспорта товаров, цен, остатков:
- В Основных настройках задать данные для подключения к API Ozon и настроить соответствие основных полей товаров
- В Управлении связями категорий соотнести Ваши категории с категориями Ozon, активировать нужные связи для последующей выгрузки (на этапе 5, 6)
- В Управлении связями характеристик соотнести Ваши характеристики с характеристиками категории Ozon
- В Управлении связями значений характеристик соотнести значения Ваших характеристик с типом список (или справочник) со списочными значениями характеристик категории Ozon
- В Тестировании выгрузки можете проверить корректность выгрузки товаров, цен, остатков
- Для массовой выгрузки необходимо активировать нужных агентов выгрузки (товаров, цен, остатков), либо поставить нужные скрипты выгрузок на cron (пути на скрипты описаны далее)
- Наслаждаться автоматизированным экспортом
- В Основных настройках задать данные для подключения к API Ozon и настроить соответствие основных полей товаров
- В Настройках заказов настроить основные поля для заказа, и по желанию соответствие статусов и флагов
- Для массовой загрузки необходимо активировать агента загрузки заказов, либо поставить нужный скрипт загрузки на cron (путь на скрипт описан далее)
- Наслаждаться автоматизированным импортом
Для получения технической поддержки пишите на почту: vguryevb24info@gmail.com
При обращении по техническим вопросам обязательно указывайте - подробное описание проблемы с картинками, адрес сайта, логин и пароль администратора, параметры доступа к FTP.