CatCode Order Sync with KeyCRM for WooCommerce
| 开发者 | catcodestudio |
|---|---|
| 更新时间 | 2026年7月27日 20:30 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
The plugin connects WooCommerce to KeyCRM via its Open API (openapi.keycrm.app). Every new store order is automatically created in KeyCRM with the buyer, products, shipping and payment.
KeyCRM is a third-party product; this plugin is an independent integration and is not affiliated with or endorsed by KeyCRM.
Features
- Send the order right after checkout (classic checkout and Checkout Blocks) or when it enters one of the selected statuses
- Deduplication:
source_uuid = wc-{id}plus the KeyCRM ID stored in order meta — no duplicates - Payment status pass-through: a paid order is created with a "paid" payment record (optional)
- Automatic retries on failure: 3 attempts with 5 min / 30 min / 2 h delays (WP-Cron)
- Metabox on the order screen: sync status, KeyCRM ID, "Resend" button (already-sent orders are partially updated via PUT)
- "Test connection" button on the settings page
- Log of recent sync events ("Journal" tab)
- API key is encrypted in the database (libsodium with an HMAC fallback)
- Buyer phone normalization to E.164 (+380...)
- Order source: explicit Source ID or a source name (KeyCRM creates it automatically)
- HPOS compatible (custom order tables), works exclusively through WC_Order CRUD
catcode_keycrm_order_payloadfilter andcatcode_keycrm_order_sentaction for third-party integrations
- WooCommerce 7.0 or newer
- PHP 7.4+
- KeyCRM API key (KeyCRM cabinet → Settings → API)
- A customer places an order in your store
- The plugin builds the payload (buyer, products, shipping, payment) and sends POST /order to KeyCRM
- KeyCRM returns the order ID, which is stored in the
_catcode_keycrm_order_idmeta - If KeyCRM is unavailable, the attempt is retried automatically (up to 3 times)
- The manager sees the status and ID in the order metabox and in the journal
安装:
- Upload the plugin folder to
/wp-content/plugins/catcode-order-sync-with-keycrm-for-woocommerce/ - Activate it in the "Plugins" menu
- Go to WooCommerce → KeyCRM Sync and enter your API key
- Click "Test connection" and save the settings
屏幕截图:
常见问题:
Where do I get the API key?
KeyCRM cabinet → Settings → API. The key is stored encrypted in the database.
Are duplicates created when the status changes again?
No. The plugin stores the KeyCRM ID in the order meta and passes source_uuid, and KeyCRM also deduplicates on its side.
What does the "Resend" button do?
If the order is not in KeyCRM yet, it creates it. If it has already been sent, it partially updates it (PUT /order/{id}) with fresh data.
更新日志:
0.1.3
- All source strings are now English, as expected for a plugin hosted on WordPress.org.
- Added a complete bundled Ukrainian translation (uk.po/uk.mo), so the Ukrainian interface is unchanged for Ukrainian sites.
- Added the "External services" section to the readme documenting the KeyCRM Open API connection, the data sent and links to the KeyCRM terms of use and privacy policy.
- Fixed the Plugin URI, which pointed to a page that returned a 404.
- Renamed the plugin to "CatCode Order Sync with KeyCRM for WooCommerce" (new slug and text domain).
- Admin styles are now enqueued via wp_add_inline_style on a registered handle instead of raw output.
- All options, order meta, hooks, transients and the cron event consolidated under the catcode_keycrm_ prefix.
- First release: order export, retries, metabox, journal, connection test.