Instalacja lokalna

Zawsze możesz użyć lokalnej wersji głównego serwera Syrve Loyalty zamiast globalnej dostępnej pod adresem http://loyalty.syrve.live/. Możliwe jest połączenie Syrve i POS z lokalnym serwerem oraz konfigurowanie programów marketingowych w taki sam sposób, jak na serwerze Syrve.

Ten dokument wyjaśnia, jak zainstalować i skonfigurować główny serwer na Twoim sprzęcie w lokalnej sieci.

Wymagania systemowe

Minimalne wymagania systemowe dla sprzętu, na którym planujesz zainstalować serwer Syrve Loyalty:

System operacyjny - Windows Server 2012R2x64.
Procesor - Intel Core i5 lub podobny.
RAM - 6GB.
Wolne miejsce na dysku - 100GB.
DBMS - Microsoft SQL Server 2014 i nowsze.

Użyj dedykowanej maszyny dla Syrve Loyalty i jego bazy danych. Nie używaj tego samego komputera zarówno dla serwera Syrve Loyalty, jak i serwera Syrve lub Syrve HQ!

Instalacja i konfiguracja głównego serwera

Serwer Syrve Loyalty posiada dwie usługi:

Syrve Loyalty Host Service odpowiada za główne funkcje Syrve Loyalty: kampanie, gości, salda itp. Użyj portu 9900, aby mieć dostęp do API.
Syrve API Service przetwarza żądania API serwera Syrve. Używa portu 9901.

Po aktualizacji Syrve Loyalty do wersji 48, wywołuj żądania API przetwarzane przez Syrve, używając nowego portu - 9901 (zamiast 9900).

[+] Lista żądań przetwarzanych przez usługę

http://localhost:9901/api/0/auth/access_token

http://localhost:9901/api/0/store/supportedProtocols

http://localhost:9901/api/0/orders/add

http://localhost:9901/api/0/orders/info

http://localhost:9901/api/0/orders/checkCreate

http://localhost:9901/api/0/orders/checkAddress

http://localhost:9901/api/0/orders/deliveryOrders

http://localhost:9901/api/0/orders/deliveryHistory

http://localhost:9901/api/0/orders/deliveryHistoryByPhone

http://localhost:9901/api/0/orders/deliveryHistoryByCustomerId

http://localhost:9901/api/0/orders/sendDeliveryOpinion

http://localhost:9901/api/0/orders/get_courier_orders

http://localhost:9901/api/0/orders/AssignCourier

http://localhost:9901/api/0/orders/add_order_problem

http://localhost:9901/api/0/deliverySettings/getDeliveryTerminals

http://localhost:9901/api/0/deliverySettings/getDeliveryRestrictions

http://localhost:9901/api/0/deliverySettings/deliveryDiscounts

http://localhost:9901/api/0/deliverySettings/getSurveyItems

http://localhost:9901/api/0/deliverySettings/getDeliveryCourierMobileSettings

http://localhost:9901/api/0/mobile/signIn

http://localhost:9901/api/0/mobile/sync

http://localhost:9901/api/0/rmsSettings/getRoles

http://localhost:9901/api/0/rmsSettings/getCouriers

http://localhost:9901/api/0/rmsSettings/getCouriersActiveOnDeliveryTerminal

http://localhost:9901/api/0/rmsSettings/GetEmployees

http://localhost:9901/api/0/rmsSettings/GetOrderTypes

http://localhost:9901/api/0/rmsSettings/GetRestaurantSections

http://localhost:9901/api/0/rmsSettings/GetMarketingSources

http://localhost:9901/api/0/rmsSettings/GetPaymentTypes

http://localhost:9901/api/0/paymentTypes/GetPaymentTypes

http://localhost:9901/api/0/stopLists/getDeliveryStopList

http://localhost:9901/api/0/olaps/olapColumns

http://localhost:9901/api/0/olaps/olap

http://localhost:9901/api/0/olaps/olapPresets

http://localhost:9901/api/0/olaps/olapByPreset

http://localhost:9901/api/0/events/events

http://localhost:9901/api/0/events/eventsMetadata

http://localhost:9901/api/0/events/sessions

http://localhost:9901/api/0/employees_data/get_orgnization_base_info

http://localhost:9901/api/0/employees_data/get_employee_base_info

http://localhost:9901/api/0/employees_data/get_employee_data_in_batch

http://localhost:9901/api/0/employees_data/get_employee_transactions

http://localhost:9901/api/0/employees_data/get_employee_attendance

http://localhost:9901/api/0/employees_data/employee_schedule

http://localhost:9901/api/0/employees_data/get_employee_news

http://localhost:9901/api/0/employees_data/get_personal_report

http://localhost:9901/api/0/employees_data/get_deleted_entities

Uzyskaj zgodę na lokalną instalację Syrve Loyalty od Działu Partnerów Syrve.
Pobierz pliki instalacyjne serwera z FTP i zapisz je na komputerze, na którym planujesz zainstalować serwer Syrve Loyalty.
Uruchom Setup.Syrve Loyalty.exe jako administrator i postępuj zgodnie z instrukcjami instalacji. W efekcie główny serwer zostanie zainstalowany w katalogu C:\Program Files\syrve\syrveBiz z następującymi podkatalogami:
- Web Interface - pliki Syrve Loyalty.
- Host Service - usługa Syrve Loyalty.

Syrve Loyalty Host Service pojawi się na liście usług oraz w witrynie\websites\Default Web Site\syrveBiz w IIS.

Jeśli MS SQL z kopią Resto nigdy nie był instalowany na tym komputerze, zostanie zainstalowany MS SQL 2014 Express. Możesz zachować SQL Express, jeśli przewidujesz minimalne obciążenie serwera Syrve Loyalty. Zalecamy instalację komercyjnej wersji MS SQL Standard lub MS SQL Enterprise na tym samym komputerze lub na dedykowanym.

Jeśli MS SQL z kopią Resto jest już zainstalowany na tym komputerze, baza danych zostanie wykryta automatycznie podczas instalacji.

Serwer komunikacyjny RabbitMQ zostanie zainstalowany wraz z głównym serwerem Syrve Loyalty. W tym momencie automatycznie tworzony jest konto corpit z hasłem: xGh4RApm7v. Służy ono do połączenia Syrve i Syrve Loyalty.

Uruchom Setup.Syrve.ApiService.msi jako administrator i postępuj zgodnie z instrukcjami instalacji. W efekcie usługa zostanie zainstalowana w C:\Program Files\syrve\syrveBiz\RMSAPI. Syrve API Service pojawi się na liście usług.
Jeśli chcesz zmienić ustawienia serwera Syrve Loyalty, użyj specjalnego pliku konfiguracyjnego opisanego poniżej. Po edycji plików konfiguracyjnych, zrestartuj Syrve Loyalty Host Service, aby zastosować zmiany.
Sprawdź, czy serwer Syrve Loyalty działa. W tym celu:
1. Upewnij się, że Syrve Loyalty Host Service jest uruchomiona.
2. Usługa loguje się w C:\logs\syrveNetServer. Po zainstalowaniu serwera i uruchomieniu usługi, sprawdź plik logu pod kątem błędów.
3. Wykonaj następujące żądanie http://localhost:9900/api/0/auth/access_token?user_id=test&user_secret=test. Serwer działa, jeśli zwraca:

{"code": null,

"description": null,

"httpStatusCode": 500,

"message": "Niepoprawna nazwa użytkownika [test] lub hasło [test]." }

Przejdź do http://localhost/syrveloyalty w przeglądarce. Jeśli wszystko jest poprawnie skonfigurowane, zostaniesz przeniesiony do strony logowania portalu Syrve Loyalty.

Podczas instalacji zostanie utworzone konto z domyślną nazwą użytkownika i hasłem - admin/admin. Hasła nie można zmienić w obecnej wersji systemu. Konto to posiada szeroki zakres uprawnień: ma dostęp do wszystkich firm w portalu Syrve Loyalty oraz dodatkowe funkcje administracyjne.

Zmień klucz połączenia serwera RabbitMQ w pliku konfiguracyjnym Syrve resto.properties:

zamiast rabbit-mq-uri=amqps://corpit:xGh4RApm7v@mq.Syrve Loyalty:5671

wklej rabbit-mq-uri=amqp://corpit:xGh4RApm7v@BIZ_LOCAL_HOSTNAME:5672.

Gdzie corpit:xGh4RApm7v - automatyczna nazwa użytkownika i hasło, BIZ_LOCAL_HOSTNAME:5672 - nazwa użytkownika i port serwera RabbitMQ. Potrzebujesz tego, aby zarejestrować firmę w lokalnym Syrve Loyalty.

Plik konfiguracyjny resto.properties jest dostępny tylko dla personelu wsparcia technicznego. Skontaktuj się ze swoim dostawcą, aby uzyskać więcej informacji.

Zrestartuj serwer Syrve.
W Syrve określ ustawienia połączenia z Twoim serwerem Syrve Loyalty oraz serwerem RabbitMQ. Jak to zrobić, przeczytaj w artykule Połączenie z Syrve Loyalty.
Zarejestruj swoją firmę na własnym lokalnym serwerze Syrve Loyalty. Szczegóły znajdziesz w artykule Rejestracja w Syrve Loyalty. Twój sklep zostanie zarejestrowany na Twojej kopii serwera Syrve Loyalty, do którego połączenie ustawiłeś w §7.
Zaloguj się do lokalnego Syrve Loyalty, używając danych podanych podczas rejestracji.

Alternatywny plik konfiguracyjny

Podczas aktualizacji instalator nadpisuje serwer. Wszelkie dokonane zmiany zostaną zresetowane do ustawień domyślnych. Aby tego uniknąć, możesz określić parametry serwera Syrve Loyalty w specjalnym pliku, który nie zostanie nadpisany podczas aktualizacji, a Twoje ustawienia zostaną zachowane.

Ten plik konfiguracyjny znajduje się w katalogu C:\Users\syrveBizSvc\AppData\Roaming\syrve\syrveBizServer i nosi nazwę Syrve LoyaltyServer.override.config. Domyślnie ten plik ma następującą strukturę:

<overridableAppSettings><add key="KEY"value="VALUE" /></overridableAppSettings>

Wstaw wymagany klucz i określ jego wartość zamiast . Na przykład:

<overridableAppSettings><add key="db.connection_string"value="Data Source=localhost\RESTO;Initial Catalog=Syrve Loyalty;Integrated Security=True;" /><add key="db.connection_string.master"value="Data Source=localhost\RESTO;Initial Catalog=master;Integrated Security=True;Connection Timeout=5;" /></overridableAppSettings><table><tbody><tr><td><img src="/resources/Storage/loyalty/card-local-installation-2018-05-11-2.png" style="max-width: 100%; height: auto;"></td><td><span style="font-size: 10pt;">Za każdym razem, gdy edytujesz plik konfiguracyjny, zrestartuj usługę Syrve Loyalty Host Service, aby zastosować zmiany.</span></td></tr></tbody></table>

W pliku Syrve LoyaltyServer.override.config możesz określić następujące:

Ustawienia połączenia MS SQL, jeśli baza danych jest inna niż domyślna:
- db.connection_string - łańcuch połączenia z bazą danych.
- db.reports.connection_string - łańcuch połączenia z bazą danych używany do raportów.
- db.connection_string.master - łańcuch połączenia do bazy master.
Ustawienia połączenia RabbitQ, jeśli inne niż domyślne: RabbitMqUri - łańcuch połączenia z serwerem RabbitMQ.
Parametry wysyłania SMS:

Parametry te otrzymasz od swojego dostawcy podczas rejestracji. Możesz też dowiedzieć się, z jakimi usługami SMS Syrve Loyalty jest kompatybilny oraz zobaczyć przykłady konfiguracji w sekcji Konfiguracja Dostawcy SMS.

SmsProvider_Company - nazwa firmy świadczącej usługę SMS.
SmsProvider_Login - login API dostawcy SMS.
SmsProvider_Password - hasło API dostawcy SMS.
SmsProvider_Gate - adres (bez portu), pod którym dostępne jest API dostawcy SMS.
SmsProvider_Port - port, pod którym dostępne jest API dostawcy SMS.

Parametry e-mail:

EmailProvider_IsEnabled - włącz/wyłącz e-mail.
EmailProvider_SmtpHost - adres serwera SMTP do wysyłania e-maili.
EmailProvider_SmtpUser - login do serwera SMTP.
EmailProvider_SmtpPassword - hasło do serwera SMTP.
EmailProvider_From - adres e-mail, z którego będą wysyłane wiadomości.
EmailProvider_UseSsl - używaj/nie używaj SSL podczas łączenia z serwerem SMTP.

E-mail używany do powiadomień o statusie systemu:

Parametr Syrve LoyaltyWebInterfaceUrl służy do tworzenia poprawnych adresów URL interfejsów webowych serwera w e-mailach. Jest on używany do wysyłania wiadomości zawierających linki do strony serwera Syrve Loyalty. Powinien zawierać publiczny adres URL interfejsu webowego serwera dostępnego dla użytkowników. Na przykład, http://loyalty.syrve.live//.

Konfiguracja Dostawcy SMS

Aby móc wysyłać wiadomości na telefony komórkowe klientów, zawierające np. informacje o koncie, musisz włączyć usługę SMS.

Aby system Syrve Loyalty działał z dowolnym dostawcą, wykonaj następujące kroki:

Zawrzyj umowę serwisową z wybranym dostawcą.
Uzyskaj od dostawcy następujące dane:
- Nazwę firmy świadczącej usługę SMS.
- Login API dostawcy SMS.
- Hasło API dostawcy SMS.
- Adres, pod którym dostępne jest API dostawcy SMS.
- Port, pod którym dostępne jest API dostawcy SMS.
Określ parametry otrzymane od dostawcy w pliku konfiguracyjnym Syrve LoyaltyServer.override.config. Więcej informacji o lokalizacji i konfiguracji pliku znajdziesz w Alternatywnym pliku konfiguracyjnym. Poniżej przykład pliku konfiguracyjnego:

Po edycji plików konfiguracyjnych zrestartuj usługę Syrve Loyalty Host Service, aby zastosować zmiany.

Obrazy produktów

Jeśli integrujesz Syrve z witryną dostawczą i eksportujesz menu zawierające zdjęcia posiłków, musisz skonfigurować magazyn obrazów. Użyj usługi Selectel do przechowywania obrazów produktów. Jeśli instalujesz Syrve Loyalty lokalnie, musisz samodzielnie się zarejestrować i skonfigurować połączenie. W tym celu:

Zarejestruj się w Selectel i opłać usługę. Jak to zrobić, znajdziesz w bazie wiedzy Selectel.
Utwórz w swoim osobistym koncie Selectel:
- Dwa magazyny: jeden na obrazy produktów, drugi na inne obrazy.

Użytkownika, pod którym dane będą zapisywane i odczytywane z magazynu.

Dodaj parametry połączenia Selectel do pliku konfiguracyjnego Syrve LoyaltyServer.override.config:

W poniższych parametrach zmień wartości -

SelectelLogin i SelectelPassword - nazwa użytkownika i hasło użytkownika Selectel utworzonego wcześniej (patrz §2).
SelectelDomainUrl - adres URL podany w ustawieniach obu magazynów.
SelectelNomenclatureContainerName - magazyn obrazów produktów.
SelectelImagesContainerName - magazyn innych obrazów.

Zrestartuj usługę Syrve Loyalty Host Service, aby zastosować zmiany.
Eksportuj menu do Syrve Office.

Instalacja i konfiguracja głównego serwera​

Alternatywny plik konfiguracyjny​

Konfiguracja Dostawcy SMS​

Obrazy produktów​

Instalacja i konfiguracja głównego serwera

Alternatywny plik konfiguracyjny

Konfiguracja Dostawcy SMS

Obrazy produktów