KeepinCRM Sync — CRM for OpenCart 2.3, 3.x & 4.x

KeepinCRM Sync for OpenCart is a module that sends orders from a shop on OpenCart 2.3, 3.x or 4.x into KeepinCRM as deals. When an order is placed (or moves into the chosen status), a deal automatically appears in the CRM with the customer, items with price and currency, and the buyer’s comment. The manager works the request in KeepinCRM while the order is still “hot”, with no copying of data from the OpenCart admin.

The module is completely free, and the code is open. Download it from GitHub: github.com/catcodestudio/opencart-keepincrm-sync — no licence keys or limits.

How it works, step by step

1. The customer places an order in the OpenCart shop.
2. The module catches the event of adding order history and fires on placement or on reaching a chosen status.
3. A deal is built: a client lead (full name, email, phone in +380 format), items as deal lines with price and currency, a comment — and it’s sent to KeepinCRM (POST /agreements on api.keepincrm.com/v1, X-Auth-Token header).
4. The deal ID is recorded in the sync log. The record per order is unique, so repeated events don’t spawn duplicates — one deal per order, guaranteed.
5. If KeepinCRM is unavailable — the order stays queued, and OpenCart’s hourly cron retries the send (up to 5 attempts by default).
6. The admin sees the result in the log: status, deal ID, number of attempts, the last error, and the full request/response body.

How much it costs

Free, open source. Repository on GitHub: catcodestudio/opencart-keepincrm-sync — use it without activations or subscriptions.

Under the hood

• OC4 event-driven architecture — the module registers an event on adding order history and works without OCMOD patches to core or theme files.
• Database-level idempotency: a cc_keepincrm_sync log table with a unique key on order_id — duplicate deals are physically ruled out.
• Retry queue via OpenCart’s built-in cron: the cc_keepincrm_retry task runs hourly and picks up failed sends until the attempt limit is reached.
• The API token is encrypted before being stored in the database — it isn’t kept in plain text.
• Full exchange log: the log stores the request body and CRM responses for every order — diagnosing issues without guesswork.

How to install

1. In the OpenCart admin, open Extensions → Installer and upload cc_keepincrm.ocmod.zip.
2. In Extensions → Extensions → Modules, find KeepinCRM Sync and click “Install” — the log table, event and cron task are created.
3. Open the module’s settings and paste the API token from your KeepinCRM account (Settings → Company profile → API tab).
4. Click the connection-test button — make sure the CRM responds.
5. Optionally fill in the routing (pipeline, stage, source, assignee), choose the send moment, and save.

Separately for OpenCart 3.x. Upload cc_keepincrm-oc3.ocmod.zip via Extensions → Installer and refresh the modifications. OpenCart 3 has no task scheduler, so retries are set up in the hosting’s crontab — the address is shown in the module’s settings; set a cron token there too, otherwise the address is open to anyone:

curl -s "https://YOUR-SHOP/index.php?route=extension/module/cc_keepincrm/cronRetry&token=TOKEN"

Separately for OpenCart 2.3. The built-in 2.3 Installer only copies files via FTP: if FTP isn’t configured in the shop, unpack cc_keepincrm-oc2.ocmod.zip and upload the contents of the upload/ folder to the shop root, then install the module in Extensions → Modules. 2.3 has no scheduler at all, so retries are set up manually in the system crontab — the address is shown on the “Cron” tab of the module’s settings; set a cron token there too, otherwise the address is open to anyone:

curl -s "https://YOUR-SHOP/index.php?route=extension/module/cc_keepincrm_cron/retry&token=TOKEN"