Integration with Wildberries
This add-on is part of our Subscription plan.
Subscribe once, and enjoy all add-ons without limits.
The add-on connects CS-Cart with Wildberries and keeps sales in sync: it uploads products, updates prices and stocks, transfers images, and helps you map categories and features.
What it is for
- send products to Wildberries from the CS-Cart catalog quickly;
- keep prices, discounts, and stocks up to date;
- match WB categories, features, and warehouses;
- monitor uploads through notifications and the error log.
Key features
- product card uploads to Wildberries;
- synchronization of prices, discounts, images, and stock levels;
- matching WB categories to CS-Cart categories;
- matching WB features to CS-Cart features;
- warehouse mapping and stock transfer per warehouse;
- separate settings for brand, barcode, weight, dimensions, VAT, and price without discount.
How it works
1. You set the API key and mappings in the admin panel.
2. The add-on collects product data from CS-Cart and sends it to Wildberries.
3. Later updates can synchronize price, stock, and images.
4. For bulk updates, the mapping tables and cron are available for automatic price and stock uploads.
Have questions about the add-on?
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Owners
- English
- Русский
- 4.18.X
- 4.17.X
- 4.16.X
Instructions for Integration with Wildberries
What the add-on does
The add-on connects CS-Cart with Wildberries and lets you:
- upload product cards to WB;
- update prices, discounts, stock levels, and images;
- match categories and features;
- configure warehouses, VAT, brand, barcode, weight, and dimensions;
- run automatic price and stock updates by cron;
- receive upload notifications and review the error log.
Where to find the add-on
In the admin panel, open Synchronization data and choose the provider MS: Integration with Wildberries.
The following tabs are available there:
- General,
- Categories,
- Features,
- Pricing,
- Warehouses,
- Images.
The add-on also has a separate block on the product page, in the detailed content section.
General settings
The General tab contains the main options:
- API key. The add-on will not send data to Wildberries without it.
- Main storefront. This field is shown in multi-storefront mode and lets you choose which storefront settings will be used.
- Upload only new ones to WB. If enabled, previously uploaded products will not be updated again.
- Display notifications about the status of the upload. Shows success and error messages.
- Password for cron. Used in the scheduler command.
- Width and Height. Set the image size sent to WB.
The tab also shows a ready-made cron command for automatic price and stock updates. It works for products with Upload to WB enabled.
Categories
In the Categories tab:
1. Click Update categories.
2. Wait for the WB category tree to load.
3. Match CS-Cart categories with the required Wildberries categories.
4. Save the changes.
If a matched WB category no longer exists, the add-on shows a warning.
Features
In the Features tab:
1. Click Update features.
2. Match WB features with CS-Cart features.
3. For some fields, choose separate data sources:
- Brand,
- Barcode,
- Product dimensions (LxWxH),
- Millimeters in a given unit of dimensions,
- Weight with packaging,
- Grams in a given unit of weight.
4. Save the settings.
If a CS-Cart feature used in a mapping no longer exists, the add-on shows a warning.
Pricing
In the Pricing tab you can set:
- price from a user group;
- allowance in percent;
- the behavior for price without discount;
- the tax sent to WB, including the 22% option.
This tab also controls how the price without discount is sent when it is needed for the WB card.
Warehouses
In the Warehouses tab:
1. Click Update warehouses.
2. Enable Send amount if you need stock data to be sent.
3. Match CS-Cart warehouses with WB warehouses.
4. For the row By default (take from field 'in Amount'), select the WB warehouse if stock should be taken from the product total amount.
If the CS-Cart Warehouses add-on is enabled, stock can be sent with warehouse splitting taken into account.
Images
The Images tab sets the image size sent to WB. For correct uploads, use values not lower than the add-on recommendations.
Working with a product
In the product page, inside the MS: Integration with Wildberries block:
- enable Upload to WB;
- click Update if needed.
After saving, the add-on sends the product data to WB and can then update the price, images, and stock levels.
How to check the result
1. Enter the API key.
2. Update categories, features, and warehouses.
3. Configure the mappings.
4. Enable WB upload on the product card.
5. Save the product or press the update button.
6. Check the result notification and the error log entry, if one appears.
7. For background synchronization, run cron and review the provider's last sync block.
If something is not uploaded
Check:
- whether the API key is filled in;
- whether the WB category is matched;
- whether the needed features are selected;
- whether brand and barcode are set if the WB category requires them;
- whether warehouses are configured and stock transfer is enabled;
- whether the upload log contains errors.
Change history
v1.15.3 from 2026-04-27
[!] Weight transfer logic was changed
[+] Added VAT 22%
v1.15.2 from 2025-06-02
[*] Weight transfer in the API was changed
v1.15.1 from 2025-04-11
[*] Domains for some API methods were changed
v1.15.0 from 2025-03-10
[!] A warehouse could not be matched with a WB warehouse by default, fixed
[!] For checkbox features, the feature name is used
[!] For multiple features, the first selected variant is sent to WB
v1.14.0 from 2025-02-24
[!] The outdated API access domain was removed
v1.13.1 from 2024-09-18
[!] Categories were not shown during WB synchronization, fixed
v1.13.0 from 2024-09-17
[+] Warehouses add-on support
[+] Ability to match WB warehouses with CS-Cart warehouses
v1.12.0 from 2024-07-29
[+] Added a setting for selecting the main storefront, after setting it will be available in "All storefronts" mode when editing products
[*] Cron link was fixed
v1.11.0 from 2024-04-26
[+] Batch sending for stock and price updates in WB during cron was added
[*] The product limit in cron selection was reduced
v1.10.0 from 2024-03-15
[+] Updated image and price upload API
[+] Product names are now truncated if they exceed 60 characters
[+] Delayed upload of images, prices, and stock when creating a product in WB
[+] If a product has no images during cron, they are pulled automatically
v1.9.5 from 2024-02-20
[!] The discounted price was calculated incorrectly, fixed
v1.9.4 from 2024-02-12
[*] Visual display of storefront ID in cron
[*] The picker on the category mapping page now shows only the full path
[!] On the category mapping page, the picker did not load additional data while scrolling, fixed
v1.9.3 from 2024-02-11
[*] Alphabetical sorting in the picker
v1.9.2 from 2024-02-11
[!] Field clearing was removed from the picker
v1.9.1 from 2024-02-06
[*] Default values were set for new settings
v1.9.0 from 2024-02-06
[+] Secondary price and discount upload, including through cron
[+] company_id parameter was added to cron for storefront-based uploads
v1.8.0 from 2024-01-30
[+] Brand is now taken from a separate mapped field
[+] Notification about successful uploads and uploads with errors
v1.7.1 from 2024-01-29
[+] Module standardization
[!] If a barcode feature with variants was selected, the selected value was not used, only the raw value, fixed
[!] If dimensions were not selected, notices were triggered during upload, fixed
[!] Main dimensions are converted from mm to cm
v1.7.0 from 2024-01-12
[+] Error log when creating or editing a product
[+] Show the last update date and the number of uploaded prices and stocks in cron
v1.6.0 from 2024-01-11
[+] The module was adapted to the new WB API version
v1.5.1 from 2024-01-09
[!] Converting the HTML space character caused the character to be removed, fixed
v1.5.0 from 2024-01-09
[+] Conversion of HTML entities into characters in product descriptions
v1.4.0 from 2024-01-09
[+] Ability to specify image size for WB uploads
v1.3.1 from 2023-12-25
[+] Floating-point dimensions are rounded up
[!] Weight was transferred incorrectly when converted to a fractional value, fixed
v1.3.0 from 2023-12-21
[+] Export of dimensions and weight in the selected WB feature units
v1.2.1 from 2023-12-20
[!] Bulk product editing did not trigger WB upload, fixed
v1.2.0 from 2023-12-07
[+] Added cron for price and stock uploads to WB when the product option "Upload to WB" is enabled
[+] Separate settings were added for exporting dimensions and weight to WB
[+] A tab was added for choosing a warehouse in WB and then exporting stock levels
[!] Uploading a product through the "Update product in WB" button affected the "Upload only new ones to WB" setting, fixed
[*] The logic for updating categories and features from WB was changed
[+] A warning is shown if the previously selected category or feature is missing
[!] AJAX refresh was removed when returning to the same Categories or Features tab
[*] In the Features tab, some feature choices were excluded because they are filled by default
[*] The "Weight" feature was renamed to "Weight with packaging"
v1.1.0 from 2023-11-30
[+] Added a method for uploading price when updating a product in WB
[!] It was not possible to expand subcategories on the Categories tab and match them, fixed
v1.0.0 from 2023-11-29
[+] First release
Legend:
[+] Added
[-] Removed
[*] Changed
[!] Bug fix
Here you can share your opinion and evaluate our work.
Your feedback helps us become better and offer you even better service.