Solomono Инструкции Все модули Модуль KEY CRM

Модуль 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. Проверьте источник заказов

  1. В KeyCRM откройте Настройки → Список источников.

  2. Убедитесь, что для магазина создан активный источник.

  3. Запомните название или идентификатор источника. В Solomono он выбирается в поле «Идентификатор магазина в KeyCRM (Источник)».

Рисунок 2. KeyCRM: источник заказов магазина

3. Подключите KeyCRM в Solomono

  1. Войдите в админ-панель Solomono.

  2. Откройте раздел Интеграция с CRM.

  3. В поле «Выберите действующую CRM» выберите KeyCRM.

  4. В поле «Домен» укажите строго: https://openapi.keycrm.app/v1

  5. В поле «Ключ» вставьте API key из KeyCRM.

  6. В поле «Идентификатор магазина в KeyCRM (Источник)» выберите нужный источник, например soloqa (1).

  7. Выберите язык и нажмите «Сохранить настройки».

Рисунок 3. Solomono: общие настройки KeyCRM

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

4. Настройте вкладку «Статусы заказов»

  1. Откройте вкладку «Статусы заказов».

  2. Для каждого статуса KeyCRM выберите соответствующий статус Solomono.

  3. Минимально проверьте статус нового заказа, статус ожидания оплаты, выполнено/доставлено и отменено.

  4. Сохраните изменения.

Рисунок 4. Solomono: сопоставление статусов заказов

Важно. Если статус не сопоставлен, заказ может передаться в CRM, но дальнейшее изменение статуса не будет понятным для другой системы.

5. Настройте вкладку «Методы оплаты»

  1. Откройте вкладку «Методы оплаты».

  2. Напротив каждого метода KeyCRM выберите соответствующий метод оплаты Solomono.

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

  4. Сохраните изменения.

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

Важно. Если метод оплаты не сопоставлен, в KeyCRM заказ может прийти без правильного типа оплаты.

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

  1. Откройте вкладку «Способы доставки».

  2. Сопоставьте службы доставки KeyCRM со способами доставки Solomono.

  3. Проверьте все активные способы доставки магазина.

  4. Сохраните изменения.

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

Важно. Если доставка не сопоставлена, заказ в CRM может быть без корректной службы доставки.

7. Проверьте вкладки «Товары», «Заказы» и «Логи»

  1. Во вкладке «Товары» проверяйте синхронизацию или соответствие товаров, если это нужно для вашего процесса.

  2. Во вкладке «Заказы» проверяйте переданные заказы и ручные действия по синхронизации, если они доступны.

  3. Во вкладке «Логи» смотрите результат запросов к KeyCRM и сообщения об ошибках.

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

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

8. Сделайте тестовый заказ

  1. На сайте магазина добавьте товар в корзину.

  2. Оформите заказ с доступным способом оплаты и доставки.

  3. После оформления откройте KeyCRM → Заказы.

  4. Найдите заказ по номеру источника или покупателю.

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

Типичные проблемы

Заказ не появился в KeyCRM

Проверьте API key, домен https://openapi.keycrm.app/v1, источник магазина и вкладку «Логи».

Неправильный статус в CRM

Проверьте вкладку «Статусы заказов» и сопоставление статусов.

Не передался метод оплаты

Проверьте вкладку «Методы оплаты».

Не передалась доставка

Проверьте вкладку «Способы доставки».

Webhook не работает 

Убедитесь, что URL webhook доступен извне и firewall / Cloudflare не блокирует POST-запросы.

Изменили API key в KeyCRM

Обновите ключ в Solomono и повторно сохраните настройки.


 

Обновлено: 17/07/2026
icon