Integration with Yandex Market

What this solution does

The module provides integration between a 1C-Bitrix website and the Yandex Market marketplace via API. It enables automated export of product catalogs, prices, and stock levels, as well as order import, with setup achievable within 10 minutes. Synchronization processes and order management reduce operational costs.

Features include exporting all product fields and attributes to Yandex Market with optional configuration for each item. The solution supports testing the export of individual products and batch exporting all eligible items via a background agent or Cron scheduler.

This module provides integration with Yandex Market for automated data exchange. It supports exporting product prices and stock levels, as well as importing orders. Each data type can be tested manually via a dedicated test mode or processed automatically for all eligible records using background agents or a Cron scheduler. When handling orders, the system allows mapping status codes between the website and the marketplace.

The architecture supports an unlimited number of Yandex Market profiles, enabling distinct configuration settings for each. It is designed to operate with any number of stores simultaneously. All export and import operations, along with any errors encountered, are logged in the exchange journal for review. A versatile filter is included to precisely define conditions for exporting products, prices, and stock levels.

The module ensures high fault tolerance during data exchange with Yandex Market. The system automatically attempts to handle incorrect data and failures occurring on both the 1C-Bitrix platform and the marketplace side. If an issue cannot be resolved automatically, it is logged in the Exchange Journal, and the module continues operating without interruption.

The module includes event handlers that allow programmatic override of data during the export of products, prices, and stock levels, as well as during order imports. A complete list of events with code examples is provided in the technical documentation.

The demo version is provided without restrictions. Installation does not require creating additional site templates, does not modify existing site or 1C-Bitrix core settings, and eliminates the risk of disrupting site functionality.

Basic configuration for exporting products, prices, and stock levels involves three steps:

1. In the Main Settings section, enter data for connecting to the Yandex Market API and configure the mapping of main product fields.

2. In the Category Link Management section, map site categories to Yandex Market categories, then activate the necessary links for subsequent export (steps 5 and 6).

3. In the Characteristic Link Management section, map site characteristics to the characteristics of Yandex Market categories.

In the Characteristic Value Mapping section, map your catalog parameters to the 'list' or 'dictionary' type used for category characteristics in Yandex Market.

Use the Export Test section to verify the correctness of product, price, and stock data transfer to Yandex Market.

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

Basic order import configuration algorithm:

In General Settings, enter the credentials for connecting to the Yandex Market 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 Yandex Market.

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

Important:

To ensure successful data export to Yandex Market, you must pre-configure links for all mandatory fields (such as article number, dimensions, etc.) and mandatory attributes within the relevant categories. If even one required field or attribute is missing for linked categories, product information in those categories will fail to update in Yandex Market.

In the Bitrix information block settings, properties must have their technical codes defined, not just their display names.

Operational notes:

Export of products, prices, stock levels, and import of orders are available by default via Bitrix agents. These tasks require activation and allow for scheduling adjustments; however, setting the frequency too high is not recommended. It is strongly advised to configure export and import tasks using Cron instead of agents. When using agents, data is processed incrementally with each run to minimize server load and prevent site slowdowns. When using Cron, the system performs a complete processing of all required data.

A number in parentheses within the Agent function specifies the profile ID for which the agent is configured. If no number is present, the agent applies to profile ID 1.

It is highly recommended to schedule all export operations using Cron. After migrating scripts to Cron, disable the corresponding module agents if they were previously active. Script paths may vary depending on your server configuration; verify exact paths with your system administrator or hosting support.

Example paths for profile ID 1:

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

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

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

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

Note: For profiles with an ID other than 1, you must pass the profile_id argument. For example, to schedule product export for profile ID 2, the script path should be: /public_html/bitrix/tools/guryev.ym/cron/export_products.php profile_id:2

Event handlers:

The module provides developers with a set of event handlers to customize data exchange with Yandex Market. Examples for the init.php file demonstrate how to override parameters during export and import operations.

To modify product data (name, VAT, characteristics, etc.), use the OnExportProduct event. Price adjustments are handled via OnExportPrice, while stock levels are managed through OnExportStock. Order imports from the platform trigger the OnImportOrder handler.

Critical limitation: In the OnExportProduct, OnExportPrice, and OnExportStock handlers, implementing custom filtering or product exclusion logic is prohibited. Doing so may result in a complete failure to export data. Only value overriding is permitted.

The following example shows a class with handler implementations for init.php. Ensure these methods are registered using the AddEventHandler function.

The Yandex Market integration module includes hooks for automatic data adjustment prior to export. The product export function increases the base price of each offer by 100 units. The price export function processes data by campaign or for the entire personal account, adding 200 units to the price. The stock export function is also provided for processing availability data.

The module provides integration with Yandex Market for the 1C-Bitrix platform. An API key obtained from the Yandex Market partner account is required for proper operation. When generating exports, data regarding sets and kits is not included.

For technical support, please provide the website address, administrator login and password, and FTP access parameters.

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