Интеграция с OZON: товары, цены, остатки, заказы (гибкая настройка, Озон)
Технические данные
- Опубликовано:
- 29.03.2023
- Обновлено:
- 19.09.2023
- Версия:
- 2.2.0
- Установлено:
- 100 - 499 раз
- Подходящие редакции:
- «Старт», «Стандарт», «Малый бизнес», «Бизнес»
- Адаптивность:
- Нет
- Поддержка Композита:
- Нет
- Совместимо с Сайты24
- Нет
- Совместимо с PHP 8.1
- Да
Пользовательское соглашение
Описание
Модуль представляет собой интеграцию Вашего Битрикс (Bitrix) сайта с Маркетплейсом Ozon (Озон). Вы сможете автоматизировать экспорт товаров и импорт заказов уже через 10 минут!
Возможности:
Выгрузка товаров в Ozon (все поля и атрибуты), с возможностью опциональной настройки каждого поля или атрибута. Вы можете выгружать конкретный товар (через Тестирование Выгрузки), а также выгружать все допустимые товары через Агент или Cron.
Выгрузка цен товаров в Ozon. Вы можете выгружать цены для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron.
Выгрузка остатков товаров в Ozon. Вы можете выгружать остатки для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron. Также имеется возможность выбрать конкретный склад для выгрузки (необходимо для случая, если у вас более 1 склада в Ozon)
Загрузка заказов из Ozon. Вы можете загружать конкретные заказы (через Тестирование Выгрузки), а также загружать все подходящие заказы через Агент или Cron.
Просмотр информации об экспорте/импорте или ошибках в Журнале обмена
Настроить фильтр на выгрузку товаров, соответствующих Вашим конкретным условиям
Т.к для для выгрузки товаров необходима обязательная настройка связей категорий Ozon c разделами Вашего сайта, то вам необходимо будет настроить выгрузку в Конкретные категории. Если в определенный момент вам не нужно будет выгружать товары по какой-то категории, то вы сможете Деактивировать связь категорий в Управлении связями категорий
Для технических специалистов имеется возможность переопределить данные при экспорте товаров, цен, остатков, а также при импорте заказов (список событий с примерами кода приводится далее в описании)
Без ограничений в Демо-период. Без создания дополнительных шаблонов сайта. Без каких-либо изменений Ваших настроек или настроек Битрикса. Без возможности хоть как-то сломать функционал Вашего сайта.
Алгоритм для базовой настройки экспорта товаров, цен, остатков:
- В Основных настройках задать данные для подключения к API Ozon и настроить соответствие основных полей товаров
- В Управлении связями категорий соотнести Ваши категории с категориями Ozon, активировать нужные связи для последующей выгрузки (на этапе 5, 6)
- В Управлении связями характеристик соотнести Ваши характеристики с характеристиками категории Ozon
- В Управлении связями значений характеристик соотнести значения Ваших характеристик с типом список (или справочник) со списочными значениями характеристик категории Ozon
- В Тестировании выгрузки можете проверить корректность выгрузки товаров, цен, остатков
- Для массовой выгрузки необходимо активировать нужных агентов выгрузки (товаров, цен, остатков), либо поставить нужные скрипты выгрузок на cron
- Наслаждаться автоматизированным экспортом
Алгоритм для базовой настройки импорта заказов:
- В Основных настройках задать данные для подключения к API Ozon и настроить соответствие основных полей товаров
- В Настройках заказов настроить основные поля для заказа, и по желанию соответствие статусов и флагов
- Для массовой загрузки необходимо активировать агента загрузки заказов, либо поставить нужный скрипт загрузки на cron
- Наслаждаться автоматизированным импортом
Важно:
1. Для успешной выгрузки полей, характеристик, цен, остатков: необходимо, чтобы у Вас были настроены связи на все обязательные поля (артикул, габариты и т.д.) и обязательные характеристики в категориях. Т.к если у Вас не настроено хоть 1 обязательное поле или 1 обязательная характеристика для связанных категорий, то в Ozon может не обновится информация ни по полям, ни по каким-либо характеристикам у товаров определенной категории.
2. Если в Ozon характеристика представляет собой список (например Пол: Мужской, Женский и т.д), то необходимо, чтобы на Вашем сайте данное св-во также было списочным (или справочником) и у вас была создана Связь характеристик в Управлении связями характеристик между Полом на Вашем сайте и Полом в Ozon, а также задано соотношение Женский из вашего св-ва Пол со значением Женский из св-ва Ozon в связях значений характеристик в Управлении связями значений характеристик, т.к фактически в Ozon будет выгружаться не строковое значение (например Женский), а специальный id из Ozon - и чтобы оно правильно выгрузилось, надо как раз и настроить связи значений характеристик
3. У ваших свойств в настройках соответствующего инфоблока, должны быть заданы Коды (а не только Название)
ВНИМАНИЕ! Для работы модуля необходимы ID и ключ API, которые можно получить в личном кабинете партнера на Ozon. Модуль выгружает товары, имеющие привязку к разделам (простые товары, sku простых товаров, sku с привязкой к разделам). Наборы и комплекты в выгрузке не участвуют.
При обращении по техническим вопросам обязательно указывайте - адрес сайта, логин и пароль администратора, параметры доступа к FTP.
Нюансы:
- По умолчанию выгрузка товаров, цен, остатков, а также загрузка заказов доступны на Агентах, но их надо Активировать и при желании изменить периодичность запуска (НЕ рекомендуется ставить слишком часто). Крайне рекомендуется настроить экспорт/импорт не через Агенты, а с использование Cron,
Если у св-ва в настройках Инфоблока задана подсказка, то при возможности будет происходить Автоматическая конвертация единиц измерения для Ozon. Например на сайте есть числовое св-во Ширина с подсказкой мм, а в Ozon для определенной категории значения надо передавать в см, тогда значение на сайте Автоматически переведется в см. Доступные на данный момент величины для автоматической конвертации:
1. Размеры (мм, см, м);
2. Вес (г, кг, т);
3. Объем жидкостей (мл, л);
4. Пропускной объем жидкостей (л/с, л/мин);
Крайне рекомендуется поставить все экспорты и импорты на Сron. Пути скриптов (начало пути может отличаться от вашего - уточняйте у штатного программиста или в ТП хостера):
- Выгрузка товаров /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
Обработчики событий:
Доступны обработчики событий для программистов. Примеры обработчиков для init.php:
- Переопределить значения при выгрузке информации о товарах (название, ндс, аттрибуты и т.д) AddEventHandler("guryev.ozon", "OnExportProduct", ["MyClassGuryevOzon", "OnExportProduct"]);
- Переопределить значения при выгрузке цен товаров AddEventHandler("guryev.ozon", "OnExportPrice", ["MyClassGuryevOzon", "OnExportPrice"]);
- Переопределить значения при выгрузке остатков товаров AddEventHandler("guryev.ozon", "OnExportStock", ["MyClassGuryevOzon", "OnExportStock"]);
- Переопределить значения при загрузке заказа AddEventHandler("guryev.ozon", "OnImportOrder", ["MyClassGuryevOzon", "OnImportOrder"]);
Примечание к обработчикам: в OnExportProduct, OnExportPrice, OnExportStock собственная реализация фильтра/отсева товаров недопустима, и может повлечь отсутствие выгрузки данных. Для успешной выгрузки разрешено только переопределение значений!
Пример класса с обработчиками для init.php
*Не забудьте также подключить их через AddEventHandler
class MyClassGuryevOzon
{
function OnExportProduct(array $preparedData): array
{
foreach ($preparedData as $key => $value) {
$updPrice = $value['price'] + 100;
$preparedData[$key]['price'] = (string)$updPrice;
}
return $preparedData;
}
function OnExportPrice(array $preparedData): array
{
foreach ($preparedData as $key => $value) {
$updPrice = $value['price'] + 200;
$preparedData[$key]['price'] = (string)$updPrice;
}
return $preparedData;
}
function OnExportStock(array $preparedData): array
{
foreach ($preparedData as $key => $value) {
$updStock = $value['stock'] + 1;
$preparedData[$key]['stock'] = (int)$updStock;
}
return $preparedData;
}
function OnImportOrder(Bitrix\Sale\Order $orderObject): Bitrix\Sale\Order
{
$orderObject->setField("STATUS_ID", 'N');
return $orderObject;
}
}
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.