Minimalne wymagania niezbędne do prawidłowego działania Comarch POS:

• System Operacyjny Microsoft Windows 10/11
• Procesor
  • zalecany: Intel Core i5 4th Gen lub odpowiednik AMD Ryzen 5 (Wynik w CPU benchmark 5000 pkt – w celu zapewnienia akceptowalnej reakcji)
  • minimum: Intel Core i3 lub odpowiednik AMD Ryzen 3 (Wynik w CPU benchmark 3000 pkt – w celu zapewnienia akceptowalnej reakcji)
• 8 GB pamięci RAM (lub więcej)
• Microsoft .NET Framework 4.7.2
• Microsoft SQL Server 2019/2022 w wersji express
• Collation Latin1_General_CI_AS
• dysk twardy SSD:
  • zalecane: 40GB wolnego miejsca
  • minimum: 20GB wolnego miejsca (+ miejsce na dodatkowe dane np. zdjęcia towarów)

Podczas instalacji aplikacji Comarch POS, Comarch ERP Auto Update weryfikuje wersję zainstalowanego komponentu Microsoft .NET Framework. W przypadku braku lub niższej wersji tego komponentu, zostanie on zainstalowany w wymaganej wersji.

Pobieranie oraz instalacja Comarch POS odbywa się za pomocą aplikacji Comarch ERP Auto Update.

Opis aplikacji oraz jej funkcjonalności jest dostępny na dedykowanej stronie: https://pomoc.comarch.pl/autoupdate/

Pobieranie i instalacja Comarch POS została opisana w artykule: https://pomoc.comarch.pl/autoupdate/documentation/dodawanie-i-konfiguracja-produktu-na-przykladzie-comarch-retail/

Comarch POS Agent

Informacje podstawowe

Usługa (POS Agent) dostarcza aktualne informacje o stanach magazynowych na każdym stanowisku , podczas wystawiania dokumentów. Informacje te prezentowane są z uwzględnieniem poszczególnych magazynów. Wszystkie procesy w magazynie będą mogły zachodzić w trybie offline z centralą, dzięki czemu korzystanie z tej usługi zapewni pełną autonomię sklepu, poprzez zagwarantowanie, że stan magazynowy jest zawsze aktualny.

W trybie pracy offline z centralą, do komunikacji z usługą POS Agent wykorzystywany jest broker wiadomości Comarch POS Agent Broker. Komponent ten agreguje kolejkę wiadomości, przekazując aktualizację stanów magazynowych do właściwego POS Agenta w danym sklepie.

Usługa POS Agent to miejsce, w którym przechowywane będą wszystkie niezbędne informacje dla stanowiska POS m.in.:

• zaparkowane dokumenty
• statystyka licznika bramek
• stany magazynowe wraz z rezerwacjami

Zasada działania

Usługa POS Agent działa jako samodzielna usługa z własną bazą danych na tym samym komputerze co baza Comarch POS lub osobnym.

Przed zatwierdzeniem dokumentów POS Agent weryfikuje poprawność stanów magazynowych na dokumentach:

• handlowych:
  • Paragony (PAR) oraz ich korekty ilościowe i ręczne
  • Faktury sprzedaży (FS) oraz ich korekty ilościowe i ręczne
  • Zamówienia sprzedaży (ZS)
• magazynowych:
  • Przesunięcia międzymagazynowe (MM-/MM+)
  • Przychody oraz rozchody wewnętrzne (PW/RW) oraz ich korekty ilościowe
  • Przyjęcia oraz wydania zewnętrzne (PZ/WZ) oraz ich korekty ręczne
    

Instalacja i konfiguracja

Instalacja usługi Comarch POS Agent odbywa się przy pomocy narzędzia Comarch ERP Auto Update.

Po uruchomieniu Comarch ERP Auto Update należy wykonać następujące czynności:

• Na zakładce Konfiguracja dodać produkt Comarch Retail.

  

• Dla produktu Comarch POS dodać komponent Comarch POS Agent.

• Skonfigurować komponent Comarch POS Agent. Okno konfiguracji otwierane jest poprzez zaznaczenie komponentu oraz wybranie z menu przycisku [Konfiguracja]. W oknie należy wskazać dane do połączenia z serwerem Microsoft SQL Server Management Studio, na którym zostanie zainstalowana baza POS Agent.

  

  • Nazwa serwera – nazwa serwera wraz z instancją, na którym zostanie zainstalowana baza danych
  • Nazwa bazy danych – domyślnie podpowiada się BOSDB_[kod_profilu]
  • Dane do logowania – Login, Hasło

Przycisk [Test połączenia] umożliwia sprawdzenie nawiązania połączenia ze wskazanym serwerem.

• Następnie należy zapisać zmiany oraz zamknąć okno konfiguracji komponentu przez wybranie odpowiednio przycisków [Zapisz] i [Zamknij].

Konfiguracja

• Należy skonfigurować w systemie ERP stanowisko POS Agent. Szczegółowa instrukcja dostępna jest w dokumentacji systemu ERP w artykułach dotyczących dodawania i konfiguracji nowego stanowiska POS.
• W kolejnym kroku należy otworzyć katalog instalacyjny POS Agent i uruchomić aplikację PosAgentConfigurator.exe.
• Pojawi się komunikat informujący o tym, że usługa jest odinstalowana:

• Po naciśnięciu przycisku [OK] następuje ładowanie parametrów:

• Po załadowaniu parametrów otwiera się okno konfiguratora:

• W aplikacji należy podać:
  • Adres IP usługi POS Agent – adres IP komputera, na którym została zainstalowana usługa POS Agent

• • Port usługi POS Agent – domyślnym portem jest 8098
  • Adres serwera OMS – domyślnym adresem jest http://localhost:8099/DataService/
  • Kod POS Agenta – kod POS Agent wprowadzony w systemie ERP
  • GUID – wartość nadawana automatycznie
• Usługę instaluje się za pomocą przycisku [Instaluj].

• Poprawność wcześniej wprowadzony danych można zweryfikować za pomocą przycisku [Weryfikuj]. Natomiast przycisk [Rejestruj] służy do rejestracji usługi POS Agent.
• W celu weryfikacji czy proces zakończył się poprawnie, należy przejść na zakładkę POS Agent w Comarch ERP Altum i sprawdzić, czy zaktualizowane zostały wpisy w polach: Host, Port i GUID.

W aplikacji POS, po instalacji usługi, dostępna jest ikona której kolor informuje o stanie połączenia z usługami:

• Zielony – wszystkie usługi są włączone

• Żółty – jedna z usług jest wyłączona

• Czerwony – wszystkie usługi są wyłączone

Dodatkowo pod ikoną dostępny jest również przycisk [Ustawienia usług], który otwiera okno konfiguracji usług aplikacji Comarch POS, dostępny również z menu głównego pod kaflem Konfiguracja.

Rejestracja usługi POS Agent z poziomu wiersza poleceń

Istnieje możliwość rejestracji usługi Comarch POS Agent z poziomu wiersza poleceń systemu Windows. Dostępne komendy:

• –register
• –install
• –uninstall
• –setaddress –agentIP:127.0.0.1 –port:8098 (ustawienie adresu IP i portu dla usługi POS Agent)
• –seterpaddress –adres:http://example.com (ustawienie adresu serwera OMS)
• –stop
• –start
• –help
• –status
• –waitforstatus

W celu rejestracji usługi Comarch POS Agent z poziomu wiersza poleceń należy:

1.Otworzyć wiersz polecenia jako administrator z lokalizacji:

C:\Users\nazwa.użytkownika\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\System Tools

2.Odnaleźć i skopiować ścieżkę gdzie znajduje się aplikacja Konfigurator usługi POS Agent (folder Comarch POS Agent), przykładowa ścieżka:

C:\2022_5\Comarch Retail\Comarch Retail POS Agent

3.W wierszu polecenia wpisać: cd C:\2022_5\Comarch Retail\Comarch Retail POS Agent i wybrać przycisk [Enter]

4.Zainstalować usługę POS Agent wpisując: POSAgentConfigurator.exe –install i wybrać przycisk [Enter]

5.Po poprawnej instalacji należy wystartować usługę wpisując: POSAgentConfigurator.exe –start i wybrać przycisk [Enter]

6.W celu rejestracji usługi należy wpisać: POSAgentConfigurator.exe –register i wybrać przycisk [Enter]

7.W celu weryfikacji statusu połączenia usługi należy wpisać: POSAgentConfigurator.exe –status i wybrać przycisk [Enter]

Po sprawdzeniu statusu wyświetlane są informacje o:

• stanie usługi
• adresie usługi Comarch POS Agent
• adresie usługi OMS
• kodzie POS Agenta
• GUID zarejestrowanego POS Agenta

Wymagalność portów

Na poniższym schemacie przedstawiono komunikację komponentów według domyślnych portów. Schemat uwzględnia również kierunek połączenia pomiędzy komponentami.

Informacje podstawowe

Komponent Comarch POS Agent Broker (POS Agent Broker) wykorzystywana jest do komunikacji z usługą Comarch POS Agent (POS Agent) jako broker wiadomości. Komponent agreguje kolejkę wiadomości, przekazując aktualizację stanów magazynowych do właściwego POS Agenta w danym sklepie, przy braku połączenia z centralą.

Aktualizowanie informacji umożliwia przy wystawianiu dokumentów w Comarch ERP Altum:

• weryfikacje aktualnego stanu zasobów na stanowisku POS przed wygenerowaniem dokumentu, który pobiera informacje o stanach z magazynu przypisanego do danego stanowiska POS
• wprowadzenie do kolejki wiadomości np. o zwiększeniu stanów magazynowych, gdy zostanie wystawiony dokument, który zwiększa takie stany magazynowe

Instalacja i konfiguracja

Przed instalacją komponentu POS Agent Broker należy włączyć dodatkowe funkcje systemu Windows – Internetowe usługi informacyjne (IIS).  W tym celu należy przejść do Panelu sterowania → Programy i funkcje → Włącz lub wyłącz funkcje systemu Windows → Internetowe usługi informacyjne (IIS) i włączyć:

• Narzędzia zarządzania siecią Web
• Usługi WWW

Instalacja Comarch POS Agent Broker odbywa się przy pomocy narzędzia Comarch ERP Auto Update.

Po uruchomieniu Comarch ERP Auto Update należy wykonać następujące czynności:

• Na zakładce Konfiguracja dodać produkt Comarch Retail

  

• Dla produktu Comarch POS dodać komponent Comarch POS Agent Broker.

  

Dodatkowo, w systemie ERP należy skonfigurować lokalizację sieciową zainstalowanej usługi POS Agent Broker. Szczegółowe informacje znajdują się w dokumentacji systemu ERP, w artykułach dotyczących dodawania i konfiguracji nowego stanowiska POS.

Adres usługi Comarch POS Agent Broker

W celu sprawdzenia pod jakim adresem została udostępniona usługa Comarch POS Agent Broker należy:

• Otworzyć Menedżer internetowych usług informacyjnych (IIS)
• W widoku Połączenia rozwinąć Witryny -> Default Web Site
• Wskazać pozycję zawierającą w nazwie ’POSAgentBroker’
• W widoku Akcje wybrać Przeglądaj *:80 (http)

• W domyślnej przeglądarce w pasku adresu znajdzie się poprawny link do usługi POS Agent Broker

Instrukcja instalacji Comarch POS we współpracy z Comarch ERP XL w systemie rozproszonym

Instrukcja prezentuje instalacje Comarch POS we współpracy z Comarch ERP XL w strukturze rozproszonej. Oznacza to, że Comarch ERP XL i Comarch POS nie znajdują się na jednej maszynie, a na przykład do utrzymania połączeń usług wykorzystuje się router.

Słownik pojęć

• Comarch ERP Auto Update – narzędzie niezbędne do instalacji produktu Comarch Retail i jego komponentów, przy instalacji tworzony jest profil główny, aplikacja umożliwia tworzenie dodatkowych profili o niezależnej konfiguracji
• Comarch POS Agent – działa jako samodzielna usługa z własną bazą danych, dostarcza aktualne informacje o stanach magazynowych na każdym stanowisku, podczas wystawiania dokumentów
• Comarch POS Agent Broker – zapewnia komunikacje pomiędzy usługą POS Agent a systemem ERP, komponent ten agreguje kolejkę wiadomości, przekazując aktualizację stanów magazynowych do właściwego POS Agenta. Należy pamiętać że komponent POS Agent Broker może być dodany tylko na jednym profilu w programie Comarch ERP Auto Update.

• Usługa synchronizacji Data service – dzięki usłudze możliwa jest synchronizacja system ERP <-> POS. Nazwę usługi i jej port definiuje się w systemie ERP, brak usługi uniemożliwia pracę z aplikacją Comarch POS.
• Kafka message queue – rozproszona platforma przesyłania strumieniowego typu „open source”, która umożliwia tworzenie aplikacji i protokołów danych przesyłania strumieniowego w czasie rzeczywistym. Kafka pełni funkcję usługi brokera komunikatów. Działa po zainstalowaniu komponentu Comarch POS Agent Broker.
• Zookeeper Service – usługa, działająca po zainstalowaniu komponentu Comarch POS Agent Broker. Służy do utrzymywania wspólnego stanu dla wszystkich instancji Kafki, zarządzania konfiguracją, monitorowania.

1. System ERP i usługa synchronizacji wysyła żądanie do Comarch POS Agent Brokera
2. Żądanie zapisuje się w kolejce zadań
3. Żądanie jest odczytywane
4. Comarch POS Agent Broker wysyła żądanie do POS Agenta
5. Następuje procesowanie w POS Agencie
6. POS Agent wysyła odpowiedź do Brokera
7. Odpowiedź zapisuje się w kolejce odpowiedzi
8. Odpowiedź jest odczytywana przez Broker
9. Comarch POS Agent Broker wysyła odpowiedź do systemu ERP i usługi synchronizacji

Informacje o logach

Szczegółowe informacje o zdarzeniach występujących na stanowisku POS dotyczące samej aplikacji Comarch POS, któregoś komponentu lub usługi, rejestrowane są w plikach txt (logach). Domyślne ścieżki zapisywania logów:

• dla stanowiska POS to: C:\Retail\POS2\mainprofile\Logs

Uwaga

W przypadku innego profilu niż główny w Auto Update, ścieżka do logowania znajduje się w pliku POS2.exe.config w katalogu Comarch POS.

• dla usługi POS Agent: C:\Retail\POS Agent\mainprofile\Logs i C:\Retail\POSAgentConfig\Log
• dla usługi synchronizacji Data Service: C:\Program Files (x86)\Comarch ERP XL\XLDataService\POS_LOG\Comarch.XL.POS.Data.Service
• dla kolejki wiadomości: C:\Kafka\kafka\logs (All + Own)
• dla POS Agent Brokera: C:\Program Files (x86)\Comarch Retail\Comarch POS Agent Broker\Logs
• dla aplikacji Comarch ERP Auto Update: C:\Program Files (x86)\Comarch ERP Auto Update\Logs

Informacje ogólne

Od wersji Comarch ERP XL 2021.0 oraz Comarch POS 2021.0 do współpracy między systemami konieczne jest wykorzystywanie nowych komponentów: Comarch POS Agent oraz Comarch POS Agent Broker.

Komponenty te należy zainstalować za pomocą Comarch ERP Auto Update wraz z instalacją produktu Comarch POS.

Aktualizacja Comarch ERP Auto Update do wersji 2020.0 lub wyższej

1.Aby móc w pełni korzystać ze wszystkich możliwości sieci agentów należy zaraz po podniesieniu agenta nadrzędnego zaktualizować agentów podrzędnych. Jest to wymagane, ponieważ nie ma możliwości wykonywania akcji zdalnych pomiędzy wersjami 2019.0 i 2020.0.

2. W celu dokonania procesu aktualizacji należy uruchomić lub zrestartować UI agenta nadrzędnego (w zależności od tego, czy był on aktualnie uruchomiony w momencie udostepnienia paczki z nową wersją Comarch ERP Auto Update)

3. W zależności od tego, czy parametr na oknie konfiguracji AU „Aktualizuj automatycznie przy starcie programu” jest zaznaczony proces aktualizacji rozpocznie się sam lub będzie wymagane potwierdzenie go przez użytkownika

4. Następnie powinno pojawić się okno z progressbarem:

5. W czasie aktualizacji agent nadrzędny automatycznie przełączy się do serwera update.comarch.com z portu 8466 na port 9466. Po ukończeniu aktualizacji najlepiej sprawdzić czy usługa RabbitMQ jest uruchomiona. Można także w oknie przeglądarki wejść na adres http://localhost:15672 i zalogować się jako admin (Login: admin, Hasło: admin). Jeżeli nie będzie z tym żadnych problemów oznacza to, że usługa rabbita została poprawnie skonfigurowana.

6.Wszyscy agenci podrzędni będą widnieć na liście, jako „Offline”, aż do momentu podniesienia ich do wersji 2020.0. Kropka zmieni się na „Online” gdy uzyskają oni połączenie do kolejki rabbita. Agentów podrzędnych można podnieść albo wszystkich na raz przy pomocy przycisku „Aktualizuj wszystkich” albo po jednym, po rozwinięciu danego agenta i wybraniu „Aktualizuj agenta” . Wtedy rozpocznie się jego proces aktualizacji.

7. W czasie aktualizacji podrzędnego, jeżeli wymagane porty są otwarte w kolumnie „Status” będą wyświetlane kroki jego aktualizacji.

8. Po zakończeniu aktualizacji agent podrzędny stanie się „Online” a w kolumnie „Wersja” pojawi się informacja o zainstalowanych na nim komponentach. Zielony „check” w kolumnie „Nazwa” oznacza, że dany agent podrzędny znajduje się w aktualnej wersji.

Po aktualizacji AutoUpdate do wersji 2020.0 będzie on domyślnie używał komunikacji WCFowej.

9.Do zmiany formy komunikacji agent nadrzędny <-> agenci podrzędni na RESTa należy na oknie konfiguracji w sekcji „Konfiguracja komunikacji” zaznaczyć „Używaj komunikacji RESTowej”. Po zapisaniu konfiguracji nastąpi restart UI I usługi AU i forma komunikacji pomiędzy agentem nadrzędnym i podrzędnymi ulegnie zmianie. Zmiana formy komunikacji zalecana jest dopiero po podniesieniu sieci agentów podrzędnych, ponieważ komunikacja AU 2019.0 <-> AU 2020.0 może odbyć się tylko przy pomocy WCFa.

10. Wymagana konfiguracja portów dla AU 2020.0, jeżeli zarówno agent nadrzędny, jak i agenci podrzędni zostali podniesieni do nowej wersji:

Na agencie nadrzędnym:

1. Połączenia przychodzące:

• 5672
• 8009
• 11365

2.Połączenia wychodzące:

• 9466

Na lokalnym agencie nadrzędnym:

1. Połączenia przychodzące:

• 8009

2. Połączenia wychodzące:

• 5672
• 8009
• 11365

Na agencie podrzędnym:

1. Połączenia wychodzące:

• 5672
• 8009
• 11365

Instalacja i konfiguracja po stronie Comarch ERP XL

Pełna instrukcja konfiguracji stanowiska POS znajduje się pod linkiem:

https://pomoc.comarch.pl/xl/index.php/dokumentacja/xl137-instalacja-i-konfiguracja-pos/ 

1. Na komputerze na którym znajduje się Comarch ERP XL należy zainstalować Auto Update w wersji nadrzędnej nazwa profilu i kod musi być taki sam jak dla agenta podrzędnego. Instrukcja instalacji agenta nadrzędnego znajduje się pod linkiem:

https://pomoc.comarch.pl/pos/documentation/instalacja-comarch-erp-auto-update/

2. Na komputerze na którym będzie znajdował się POS należy zainstalować agenta podrzędnego, nazwa profilu i kod musi być taki sam jak dla agenta nadrzędnego, informacje na temat zrządzania strukturą agentów podrzędnych, znajdują się w dokumentacji:

https://pomoc.comarch.pl/autoupdate/documentation/struktura-agentow-i-agent-podrzedny/

3. Przy definiowaniu stanowiska POS w systemie Comarch ERP XL należy określić typ licencji:

Od rodzaju licencji określonej na poziomie danego stanowiska zależy dostępność funkcji dla poszczególnych modułów aplikacji:

• Back office (funkcjonalność magazynowa)
• Front office (funkcjonalność sprzedażowa)

4. Na zakładce POS Agent w konfiguracji Oddziału Comarch POS należy zdefiniować kod POS Agenta.

Komponent POS Agent Broker

Przed instalacją komponentu POS Agent Broker należy włączyć dodatkowe funkcje systemu Windows – Internetowe usługi informacyjne (IIS).  W tym celu należy przejść do Panelu sterowania → Programy i funkcje → Włącz lub wyłącz funkcje systemu Windows → Internetowe usługi informacyjne (IIS) i włączyć:

• Narzędzia zarządzania siecią Web
• Usługi WWW

1.Na komputerze gdzie zainstalowany jest agent nadrzędny (serwer centralny na którym znajduje się system ERP) należy dodać produkt Comarch Retail i komponent Comarch POS Agent Broker.

2. Po dodaniu komponentu Comarch POS Agent Broker w aplikacji Comarch ERP Auto Update należy zainstalować odpowiednią wersję Brokera. (Tabela 1 Współpraca pomiędzy systemami a komponentami)

3. Po instalacji komponentu, należy wprowadzić adres kolejki wiadomości POS Agent Brokera. W tym celu należy przejść do System -> Konfiguracja -> POS w systemie Comarch ERP XL.

W celu sprawdzenia pod jakim adresem została udostępniona usługa Comarch POS Agent Broker należy:

• Otworzyć Menedżer internetowych usług informacyjnych (IIS)
• W widoku Połączenia rozwinąć Witryny -> Default Web Site
• Wskazać pozycję zawierającą w nazwie ’POSAgentBroker’
• W widoku Akcje wybrać Przeglądaj *:80 (http)

4. Po wybraniu [Przeglądaj] w domyślnej przeglądarce w pasku adresu znajdzie się poprawny link do usługi POS Agent Broker.

Jeżeli POS Agent Broker zainstalowany został na profilu o nazwie: 2021_2 to adres prezentowany w przeglądarce będzie wyglądał następująco: localhost/POSAgentBroker_2021_2

Localhost = IP komputera na którym zainstalowano Comarch POS Agent Brokera, przy problemach z połączeniem z Brokerem i POS Agentem, warto zmienić tą nazwę na IP komputera.

Przy problemach z połączeniem i synchronizacją można również w oknie Menedżera internetowych usług IIS dla puli aplikacji POS Agent Broker wybrać Odtwarzanie.

5. W Usługach Windows należy zweryfikować czy uruchomione są usługi:

• Kafka Message Queue
• Zookeeper Service

6. Jeżeli obie usługi są uruchomione, należy w Comarch ERP XL przejść do zakładki System -> Konfiguracja -> POS -> [test połączenia].

W przypadku gdy weryfikacja połączenia zakończy się niepowodzeniem, należy sprawdzić w przeglądarce poprawność linku:

http://localhost/POSAgentBroker_2021_2/health?Auth=MjhlMWUxMmEtNDc5OS00ZTRkLWIwMWMtNzk2ZDA2MmZmYjlj

W pogrubionej części należy wprowadzić adres dostępny z poziomu System -> Konfiguracja -> POS w Comarch ERP XL.

Jeżeli po wykonaniu wszystkich powyższych czynności test połączenia w Comarch ERP XL kończy się niepowodzeniem. Należy w Menedżerze internetowych usług (IIS) wybierając Witryny -> Default Web Side -> prawy przycisk myszy -> Powiązania usunąć powiązanie https port 443, jeżeli pojawia się na liście.

Komponent Comarch POS

Po poprawnej instalacji i konfiguracji komponentu Comarch POS Agent Broker należy dodać komponent Comarch POS dla produktu Comarch Retail.

Okno konfiguracji otwierane jest poprzez zaznaczenie komponentu oraz wybranie z głównego menu przycisku [Konfiguracja]. W oknie należy wprowadzić dane dotyczące połączenia bazy danych stanowiska POS.

Następnie na zakładce Więcej -> Struktura agentów należy dodać agenta podrzędnego oraz wybrać jakie komponenty będą instalowane dla danego profilu.

W oknie należy uzupełnić:

• Kod agenta – kod agenta podrzędnego, który należy wprowadzić w Auto Update podczas konfiguracji
• Lokalizację – opcjonalnie
• Tagi – oznaczenia wykorzystywane podczas wyszukiwania agenta podrzędnego na liście
• Profile – wraz ze wskazaniem produktów, które mają być zainstalowane na agencie podrzędnym
• Lokalny nadrzędny – czy dany agent pełni rolę lokalizacji

Po dodaniu agenta podrzędnego będzie on widoczny w strukturze agentów. Z poziomu tego okna istnieje możliwość:

• Dodania nowego agenta podrzędnego
• Dodania nowej lokalizacji
• Wykonanie aktualizacji wszystkich agentów do najnowszej wersji
• Wymuszenie synchronizacji z agentami podrzędnymi
• Wykonanie akcji zdalnej na agencie podrzędnym – pobranie, instalacja, możliwość przywrócenia wersji i dezinstalacji dla wskazanego produktu. Istnieje możliwość zaznaczenia na liście kilku agentów i wykonania dla nich akcji zdalnej.

• Pokazania/ukrycia szczegółów
• Zmiany profilu

Komponent POS Agent

Po poprawnej instalacji i konfiguracji komponentu Comarch POS Agent Broker należy dodać komponent Comarch POS Agent dla produktu Comarch Retail.

Po zainstalowaniu na agencie podrzędnym komponentu Comarch POS Agent należy przejść do katalogu gdzie znajduje się zainstalowany i pobrany POS Agent (domyślna ścieżka C:\Program Files (x86)\Comarch Retail\Comarch Retail POS Agent).

1.W folderze Comarch Retail -> Comarch Retail POS Agent dostępna jest aplikacja exe.

2.Przy pierwszym uruchomieniu pojawi się okno z wyborem języka.

3.Podczas pierwszego uruchomienia, pojawi się błąd dotyczący odinstalowanej usługi.

4.Wyświetlony komunikat należy potwierdzić przyciskiem [OK], w kolejnym kroku wyświetlone zostanie okno konfiguratora:

W aplikacji przed wybraniem przycisku [Instaluj] należy podać:

• Adres IP usługi POS Agent – pole uzupełniane automatycznie adresem IP komputera na którym zainstalowano usługę POS Agent. W przypadku gdy IP jest zmienne, należy ustawić dla usługi POS Agent stałe przekierowanie na IP, zamiast nazwy localhost przy zmiennym IP można wprowadzić 127.0.0.1.

• Port usługi POS Agent – domyślnym portem jest 8098, należy pamiętać, że usługa POS Agent i usługa synchronizacji XL – POS nie może działać na tym samym porcie, wprowadzony może być dowolny wolny port
• Adres serwera OMS – domyślnym adresem jest http://localhost:8099/DataService/, adres ten składa się z:
  • localhost – IP komputera na którym, znajduje się XL i usługa synchronizacji
  • 8099 – domyślny port dla usługi synchronizacji, należy podać port, jaki został wprowadzony dla usługi synchronizacji w Comarch ERP XL na zakładce Oddziały -> Konfiguracja automatu synchronizacji. Na poniższym rysunku uzupełniony jest port: 51426, więc adres przy IP = 10.138.37.7 w aplikacji POS Agent Konfigurator wyglądałby tak: http://10.138.37.7:51426/DataService/

• Kod POS Agenta – kod POS Agent wprowadzony w systemie ERP w oknie Konfiguracji oddziału -> Comarch POS

• GUID – wartość nadawana automatycznie, po poprawnym zarejestrowaniu usługi

5.Po uzupełnieniu powyższych danych w Konfiguratorze POS Agent należy wybrać przycisk:

• [Instaluj]
• [Odśwież]
• [Uruchom] – powinien pojawić się komunikat dotyczący uruchomienia usługi
• [Sprawdź] (przy wpisanym kodzie POS Agenta) – po wybraniu przycisku pojawi się okno z informacją o stanie połączenia

• [Odśwież]
• [Zarejestruj] – automatycznie uzupełnione zostanie pole GUID w konfiguratorze, a także pola HOST, PORT i GUID w systemie Comarch ERP XL. Dodatkowo pojawi się okno z informacją o poprawnym zarejestrowaniu Agenta.

6.Po włączeniu usług i wykonaniu prawidłowej konfiguracji, dodatkową i najlepszą weryfikacją poprawności działania usług jest wystawienie w systemie Comarch ERP XL dokumentu magazynowego (rozchód wewnętrzny, wydanie zewnętrzne) z magazynu POSowego – tutaj przy dodawaniu elementu na dokument, jeżeli połączenie będzie niepoprawne otrzymamy o tym komunikat: „Nie można wykonać akcji ze względu na niedostępność usługi POS Agent. Operacje na magazynach POS wymagają połączenia z usługą.”

7.Po wykonaniu wszystkich kroków na stanowisku POS zaleca się włączenie Uzgadniania stanów – funkcjonalność synchronizuje stany magazynowe pomiędzy sklepem a systemem centralnym ERP. Dodatkowe informacje na temat uzgadniania znajdują się pod linkiem:

https://pomoc.comarch.pl/pos/documentation/uzgadnianie-stanow-magazynowych/

O czym należy pamiętać:

1. Przede wszystkim należy pamiętać aby porty były dostępne dla dwóch komputerów, w tym celu należy zrobić przekierowanie na routerze danych portów usług synchronizacji.
2. Zalecanym sposobem weryfikacji jest korzystanie z wiersza poleceń (cmd), gdzie za pomocą poleceń:

• netstat -aon
• telnet

można zweryfikować dostępność danych portów.

Na stanowisku POS można korzystać z aplikacji BI Point po zainstalowaniu odpowiedniego komponentu za pomocą Comarch ERP Auto Update.

Po uruchomieniu aplikacji Comarch ERP Auto Update należy wykonać następujące czynności:

1. 1. Na zakładce Konfiguracja należy wskazać produkt Comarch Retail
   2. Dla produktu Comarch Retail dodać komponent Comarch Retail BI Point

1. Zapisać zmiany oraz zamknąć okno konfiguracji produktów przez wybranie odpowiednio przycisku [Zapisz], a następnie [Zamknij].
2. W głównym oknie aplikacji należy wybrać jedną z dostępnych opcji:
   • [Pobierz] – spowoduje, że produkt zostanie zapisany w katalogu podanym w konfiguracji, domyślna ścieżka to C:\Comarch ERP Auto Update\Downloads\. Po zakończeniu pobierania dostępny będzie przycisk [Instaluj].
   • [Pobierz i instaluj] – produkt jest automatycznie instalowany po zakończeniu pobierania.

Domyślny adres prezentowany na stanowisku POS dla BI Point to: http://bipoint.comarch.pl/. Adres można zmienić w tabeli stanowiska POS Configuration.Settings, w wierszu o nazwie BIPointUrl.

Szczegółowe omówienie instalacji produktów znajduje się w sekcji Comarch ERP Altum Auto Update.

W celu uzgodnienia stanów magazynów należy w menu głównym wybrać kafel [Aktualizacja danych], a następnie [Uzgadnianie stanów magazynowych].

Wykonanie procesu spowoduje, że stany magazynowe towarów dostępnych w sklepie zostaną ustalone zgodnie z informacjami uzyskanymi z systemu centralnego. Pozyskane dane mogą nie uwzględniać informacji o dokumentach, które nie zostały jeszcze przesłane ze stanowiska Comarch POS lub Comarch mPOS do systemu centralnego.

Aby zminimalizować prawdopodobieństwo istnienia takich dokumentów należy:

• upewnić się, że wszystkie urządzenia w sklepie obsługujące Comarch POS oraz Comarch mPOS zostały włączone i pracują w trybie online
• uruchomić proces uzgadniania po możliwie najdłuższym czasie od wystawienia w sklepie ostatniego dokumentu (np. przed rozpoczęciem dnia pracy)

W celu uruchomienia procesu uzgadniania stanów magazynowych należy wybrać przycisk [Rozpocznij].

Po rozpoczęciu procesu stany magazynowe są ustalane w usłudze POS Agent na podstawie informacji uzyskanych z systemu ERP.

Po ukończeniu procesu wyświetlony zostanie komunikat: Uzgodniono stany magazynowe z systemem centralnym. W przypadku wystąpienia błędu lub braku połączenia wyświetlona zostanie informacja o przerwaniu procesu i konieczności powtórnego jego uruchomienia.

Comarch ERP Menadżer Kluczy

Aplikacja Comarch ERP Menadżer Kluczy jest niezbędnym narzędziem pozwalającym na pobieranie i aktywację zakupionych modułów produktów Comarch ERP. Może on współpracować zarówno z fizycznymi kluczami HASP, plikami SoftHASP, a także z modułami potrzebnymi dla stacjonarnych aplikacji jak np. Comarch POS. Aplikacja ta zastępuje Serwis klucza HASP oraz Zdalny Serwer Klucza.

Jedną z zalet Menadżera Kluczy jest możliwość pracy na maszynach wirtualnych z wykorzystaniem kluczy aktywowanych w Comarch.

Wymagania systemowe

• System operacyjny Windows 11, Windows 10, Windows 8.1, Windows 7, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows Server 2019
• Dostęp do adresów ml.comarch.pl i erp.comarch.pl na portach TCP 80, TCP 443
• Microsoft SQL Server

Instalacja i konfiguracja

Instalację Menadżera Kluczy wykonuje się na serwerze, na którym zainstalowany jest Microsoft SQL Server, na profilu głównym Comarch ERP Auto Update.

Po uruchomieniu Comarch ERP Auto Update należy wykonać następujące czynności:

• Na zakładce Konfiguracja dodać produkt Comarch ERP Menadżer Kluczy
• Dla produktu Comarch ERP Menadżer Kluczy dodać komponent Comarch ERP Menadżer Kluczy

• Po dodaniu produktu i komponentu Comarch ERP Menadżer Kluczy należy dokonać jego konfiguracji. Okno konfiguracji otwierane jest poprzez zaznaczenie komponentu oraz wybranie z menu przycisku [Konfiguracja]. Po przejściu do konfiguracji komponentu należy uzupełnić poniższe pola:
  • Lokalną nazwę instancji serwera bazy danych, na której komponent ma zostać zainstalowany wraz z danymi do logowania na konto użytkownika z uprawnieniami administracyjnymi
  • Id klienta, PIN i numer klucza licencyjnego – dostępne w aplikacji iZAM
  • Opcjonalnie adres e-mail dla powiadomień w przypadku utraty połączenia z serwerem Comarch

W ramach instalacji wykonywane są następujące czynności:

• Instalacja sterowników klucza HASP
• Konfiguracja serwera bazy danych
• Dodanie wyjątku do zapory sieciowej w celu umożliwienia pracy sieciowej
• Instalacja usługi Zarządzanie kluczami produktów Comarch ERP (ComarchML)
• Instalacja aplikacji (monitora) Menadżera Kluczy

Po zakończeniu instalacji należy uruchomić Comarch ERP Menadżer Kluczy, w prawym dolnym rogu ekranu powinna pojawić się ikona informująca o stanie gwarancji na program. Zielony kolor ikony kłódki informuje o prawidłowym stanie pozwalającym na pracę z najnowszymi wersjami oprogramowania dla zakupionych programów. Kolor ikony:

• Czerwony – brak informacji o dostępnych modułach, lub zatrzymana usługa Zarządzanie kluczami produktów Comarch ERP, aplikacje mogą jedynie pracować w trybie DEMO
• Żółty – program poza gwarancją, można pracować ale tylko na wersjach, na których data produkcji jest wcześniejsza od daty ważności zakupionych modułów. Zalecamy przedłużenie ważności gwarancji.
• Zielony – program na gwarancji, prawidłowy stan pozwalający na pracę z najnowszymi wersjami oprogramowania dla zakupionych modułów

Monitor Menadżera Kluczy

W skład Menadżera Kluczy wchodzi aplikacja monitora (ComarchMLTray). To ona odpowiada za wyświetlanie ikony kłódki w prawym dolnym rogu ekranu.

Po kliknięciu prawym klawiszem na ikonie kłódki dostępne są następujące opcje:

• Pokaż konfigurację – wyświetla okno aplikacji
• Uruchom usługę – uruchamia usługę Zarządzanie kluczami produktów Comarch ERP
• Restartuj usługę – restartuje usługę Zarządzanie kluczami produktów Comarch ERP
• Zatrzymaj usługę – zatrzymuje usługę Zarządzanie kluczami produktów Comarch ERP
• Zwolnij moduły – wylogowuje poszczególnych użytkowników z usługi i tym samym zwalnia pobrane moduły dla wybranych kluczy
• Aktualizuj moduły w kluczu HASP – aktualizuje moduły w kluczu HASP (programowanie klucza). Aktualizacja może być wykonana na dwa sposoby:
  • Aktualizacja z chmury – po wybraniu tej opcji moduły w kluczu HASP będę zaktualizowane plikiem RUS automatycznie pobranym z serwerów Comarch (opcja wymaga dostępu do Internetu). Aktualizacja z chmury nie jest dostępna dla kluczy partnerskich.
  • Aktualizacja z dysku – po wybraniu tej opcji należy wskazać na dysku plik RUS odpowiedni dla podłączonego klucza HASP w celu wykonania aktualizacji modułów
• Wyłącz monitor Comarch ERP Menadżer Kluczy – wyłącza ikonę kłódki, która pojawi się po ponownym uruchomieniu aplikacji

Ponadto dwukrotne kliknięcie na ikonę zielonej (lub żółtej) kłódki spowoduje uruchomienie okna aplikacji monitora Comarch ERP Menadżer Kluczy, co jest tożsame z wybraniem opcji Pokaż konfigurację.

Po kliknięciu na opcję Pokaż konfigurację uruchamiane jest okno aplikacji z trzema zakładkami: Dostępne moduły, Pobrane moduły oraz Konfiguracja.

Jeżeli na komputerze jest włączony mechanizm kontroli konta (UAC) i jeżeli monitor Menadżera Kluczy nie zostanie uruchomiony jako administrator, to przy próbie użycia funkcji wymagających uprawnień administracyjnych takich jak: Uruchom usługę, Restartuj usługę, Zatrzymaj usługę lub przejście do ustawień zaawansowanych pojawi się monit z prośbą o zaakceptowanie ponownego uruchomienia monitora Menadżera Kluczy jako administrator, co umożliwi skorzystanie z wymienionych funkcji.

Zakładka Dostępne moduły

Zakładka przedstawia listę dostępnych modułów pochodzących z podłączonego klucza HASP, plików SoftHASP, bądź z modułów aktywowanych w Comarch (kluczy wirtualnych). Te same informacje dostępne są również na stronie http://localhost:5150/.

W nagłówku okna widoczny jest numer wersji Menadżera Kluczy.

Kolor wyświetlanych modułów informuje, czy dany moduł jest aktualny, czy jest już po gwarancji. Kolorem zielonym wyświetlane są moduły na gwarancji (data ważności późniejsza lub równa dacie bieżącej), natomiast kolorem żółtym oznaczane są moduły po gwarancji (data ważności wcześniejsza niż data bieżąca). Analogicznie jak to ma miejsce w przypadku koloru ikony kłódki w prawym dolnym rogu ekranu.

Zakładka Pobrane moduły

Zakładka zawiera informacje o modułach pobranych przez aplikacje, które korzystają z Menadżera Kluczy. W kolumnie Zalogowani użytkownicy znajdują się informacje pozwalające zidentyfikować użytkownika, który pobrał dany moduł.

Na zakładce znajdują się przyciski:

• Ikona pioruna – pozwala zaktualizować widok, opcja dostępna również poprzez klawisz [F5]
• Ikona kosza – usuwa wszystkie pobrane moduły dla zaznaczonego użytkownika

Zakładka Konfiguracja

Na zakładce Konfiguracja podana jest lista wszystkich kluczy podłączonych do Menadżera Kluczy. Wśród nich może być klucz HASP, klucze wirtualne lub tzw. SoftHASP w postaci plików Softhasp.sig i Softhasp.dat umieszczonych na dysku komputera (domyślnie C:\).

Na zakładce Konfiguracja wyświetlana jest lista dostępnych kluczy wraz z odpowiednim kolorem:

• oliwkowy – standardowy klucz przeznaczony dla Klientów
• fioletowy – klucz partnerski
• jasnoniebieski – klucz firmowy. Klucz ten może działać tylko z bazą, która w danych o firmie ma przypisany ten sam numer NIP, jaki związany jest z tym kluczem (kolumna Dane identyfikacyjne firmy). Klucz firmowy może występować w postaci klucza HASP bądź klucza wirtualnego.
• pomarańczowy – klucz wielofirmowy. W przypadku tego klucza mamy do czynienia z przypisaniem do klucza więcej niż jednego numer NIP. Wszystkie numery NIP dla zaznaczonego klucza wielofirmowego wyświetlane są w dodatkowej tabeli poniżej listy kluczy. Klucz wielofirmowy jest rozszerzeniem klucza firmowego i działa analogicznie jak klucz firmowy, przy czym mamy możliwość połączenia z bazą danych, która zawiera jeden z numerów NIP przypisanych do tego klucza. Klucze wielofirmowe występują wyłącznie w postaci kluczy wirtualnych.
• czerwony – klucz, którego data ograniczenia czasowego została przekroczona

W pierwszej kolumnie Dane identyfikacyjne firmy znajduje się numer NIP firmy, która jest właścicielem klucza lub jej akronim.

Na zakładce dostępne są przyciski:

• [Aktualizuj moduły] – wymusza połączenie z serwerami Comarch, aktualizuje widok. Opcja dostępna również poprzez kombinację klawiszy [Ctrl+F5]
• [Aktualizacja modułów w przypadku braku połączenia internetowego] – pozwala na aktywację modułów w przypadku braku połączenia z siecią
• [Dodaj] – pozwala na dodanie klucza wirtualnego, który wymaga cyklicznego kontaktu z serwerami Comarch (minimum co 24 godziny w przypadku modułów Comarch ERP Optima oraz co 72h dla Comarch ERP XL i Comarch ERP Altum). W celu dodania takiego klucza w oknie Dane klucza wirtualnego należy podać: ID Klienta, Pin, Nr klucza oraz Adres e-mail, jeżeli nie jest jeszcze wpisany w konfiguracji Menadżera Kluczy (Adres e-mail administratora).
• [Usuń] – usuwa klucz wirtualny (nie dotyczy kluczy HASP oraz SoftHasp). Po usunięciu klucza wirtualnego z Menadżera Kluczy, może on zostać aktywowany na innym komputerze.
• [Edytuj] – umożliwia edycję nieaktywnych kluczy
• [Zaawansowane] – uruchamia dodatkowe okno z zaawansowanymi parametrami konfiguracji, możliwe do włączenia w przypadku uruchomienia Menadżera Kluczy z uprawnieniami administratora

Aktualizacja Comarch ERP Menadżer kluczy

Aby zaktualizować do najnowszej wersji aplikację Comarch ERP Menadżer Kluczy należy w narzędziu Comarch ERP Auto Update przejść na zakładkę Więcej następnie wybrać przycisk [Pobierz i instaluj] dla Comarch ERP Menadżer Kluczy. W celu aktualizacji do innej wersji należy użyć przycisku [Akcje zaawansowane].

Po wybraniu przycisku [Pobierz i instaluj] zostanie wyświetlony standardowy komunikat, który informuje o konieczności wyłączenia wszystkich powiązanych aplikacji i usług.

Po aktualizacji aplikacji w Comarch ERP Auto Update należy uruchomić Comarch ERP Menadżer Kluczy, przejść na zakładkę Konfiguracja -> wybrać przycisk [Aktualizuj moduły] w celu aktualizacji modułów licencyjnych.