Модуль KEY CRM

Що робить інтеграція

Інтеграція KeyCRM передає замовлення з магазину Solomono у кабінет KeyCRM. Разом із замовленням передаються покупець, товари, сума, спосіб оплати, спосіб доставки та статус.

• Менеджер бачить замовлення в таблиці KeyCRM і може обробляти його в CRM.

• Статуси, оплати та доставки зіставляються у вкладках модуля в адмінці Solomono.

• Логи інтеграції допомагають швидко знайти причину, якщо замовлення не передалося.

Що підготувати

• Доступ адміністратора до магазину Solomono.

• Акаунт KeyCRM з правами доступу до налаштувань.

• API key з кабінету KeyCRM.

• Джерело замовлень у KeyCRM, наприклад soloqa.

Увага. API key є секретним. Не надсилайте його у відкритих чатах і не залишайте на скріншотах.

 

1. Відкрийте налаштування KeyCRM

1. Увійдіть у кабінет KeyCRM.

2. Відкрийте Налаштування.

3. У розділі загальних налаштувань знайдіть API key або пункт документації API.

4. Скопіюйте API key. Він знадобиться в адмінці Solomono.

Рисунок 1. KeyCRM: загальні налаштування та API

2. Перевірте джерело замовлень

5. У KeyCRM відкрийте Налаштування → Список джерел.

6. Переконайтеся, що для магазину створене активне джерело.

7. Запам’ятайте назву або ідентифікатор джерела. У Solomono воно вибирається у полі «Ідентифікатор магазину у KeyCRM (Источник)».

Рисунок 2. KeyCRM: джерело замовлень магазину

3. Підключіть KeyCRM у Solomono

8. Увійдіть в адмін-панель Solomono.

9. Відкрийте розділ Інтеграція з CRM.

10. У полі «Виберіть діючу CRM» виберіть KeyCRM.

11. У полі «Домен» вкажіть строго: https://openapi.keycrm.app/v1

12. У поле «Ключ» вставте API key з KeyCRM.

13. У полі «Ідентифікатор магазину у KeyCRM (Источник)» виберіть потрібне джерело, наприклад soloqa (1).

14. Виберіть мову і натисніть «Зберегти налаштування».

Рисунок 3. Solomono: загальні налаштування KeyCRM

Увага. Домен підключення завжди має бути https://openapi.keycrm.app/v1. Без /v1 інтеграція не працюватиме коректно.

4. Налаштуйте вкладку «Статуси замовлень»

15. Відкрийте вкладку «Статуси замовлень».

16. Для кожного статусу KeyCRM виберіть відповідний статус Solomono.

17. Мінімально перевірте статус нового замовлення, статус очікування оплати, виконано/доставлено та скасовано.

18. Збережіть зміни.

Рисунок 4. Solomono: зіставлення статусів замовлень

Важливо. Якщо статус не зіставлений, замовлення може передатися в CRM, але подальша зміна статусу не буде зрозумілою для іншої системи.

5. Налаштуйте вкладку «Методи оплати»

19. Відкрийте вкладку «Методи оплати».

20. Навпроти кожного методу KeyCRM виберіть відповідний метод оплати Solomono.

21. Перевірте ті методи, які реально використовуються на checkout: оплата карткою, готівка, банківський переказ, PayPal або інше.

22. Збережіть зміни.

Рисунок 5. Solomono: зіставлення методів оплати

Важливо. Якщо метод оплати не зіставлений, у KeyCRM замовлення може прийти без правильного типу оплати.

6. Налаштуйте вкладку «Способи доставки»

23. Відкрийте вкладку «Способи доставки».

24. Зіставте служби доставки KeyCRM зі способами доставки Solomono.

25. Перевірте всі активні способи доставки магазину.

26. Збережіть зміни.

Рисунок 6. Solomono: вкладка способів доставки

Важливо. Якщо доставка не зіставлена, замовлення в CRM може бути без коректної служби доставки.

7. Перевірте вкладки «Товари», «Замовлення» та «Логи»

27. У вкладці «Товари» перевіряйте синхронізацію або відповідність товарів, якщо це потрібно для вашого процесу.

28. У вкладці «Замовлення» перевіряйте передані замовлення та ручні дії з синхронізації, якщо вони доступні.

29. У вкладці «Логи» дивіться результат запитів до KeyCRM і повідомлення про помилки.

Рисунок 7. Solomono: вкладка замовлень інтеграції

Рисунок 8. Solomono: логи інтеграції KeyCRM

8. Зробіть тестове замовлення

30. На сайті магазину додайте товар у кошик.

31. Оформіть замовлення з доступним способом оплати та доставки.

32. Після оформлення відкрийте KeyCRM → Замовлення.

33. Знайдіть замовлення за номером джерела або покупцем.

Рисунок 9. KeyCRM: тестове замовлення з Solomono у таблиці

Типові проблеми

Замовлення не з’явилось у KeyCRM	Перевірте API key, домен https://openapi.keycrm.app/v1, джерело магазину та вкладку «Логи».
Неправильний статус у CRM	Перевірте вкладку «Статуси замовлень» і зіставлення статусів.
Не передався метод оплати	Перевірте вкладку «Методи оплати».
Не передалась доставка	Перевірте вкладку «Способи доставки».
Webhook не працює	Переконайтеся, що URL webhook доступний ззовні і firewall / Cloudflare не блокує POST-запити.
Змінили API key у KeyCRM	Оновіть ключ у Solomono і збережіть налаштування повторно.