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.

Uwaga
Wymagana jest najnowsza wersja Comarch ERP Auto Update 2020.0.

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

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

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

Dodanie komponentu 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.

    Konfiguracja połączenia z serwererm SQL dla 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 logowaniaLogin, 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ę błąd informujący o tym, że usługa jest odinstalowana:

 

Błąd dotyczący odinstalowanej usługi

  • Po naciśnięciu przycisku [OK] otwiera się okno konfiguratora:

Konfigurator POS Agent

  • 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

Uwaga
Każde stanowisko POS i mPOS w sklepie powinna nawiązać połączenie ale tylko z POS Agent w przypadku potwierdzenia dowolnego dokumentu magazynowego. Jednak jedynie połączenie z centralą zapewnia, że dokument magazynowy zawiera poprawną – dostępną ilość i będzie prawidłowo przetwarzany.

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.

Okno Konfiguracja usług aplikacji Comarch POS




Comarch POS Agent Broker

Uwaga
Komponent POS Agent Broker wymagany jest do komunikacji pomiędzy Comarch ERP Altum/XL a Comarch POS Agent.

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 sterowaniaProgramy i funkcjeWłącz lub wyłącz funkcje systemu WindowsInternetowe usługi informacyjne (IIS) i włączyć:

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

Funkcje systemu Windows

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

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

    Dodanie komponentu Comarch POS Broker
    Dodanie komponentu Comarch POS Agent Broker

Uwaga
Po włączeniu dodatkowych funkcji Windows i  instalacji POS Agent Broker, może być wymagane ponowne uruchomienie stacji roboczej.

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)

Menedżer internetowych usług informacyjnych IIS

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

Adres usługi Comarch POS Agent Broker w pasku przeglądarki

 

Uwaga
http://localhost/POSAgentBroker jest to domyślny adres w przypadku głównego profilu programu Comarch ERP Auto Update. 




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

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.

Współpraca pomiędzy wersjami systemów a wersjami komponentów

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.

Przykład

Jeżeli w programie Comarch ERP Auto Update skonfigurowanych jest kilka profili na przykład:

Profil I:

XL w wersji 2021.0

POS w wersji 2021.0

POS Agent w wersji 2021.0

POS Agent Broker – brak

Profil II:

XL w wersji 2021.1

POS w wersji 2021.6

POS Agent w wersji 2021.6

POS Agent Broker w wersji 2021.6

W konfiguracji XL w wersji 2021.0, dla Brokera należy podać adres Brokera z Profilu II.

Uwaga
Jeżeli na jednej maszynie zainstalowanych jest kilka wersji Comarch ERP XL i Comarch POS, to należy pamiętać, że system Comarch ERP XL musi posiadać aktualne rejestry odpowiedniej wersji, aby usługa synchronizacji działała poprawnie. Dodatkowo w zmiennych środowiskowych w części PATH musi być podany wpis na pierwszym miejscu odnoszący się do odpowiedniej wersji Comarch ERP XL, na której chcemy pracować. Konieczny jest wtedy restart komputera, aby zmiany zostały poprawnie odczytane oraz puszczenie rejestrów do wybranej wersji Comarch ERP XL.

  • 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.

Rysunek poglądowy schematu komunikacji

  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.

Ścieżka logowania aplikacji POS w pliku POS2.exe.config

  • 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.

Przykładowy schemat działania usług

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.

Wskazówka

Żeby proces aktualizacji AU przebiegł poprawnie należy upewnić się, że wszystkie wymagane porty są poprawne:

Na agencie nadrzędnym:

1. Połączenia przychodzące:

  • 5672
  • 8009
  • 11365

2.Połączenia wychodzące:

  • 11366 – domyślnie jest to 11366, ale mogą być wymagane także inne w zależności od tego, jaki port jest skonfigurowany na podrzędnym do łączenia z agentem nadrzędnym
  • 8466 – port do łączenia z update.comarch.com dla AU 2019.0
  • 9466 – port do łączenia z update.comarch.com dla AU 2020.0

Na agencie podrzędnym:

3.Połączenia przychodzące:

  • 11366 – domyślnie jest to 11366, ale mogą być wymagane także inne w zależności od tego, jaki port jest skonfigurowany na podrzędnym do łączenia z agentem nadrzędnym

4.Połączenia wychodzące:

  • 5672
  • 8009
  • 11365

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

Uwaga
Aplikacja Comarch ERP Auto Update wymaga zainstalowanego .NET Framework w wersji 4.7.2.

Przykład

Rozwiązywanie problemów związanych z rabbitem

W przypadku wystąpienia problemów z rabbitem, można je rozwiązać w następujący sposób:

  1. uruchomić “cmd.exe” z uprawnieniami administratora, a następnie wykonać następujące instrukcje
  2. cd C:\Program Files\RabbitMQ Server\rabbitmq_server-3.7.5\sbin
  3. rabbitmq-service.bat remove
  4. rabbitmq-service.bat install
  5. rabbitmq-service.bat start
  6. rabbitmq-plugins enable rabbitmq_management
  7. rabbitmqctl stop (należy chwilę zaczekać na wykonanie tej komendy, czasem jest wymagane ręczne zatrzymanie usługi RabbitMQ)
  8. rabbitmq-server -detached
  9. rabbitmqctl start_app (należy chwilę zaczekać na wykonanie tej komendy, czasem jest wymagane ręczne uruchomienie usługi RabbitMQ)
  10. rabbitmqctl add_user admin admin
  11. rabbitmqctl set_user_tags admin administrator
  12. rabbitmqctl set_permissions -p / admin „.*” „.*” „.*”

W czasie wykonywania powyższych komend może wystąpić problem z autentykacją i plikiem erlang cookie. Aby go rozwiązać należy przekopiować: C:\Windows\System32\config\systemprofile\.erlang.cookie

do

C:\Users\UserName\.erlang.cookie

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/20221/documentation/instalacja-comarch-erp-auto-update/

  1. 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/pos/20221/documentation/dodawanie-agentow-podrzednych/

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

Okno konfiguracji stanowiska POS

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

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

Uwaga
Należy pamiętać, że kod POS Agenta ≠ kod Stanowiska POS, jednak nie ma przeciwskazań aby nazwy były takie same.

Konfiguracja oddziału Comarch POS w systemie ERP XL

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 sterowaniaProgramy i funkcjeWłącz lub wyłącz funkcje systemu WindowsInternetowe usługi informacyjne (IIS) i włączyć:

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

Funkcje systemu Windows

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.

Komponent Comarch POS Agent Broker na agencie nadrzędnym

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)

Uwaga
Po włączeniu dodatkowych funkcji Windows i instalacji POS Agent Broker, może być wymagane ponowne uruchomienie stacji roboczej.

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.

Okno testu połączenia Comarch POS Agent Brokera w 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)

Uwaga
Należy pamiętać, że port 80 jest portem domyślnym – przy konfiguracji należy zweryfikować czy port nie jest już w użyciu.

Menedżer internetowych usług informacyjnych (IIS)

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

Adres usługi Comarch POS Agent Broker w pasku przeglądarki dla profilu głównego (mainprofile) w AU

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].

Test połączenia Brokera w systemie Comarch ERP XL

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.

Sprawdzenie połączenia linkiem autoryzacyjnym

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.

Powiązania w Menedżerze internetowych usług IIS

Komponent Comarch POS

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

Komponent Comarch POS na agencie nadrzędnym

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.

Konfiguracja komponentu Comarch 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.

Dodanie nowego agenta podrzędnego

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.

Akcje dostępne dla agenta podrzędnego

  • 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.

Dodanie komponentu Comarch POS Agent

Uwaga
Zalecane jest aby POS Agent znajdował się na tej samej maszynie co produkt Comarch POS, dlatego stosowana jest struktura nadrzędny – podrzędny.

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.

Katalog Comarch Retail POS Agent

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

Okno wyboru języka w konfiguratorze POS Agent

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

Błąd dotyczący odinstalowanej usługi

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

Konfigurator usługi POS Agent

Uwaga
Należy zweryfikować automatycznie uzupełnione porty i IP.

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/

Uwaga
Port dla usługi synchronizacji na przykład 51426 powinien być przekierowany na routerze. Dotyczy to również portu usługi POS Agent – domyślnie 8098.

Okno usługi synchronizacji

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

Pole Kod na zakładce POS Agent

  • 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

Komunikat o poprawnym połączeniu usług

  • [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.

Uwaga
Usługa POS Agent powinna pracować nieprzerwanie, to oznacza, że maszyna na jakiej działa powinna być cały czas włączona aby zapewnić poprawność pracy na magazynach POS.

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/20221/documentation/uzgadnianie-stanow-magazynowych/

Uwaga
Uzgadnianie stanów należy włączać w momencie gdy nikt nie pracuje na stanowiskach POS i wykonywać pojedynczo na każdym stanowisku POS. Po wykonaniu pierwszego uzgadniania, z funkcjonalności należy korzystać doraźnie, gdy zaobserwowane zostaną różnice w stanach.

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.