Integration with Rozetka
Marketplaces help a store receive additional sales without creating a separate website. The seller lists products on the platform, while the marketplace shows them to potential buyers, accepts orders, and provides promotion tools. For this, the marketplace charges a commission and placement fee according to its terms.
Torgsoft supports synchronization with the marketplaces Prom.ua and Rozetka.com.ua. Integration with Rozetka helps transfer product data from Torgsoft without manually creating price lists. This reduces manual work and helps update sales information for the marketplace faster.
This article describes the action plan for integrating Torgsoft with Rozetka and provides detailed instructions for the technical specialist who will configure the synchronization.
The business owner should review the sequence of steps, register on Rozetka as a seller, and complete the settings described below in the instructions.
How to start selling on Rozetka
To sell on Rozetka and synchronize Torgsoft with the marketplace:
Instructions for setting up Torgsoft integration with Rozetka
1. Introduction to the “Integration with Rozetka.com.ua” option
2. How to sell on Rozetka
3. Introduction to the Rozetka Help Center
4. How to register a store on Rozetka
4.1. Why you do not need to specify the XML file link at the beginning
4.2. Requesting access to the seller account on Rozetka
4.3. Why it is important to get access to the seller account on Rozetka
5. How to prepare a price list for Rozetka
5.1. Setting up the synchronization object in Torgsoft
5.2. Creating a price list for Rozetka in Torgsoft
5.3. How to describe products for Rozetka in Torgsoft
5.3.1. Product photos
5.3.2. Setting up product types
5.3.3. Selecting and setting up the product group
5.3.4. Linking categories with Rozetka
5.3.5. Bulk selection of the product manufacturer
5.3.6. Filling in product information for Rozetka
5.3.7. Filling in additional product characteristics for the marketplace
5.3.8. Working with basic product characteristics for “Rozetka”
5.3.9. Filling in identical characteristics for all products in a category
5.3.10. Product description
5.3.11. Analysis of the synchronization file
5.4. Creating a link to the price list for Rozetka
6. Adding and selling products on Rozetka
7. Limitations and requirements for working with the “Integration with Rozetka.ua” additional option
1. Introduction to the “Integration with Rozetka.com.ua” option
The additional “Integration with Rozetka” option is a convenient tool for automating product accounting and processing orders on the Rozetka marketplace. The option allows you to prepare a price list (XML file) with a list of products and their characteristics in the format required by Rozetka.
After the price list is prepared, it can be uploaded manually, or automatic upload from the Torgsoft program can be configured. This will ensure regular updates of product information and stock balances, prices, and characteristics on Rozetka. Torgsoft also provides the ability to receive orders from the marketplace, so all work is carried out in a single information system.
The additional option is implemented based on the “Synchronization with an online store” feature, with the relevant differences and additions.
2. How to sell on Rozetka
1. Go to rozetka.com.ua and open the “Sell on Rozetka” section.
2. Fill in the application. Wait for a manager’s call to discuss the details of cooperation.
3. Provide all required documents and sign the agreement using an electronic digital signature.
4. Create an XML catalog of your products for publication on the marketplace. Requirements for the XML file and for product listing.
5. Start selling and receive payments from buyers in the way convenient for you.
3. Introduction to the Rozetka Help Center
Before submitting the application and signing the agreement, review Rozetka’s requirements and operating terms in the Rozetka Help Center. Pay attention to the “Sell on Rozetka” section, which contains all the information: from submitting an application to receiving the first customer order.
The Getting started section contains recommendations on how to register an account on the marketplace and prepare before submitting a partnership application:
The “Product categories and brands on Rozetka” section describes which products require additional certificates or permits for sale, and which products and brands are completely prohibited from being sold on “Rozetka”.
Sole proprietors of groups II–III, legal entities, or individuals can register as sellers on the marketplace; sole proprietors and legal entities need a bank certificate for an IBAN account, while an individual needs a passport, taxpayer registration number, and bank details.
4. How to register a store on Rozetka
To fill in and submit the application electronically, go to the «Sell on Rozetka» section and click the «Fill in the application» button.
If you use the Torgsoft program, then when filling in the application in the field «Are you ready to create/provide XML export in YML format», you can select «YES».
Leave the «Price list link» field empty. The link to the price list in the form of an XML file will be created in Torgsoft later.
4.1. Why you can omit the link to the XML file at the beginning
After reviewing the application, Rozetka managers will contact you to clarify the details. At the stage of agreeing on the contract terms, you need to inform the Rozetka manager that you plan to use the API to generate an XML file that meets Rozetka requirements.
Torgsoft generates an XML feed in the format used to transfer products to ROZETKA. The API can be used for separate integration scenarios, including working with orders and other data, if this is supported by the current version of the integration.
To work with the «Rozetka» API, you need a login and password to access the seller account. The login and password are issued by service managers at the time of signing the cooperation agreement, after the preparatory procedures have been completed. The decision on cooperation is made by «Rozetka» individually for each client.
4.2. Requesting access to the seller account on Rozetka
Ask the manager for the login and password for the seller account in order to create a price list using the API and provide the Rozetka manager with a link to your XML file for moderation and successful signing of the agreement.
4.3. Why it is important to get access to the seller account on Rozetka
The Torgsoft marketplace program will help prepare an XML file (price list) in the correct format according to the XML file requirements of Rozetka.
Using the Torgsoft «Rozetka Marketplace Setup Wizard» mode, you will create the required XML file. This mode requires personal data from the Rozetka seller account so that the necessary data can be pulled via the API:
This way, you will save significant time if these parameters are pulled into Torgsoft automatically. You will not have to search for them on the service yourself or manually enter categories, characteristics for each product, and manufacturers.
If it is not possible to obtain data from the «Rozetka» seller account to create the XML file (for example, if the Rozetka manager refuses for service-related subjective reasons), then the file can be prepared independently using the Torgsoft «Rozetka Marketplace Setup Wizard» mode. But you will have to manually create categories, characteristics, and manufacturers in Torgsoft in the same way as on Rozetka.com.ua according to the XML file requirements.
For your store, the Rozetka manager may set requirements for the number of unique product items in the price list that must be submitted for moderation. The requirements for the number of unique product items are individual for each potential seller of the Rozetka service and depend on the store specifics and product assortment. And for those for whom the required number of unique products is too large, data from the seller account is needed to prepare the XML file, because the number of unique products in the price list for moderation may equal the number of all products that will first have to be published on Rozetka.
If you have obtained access to the seller account, then the list of available characteristics can be obtained in the «Product management» section or by loading it through the «Rozetka Marketplace Setup Wizard» mode in Torgsoft.
If there is no access to the seller account, then the characteristics will have to be searched for among similar products on the Rozetka website.
The recommendations in this section are based on the experience of communication between Torgsoft specialists and Rozetka managers, so that you can quickly and with minimal effort prepare a price list for Rozetka.
5. How to prepare a price list for Rozetka
How to prepare a link to the price list (XML file):
5.1. Setting up the synchronization object in Torgsoft
Setting up the synchronization object is the first setting with the necessary parameters for successful connection with Rozetka.
After activating the additional «Integration with Rozetka» function, you need to:
The «General» tab
The «Synchronization object» form has a «General» tab with fields that need to be partially filled in:
To add a new address, click the «Add» button. In the «Name» field, enter any name for the address. The name can be anything, because it is not connected with the FTP server settings and is used only in the Torgsoft marketplace program. Then enter the FTP server settings. Important: in the «FTP address» field, you must specify the FTP server address without the characters - ftp:\\.
Note: if the photo catalog is located on your local computer with an FTP server, then for the product photo to have a public link, a link to the FTP server alone is not enough. You need to configure the web server to work together with the FTP server to provide access to each photo via the internet.
It is convenient to upload photos to hosting into a catalog of an existing website, with «Read only» access to the catalog (755).
Thanks to the «Photo delivery address» field, the Torgsoft program forms the public link address by combining the link prefix and the product photo file name. Example: https: //mysite.ua/photo-catalog/rozetka/ + krossovki-mida-36-r-chernyj.jpg
This link will be written to the price list for each product to upload photos to Rozetka. When reading data from the XML file, Rozetka will process the public links to photos and upload photos to each product card on the marketplace.
The presence of public photo links for each product is a mandatory Rozetka requirement.
On the «Accounting centers» tab, tick the accounting centers from which products will be synchronized with Rozetka. Additional fields of the «Accounting centers» tab:
On the «Synchronization time» tab, specify the time for automatic synchronization between the Torgsoft program and Rozetka.
To create a new automatic synchronization task, click «Add». In the «Synchronization time» window, first select the parameter - the automatic synchronization executor - the application server or the Torgsoft program. The application server is an additional component of the Torgsoft program that is responsible for performing automatic tasks.
If you selected the Torgsoft program, next fill in the «Computer\User name» field. This field can be filled in automatically by clicking the «Get» button. The field will contain the name of the computer and the Windows OS user, separated by «\», under which the Torgsoft program is running.
In the «Time» field, specify the time for automatic synchronization. To execute the task, be sure to enable the «Active» switch and click «Save».
Important! Automatic synchronization occurs only if Torgsoft is running.
You can also set the synchronization period on the «Synchronization time» tab. When you click the «Create synchronization interval» button, a window will appear where you also need to fill in the «Start time», «Interval», and «End time» fields and click «Save».
Important! On its side, Rozetka processes the XML file (price list) hourly. This means that data on Rozetka cannot be updated more often than once per hour. We recommend taking this marketplace data update interval into account when setting the synchronization interval in Torgsoft.
After setting up the «Rozetka Marketplace Setup Wizard» mode, automatically created dynamic characteristics will be displayed on the «Synchronization files» tab. These values in Torgsoft are assigned to Rozetka fields according to the XML file requirements. Dynamic characteristics and their values will fill the XML file (price list) - TSGoods.xml, which is automatically created by the Torgsoft program.
By default, this form contains 6 fields, which will be supplemented with new parameters as product characteristics are filled in. If you accidentally deleted one or more default records, use the «Add all fields to the synchronization file» button.
You can synchronize any available product card field or any dynamic characteristic with Rozetka. It is important to perform these actions in the «Rozetka Marketplace Setup Wizard» mode. To manually add a new synchronization field, click «Add». In the «Product synchronization file field» window, select «Data type» and specify the value of the «Column name» field.
If the «Data type» field value «Dynamic characteristic» is selected, in addition to the «Column name» field, select the name of this characteristic in the «Product dynamic characteristic» field.
Important: when manually adding fields on the «Synchronization files» tab in the synchronization object settings, correctly specify the value of the «Column name» field. This value must be exactly the same as the name of the product group characteristic in Rozetka.
5.2. Creating a price list for Rozetka in Torgsoft
The Rozetka Marketplace Setup Wizard» will help prepare, fill in, and create an XML file. Although, according to the information in the Preparing a product price list section, the Rozetka service does not cooperate with third-party resources that offer price list preparation services, Torgsoft will prepare and create the price list according to the XML file requirements.
In addition to the requirements for the XML file structure, which are met in Torgsoft, the products in the price list must also comply with the product card design requirements:
All product parameters: name, description, manufacturer, price, availability, characteristics, and photos must strictly comply with the criteria of «Rozetka». Otherwise, the XML file will not pass validation.
Even after signing the agreement with «Rozetka», approving the price list, and the first synchronization with the marketplace, the product card must comply with «Rozetka» requirements. Otherwise, «problematic» items will be hidden on the website. Therefore, follow the requirements (except for working with XML tags, because this is already taken into account in Torgsoft when creating the XML file).
Before creating a price list using Torgsoft, determine the correct final categories on Rozetka where you plan to publish the products. How to do this correctly is described in the Rozetka marketplace help center in the Selecting the correct categories section.
Filling in products and creating the XML file (price list) is done in the «Rozetka Marketplace Setup Wizard» in Torgsoft. To work with the «Rozetka Marketplace Setup Wizard» mode, go to the «Warehouse» menu item and select the «Synchronization with Online Store» form. Click «Rozetka Marketplace Setup Wizard» (the icon with the «Rozetka» logo).
Let’s take a closer look at the «Rozetka Marketplace Setup Wizard» form.
Save Rozetka database - the action is available if you have access to the Rozetka seller account and the «Username» and «Password» fields are filled in the synchronization object settings. This action saves the Rozetka database to the Torgsoft database, namely information about:
The process of loading information from «Rozetka» into Torgsoft takes a long time, so load the database only after significant changes appear in Rozetka.
Recreate synchronization file fields - the action recreates the required fields for uploading to Rozetka according to the filled-in category characteristics. This is relevant if, in the synchronization object settings on the «Synchronization files» tab, a field that is automatically created when filling in a product category characteristic was manually deleted.
Analyze synchronization file - the action analyzes the price list for completion of the «Name», «Manufacturer», «Category», «Price», and «Discounted price» fields.
Change synchronization object settings - the action opens the «Synchronization object» form to change the synchronization settings.
The Working with products tab is intended for working with product types; filling in the category, name, manufacturer, description, and characteristics of exported products.
The Synchronization file analysis tab displays errors after analyzing the price list that need to be corrected.
5.3. How to describe products for Rozetka
Step 1. Product photos
Having product photos is the first and mandatory condition before you start filling in product information for uploading to the Rozetka marketplace. According to the product photo requirements, the product card must contain at least one photo, with a maximum of 15.
Step 2. Setting up product types
The setup wizard workspace is «Product types participating in synchronization».
Define which product types in Torgsoft will participate in synchronization with Rozetka. If necessary, rebuild the product type tree in the program so that one product type corresponds to one final category on the marketplace.
Please note: if products are already synchronized with your online store, changing product types will affect how products are displayed in the online store.
Step 3. Selecting and setting up the product group
In the synchronization object settings, select the Product group whose products need to be uploaded. If you need to upload absolutely all products from Torgsoft, do not select a product group.
To create a product group for Rozetka, use only the following tabs:
Nuance: the «Manufacturer», «Season», «Supplier», and «Plus products (services)» tabs for including products that do not belong to the selected product type will not affect the product group for the Rozetka marketplace in any way.
In our example, in the product group that we export to the marketplace, the product type is «Trade equipment».
Step 4. Linking categories with Rozetka
Next, each product type needs to be linked to the final category on «Rozetka». This can be done in two ways: «Link product type to Rozetka product category» or «Link product type and all subordinate product types to Rozetka product category».
If there is no access to the Rozetka seller account
Without access to the «Rozetka» API, after selecting a product type (with or without subordinate subtypes) and clicking one of the category linking buttons, a window with an empty Rozetka category directory will appear. In this window, you can manually create a category directory. However, we recommend creating final categories immediately.
To do this, click «Add», fill in the «Name» and «Identifier (ID)» fields, and click «Save». After manually creating the category, it must be selected and the binding to the product type must be confirmed.
Important! For correct product export to Rozetka, the category name and ID must be identical to the category name and ID on «Rozetka». The correct category names and their IDs are described in the «Selecting the correct categories» section on the «Rozetka» website.
After receiving API access and running the «Save Rozetka database» action on the main setup wizard form, the manually created categories will automatically be replaced with «Rozetka» categories if they exist.
If there is access to the Rozetka seller account
If you have API access and the «Save Rozetka database» action has been successfully completed, the Rozetka category directory will appear in Torgsoft. You will only need to select the final «Rozetka» category in which the product will be published.
After linking each Rozetka category with each product type in Torgsoft, we will get the following:
If you made a mistake and linked an incorrect category, use one of the two actions: «Unlink product type from Rozetka product category» or «Unlink product type and all subordinate product types from Rozetka product category». After that, link the correct category.
Step 5. Bulk selection of the product manufacturer
Products of a certain product type and its subtypes can be assigned a common manufacturer in bulk using the actions «Set manufacturer for all products of the product type» or «Set manufacturer for all products of the product type including subordinate product types».
If you have API access and the «Save Rozetka database» action has been successfully completed, the Manufacturer field can be filled in bulk with an existing manufacturer from «Rozetka».
Step 6. Filling in product information for Rozetka
After linking each product type to a category on Rozetka, proceed to filling in product data in the «Products participating in synchronization» form.
Fields in the «Products participating in synchronization» form:
Important: after adding new products to the «Products participating in synchronization» tab, for example, after receiving new goods, you need to link the product type to the category again so that the category value is filled in for the new products.
In the «Products participating in synchronization» form, you will also be able to:
Step 7. Filling in additional product characteristics for the marketplace
The setup wizard workspace is «Category parameters».
This form is intended for filling in distinctive properties and features of the product for export.
If API access is available, after linking the product type to the Rozetka category, the «Category parameters» table will automatically be filled with all available characteristics of the «Rozetka» category. Automatic filling is possible only if there are products in the «Products participating in synchronization» form.
An incomplete example of the list of characteristics for the «Label printers» category on Rozetka, which were automatically pulled into the Torgsoft program using the API:
When you hover the mouse cursor over the «question mark» on the right side, a tooltip will appear explaining how to fill in the required category parameter.
Without API access, the «Category parameters» table will be empty, and all characteristic names will have to be filled in manually after first finding the parameters in one or several products on «Rozetka» in the corresponding category.
Step 8. Working with basic product characteristics for «Rozetka»
Rozetka has basic characteristics that participate in the product search filter. If you do not fill in the basic product characteristics, the user will not find your product on «Rozetka» when searching with marketplace filters. The minimum number of characteristics for a product is 3. The characteristics must match the photo, description, and name, and it is advisable to fill in logistics parameters for correct delivery calculation.
If API access is available, basic characteristics in the «Category parameters» table are highlighted in red.
Without API access, the main characteristics will have to be found independently on the marketplace, created manually in the «Category parameters» form, and filled with values.
To create a basic characteristic parameter without API access in the «Category parameters» form, you need to do one of the following:
The category parameter name must be identical to the name of the current characteristic on Rozetka. The characteristics you create in Torgsoft will be linked to the current ones on «Rozetka». If the product characteristic does not exist on «Rozetka», it must be added to the text description of the product. You cannot create your own unique characteristic on «Rozetka» if it is not provided by the service.
Step 9. Filling in identical characteristics for all products in a category
Product characteristics may repeat. If you need to fill in the same characteristic value for all products in a category, then with or without API access, use the following actions in the «Category parameters» area.
Without API access, use one of the two actions «Create and/or define a parameter for all products of the specified product type» or «Create and/or define a parameter for all products of the specified type and all subordinate product types» to create this characteristic before filling it in.
In the «Product category parameter» window, select the parameter name and specify the value for this parameter. After clicking the «Save» button, the selected characteristic value will be filled in for all products of the product type that is selected in the product type tree. If the product type contains subtypes, the value will also be filled in for all subordinate product types.
Step 10. Product description
The setup wizard workspace is «Product description».
After filling in the characteristics, the only thing left to fill in for each product is its description according to the product description requirements. The «Product description» area provides standard components for editing HTML text.
Important! After every change made in the «Product description» field, click «Save».
Step 11. Synchronization file analysis
After you have filled in all parameters, fields, and required product information in Torgsoft for Rozetka, you need to «Analyze the synchronization file».
The Torgsoft program will open the «Synchronization file analysis» tab, analyze the price list, and notify you if:
If there are remarks, they must be corrected so that the XML file can later pass moderation on the marketplace. From the «Synchronization file analysis» form, you can immediately «go to the product» with the remark and correct the errors.
If all information is filled in in the «Rozetka Marketplace Setup Wizard» and the «Synchronization file analysis» contains no errors, proceed to uploading the XML file (price list) to the FTP server, creating a public link, and sending the price list link to the Rozetka manager for file moderation.
5.4. Creating a link to the price list for Rozetka
To send a link to the XML file, it must be uploaded to the FTP server specified in the synchronization object settings. The photos of all products included in the price list will be uploaded to the FTP server.
First, export the data manually in the «Synchronization with online store» form in Torgsoft. It is advisable to run automatic synchronization only after the XML file link has been sent to the manager and the price list has successfully passed moderation on «Rozetka».
To perform synchronization manually, go to the «Synchronization with online store» form in Torgsoft and click «Select all photos». This action will mark all product photos for export with the price list. Then click «Run synchronization».
The «Run synchronization» action exports all product photos and the price list to the specified FTP server. Please note that on the «Synchronization products» tab, the product list may differ from the one that will be exported to Rozetka. This may be because only products with photos are available in the setup wizard, and products added to the product group through the «Plus products and services» tab are absent.
The «Synchronization log» tab will display data about successful synchronization.
After successful data export, check access to the XML file via the link. To do this, in the browser, the link https: //mysite.ua/catalog/rozetka/TSGoods.xml should display product information from the XML file.
Before sending the price list link to the manager for moderation, perform XML file validation using the special Rozetka marketplace tool. After receiving information about successful validation, call the Rozetka manager and provide the link to your price list.
The logical completion of this process — signing the agreement with «Rozetka» and starting sales on the marketplace.
6. Adding and selling products on Rozetka
After signing the agreement with «Rozetka», you may need to add new products or update the parameters of existing products on Rozetka. Do all this using the «Rozetka Marketplace Setup Wizard» mode.
Review the requirements for adding new products and requirements for updating existing products before adding or updating products in the price list.
We have reviewed the requirements and can highlight the following:
Torgsoft automatically updates the TSGoods.xml price list file with information about product prices and availability on the FTP server. To do this, do not forget to configure «Synchronization time» in Torgsoft in the synchronization object. Manual synchronization is needed only during the first price list export and when changing its content: adding and updating products.
Please note that the XML file link address must not change. This is described in the XML file requirements. If the file address or directory has changed, provide the Rozetka manager with the new data.
Rozetka is in one way or another responsible for the compliance of sellers and their products on its website. Therefore, before starting cooperation, review Rozetka’s requirements for working with orders and product delivery:
It is advisable to manage orders and customers either only in Torgsoft or only on the Rozetka marketplace to maintain current product availability in the program and, accordingly, on «Rozetka». To work with Rozetka orders in Torgsoft, use the «Trade with invoicing» mode.
The additional «Integration with Nova Poshta» and «Integration with Ukrposhta» functions will help automate work with delivery services. In Torgsoft, in the «Trade with invoicing» mode, create and print consignment notes for issued invoices, track parcel status, and send the consignment note number to the customer using the «Bulk customer messaging» function.
7. Limitations and requirements for working with the additional «Integration with Rozetka.ua» function
The limitations include the following points:
Torgsoft requirements include only the presence of SQL Server 2008 or higher, on which the Torgsoft database will run with the compatibility level in the SQL Server database properties set to 100 or higher.
Connect the integration with Rozetka — Torgsoft will help automate product uploads, price and stock updates, and order processing in a single system.
Go back to the previous step