# OpenCart + Krokul CRM

Так. У Krokul CRM є нативний конектор OpenCart. Ви встановлюєте розширення Krokul в адмінці OpenCart, і кожне замовлення з товарами приходить у Krokul угодою, а покупець стає контактом. Зміни статусу замовлення в магазині рухають угоду, а Krokul записує залишки й історію замовлення назад в OpenCart.

**Статус:** Нативна. **Платформи автоматизації:** Make.

## Що отримує команда

### Замовлення з магазину стає угодою з товарами

Гуртовий покупець оформлює замовлення у вашому магазині на OpenCart. Розширення надсилає замовлення з рядками товарів, і Krokul відкриває угоду з номером замовлення OpenCart у назві. Покупець стає контактом. Кожен рядок зберігає назву, код моделі, кількість і ціну, а рядки, чий код моделі збігається з товаром Krokul, привʼязуються до цієї позиції каталогу. Спосіб оплати, спосіб доставки й коментар покупця йдуть у текст угоди.

### Замовлення в іншій валюті зберігає правильну суму

OpenCart зберігає суму замовлення у валюті магазину за замовчуванням і окремо курс currency_value для валюти, яку бачив покупець. Krokul перемножує їх і записує угоду у валюті замовлення, тож замовлення в доларах приходить у доларах. Звіти додають його правильно.

### Статус замовлення в магазині рухає угоду

Коли працівник магазину додає запис в історію замовлення, наприклад Processing, Shipped чи Canceled, розширення надсилає замовлення знову з новим order_status_id. Krokul знаходить угоду за ID замовлення OpenCart і переводить її на етап, призначений для цього статусу. Скасоване замовлення закриває угоду як програну й знімає резерв.

### Krokul оновлює замовлення й залишки в OpenCart

Коли угоду відвантажено, Krokul додає в історію замовлення запис із вибраним статусом і коментарем із номером для відстеження, і OpenCart може сповістити покупця. Рух складу в Krokul задає кількість товару в OpenCart за тим самим кодом моделі. Покупці бачать справжню наявність.

## Що передається між системами

| OpenCart | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (order_id, total, currency_code) | Угода із сумою у валюті замовлення | OpenCart → Krokul | Замовлення отримує перший запис історії |
| Товари замовлення (name, model, quantity, price) | Рядки угоди, привʼязані до каталогу за кодом моделі | OpenCart → Krokul | Те саме замовлення |
| Дані покупця (firstname, lastname, email, telephone) | Контакт, зіставлений за телефоном чи поштою | OpenCart → Krokul | Те саме замовлення |
| Спосіб оплати, спосіб доставки, коментар | Текст на угоді | OpenCart → Krokul | Те саме замовлення |
| Історія замовлення (order_status_id) | Етап угоди й резерв | OpenCart ↔ Krokul | Статус змінюють в одній із систем |
| Кількість товару | Залишок товару на складі | Krokul → OpenCart | Залишок змінюється в Krokul |

## Як підключити сьогодні

### Нативний конектор у «Маркетплейсі»

1. У «Маркетплейсі» Krokul відкрийте OpenCart, виберіть воронку, джерело й відповідального, задайте спільний секрет і скопіюйте адресу потоку.
2. Завантажте розширення для своєї версії магазину, OpenCart 3.x або OpenCart 4.x. Версію видно внизу сторінки адмінки.
3. В адмінці OpenCart відкрийте Extensions → Installer, завантажте файл .ocmod.zip, потім встановіть модуль Krokul CRM у Extensions → Extensions → Modules. В OpenCart 3.x спершу натисніть Refresh у Extensions → Modifications.
4. Відкрийте модуль на редагування, вставте адресу потоку й спільний секрет, увімкніть його і збережіть.
5. Оформіть тестове замовлення. Журнал інтеграцій покаже замовлення, контакт і угоду, яку воно відкрило.

### Для інтеграторів

Вихідних вебхуків в OpenCart немає, а вбудований API не віддає список замовлень, тому замовлення надсилає розширення Krokul. Воно працює всередині магазину. Розширення слухає подію історії замовлення й надсилає замовлення з товарами в JSON. Заголовок X-OpenCart-Signature несе HMAC-SHA256 тіла, і Krokul відхиляє запити без правильного підпису. Розширення не змінює файлів магазину, тож оновлення движка його не зносить. Для власних доробок є REST API Krokul, підписані вебхуки, як-от card.statusChanged, зовнішні ключі для ID замовлень і тестова компанія.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Які версії OpenCart підтримує розширення Krokul?

OpenCart 3.x і 4.x. Для кожної версії є свій пакет, бо код розширення в них різний.

### Що робити, якщо встановлювач розширень OpenCart недоступний?

Короткий PHP-сніпет на тій самій події замовлення надсилає те саме тіло з тим самим підписом. Оновлення движка магазину видаляє сніпет, тож після кожного оновлення його треба додати знову.

### Чи створює зміна статусу другу угоду?

Ні. Krokul зберігає ID замовлення OpenCart як зовнішній ключ. Наступні доставки того самого замовлення оновлюють наявну угоду.

### Чи містить пакет розширення мій секрет?

Ні. Пакет однаковий для кожної компанії в Krokul. Адресу потоку й секрет ви вводите в налаштуваннях модуля всередині OpenCart.

## Обмеження

Вітрина, оформлення замовлення, розширення оплати й доставки та тема лишаються в OpenCart. Krokul веде бік продажу, тобто покупця, угоду, склад і роботу після замовлення.

## Пов’язані сервіси

- [WooCommerce](https://krokul.com/uk/integrations/woocommerce/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)
- [BigCommerce](https://krokul.com/uk/integrations/bigcommerce/index.md)
- [Adobe Commerce](https://krokul.com/uk/integrations/adobe-commerce/index.md)
- [Хорошоп](https://krokul.com/uk/integrations/horoshop/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)

[Платформи електронної торгівлі](https://krokul.com/uk/integrations/category/ecommerce/index.md)

OpenCart є торговою маркою OpenCart Limited. Krokul не афілійований з OpenCart.

Оновлено: 2026-10-15

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs