Advanced integration with retailCRM

Installation

After downloading the add-on, it is installed using standard CS-Cart tools on the page Admin panel → Add-ons → Manage add-ons → Download and install add-on (+).

For CS-Cart version older than 4.13.1 Admin panel → Add-ons → Manage add-ons → Gear button → Manual installation

Click Download, in the window that appears, select the add-on file, then Download and install.

Setting

The initial setup is carried out on the General settings tab, where you need to enter the RetailCRM account URL and api key.

By default, the add-on is in the Disabled status, it is recommended to configure it before enabling it.

After connecting, you need to select a store and warehouses in RetailCRM and specify the currency of the store in RetailCRM

Additional setting

Description of settings:

On the Directories tab, you need to mutually compare order statuses, delivery methods, payment methods between Cs-Cart and RetailCRM. It also indicates the dependence of the payment status in retailCRM on the status of the order in CS-Cart.

The User Fields tab maps buyer profile fields

On the Orders tab, synchronization is configured in detail: import of new orders from retailCRM, import / export of order changes, export of callbacks, one-click orders, etc. are disabled.

You need to create a YML file (for example, using the standard Export to Yandex.Market add-on) to import products from CS-Cart to RetailCRM. To do this, go to Administration → Export to Yandex.Market → Price list.

Click the Create a new price list button in the form of a plus.

Set the necessary values Access key, Price list name, Store name and check the box Price list for RetailCRM.

The access key is located in RetailCRM Settings - Integration - API Access Keys

After that, click Create, additional export settings will appear (you can leave the default) and links for generating and downloading the file, as well as a cron - command for automatically updating the file.

And from the RetailCRM side, on the Settings tab→ Stores→ [Select the desired store] → Catalog select Download from ICML and specify the address of the generated YML file in the ICML file URL field.

Important:For end-to-end synchronization of MySklad - RetailCRM - CS-Cart, you need to add an external_id for the product to the yml-file. You can do this using our add-on fixes integration add-on.

Apply 7 (Adding retailcrm xmlid changes to gatherAdditional) and 8 (Adding retailcrm xmlid changes to getRetailCrmOfferAttributes) fix:

After that, for the products you need to specify the external_id value:

After that, be sure to regenerate the import file and the external_id value will appear there in the .... field.

To automatically synchronize order/status changes from RetailCRM to CS-Cart, you need to register the cron command php /path/to/admin.php --dispatch=trigger.retailcrm_import, on the CS-Cart server

After configuring synchronization, change the status of the module to Enabled.

Important: When you enable/disable and update the module, the start points for orders and pending purchases are updated. This is done for those cases when the module is disabled for a long time, so that old orders are not unloaded and old changes from the history are not synchronized.