The addon provides full two-way integration between CS-Cart and RetailCRM. Data is synchronized in both directions: orders, customers, carts, callback requests, and one-click orders.
How synchronization works
The addon integrates with the CS-Cart lifecycle through hooks and reacts to events in real time. When an order is created on the site (hook place_order), it is automatically exported to RetailCRM. When the order status changes (hook change_order_status), the update is sent to the CRM. On payment (hook finish_payment), the payment status is updated in RetailCRM. Customers are synchronized on registration and profile update (hooks update_profile, retailcrm_pre_save_customer).
For bulk export and import, cron jobs are used. The addon provides separate cron URLs for: importing change history from RetailCRM (orders and customers), exporting users to CRM, importing users from CRM, exporting orders, importing orders. Each task is invoked via its own URL with a secret key for authorization.
Export from CS-Cart to RetailCRM
Orders are exported on creation, status change, and payment. For each order, the addon sends: products with prices and quantities, customer data (name, phone, email, address), shipping and payment methods, status, discounts, UTM tags (when enabled). Carts (incomplete purchases) are exported when the option is enabled — orders with status «cart» are created in RetailCRM.
Customers are exported on registration and profile update. The addon matches users by email and phone to avoid duplicates. When exporting an order, if the customer is not yet in RetailCRM, they are created automatically.
Import from RetailCRM to CS-Cart
Order import is performed via cron or when receiving a webhook from RetailCRM (if change history is configured). New orders from CRM are created on the site with status, payment, and shipping method mapping. Customers are imported when first referenced in an order.
The addon supports importing change history: when an order or customer is updated in RetailCRM, the data is updated in CS-Cart. Order status, payment, delivery data, and notes are synchronized.
Callback requests and one-click purchase
When the «Callback requests» addon is installed, callback and one-click purchase requests are sent to RetailCRM (hook call_requests_do_call_request_post). An order with type «callback» or «one-click purchase» is created in the CRM, and a manager is assigned. You can configure creation of full orders with products for one-click purchases.
MEASoft and Yandex.Market integration
When using the MEASoft module for shipping, the shipping cost is passed to RetailCRM (in the comment or as a separate field). For Yandex.Market: when generating a YML price list for RetailCRM export, the addon replaces the Offers class to use external_id from RetailCRM (hook yml_export_get_options_post).
Multi-vendor support
The addon supports Multi-Vendor and Ultimate. Settings and mappings are stored separately for each company (storefront). Each store has its own site and warehouse in RetailCRM. Cron tasks run with respect to company_id or storefront_id.
Where to find settings
All addon settings are located in «Administration» → «Sync data» → «MS: Extended RetailCRM Integration». The interface is organized by tabs: General (URL, API key, currency, default site and warehouse), Orders (export and import modes, field settings), Warehouses, Import statuses, Export statuses, Payment methods, Shipping methods, User fields, Callback and one-click purchase, Cron (password and cron URLs).
On the order edit page in the CS-Cart admin panel, the RetailCRM order ID is displayed (if the order was exported). Buttons are available to export the order to RetailCRM and import from RetailCRM to the site.
