Интеграция Озон и Opencart

Интеграция Ozon для OpenCart

Модуль связывает каталог и заказы OpenCart с личным кабинетом продавца Ozon через Seller API (https://api-seller.ozon.ru). Работа ведётся из админки магазина: выгрузка товаров, обновление остатков, импорт FBS-заказов, сопоставление справочников и журнал синхронизаций.

Сайт и лицензии: https://pluginhub.pro/

Совместимость

OpenCart 2.3.x — сборка в releases/ozon-integration-opencart-2.3/
OpenCart 3.x — основная сборка в upload/
OpenCart 4.x — сборка в releases/ozon-integration-opencart-4.x/ (vendor pluginhub)

Интерфейс админки: RU, EN, KK, UZ, ZH.

Что умеет модуль

Выгрузка товаров на Ozon
Пакетная отправка карточек через /v2/product/import: название, описание, offer_id, категория Ozon, цена, изображения, габариты и атрибуты. offer_id берётся из артикула (sku) товара OpenCart или формируется как OC-{product_id}. Повторная синхронизация обновляет уже связанные позиции.

Импорт заказов FBS
Загрузка отправлений за последние 7 дней через /v3/posting/fbs/list. Новые заказы создаются в OpenCart с привязкой к товарам по offer_id. Дубли не создаются — проверка по номеру заказа Ozon.

Синхронизация остатков
Выгрузка остатков связанных товаров на Ozon через /v1/product/import/stocks пакетами до 100 позиций. Используются данные из таблицы связей (offer_id, fbs_sku).

Сопоставление справочников
Магазины OpenCart ↔️ магазины Ozon
Категории OpenCart ↔️ ID категорий Ozon (есть категория по умолчанию)
Атрибуты OpenCart ↔️ ID характеристик Ozon
Производители OpenCart ↔️ бренды Ozon
Склады (магазины) ↔️ ID складов Ozon

Ценообразование
Глобальная наценка: режим base / percent / fixed и значение module_ozon_integration_price_markup
Отдельные правила в таблице ozon_price_rules (имя, режим, значение, вкл/выкл)

Ручная и автоматическая синхронизация
Кнопки в админке: товары, заказы, остатки
CRON по URL с секретным токеном: товары + заказы + остатки по расписанию (интервал 1–24 часа)

Статистика и логи
Счётчики связанных товаров и заказов, время последней синхронизации, ошибки за 7 дней
Журнал ozon_sync_log с типом операции, статусом и текстом сообщения

Лицензия Pluginhub
Ключ привязан к домену магазина. Проверка при сохранении настроек и через https://pluginhub.pro/api/license/check
Plugin ID: cmjyplrnh000gwfaudt09qwbp

Структура проекта

upload/ — OpenCart 3.x (admin + system/library/ozon_integration)
releases/ozon-integration-opencart-2.3/ — OpenCart 2.3 (шаблон .tpl)
releases/ozon-integration-opencart-4.x/ — OpenCart 4.x (extension/pluginhub/ozon_integration)
install.xml — OCMOD-описание (опционально пункт меню в админке)

Таблицы базы данных

ozon_products — связь product_id, offer_id, fbs_sku, fbo_sku, статус
ozon_orders — связь order_id, номер заказа и отправления Ozon, статус
ozon_sync_log — журнал синхронизаций
ozon_category_map, ozon_attribute_map, ozon_manufacturer_map
ozon_store_map, ozon_warehouse_map
ozon_price_rules — правила цен

При удалении модуля таблицы по умолчанию не удаляются (данные сохраняются для переустановки).

Документация

Краткий обзор: README.md (этот файл)
Установка и настройка: INSTALL.md

Требования

OpenCart 2.3.x, 3.x или 4.x
PHP с расширением cURL
HTTPS на сайте (для доступа Ozon к изображениям товаров)
Client ID и API Key из кабинета продавца Ozon (Настройки → Seller API)
Действующая лицензия Pluginhub для домена магазина

Рекомендуемый порядок запуска

1. Установить модуль и указать лицензию, Client ID и API Key
2. Заполнить сопоставление категорий (хотя бы для основных)
3. Выполнить синхронизацию товаров
4. Проверить связи на вкладке «Товары» (offer_id, fbs_sku)
5. Синхронизировать остатки
6. Импортировать заказы FBS
7. При необходимости включить CRON и автосинхронизацию

Подробные шаги — в INSTALL.md.