Enova.Loyalty Program lojalnościowy Dokumentacja techniczna + Instrukcja użytkownika DRIT 1
1. Wstęp...3 2. Instalacja...3 3. Konfiguracja...4 4. Opis działania...8 5. System uprawnień...10 DRIT 2
1. Wstęp Jeśli prowadzimy sklep, firmę lub świadczymy usługi i chcemy zwiększyć przywiązanie Swoich Klientów oraz pozyskać nowych, w tym celu najlepiej wybrać i wdrożyć profesjonalny Program Partnerski, na którym będziemy mogli oprzeć sprzedaż oferowanych produktów lub usług. Enova.Loyalty to specjalnie dedykowany do tego celu dodatek oferujący teraz taką możliwość w oparciu o rozszerzenie funkcjonalności systemu ERP enova we współpracy z modułami Handel, CRM. Opis działania: Podczas sprzedaży (paragon lub faktura) Klient podaje sprzedawcy swój numer karty lojalnościowej (numer jest w kodzie EAN13). Sprzedawca do momentu zatwierdzenia faktury lub paragonu, w każdej chwili wprowadzania pozycji towarów/usług na paragon lub fakturę może wywołać okienko programu lojalnościowego gdzie wprowadza nr karty lojalnościowej. Jeśli nr karty lojalnościowej zostanie wprowadzony to w momencie zapisywania faktury/paragonu wtyczka automatycznie wyśle dane do systemu lojalnościowego, które będą zawierać 4 dane: - nr karty lojalnościowej Partnera ( w kodzie EAN13) - kwota transakcji brutto faktury lub paragonu - nr paragonu/faktury - Identyfikator Sprzedawcy, który naliczył sprzedaż w programie lojalnościowym. W przypadku braku połączenia internetowego, dane gromadzone są w kolejce do wysłania od ostatniej poprawnej potwierdzonej transakcji. 2. Instalacja Dodatek rozprowadzany jest w formie biblioteki dll dołączanej dynamicznie do systemu enova. Bibliotekę należy wgrać (w zależności od architektury systemu operacyjnego) do katalogu w zmiennej środowiskowej %CommonProgramFiles %\Soneta\Assemblies. DRIT 3
Pierwsze uruchomienie enova po instalacji dodatku będzie wymagało przeprowadzania konwersji bazy danych co należy wykonać z uprawnieniami administratora programu po wcześniejszym wylogowaniu pozostałych operatorów pracujących na systemie (UWAGA: Jeśli baza enova działa w oparciu o silnik bazodanowy MySQL przed wykonaniem konwersji zaleca się sporządzenie kopii zapasowej w celu przywrócenia stanu bazy sprzed konwersji w razie wystąpienia błędu MySQL nie obsługuje bowiem w pełni transakcyjności i rollback nie wykona się tak jak to ma miejsce w przypadku MSSQL). 3. Konfiguracja Ustawienia programu lojalnościowego znajdują się w sekcji konfiguracyjnej bezpośrednio w samej enova, przez co zarządzać systemem można w trybie WYSIWYG: Dostęp do sekcji z poziomu Narzędzia / Opcje / Program lojalnościowy. Konfiguracja podzielona jest na trzy podstawowe sekcje: Ogólne, Skaner kodów, Sprzedawcy. W pierwszej zakładce czyli Ogólne, ulokowane są podstawowe ustawienia systemu. DRIT 4
Pole Url zawiera adres webservice programu lojalnościowego z którym jesteśmy aktualnie połączeni. Pole ma domyślnie status tylko do odczytu, gdyż ma za zadanie informować jedynie czy systemu uruchomiony jest w środowisku testowym (tzw. sandbox) czy produkcyjnym. W standardzie dodatek rozprowadzany jest w trybie produkcyjnym. Pole Aktywny to flaga do globalnego włączania/wyłączania aktywności programu lojalnościowego. Czynność nie wymaga ponownego uruchomienia systemu enova. Pierwsze włączenie systemu wymusi wybór rodzaju kodu kreskowe z listy w sekcji Pozostałe Domyślnie używanym standardem jest EAN13. Pole Połącz asynchronicznie określa czy przesyłanie transakcji do systemu lojalnościowego ma być przeprowadzane w sposób synchroniczny (żądanie odpowiedź) czy asynchroniczny, gdzie potwierdzenie transakcji może przyjść w dowolnej chwili i zostaje obsłużone w tle w sposób niewidoczny dla użytkownika. Pole Akceptuj nieautoryzowane certyfikaty SSL jest opcjonalne i wykorzystywane tylko dla w sporadycznych przypadkach gdzie serwis programu lojalnościowego działa w oparciu o protokół HTTPS a certyfikat SSL nie został wystawiony przez autoryzowanego dostawcę. Głównie wykorzystywane w przypadku środowiska testowego. W trybie produkcyjnym serwis obsługiwany jest przez certyfikat wildcard. DRIT 5
Pole Podczas naliczenia rabatu - definiuje zachowanie systemu w sytuacji obsługi transakcji na dokumencie na którym nastąpiła zmiana ceny lub przyznanie procentowe rabatu (u uwzględnieniem tego samego warunku do każdej pojedynczej pozycji towarowej). Dostępne opcje to: Ignoruj: punkty prowizji będą wówczas naliczane niezależnie od przyznania rabatu Blokuj: punkty domyślnie nie będą naliczane. Pytaj: Użytkownik podczas zatwierdzania dokumentu jak faktura czy paragon, sam będzie mógł określić czy naliczyć prowizje. Pole Tryb Offline określa czy system weryfikacji transakcji ma działać w przypadku braku połączenia internetowego. Bez tej flagi jeśli stacja znajduje się w trybie offline, podczas zatwierdzania faktury lub paragonu nastąpi wyjątek o braku połączenia. Ustawienie jej na TAK pozwoli zatwierdzić poprawnie dokumenty handlowe również w przypadku braku połączenia z siecią, a niezatwierdzone transakcje zostaną ustawione w kolejce do weryfikacji przy przejściu w tryb online. Włączenie tej flagi automatycznie pozwala na edycję sekcji Harmonogram gdzie ustalamy sposób weryfikacji transakcji offline. Do wyboru mamy następujące opcje: Po zalogowaniu do systemu enova Przed wylogowaniem użytkownika O określonej godzinie (Scheduler) Pole Rodzaj kodu kreskowego - opis powyżej w sekcji pola Aktywny. Pole Definicje dokumentów - zawiera kolekcję definicji dokumentów handlowych, które będą używane w procesie naliczania punktów w programie lojalnościowym. Standardowo są to definicje Faktura sprzedaży (FV), Paragon fiskalny (PAR), jednakże operator może wybrać i skonfigurować własne definicje dokumentów. DRIT 6
Następna sekcja to Skaner kodów, gdzie dokonujemy skustomizowanych ustawień skanera kodów paskowych (włączenie/wyłączenie, ustawienie prefixu, sufixu etc.). Ostatnia sekcja to ustawienia sprzedawców naliczających punkty w programie lojalnościowym. DRIT 7
Każdy sprzedawca musi być spięty relacją z operatorem enova. Reszta to ustawienia systemu lojalnościowego jak Identyfikator sprzedawcy oraz hasło do poprawnej autoryzacji w systemie. Dodatkowo pole Blokada na formularzu pozwala w każdym momencie wyłączyć danego sprzedawcę z systemu bez konieczności usunięcia konta na stałe. 4. Opis działania Podczas wystawiania dokumentu handlowego o definicji określonej wcześniej w konfiguracji systemu lojalnościowego, w dowolnym momencie możemy wprowadzić numer karty lojalnościowej klienta wywołując specjalne okienko (skrót klawiszowy F9) gdzie wpisujemy numer z palca bądź skanując kod EAN bezpośrednio z karty. DRIT 8
System zablokuje zatwierdzenie dokumentu bez wprowadzonego uprzednio numeru karty informując o tym odpowiednim komunikatem: Jeśli klient nie posiada jeszcze karty można obejść weryfikację wprowadzając numer 1111. W celu ułatwienia pracy sprzedawcy numer 1111 można ustawić jako domyślnie inicjowany na karcie poprzez przycisk Ustaw jako domyślne. DRIT 9
Poniżej widok transakcji którą wykonaliśmy w poprzednim punkcie już przesłanej do programu lojalnościowego. Oraz widok prowizji i innych danych naliczonych przez system lojalnościowy. 5. System uprawnień Poniżej zamieszczony jest schemat struktury praw w programie lojalnościowym Enova.Loyalty. Prawami zarządza się z poziomu Roli: Narzędzia / Opcje / Systemowe gdzie gałąź Prowizje jest węzłem nadrzędnym. DRIT 10
Dostępne są trzy poziomu dostępu: Definicja prowizji odnosi się do konfiguracji sprzedawców. Sam sprzedawca do poprawnej pracy musi mieć do tego elementu prawo co najmniej do odczytu. Prawo w ścieżce Definicje prowizji / Page / Ogólne odnosi się do formularza sprzedawcy opisanego szerzej w sekcji Konfiguracja. Odebranie prawa do formatki + prawo tylko do odczytu do samego elementu definicji oznacza iż operator nie może dodawać nowych sprzedawców do systemu. (UWAGA: Operator będący administratorem programu lojalnościowego musi posiadać prawo do zarządzania operatorami systemowymi enova) Gałąź Simple reprezentuje z kolei prawa edycji na poszczególnych poziomach. Najbardziej uprzywilejowanym jest prawo Zarządzanie systemem które daje możliwość większości opcji konfiguracyjnych opisanych w rozdziale 2. Przy oznaczeniu prawa do wyboru definicji dokumentów dla operatora nie będącego standardowo administratorem systemu należy pamiętać o kwestii uprawnień do samych definicji w module handel (prawa obiektowe). Gałąź Transakcja odnosi się natomiast do obiektu który jest generowany na etapie naliczania punktów podczas wystawiania faktury lub paragonu. Do poprawnej pracy systemu lojalnościowego wymagane jest by każdy sprzedawca miał do tego elementu pełne prawo dostępu (Pozwolenie / edycja) DRIT 11