Moduł KEY CRM

Co robi integracja

Integracja KeyCRM przesyła zamówienia ze sklepu Solomono do konta KeyCRM. Dane zamówienia obejmują klienta, produkty, kwotę zamówienia, metodę płatności, sposób dostawy oraz status.

• Menedżer może widzieć i obsługiwać zamówienia sklepu w tabeli zamówień KeyCRM.

• Statusy zamówień, metody płatności i sposoby dostawy są mapowane w zakładkach modułu CRM w Solomono.

• Zakładka Logs pomaga diagnozować przypadki, gdy zamówienie nie zostało wysłane do KeyCRM.

Przed rozpoczęciem

• Dostęp administratora do sklepu Solomono.

• Konto KeyCRM z dostępem do ustawień.

• API key z KeyCRM.

• Źródło zamówień w KeyCRM, na przykład soloqa.

Uwaga. API key jest poufny. Nie udostępniaj go w publicznych czatach i nie zostawiaj go widocznego na zrzutach ekranu.

 

1. Otwórz ustawienia KeyCRM

1. Zaloguj się do KeyCRM.

2. Otwórz Settings.

3. W obszarze ustawień ogólnych znajdź API key lub sekcję dokumentacji API.

4. Skopiuj API key. Będzie potrzebny w panelu administracyjnym Solomono.

Rysunek 1. KeyCRM: ustawienia ogólne i API

2. Sprawdź źródło zamówień

5. W KeyCRM otwórz Settings → Sources List.

6. Upewnij się, że dla sklepu istnieje aktywne źródło.

7. Zapamiętaj nazwę lub identyfikator źródła. W Solomono wybiera się je w polu identyfikatora/źródła sklepu KeyCRM.

Rysunek 2. KeyCRM: źródło zamówień sklepu

3. Podłącz KeyCRM w Solomono

8. Zaloguj się do panelu administracyjnego Solomono.

9. Otwórz Integration with CRM.

10. W polu aktywnej CRM wybierz KeyCRM.

11. W polu Domain wpisz dokładnie: https://openapi.keycrm.app/v1

12. Wklej API key KeyCRM do pola Key.

13. Wybierz wymagane źródło sklepu KeyCRM, na przykład soloqa (1).

14. Wybierz język i kliknij Save settings.

Rysunek 3. Solomono: ogólne ustawienia KeyCRM

Uwaga. Domena połączenia zawsze musi mieć postać https://openapi.keycrm.app/v1. Bez /v1 integracja może nie działać poprawnie.

4. Skonfiguruj zakładkę statusów zamówień

15. Otwórz zakładkę Order statuses.

16. Dla każdego statusu KeyCRM wybierz odpowiadający mu status zamówienia Solomono.

17. Co najmniej sprawdź statusy: nowe zamówienie, oczekiwanie na płatność, zakończone/dostarczone oraz anulowane.

18. Zapisz zmiany.

Rysunek 4. Solomono: mapowanie statusów zamówień

5. Skonfiguruj zakładkę metod płatności

19. Otwórz zakładkę Payment methods.

20. Dla każdej metody płatności KeyCRM wybierz odpowiadającą jej metodę płatności Solomono.

21. Sprawdź metody faktycznie używane na checkout: płatność kartą, gotówka, przelew bankowy, PayPal lub inne.

22. Zapisz zmiany.

Rysunek 5. Solomono: mapowanie metod płatności

6. Skonfiguruj zakładkę sposobów dostawy

23. Otwórz zakładkę Delivery methods.

24. Zmapuj usługi dostawy KeyCRM ze sposobami dostawy Solomono.

25. Sprawdź wszystkie aktywne sposoby dostawy używane przez sklep.

26. Zapisz zmiany.

Rysunek 6. Solomono: zakładka sposobów dostawy

7. Sprawdź Goods, Orders i Logs

27. Użyj zakładki Goods, aby sprawdzić synchronizację produktów lub dopasowanie produktów, jeśli jest to częścią Twojego procesu.

28. Użyj zakładki Orders, aby przejrzeć wysłane zamówienia i ręczne akcje synchronizacji, jeśli są dostępne.

29. Użyj zakładki Logs, aby sprawdzić wynik zapytań KeyCRM oraz ewentualne komunikaty o błędach.

Rysunek 7. Solomono: zakładka zamówień integracji CRM

Rysunek 8. Solomono: logi integracji KeyCRM

8. Utwórz zamówienie testowe

30. Otwórz frontend sklepu i dodaj produkt do koszyka.

31. Złóż zamówienie z dostępną metodą płatności i dostawy.

32. Po złożeniu zamówienia otwórz KeyCRM → Orders.

33. Wyszukaj zamówienie po numerze zamówienia ze źródła lub po nazwie klienta.

Rysunek 9. KeyCRM: testowe zamówienie Solomono w tabeli zamówień

Typowe problemy

Zamówienie nie pojawia się w KeyCRM	Sprawdź API key, domenę https://openapi.keycrm.app/v1, wybrane źródło oraz zakładkę Logs.
Nieprawidłowy status w CRM	Sprawdź zakładkę Order statuses i mapowanie statusów.
Brakuje metody płatności	Sprawdź zakładkę Payment methods.
Brakuje sposobu dostawy	Sprawdź zakładkę Delivery methods.
Webhook nie działa	Upewnij się, że URL webhooka jest dostępny z zewnątrz oraz że firewall / Cloudflare nie blokuje żądań POST.
API key zostało zmienione w KeyCRM	Zaktualizuj klucz w Solomono i ponownie zapisz ustawienia.