Integration with OZON: products, prices, stock levels, orders (flexible configuration)

What this solution does

The module provides integration between a 1C-Bitrix website and the Ozon marketplace via API. It enables automated export of products, prices, and stock levels, as well as import of orders. Synchronization can be configured within 10 minutes of installation.

The functionality includes exporting all product fields and attributes to Ozon with the option to configure each parameter individually. It supports testing the export of a specific product to verify data accuracy. Full export of available products is performed via background processes (Agent or Cron).

The module enables price and stock updates to Ozon, as well as order import from the marketplace. Prices and stock levels can be pushed for individual items via a test mode or for all eligible items automatically through a background agent or Cron scheduler. When multiple Ozon warehouses are configured, a specific warehouse can be selected for stock updates. Orders are imported either individually or in batches using the same automated mechanisms. The system allows mapping order statuses between the website and Ozon. It supports an unlimited number of integration profiles with distinct settings and works with any number of Ozon warehouses. All export, import operations and errors are recorded in the exchange log.

The multi-functional export filter allows flexible configuration of product, price, and stock data export to meet specific business requirements. The module features high fault tolerance: it automatically handles incorrect data and errors occurring in both the Bitrix system and on the Ozon side. If an issue cannot be resolved automatically, it is logged in the Exchange Journal, and the module continues operating without interruption.

Developers can programmatically override data during the export of products, prices, and stock, as well as during order import, by utilizing the module's event handlers. A complete list of events with code examples is provided in the technical documentation.

The demo period is provided without restrictions. Installation does not require creating additional site templates, does not modify user settings or Bitrix configuration, and poses no risk to the existing site functionality.

Basic setup for exporting products, prices, and stock involves two steps. First, in the Main Settings, specify the credentials for connecting to the Ozon API and configure the mapping of core product fields. Next, in the Category Relationship Management section, map your store categories to Ozon categories and activate the necessary links for subsequent data export.

In the Characteristic Link Management section, map your attributes to the parameters of the Ozon category.

In the Characteristic Value Link Management section, link your values to the dictionaries or lists used for category attributes in Ozon.

Use the Export Test module to verify the correctness of product, price, and stock data transfer to Ozon.

For mass export, activate the relevant agents (products, prices, stock) or schedule the export scripts via cron (script paths are provided in the documentation).

Basic order import configuration algorithm:

In General Settings, enter the credentials for connecting to the Ozon API and configure the mapping of main product fields.

In Order Settings, define the main order fields and, optionally, map the order statuses on your site to the statuses in Ozon.

For mass import, activate the order import agent or schedule the relevant import script via cron (script path is provided in the documentation).

To ensure successful data export to Ozon, you must preconfigure mappings for all mandatory fields (such as SKU, dimensions, etc.) and mandatory characteristics within the relevant categories. If even one required field or characteristic is missing for a linked category, product information in that category will fail to update in Ozon, affecting both fields and characteristics.

If a characteristic in Ozon is defined as a list of values (for example, 'Gender: Male, Female'), the corresponding property on your site must also be implemented as a list or reference table. You must create a mapping between the site property and the Ozon property in the 'Characteristic Mapping Management' section. Additionally, in the 'Characteristic Value Mapping Management' section, you must define the correspondence between specific values (for instance, mapping 'Female' from your site to 'Female' in Ozon). This is necessary because Ozon exports an internal identifier (ID) rather than a text string; therefore, correct export depends on properly configured value mappings.

In the Bitrix information block settings, properties used for integration must have codes defined. Relying solely on property names is insufficient.

By default, product, price, and stock export, as well as order import, are implemented via agents. These tasks must be activated. The execution frequency can be adjusted, but setting very short intervals is not recommended. It is strongly advised to configure export and import using Cron. When agents are used, data is processed incrementally each time the agent runs, which prevents site slowdowns for visitors. Configuring via Cron ensures complete and immediate processing of all required data.

If a number is specified in parentheses within the agent function name, it indicates the profile ID for which the agent is configured. If no number is present, the agent operates for profile ID 1.

The module provides automatic unit conversion during integration with OZON when a hint is specified for a property in the information block settings. For instance, if the site property 'Width' has a hint of 'mm' but the OZON category requires values in 'cm', the system will automatically convert the value. Supported unit types include dimensions (mm, cm, m), weight (g, kg, t), liquid volume (ml, l), and flow rate (l/s, l/min, l/h).

It is highly recommended to schedule all export and import operations using the Cron task scheduler. Once scripts are moved to Cron, deactivate the corresponding module agents if they were previously active. Script paths may vary depending on the server configuration; verify the correct paths with your system administrator or hosting technical support.

Example paths for a profile with ID 1:

Product export: /public_html/bitrix/tools/guryev.ozon/cron/export_products.php

Price export: /public_html/bitrix/tools/guryev.ozon/cron/export_prices.php

Stock export: /public_html/bitrix/tools/guryev.ozon/cron/export_stocks.php

Order import: /public_html/bitrix/tools/guryev.ozon/cron/import_orders.php

The module provides synchronization with the OZON marketplace, managing products, prices, stock levels, and orders with flexible configuration options.

Brand data is loaded via the script /public_html/bitrix/tools/guryev.ozon/cron/import_brands.php.

When configuring Cron tasks for profiles with an ID other than 1, the profile_id argument must be passed. For instance, to schedule product export for a profile with ID=2, the script path should be formatted as: /public_html/bitrix/tools/guryev.ozon/cron/export_products.php profile_id:2.

Developers can utilize event handlers to customize data before transmission. In the init.php file, it is possible to override values during the export of product information (name, VAT, attributes), prices, or stock levels by implementing the OnExportProduct, OnExportPrice, and OnExportStock hooks respectively.

The module provides flexible integration with the OZON marketplace for synchronizing products, prices, stock levels, and orders. Developers can override values during order import from Ozon by using the OnImportOrder event via AddEventHandler.

When implementing custom handlers for export operations (OnExportProduct, OnExportPrice, OnExportStock), creating custom filtering or product exclusion logic is strictly prohibited, as it may result in a complete failure of data export. Only value overriding is permitted to ensure successful data transmission.

An example class implementation for the init.php file demonstrates how to modify prices and stock levels within the data processing loop. It is essential to register this class with the system using AddEventHandler.

The module exports products, prices, and stock, and imports orders from OZON with flexible configuration. Operation requires an ID and API key obtained from the OZON partner personal account. The export includes only simple products and their SKUs that are linked to catalog sections. Sets and bundles are excluded from the process. For technical support, provide the website address, administrator login and password, and FTP access parameters.

The module provides integration with the OZON marketplace for synchronizing products, prices, stock levels, and orders. Exchange parameters can be configured flexibly to meet store requirements.

The module provides integration with the OZON marketplace for synchronizing products, prices, stock levels, and orders with flexible exchange parameter settings.

The module provides integration with the OZON platform for synchronizing products, prices, stock levels, and orders with flexible configuration options. The functionality allows setting data exchange rules between systems to align with business processes.

General iT can install and configure this module and check how it works on your website.