MS: Extended RetailCRM Integration

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.

Product:

Store Builder
Store Builder Ultimate

Recipient:

Owners

Development

:

Backend

Localization:

English
Русский

Compatible versions:

4.18.X
4.17.X
4.16.X
4.15.X

Оформление подписки

Мы переходим на новую подписную систему, открывая для вас полный доступ ко всем нашим модулям. Подробную информацию об условиях подписки и часто задаваемых вопросах вы можете найти здесь.

Обратите внимание, что приобретение модулей по отдельности теперь недоступно — воспользоваться ими возможно исключительно в рамках подписки.

За единую стоимость подписки - 2000 руб/мес. Вы получаете доступ ко всем модулям.

Как оформить подписку у нас на сайте

Зарегистрируйтесь или авторизуйтесь на нашем сайте и выберите интересующий вас модуль

Нажмите кнопку Запросить триал доступ

Введите в поле URL сайта ваш домен в формате domain.com, без www и https://

Далее в личном кабинете в разделе загрузки вы сможете скачать нужный вам модуль и менеджер модулей для удобного управления модулями и оформления подписки.

Далее у вас есть 7 дней для тестирования выбранного модуля.

По истечении строка триала, для продолжения работы необходимо оплатить подписку.

Сделать это можно из менеджера модулей.

На выбор вы можете оплатить:

для зарубежных карт - PayPal

для РФ карт - Robokassa

Или на странице на сайте https://makeshop.pro/subscription/

При оплате нужно указать электронную почту с которой вы оформляли триал доступ.

При покупке на маркетплейсе CS-Cart

При покупке любого модуля зарубежной картой или картой РФ

Так как система при оформлении подписки не спрашивает дополнительных вопросов (на какой домен подписка оформляется) желательно вводить электронную почту ту же что и ваша учетная запись у нас на сайте (если она есть), тогда ваши учётки свяжутся между собой.

Выберите интересующий модуль и нажмите кнопку “Оформить подписку“

Далее после оплаты подписки вы сможете скачать модуль перейдя в раздел “Загрузки“, там выберите свой заказ и в нем будет ссылка на скачивание.

В дальнейшем, для получения новых модулей по подписке рекомендуем пользоваться нашим сайтом.

Всё что вам будет нужно сделать это на интересующем вас модуле (после авторизации) нажать кнопку “Запросить модуль по подписке“ и после одобрения скачать его в разделе загрузки.

Если что-то пойдет не так - проверьте выписалась ли лицензия

Найдите заказ с датой оформления подписки

Убедитесь что у вас прописался URL сайта в заказ

Если URL сайта неправильный и вам нужно обновить его: переходите в пункт меню “Мои модули”

Ищите модуль и проверьте URL магазина для которого выписана подписка

Instruction — MS: Extended RetailCRM Integration

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.

Changelog — MS: Extended RetailCRM Integration

v2.2.0

19.02.2026

[\*] Module template updated

v2.1.0

28.01.2026

[!] 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

24.11.2025

[\*] Complete module overhaul
[!] 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
[\*] 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

v1.14.2

11.01.2024

[\*] Improved utm tags transfer when creating order
[!] Fixed error after module installation (module class not found)

v1.14.1

25.12.2023

[\*] Changed cron link
[!] Fixed error when generating Yandex.Market price list file (external_id was searched in products table)
[+] Added utm tags transfer in order via module setting

v1.14.0

30.10.2023

[+] Added shipping cost transfer from «Exclude shipping cost from order» module

v1.13.2

23.09.2023

[+] Added customer TIN (INN) transfer in order

v1.13.1

18.09.2023

[\*] MEASoft: shipping cost transfer to order comment, applies only to 5post

v1.13.0

11.09.2023

[+] MEASoft: shipping cost transfer to order comment

v1.12.0

04.09.2023

[+] 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

05.06.2023

[\*] Improved customer check on retailcrm side to prevent duplicates (added email and TIN search), company name normalization when comparing

v1.11.15

12.05.2023

[\*] 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

26.12.2022

[+] Module standardization

v1.11.13

06.12.2022

[!] Fixed user duplication issue
[\*] When «Import new orders» is disabled, new customers are not created
[\*] Import only to enabled storefronts

v1.10.13

18.11.2022

[!] Fixed payment method duplication issue
[\*] Shipping comment moved to different hook

v1.9.13

17.11.2022

[+] Added shipping method export to comment

v1.8.13

17.10.2022

[\*] Changed language variables

v1.8.12

04.10.2022

[+] Module standardization

v1.8.11

20.07.2022

[+] Added «Export product external_id» setting

v1.8.10

29.04.2022

[!] Fixed bug when customer external code matched

v1.8.9

21.04.2022

[\*] Disabled email sending when importing new customer to CS-Cart

v1.8.8

20.04.2022

[+] Added mapping of Deliveries / PVZ (CS-Cart) to Stores / Warehouses (RetailCRM)

v1.7.8

08.04.2022

[!] Fixed order duplication on one-click purchase

v1.7.7

31.03.2022

[+] Added full name transfer when creating individual customer

v1.7.6

25.03.2022

[+] Added TIN removal from order when it contains error
[+] Added PVZ address to order
[\*] Changed order type detection by identification field

v1.6.6

24.03.2022

[+] 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
[!] Fixed discount calculation and sync
[\*] MsRetailcrm_orders => MsRetailcrm_objects (other entity sync)
[+] Option to disable new order import from retailCRM
[+] Actions on module update in developer mode

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

Request revision

Бэклог

Планируется

В работе

Выпущено

Передачи ИНН из CS-Cart в retailCRM

передачи ИНН из CS-Cart в retailCRM

November 2023

100%

Перенос всех настроек в раздел Синхронизация данных

December 2023