Integration of Ozon and Opencart

Ozon integration for OpenCart

The module connects the OpenCart catalog and orders to the personal account of the Ozon seller via the Seller API (https://api-seller.ozon.ru ). The work is carried out from the store's admin panel: unloading goods, updating balances, importing FBS orders, comparing directories and a synchronization log.

Website and licenses: https://pluginhub.pro/

Compatibility

OpenCart 2.3.x — build in releases/ozon-integration-opencart-2.3/
OpenCart 3.x — basic build in upload/
OpenCart 4.x — build in releases/ozon-integration-opencart-4.x/ (vendor pluginhub)

Admin panel interface: RU, EN, KK, UZ, ZH.

What the module can do

Unloading goods on Ozon
Batch sending of cards via /v2/product/import: name, description, offer_id, Ozon category, price, images, dimensions and attributes. The offer_id is taken from the sku of the OpenCart product or is formed as OC-{product_id}. Repeated synchronization updates the already linked positions.

Importing FBS orders
Uploading shipments for the last 7 days via /v3/posting/fbs/list. New orders are created in OpenCart linked to products by offer_id. Duplicates are not created — verification by the Ozon order number.

Syncing balances
Unloading the remaining related items on Ozon via /v1/product/import/stocks in packages of up to 100 items. Data from the relationship table (offer_id, fbs_sku) is used.

Comparison of reference books
OpenCart Stores , Ozon stores
OpenCart categories ↔️ Ozon category IDs (there is a default category)
OpenCart attributes, Ozon feature IDs
OpenCart manufacturers , Ozon brands
Warehouses (stores) ↔️ Ozon warehouse IDs

Pricing
Global margin: base/percentage/fixed mode and module_ozon_integration_price_markup value
Separate rules in the ozon_price_rules table (name, mode, value, on/off)

Manual and automatic synchronization
Buttons in the admin area: products, orders, leftovers
CRON by URL with secret token: products + orders + scheduled balances (interval 1-24 hours)

Statistics and logs
Counters of related products and orders, last synchronization time, errors in 7 days
ozon_sync_log with operation type, status, and message text

Pluginhub License
The key is linked to the store's domain. Checking when saving settings and via https://pluginhub.pro/api/license/check
Plugin ID: cmjyplrnh000gwfaudt09qwbp

Project structure

upload/ — OpenCart 3.x (admin + system/library/ozon_integration)
releases/ozon-integration-opencart-2.3/ — OpenCart 2.3 (template .tpl)
releases/ozon-integration-opencart-4.x/ — OpenCart 4.x (extension/pluginhub/ozon_integration)
install.xml — OCMOD description (optional menu item in the admin area)

Database tables

ozon_products — link product_id, offer_id, fbs_sku, fbo_sku, status
ozon_orders — link order_id, order and shipment number Ozon, status
ozon_sync_log — synchronization log
ozon_category_map, ozon_attribute_map, ozon_manufacturer_map
ozon_store_map, ozon_warehouse_map
ozon_price_rules — pricing rules

When deleting the module, the tables are not deleted by default (the data is saved for reinstallation).

Documentation

A brief overview: README.md (this file)
Installation and configuration: INSTALL.md

Requirements

OpenCart 2.3.x, 3.x or 4.x
PHP with cURL extension
HTTPS on the website (for Ozon access to product images)
Client ID and API Key from the Ozon seller's account (Settings → Seller API)
Valid Pluginhub license for the store's domain

Recommended starting order

1. Install the module and specify the license, Client ID and API Key
2. Fill in the category mapping (at least for the main ones)
3. Synchronize the products
4. Check the connections on the "Products" tab (offer_id, fbs_sku)
5. Synchronize your leftovers
6. Import FBS orders
7. Enable CRON and auto-sync if necessary.

The detailed steps are in INSTALL.md .