This add-on is part of our Subscription plan.
Subscribe once — enjoy all add-ons without limits.
Extended integration with retailCRM
The add-on connects CS-Cart and retailCRM into a single workflow and helps keep orders, customers, carts, callback requests, and one-click purchases in sync. It is useful when the store and CRM need to exchange data without manual transfer or gaps in accounting.
What it is for
The add-on is used to transfer orders from CS-Cart to retailCRM and back, synchronize customers and profile data, work with carts, callback requests, and one-click purchases, and map statuses, payments, shipping methods, and custom fields.
Key features
Two-way data exchange between the store and retailCRM.
Order export on creation, payment, and status change.
Order and change import from retailCRM.
Customer synchronization and duplicate protection.
Support for carts and one-click orders.
Payment, shipping, and custom field mapping.
Support for MEASoft, callback scenarios, and YML export.
Cron tasks for scheduled synchronization.
How it works
The add-on hooks into CS-Cart events and sends changes to retailCRM as the store works. For bulk exchange, it uses cron tasks and mapping settings, where import and export rules and links between store and CRM entities are defined.
Have questions about the add-on?
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Owners
- English
- Русский
- 4.20
- 4.19.X
- 4.18.X
- 4.17.X
- 4.16.X
- 4.15.X
Installation
Install the addon via «Administration» → «Add-ons» → «Manage add-ons». Find «MS: Extended RetailCRM Integration» and click «Install». After installation, the addon will appear in the sync data list.
Where settings are located
All addon settings are in «Administration» → «Sync data» → «MS: Extended RetailCRM Integration». The interface is organized in tabs: General, Orders, Warehouses, Import statuses, Export statuses, Payment methods, Shipping methods, User fields, Callback and one-click purchase, Cron.
Configuration — «General» tab
RetailCRM URL — enter the full URL of your RetailCRM account (e.g. https://your-store.retailcrm.ru/). You can copy it from the browser address bar when logged into RetailCRM.
API key — get the key in RetailCRM: «Settings» → «Integrations» → «API keys» → «Add key». Create a key with read and write permissions. Copy the key and paste it into the field.
Enable sync — check this to activate synchronization. Without it, no exchange occurs.
Export product external_id — enable if you need to export product external ID to RetailCRM.
Default currency — select the currency for amounts sent to RetailCRM.
Default site and Default warehouse — select from the list loaded from RetailCRM after entering URL and API key. These values are used when creating orders and products.
Configuration — «Orders» tab
Export orders from CS-Cart to RetailCRM — mode: disabled, create only, update only, full sync. When enabled, set the export mode: all orders, today only, from date, last N days.
Import orders from RetailCRM to CS-Cart — similar modes. When importing, new orders are created on the site; when updating, changes are synchronized.
In the «Order general settings» subsection configure: order type, method, URL field for order, add to comment (coupon, delivery address, shipping method), import notes and details, export changes.
Incomplete purchases — enable to export carts to RetailCRM. Specify the order method and status for such orders, and whether to add cart items to the comment.
In the «Individual» and «Legal entity» sections, map RetailCRM fields to CS-Cart profile fields (name, phone, email, address, etc.). In «Custom fields» map additional order fields.
Configuration — mapping tabs
Warehouses — map CS-Cart warehouses/PVZ to RetailCRM stores/warehouses.
Import statuses and Export statuses — map CS-Cart order statuses to RetailCRM statuses. Without mapping, orders may not sync correctly.
Payment methods and Shipping methods — map payment and shipping methods between systems.
User fields — map additional profile fields to RetailCRM fields.
Configuration — Callback and one-click purchase
Requires the «Callback» addon. Enable integration, choose the action on callback (create no order, create order, create order with products). Configure field mapping and, if needed, add products to comment on one-click purchase.
Configuration — «Cron» tab
Cron password — set a secret key (default ms_retailcrm). It is used to authorize cron requests.
After saving settings, cron links will appear for: import of order and customer history, export users, import users, import orders, export orders. Copy the required command and add it to crontab on the server (e.g. every 10 minutes: 10 * * * *).
Using the addon
After enabling sync and saving settings, synchronization runs automatically when orders are created or updated on the site, when customers register, and on payment. For bulk export or import, use cron tasks.
On the order edit page in CS-Cart admin, the RetailCRM order ID is shown (if the order was exported). Buttons are available to export product data to RetailCRM and import from RetailCRM to the site.
Verifying operation
1. Create a test order on the site — it should appear in RetailCRM under «Orders».
2. Create an order in RetailCRM — with import enabled, it should appear in CS-Cart.
3. Check logs: sync settings show the last export info (updated and skipped count). If there are errors, verify URL, API key, and status, payment, and shipping method mapping.
Common issues
Orders not exporting — ensure «Enable sync» is checked, order export is not disabled, and statuses and payment/shipping methods are mapped.
API error — ensure the URL has no extra characters, the API key is valid and has the required permissions.
Customer duplication — the addon searches customers by email and phone; with mismatched data, duplicates may be created. Check field mapping.
Change history
v2.3.0 from 2026-03-30
[*] Improved integration stability and background tasks
[*] Improved module update reliability and error handling
[*] Removed debug output from production flows
[!] Fixed checkout issues and customer profile handling with incomplete contact details
v2.2.0 from 2026-02-19
[*] Module template updated
v2.1.0 from 2026-01-28
[!] Fixed critical error in module file (StaticFunctions class code was replaced with controller code)
[!] Fixed error caused by missing store_locations module function
v2.0.0 from 2025-11-24
[*] Complete module overhaul
[*] Fixed user search by phone number for callback
[*] Fixed search and transfer of patronymic in order
[+] Added user export and import to RetailCrm
[*] Fixed warehouse/PVZ transfer in order
[+] Added order import settings and cron for order import
[+] Added order export settings and cron for order export
[+] Added RetailCrm order ID display on order edit page, plus buttons for product data export to RetailCrm and import from it
[!] Fixed error when navigating to sync settings
[!] Fixed error when retrieving retailcrm_id from database
[!] Fixed error when discount exceeded total cost and incorrectly adjusted prices
v1.14.2 from 2024-01-11
[*] Improved utm tags transfer when creating order
[!] Fixed error after module installation (module class not found)
v1.14.1 from 2023-12-25
[*] Changed cron link
[+] Added utm tags transfer in order via module setting
[!] Fixed error when generating Yandex.Market price list file (external_id was searched in products table)
v1.14.0 from 2023-10-30
[+] Added shipping cost transfer from «Exclude shipping cost from order» module
v1.13.2 from 2023-09-23
[+] Added customer TIN (INN) transfer in order
v1.13.1 from 2023-09-18
[*] MEASoft: shipping cost transfer to order comment, applies only to 5post
v1.13.0 from 2023-09-11
[+] MEASoft: shipping cost transfer to order comment
v1.12.0 from 2023-09-04
[+] MEASoft shipping support, address and payer transfer
[+] MEASoft: Payer can be selected in module settings, Orders tab
[*] Replaced short PHP tags with standard <?php
v1.11.16 from 2023-06-05
[*] Improved customer check on retailcrm side to prevent duplicates (added email and TIN search), company name normalization when comparing
v1.11.15 from 2023-05-12
[*] Improved customer check on retailcrm side to prevent duplicates
[*] Changed file structure
[+] Added customer sites selection in module settings for retailcrm customer requests
v1.11.14 from 2022-12-26
[+] Module standardization
v1.11.13 from 2022-12-06
[*] When «Import new orders» is disabled, new customers are not created
[*] Import only to enabled storefronts
[!] Fixed user duplication issue
v1.10.13 from 2022-11-18
[*] Shipping comment moved to different hook
[!] Fixed payment method duplication issue
v1.9.13 from 2022-11-17
[+] Added shipping method export to comment
v1.8.13 from 2022-10-17
[*] Changed language variables
v1.8.12 from 2022-10-04
[+] Module standardization
v1.8.11 from 2022-07-20
[+] Added «Export product external_id» setting
v1.8.10 from 2022-04-29
[!] Fixed bug when customer external code matched
v1.8.9 from 2022-04-21
[*] Disabled email sending when importing new customer to CS-Cart
v1.8.8 from 2022-04-20
[+] Added mapping of Deliveries / PVZ (CS-Cart) to Stores / Warehouses (RetailCRM)
v1.7.8 from 2022-04-08
[!] Fixed order duplication on one-click purchase
v1.7.7 from 2022-03-31
[+] Added full name transfer when creating individual customer
v1.7.6 from 2022-03-25
[+] Added TIN removal from order when it contains error
[+] Added PVZ address to order
[*] Changed order type detection by identification field
v1.6.6 from 2022-03-24
[+] Added creation of two customer types — legal entity and individual
[+] Added order to customer binding
[!] Fixed error when accessing corporate customer methods
v1.5.6
[+] Added mapping of «TIN» and «Company name» fields from ms_invoicing module
[+] Added order type change to «Legal entity» when TIN is filled
[+] Added email validation
[!] Fixed «Invalid counterparty type» error
v1.4.6
[*] Updated MakeShop.pro icon
v1.4.5
[+] Customer merge sync
[+] One-click order symbol setting
[!] Multivendor settings fix
[!] «No full name» customers fix
v1.4.4
[*] Replaced language variables
v1.4.3
[+] Added discount coupon export
[!] Fixed interaction error with «Callback» module
[!] Fixed language file (en)
v1.4.2
[*] Fixed bug in multivendor settings templates
v1.4.1
[+] Remove cancelled items from cart
[+] Added logging function
v1.4.0
[+] Multistore support
v1.3.3
[+] Export of incomplete purchases by unregistered users with contact data
v1.3.2
[+] Storefront disable option
v1.3.1
[+] Start point for incomplete purchases export
[*] Bug fixes
v1.3.0
[+] Incomplete purchases export + settings
[+] Weight calculation
[+] Gift certificate and discount coupon amounts
[*] MsRetailcrm_orders => MsRetailcrm_objects (other entity sync)
[+] Option to disable new order import from retailCRM
[+] Actions on module update in developer mode
[!] Fixed discount calculation and sync
v1.2.0
[*] Added callback and one-click purchase settings
[*] Added option to add delivery address, SDEK offices to customer comment
[*] Added option to add cart items to customer comment on one-click purchase
[*] Added option to clear email field by specified domains
[*] Added option to specify order URL from admin
[*] Added option to write full name to «name» field
[*] Added module disable option (to show settings when disabled)
[!] Fixed retailCRM customer ID assignment error
v1.1.1
[*] firstUpdateSince runs after enabling disabled module
[!] Fixed error when creating one-click order
v1.1.0
[+] Price list structure per retailCRM documentation
[+] «Price list for retailCRM» option in price list edit
[+] Import/export enable/disable options
[*] Improved discount calculation
[!] Activity check before postInstall() and firstUpdateSince()
[!] Minor fixes
v1.0.0
[+] Initial 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.