Integracja z Loyalty Starter

Wstęp

Integracja z system lojalnościowym Loyalty Starter.

Integracja polega na nadawaniu punktów kontrahentom na podstawie faktur wystawianych w systemie Symfonia Handel.

Opis funkcjonalny

Uruchamianie na procedurze AfterInsert (czyli od razu po wystawieniu faktury) zakolejkowania naliczenia punktów danej fakturze. Wystawienie faktury powoduje "zakolejkowanie" procedury naliczenia punktów, a samo naliczanie punktów odbywa się cyklicznie (np. co 5 minut) na serwerze.

Integrator sprawdza jakie są aktualnie punkty dla poszczególnych grup towarowych w LoyaltyStarter i wylicza ilość punktów jakie każda grupa pozycji na fakturze wygenerowała kontrahentowi.

• rodzaj towaru w Symfonii służy do powiązania z grupą towarową w LoyaltyStarter (nazwa grupy towarowej w Loyaltystarter musi być taka sama jak nazwa rodzaju w Symfonii)
• punkty są naliczanie tylko wtedy, gdy grupa towaru ma ustawiony przelicznik w Loyaltystarter

Korekty z wartościami ujemnymi zmniejszają punkty.

Numer klienta w LoyaltyStarter jest odczytywany z:
- pola dodatkowego faktury
- jeśli nie ma wprowadzonego numeru na fakturze to numer sprawdzamy w wymiarze kontrahenta.

Instalacja funkcjonalności

1. Instalacja HPP (tylko na serwerze)

2. Wgranie raportów do Symfonia Handel (tylko raz z dowolnego stanowiska)

• hpp_runtime.sc - NET Runtime (BLOT)
• hpp_eitg_ls00.sc - Integracja Loyaltystarter - Ustawienia NET (BLOT)
• hpp_eitg_ls01.sc - NET Runtime - Integracja Loyaltystarter (BLOT)
• procsp.sc - Procedury dokumentu sprzedaży

Konfiguracja modułu

Konfiguracja jest wykonywana jednorazowo podczas wdrożenia i pierwszego uruchomienia integracji. Obejmuja ona szereg parametrów konfiguracyjnych.

Ustawienie zadania w harmonogramie zadań serwera na uruchomienie 'automatu'
Zadanie powinno być uruchamiane np. co 5 minut lub raz dziennie. Częstotliwość uzgadniana podczas wdrożenia.
Każde uruchomienie zadania spowoduje wysłanie punktów ze wszystkich skolejkowanych do tej pory faktur.
Po poprawnym wysłaniu punktów faktury zostaną usunięte z kolejki.

Akcja:

• Program/skrypt:
  • C:\hpp\hpp.exe
• Argumenty:
  • "<HMF/H50>|<skrót firmy>" EITG_LOYALTYSTARTERGENERUJ
  • w zależności od rodzaju programu wpisujemy HMF lub H50
  • należy również wpisać skrót firmy do argumentu
• Rozpocznij w: C:\hpp

Uruchomienie

Funkcjonalność działa automatycznie. Warunkiem jest poprawna instalacja i konfiguracja rozwiązania.

Konfiguracja dodatku

Aby uruchomić okno z konfiguracją należy otworzyć w Symfonii Handel okno raportów (Kartoteki -> Raporty), następnie wchodzimy kolejno do Symfonia.Pro -> HPP.
Klikamy PPM na raport "Integracja Loyaltystarter - Ustawienia NET (BLOT)" i wybieramy "Wykonaj raport".

Pokaże nam się poniższe okno.

W polach ClientID oraz Secret należy podać dane autoryzacyjne do API wygenerowane w panelu administracyjnym Loyaltystarter.
Instrukcja wygenerowania ww. danych: INSTRUKCJA
(Podczas dodawania aplikacji wg powyższego linku należy zaznaczyć w sekcji 'Dostęp' zarówno Odczyt jak i Zapis)

W polu Numer klienta w Loyaltystarter należy wybrać pole dodatkowe (typu tekstowego) faktur sprzedaży, z którego będziemy odczytywać numer klienta w Loyaltystarter.

W polu Kartotekowy numer klienta w Loyaltystarter należy wskazać wymiar (typu tekstowego) kontrahenta, z którego będziemy odczytywać numer klienta w Loyaltystarter
(w przypadku braku tego numeru w polu dodatkowym faktury).

Po uzupełnieniu danych w sekcji Parametry API możemy sprawdzić czy wszystko jest poprawnie ustawione poprzez kliknięcie guzika Przetestuj połączenie.
Spowoduje on testowe zalogowanie się przez API do Loyaltystarter i pobranie pierwszego klienta w bazie.
Jeżeli nam się to uda to dostaniemy komunikat Połączenie poprawne!. W przeciwnym przypadku dostaniemy informację o błędzie.

Kliknięcie Zapisz spowoduje zapisanie zmian na oknie i zamknięcie okna ustawień.
Kliknięcie Anuluj spowoduje zamknięcie okna ustawień bez zapisania dokonanych zmian.