CatCode Order Sync with KeyCRM for WooCommerce

Опис

Плагін з’єднує WooCommerce із KeyCRM через його Open API (openapi.keycrm.app). Кожне нове замовлення магазину автоматично створюється в KeyCRM разом із покупцем, товарами, доставкою та оплатою.

KeyCRM — сторонній продукт; цей плагін є незалежною інтеграцією і не пов’язаний із KeyCRM та не схвалений ним.

Можливості

• Відправка замовлення одразу після оформлення (класичний checkout і Checkout Blocks) або при переході в один із обраних статусів
• Дедуплікація: source_uuid = wc-{id} плюс ID KeyCRM у метаданих замовлення — без дублікатів
• Передача статусу оплати: оплачене замовлення створюється із записом про оплату «paid» (опційно)
• Автоматичні повтори при збої: 3 спроби із затримками 5 хв / 30 хв / 2 год (WP-Cron)
• Метабокс на екрані замовлення: статус синхронізації, ID KeyCRM, кнопка «Надіслати повторно» (уже відправлені замовлення частково оновлюються через PUT)
• Кнопка «Перевірити з’єднання» на сторінці налаштувань
• Журнал останніх подій синхронізації (вкладка «Журнал»)
• API-ключ зашифровано в базі даних (libsodium із запасним HMAC)
• Нормалізація телефону покупця до формату E.164 (+380…)
• Джерело замовлення: явний Source ID або назва джерела (KeyCRM створює його автоматично)
• Сумісність із HPOS (власні таблиці замовлень), робота виключно через WC_Order CRUD
• Фільтр catcode_keycrm_order_payload та дія catcode_keycrm_order_sent для сторонніх інтеграцій

Вимоги

• WooCommerce 7.0 або новіший
• PHP 7.4+
• API-ключ KeyCRM (кабінет KeyCRM → Налаштування → API)

Як це працює

1. Покупець оформлює замовлення у вашому магазині
2. Плагін формує payload (покупець, товари, доставка, оплата) і надсилає POST /order у KeyCRM
3. KeyCRM повертає ID замовлення, який зберігається в метаполі _catcode_keycrm_order_id
4. Якщо KeyCRM недоступний, спроба повторюється автоматично (до 3 разів)
5. Менеджер бачить статус і ID у метабоксі замовлення та в журналі

Інтерфейс плагіна повністю перекладено українською.

Зовнішні сервіси

Цей плагін під’єднується до KeyCRM Open API (https://openapi.keycrm.app/v1) — стороннього CRM-сервісу. Це з’єднання і є сенсом плагіна: він створює та оновлює ваші замовлення WooCommerce у вашому власному акаунті KeyCRM.

Що і коли надсилається:

• POST /order — коли покупець оформлює замовлення або коли замовлення переходить в один із обраних вами статусів-тригерів. До 3 повторних спроб, якщо KeyCRM недоступний.
• PUT /order/{id} — коли ви натискаєте «Надіслати повторно» у метабоксі замовлення, яке вже існує в KeyCRM.
• GET /order?limit=1 — лише коли ви натискаєте «Перевірити з’єднання» на сторінці налаштувань.

Кожен запит містить ваш API-ключ KeyCRM у заголовку Authorization. Надсилаються такі дані замовлення: ID замовлення WooCommerce (як source_uuid, напр. wc-123), назва джерела замовлення, коментар покупця, товарні позиції (назва, SKU, ціна, кількість), спосіб доставки, вартість доставки, місто й адреса доставки, назва способу оплати, сума замовлення та ознака оплати, а також ім’я, електронна адреса й номер телефону покупця, вказані на оформленні.

Жодні дані не надсилаються до інших сервісів, і нічого про ваших відвідувачів, сайт чи адміністраторів не передається понад перелічені вище дані замовлення. Нічого не надсилається, доки ви не введете свій API-ключ KeyCRM: без ключа плагін не робить зовнішніх запитів.

Цей сервіс надає KeyCRM: умови використання, політика конфіденційності.