KEY CRM module

What The Integration Does

The KeyCRM integration sends orders from the Solomono store to the KeyCRM account. The order data includes the customer, products, order amount, payment method, delivery method, and status.

• A manager can see and process store orders in the KeyCRM orders table.

• Order statuses, payment methods, and delivery methods are mapped in the Solomono CRM module tabs.

• The Logs tab helps diagnose cases when an order was not sent to KeyCRM.

Before You Start

• Administrator access to the Solomono store.

• A KeyCRM account with access to settings.

• An API key from KeyCRM.

• An order source in KeyCRM, for example soloqa.

Warning. The API key is secret. Do not share it in public chats and do not leave it visible in screenshots.

 

1. Open KeyCRM Settings

1. Log in to KeyCRM.

2. Open Settings.

3. In the general settings area, find the API key or the API documentation section.

4. Copy the API key. You will need it in the Solomono admin panel.

Figure 1. KeyCRM: general settings and API

2. Check The Order Source

5. In KeyCRM, open Settings → Sources List.

6. Make sure an active source exists for the store.

7. Remember the source name or identifier. In Solomono it is selected in the KeyCRM store identifier/source field.

Figure 2. KeyCRM: store order source

3. Connect KeyCRM In Solomono

8. Log in to the Solomono admin panel.

9. Open Integration with CRM.

10. In the active CRM field, select KeyCRM.

11. In the Domain field, enter exactly: https://openapi.keycrm.app/v1

12. Paste the KeyCRM API key into the Key field.

13. Select the required KeyCRM store source, for example soloqa (1).

14. Select the language and click Save settings.

Figure 3. Solomono: general KeyCRM settings

Warning. The connection domain must always be https://openapi.keycrm.app/v1. Without /v1 the integration may not work correctly.

4. Configure The Order Statuses Tab

15. Open the Order statuses tab.

16. For each KeyCRM status, select the matching Solomono order status.

17. At minimum, check new order, waiting for payment, completed/delivered, and canceled statuses.

18. Save the changes.

Figure 4. Solomono: order status mapping

5. Configure The Payment Methods Tab

19. Open the Payment methods tab.

20. For each KeyCRM payment method, select the matching Solomono payment method.

21. Check the methods actually used at checkout: card payment, cash, bank transfer, PayPal, or other.

22. Save the changes.

Figure 5. Solomono: payment method mapping

6. Configure The Delivery Methods Tab

23. Open the Delivery methods tab.

24. Map KeyCRM delivery services to Solomono delivery methods.

25. Check all active delivery methods used by the store.

26. Save the changes.

Figure 6. Solomono: delivery methods tab

7. Check Goods, Orders, And Logs

27. Use the Goods tab to check product sync or product matching if it is part of your workflow.

28. Use the Orders tab to review sent orders and manual sync actions, if available.

29. Use the Logs tab to check the result of KeyCRM requests and any error messages.

Figure 7. Solomono: CRM integration orders tab

Figure 8. Solomono: KeyCRM integration logs

8. Create A Test Order

30. Open the store frontend and add a product to the cart.

31. Place an order with an available payment and delivery method.

32. After the order is placed, open KeyCRM → Orders.

33. Search for the order by source order number or customer name.

Figure 9. KeyCRM: test Solomono order in the orders table

Common Issues

The order does not appear in KeyCRM	Check the API key, the https://openapi.keycrm.app/v1 domain, the selected source, and the Logs tab.
Wrong status in CRM	Check the Order statuses tab and status mapping.
Payment method is missing	Check the Payment methods tab.
Delivery method is missing	Check the Delivery methods tab.
Webhook does not work	Make sure the webhook URL is externally available and firewall / Cloudflare does not block POST requests.
The API key was changed in KeyCRM	Update the key in Solomono and save the settings again.