Uwaga

Przed zainstalowaniem Comarch ERP XL Web 2024.0 należy odinstalować poprzednią wersję aplikacji.

Uwaga

Podczas instalacji Comarch ERP XL Web 2024.0 na systemie Microsoft Windows 11 należy być zalogowanym na lokalne konto systemowe.

Comarch ERP XL Instrukcja instalacji

Proces instalacji

Uruchomienie pliku instalacyjnego Comarch ERP XL Web.exe rozpoczyna proces instalacji systemu.

W kolejnym kroku użytkownik może wybrać typ instalacji:

Następnie należy wskazać katalog instalacyjny.

Kolejny etap to podanie parametrów konfiguracyjnych takich jak:

Po naciśnięciu przycisku Dalej wyświetlony zostaje ekran, na którym można uruchomić instalację zgodnie z ustawionymi we wcześniejszych krokach parametrami.

Po rozpoczęciu instalacji wyświetlany jest stan procesu instalacyjnego.

Na zakończenie wyświetlany jest ekran z informacją o zakończeniu procesu instalacji.

Uruchomienie

Ekran logowania

Po wpisaniu w przeglądarce nazwy hosta, na którym zainstalowany został Comarch ERP XL oraz portu wskazanego podczas instalacji, np. https://localhost:8000, zostanie wyświetlony ekran logowania się do programu.

Po wpisaniu identyfikatora operatora oraz hasła program Comarch ERP XL zostanie uruchomiony w przeglądarce.

Comarch ERP XL Podręcznik użytkownika

Logowanie

Ekran logowania

Po uruchomieniu w przeglądarce programu Comarch ERP XL wyświetlony zostaje ekran logowania jak poniżej.

Dane użytkownika

W polu Użytkownik należy wpisać identyfikator operatora zdefiniowanego w programie Comarch ERP XL, w polu Hasło należy wprowadzić hasło wpisanego operatora.

Uwaga

W celu zabezpieczenia się przed zalogowaniem nieuprawnionego użytkownika na ekranie logowania nie ma możliwości wyświetlenia listy operatorów. Identyfikator operatora należy każdorazowo wpisać w pole Użytkownik.

Informacje o bazie danych i wersji programu

U dołu ekranu logowania wyświetlana jest informacja z nazwą bazy danych, do której loguje się użytkownik oraz numer wersji programu.

Uwaga

Podczas logowania nie ma możliwości zmiany bazy – użytkownik może się zalogować wyłącznie do bazy wskazanej podczas instalacji programu.

Wskazówka

Zmiany parametrów logowania takich jak nazwa serwera SQL oraz nazwa bazy danych można dokonać poprzez edycję stosownych ustawień w plikach appsettings znajdujących się w katalogach podrzędnych katalogu XLRestApi w folderze, w którym zainstalowany jest program Comarch ERP XL Web.

Ekran główny programu

Po zalogowaniu się do programu wyświetlany jest ekran startowy jak poniżej.

Uwaga

Ze względu na to, że w pierwszej wersji programu obsługiwane są wyłącznie zamówienia sprzedaży, na ekranie startowym automatycznie wyświetlana jest lista zamówień sprzedaży.

Na ekranie programu można wyróżnić trzy podstawowe elementy:

Panel boczny nawigacji

W panelu bocznym nawigacji wyświetlane są przyciski pozwalające na przejście do wybranego obszaru programu.

W pierwszej wersji dostępne są następujące obszary:

Uwaga

W pierwszej wersji programu obsługiwany jest wyłącznie obszar zamówień sprzedaży. Po naciśnięciu przycisków Start, Kontrahenci oraz Towary wyświetlany jest jedynie ekran informacyjny.

Za pomocą przycisku można zwijać/rozwijać panel boczny.

Panel górny nawigacji

W panelu górnym nawigacji dostępne są następujące przyciski:

Pomoc

Naciśnięcie przycisku Pomoc powoduje otwarcie okna, w którym wyświetlana jest informacja o programie oraz dostępne są przekierowania do stron pomocy dla programu Comarch ERP XL oraz stron społeczności Comarch ERP.

Informacje o operatorze

Na przycisku z informacją o operatorze wyświetlana jest nazwa centrum, do którego zalogowany jest operator oraz identyfikator i nazwisko operatora.

Po rozwinięciu przycisku Operator ma dostępną opcję wylogowania się z programu.

Uwaga

Po rozwinięciu przycisku wyświetlana jest lista centrów, do których dołączony jest zalogowany operator, w wersji 2023.1 nie ma natomiast możliwości zmiany centrum (zmiany kontekstu operatora).

Lista zamówień sprzedaży

Układ listy zamówień

Po naciśnięciu w panelu bocznym przycisku Zamówienia sprzedaży na ekranie głównym aplikacji wyświetlana jest lista zamówień sprzedaży.

Na liście wyświetlane są wszystkie dokumenty widoczne w centrum, w którym zalogowany jest użytkownik.

Lista zawiera następujące kolumny:

Uwaga

W aplikacji webowej znany z wersji standardowej Stan dokumentu wyświetlany jest w rozbiciu na Status i Stan realizacji.

Powiązania pomiędzy Stanem dokumentu a Statusem i Stanem realizacji prezentuje poniższa tabela:

Stan w standardowym interfejsie	Status w interfejsie webowym	Stan realizacji w interfejsie webowym
Niepotwierdzone	Niezatwierdzony	-
Potwierdzone	Zatwierdzony	Do realizacji
W realizacji	Zatwierdzony	W realizacji
Zrealizowane	Zamknięty	Zrealizowany
Odrzucone	Anulowany	Niezrealizowany
Anulowane potwierdzone	Anulowany	Niezrealizowany
Zamknięte potwierdzone	Zamknięty	Niezrealizowany
Zamknięte w realizacji	Zamknięty	Częściowo zrealizowany
Korygowane potwierdzone	Korygowany	Do realizacji
Korygowane w realizacji	Korygowany	W realizacji

Uwaga

W aplikacji webowej kontrahent główny wyświetlany jest jako Nabywca, a kontrahent docelowy jako Odbiorca.

Obsługa listy zamówień

Na liście użytkownik może wykonywać następujące operacje:

Dodawanie zamówienia sprzedaży

Układ formularza zamówienia

Po naciśnięciu na liście zamówień przycisku Dodaj wyświetlony zostaje formularz nowego zamówienia sprzedaży.

Formularz składa się z następujących elementów: Pola obowiązkowe do wypełnienia oznaczone są gwiazdką. Pomiędzy sekcjami formularza można poruszać się za pomocą nawigacji dostępnej z prawej strony:

Nagłówek zamówienia

W nagłówku zamówienia wyświetlane są następujące elementy:

Uwaga

Numer zamówienia generowany jest po dodaniu kontrahenta na dokument.

Przed dodaniem kontrahenta w miejscu numeru wyświetlany jest opis Numer zamówienia.

Uwaga

Jeżeli do zamówienia dodany został kontrahent i wygenerowany został numer dokumentu, to po naciśnięciu przycisku Wróć do listy zamówień sprzedaży zamówienie zostanie zapisane ze statusem Niezatwierdzony.

Dodawanie kontrahenta na zamówienie

Po ustawieniu kursora w polu Wybierz kontrahenta użytkownik ma możliwość dodania kontrahenta na zamówienie. Istnieją dwa sposoby na dodanie kontrahenta:

Nabywca i odbiorca na zamówieniu

Po wybraniu kontrahenta w zależności od ustawień na kartotece kontrahenta na dokument pobierane są dane nabywcy i odbiorcy.

Dane nagłówkowe

Na formularzu nowo dodawanego zamówienia przed dodaniem kontrahenta na dokument w sekcji Dane nagłówkowe wyświetlane są następujące pola:

Po dodaniu kontrahenta na zamówienie w sekcja Dane nagłówkowe zostaje uzupełniona o następujące pola:

Pozycje zamówienia

Pozycje zamówienia przed dodaniem kontrahenta

Na formularzu nowo dodawanego zamówienia sprzedaży przed dodaniem kontrahenta na dokument w sekcji Pozycje wyświetlane są wyłącznie nagłówki kolumn i nie ma możliwości dodania pozycji.

Wyświetlany jest także stosowny komunikat informujący, że dodanie pozycji będzie możliwe po wybraniu kontrahenta.

Pozycje zamówienia po dodaniu kontrahenta

Po wybraniu kontrahenta w sekcji Pozycje zostaje wyświetlony wiersz, w którym można dodawać pozycje do zamówienia.

Układ listy pozycji zamówienia

Lista pozycji zamówienia sprzedaży zawiera następujące kolumny:

Dodawanie pozycji na zamówienie

Po ustawieniu kursora w polu Towar użytkownik ma możliwość dodania pozycji na zamówienie. Istnieją dwa sposoby na dodanie pozycji:

Wiersz do dodawania nowej pozycji wyświetlany jest zawsze jako pierwszy.

Pobieranie danych o towarze na pozycje zamówienia

Po wybraniu towaru na pozycję zamówienia pobierane są następujące dane z kartoteki towaru:

Uwaga

Aktualnie do zamówienia można dodawać tylko te towary, dla których cena domyślna ma walutę PLN.

Uwaga

W wersji 2023.1 nie są naliczane rabaty pozycji.

Zapisywanie zamówienia

W stopce zamówienia znajduje się przycisk pozwalający na zapisanie dokumentu.

Po naciśnięciu przycisku weryfikowane jest, czy obowiązkowe pola zostały uzupełnione oraz czy dane na dokumencie są poprawne – jeżeli na zamówieniu występuje błąd, wyświetlany jest stosowny komunikat, pole, w którym występuje błąd jest odpowiednio podświetlane a przycisk Zapisz jest dezaktywowany aż do usunięcia błędu.

Jeżeli próba zapisu zakończy się sukcesem, system wraca do listy zamówień sprzedaży.

Architektura rozwiązania

Opis

Architektura Comarch ERP XL wydziela część dostępu do danych (backend) od części prezentacyjnej (frontend). W ramach części prezentacyjnej dostarczany jest interfejs WWW, który jest serwowany przy wykorzystaniu serwera nginx. Dodatkowo nginx służy jako API gateway i load balancer, rozdzielając zapytania do warstwy danych, do odpowiednich mikroserwisów. Sama warstwa danych składa się z wielu mikroserwisów odpowiadających za wybrane funkcjonalności systemu. Dzięki takiej architekturze możliwe jest skalowanie horyzontalne aplikacji oraz łatwe aktualizowanie pojedynczych serwisów przy zachowaniu ciągłości pracy. Aby mikroserwisy były osiągalne z poziomu frontendu, aby mogły się ze sobą komunikować oraz aby można było rozdzielać do nich ruch - konieczny jest mechanizm rejestracji serwisów, czyli Service Discovery. Służy do tego Consul - czyli repozytorium serwisów.

W konsekwencji do działania XL'a w wersji Web konieczne są aktywne procesy: nginx, consul, consul-template oraz procesy samych mikroserwisów (obecnie XL.Authorization, XL.Customers, XL.Orders, XL.Users oraz XL.Articles).

Proces uruchamiania Comarch ERP XL składa się zatem z uruchomienia usługi Consul, następnie uruchomienia mikroserwisów (które zarejestrują swój adres i port w Consul'u) - na tym etapie mamy już dostępne nowe Rest API dla XL'a. Następnie do uruchomienia frontend potrzebne jest jeszcze uruchomienie serwera nginx oraz usługi consul-template, której zadaniem jest odczytanie adresów i portów mikroserwisów z repozytorium Consul'a, oraz zapisanie ich w konfiguracji nginx. Jeżeli uruchomimy wiele instancji tego samego mikroserwisu, to nginx będzie przekierowywał żądania równomiernie do każdej instancji (tzw. metoda Round-Robin). Również w ramach wewnętrznej komunikacji między mikroserwisami funkcjonuje load balancing oparty o repozytorium Consul.

Przy domyślnej instalacji stan serwisów można monitorować z poziomu strony http://localhost:8500/. Dodatkowo wszystkie błędy i ostrzeżenia samych mikroserwisów są logowane w zdarzeniach systemowych Windows w sekcji "Aplikacja". Natomiast logi z warstwy prezentacji znajdują się w katalogu serwera nginx w podkatalogu logs. Ponieważ cała komunikacja wymaga zabezpieczenia przed nieautoryzowanym dostępem wdrożono wykorzystanie protokołu https. Aby to było możliwe konieczne jest posiadanie certyfikatu ssl - podczas instalacji jest kreowany certyfikat podpisany samodzielnie o nazwie localhost_xlweb. W przypadku potrzeby udostępnienia programu w sieci publicznej zalecane jest zakupienie certyfikatu w jednym z zaufanych centrów certyfikacji.

Uwaga

Przed zainstalowaniem Comarch ERP XL Web 2024.0 należy odinstalować poprzednią wersję aplikacji.

Uwaga

Podczas instalacji Comarch ERP XL Web 2024.0 na systemie Microsoft Windows 11 należy być zalogowanym na lokalne konto systemowe.

Dashboard aplikacji

Układ dashboardu

Wyświetlenie dashboardu

W wersji 2024.0 systemu Comarch ERP XL Web udostępniony został ekran startowy, tzw. dashboard aplikacji.

Dashboard wyświetlany jest w następujących sytuacjach:

Budowa dashboardu

Ekran startowy podzielony jest na trzy panele: Skróty, Statystyki i Zamówienia sprzedaży.

W wersji 2024.0 systemu Comarch ERP XL Web obsługiwane są wyłącznie zamówienia sprzedaży, stąd dane prezentowane na ekranie startowym dotyczą tylko tego obszaru.

Wraz z pojawieniem się funkcjonalności z kolejnych obszarów dashboard będzie stosownie rozbudowywany.

Panel Skróty

W panelu Skróty znajdują się przyciski szybkiej obsługi pozwalające wykonać określoną akcję.

W wersji 2024.0 aktywny jest wyłącznie przycisk do dodawania nowego zamówienia sprzedaży. W kolejnych wersjach wraz z rozwojem funkcjonalności aktywowane pojawią się kolejne przyciski.

Panel Statystyki

Panel Statystyki zawiera dwa wykresy:

Dla każdego z wykresów można wskazać okres, za jaki mają zostać zaprezentowane dane:

Po najechaniu kursorem na słupek wykresu Wartość zamówień Twojego centrum prezentowana jest szczegółowa informacja dotycząca zamówień w danym okresie.

Najeżdżając kursorem na wybrany fragment wykresu Zamówione towary wg wartości można zobaczyć szczegóły dotyczące danego towaru.

Uwaga

Wartości na wykresach dotyczą zamówień, których właścicielem jest centrum, w którym zalogowany jest Użytkownik.

Uwaga

Zarówno na wykresie słupkowym, jak i na wykresie kołowym wartości prezentowane są w przeliczeniu na walutę systemową.

Panel Zamówienia sprzedaży

W panelu Zamówienia sprzedaży prezentowana jest lista 10 ostatnich zamówień sprzedaży wystawionych w centrum, w którym zalogowany jest Użytkownik.

Po naciśnięciu przycisku Pokaż więcej wyświetlona zostaje pełna lista zamówień sprzedaży.

Po prawej stronie listy zamówień znajdują się przyciski prezentujące informacje związane z realizacją zamówień:

Po naciśnięciu któregokolwiek przycisku Użytkownik przenoszony jest na listę zamówień sprzedaży.

Uwaga

Filtry na listach implementowane będą w kolejnych wersjach systemu. Docelowo po naciśnięciu danego przycisku wyświetlona zostanie lista zamówień odfiltrowana do dokumentów w stanie realizacji zgodnym z opisem na przycisku.

Dodawanie pozycji zamówienia z uproszczonej listy towarów

W wersji 2024.0 systemu Comarch ERP XL Web na formularzu zamówienia sprzedaży udostępniona została możliwość dodawania pozycji zamówienia z uproszczonej listy towarów.

Wywołanie uproszczonej listy towarów

Na zamówieniu sprzedaży Użytkownik może wywołać uproszczoną listę towarów na dwa sposoby:

Obsługa uproszczonej listy towarów

Po wyborze opcji do dodawania towarów z listy wyświetlona zostaje uproszczona lista towarów w następującym układzie.

W celu wyboru towaru, który ma zostać dodany na zamówienie, Użytkownik może:

Jeżeli na karcie towaru zdefiniowane są jednostki pomocnicze, to na uproszczonej liście na tym towarze Użytkownik może wskazać, w jakiej jednostce towar ma zostać dodany do zamówienia.

Po naciśnięciu przycisku Dodaj zaznaczone towary zostaną dodane na zamówienie w ilościach i jednostkach ustalonych na uproszczonej liście towarów.

Uwaga

Jeżeli na kartotece towaru jednostka pomocnicza oznaczona została, jako proponowana przy sprzedaży, to na uproszczonej liście towarów jednostka ta będzie się domyślnie proponować dla danego towaru.

Wskazówka

Jeżeli Użytkownik chce dodać do zamówienia ilość towaru inną niż 1, to powinien to zrobić korzystając z uproszczonej listy towarów – w wersji 2024.0 nie ma możliwości edycji ilości towaru bezpośrednio na liście pozycji zamówienia.

Inne zmiany

Obsługa powielania pozycji na zamówieniu zgodnie z definicją dokumentu

W wersji 2024.0 systemu Comarch ERP XL Web dodana została obsługa na zamówieniu parametru związanego z powielaniem pozycji na dokumencie.

Wartość parametru ustalana jest na definicji dokumentu ZS z poziomu programu Comarch ERP XL, gdzie ustala się, jak ma się zachować system w sytuacji dodawania na zamówienie towaru, który już jest na tym dokumencie:

Przyklad

Na definicji dokumentu ZS ustawiona została blokada powielania pozycji.

Podczas próby dodania towaru, który już istnieje na zamówieniu, wyświetlony zostaje stosowny komunikat i towar nie jest dodawany do dokumentu.

Wyświetlanie wartości liczbowych zgodnie z konfiguracją

W wersji 2024.0 systemu Comarch ERP XL Web zaimplementowane zostało wyświetlanie wartości liczbowych na listach zgodnie z ustawieniami w konfiguracji programu Comarch ERP XL. W Comarch ERP XL w konfiguracji na zakładce [Ogólne]/[Parametry 1] ustala się takie parametry, jak: Powyższe parametry uwzględniane są na listach systemu Comarch ERP XL Web.

Przyklad

Konfiguracja wyświetlania wartości liczbowych została sparametryzowana następująco:

Na bazie powyższej konfiguracji w systemie Comarch ERP XL Web wartości na listach wyświetlane są następująco:

Uwaga

Przed zainstalowaniem Comarch ERP XL Web 2024.0 należy odinstalować poprzednią wersję aplikacji.

Uwaga

Podczas instalacji Comarch ERP XL Web 2024.0 na systemie Microsoft Windows 11 należy być zalogowanym na lokalne konto systemowe.

Comarch ERP XL Web Instrukcja instalacji

Proces instalacji

Uruchomienie pliku instalacyjnego Comarch XL Web.exe rozpoczyna proces instalacji systemu.

W kolejnym kroku Użytkownik może wybrać typ instalacji:

Następnie należy wskazać katalog instalacyjny.

Kolejny etap to podanie parametrów konfiguracyjnych takich jak:

Po naciśnięciu przycisku Dalej wyświetlony zostaje ekran, na którym można uruchomić instalację zgodnie z ustawionymi we wcześniejszych krokach parametrami.

Po rozpoczęciu instalacji wyświetlany jest stan procesu instalacyjnego.

Na zakończenie wyświetlany jest ekran z informacją o zakończeniu procesu instalacji.

Uruchomienie

Ekran logowania

Po wpisaniu w przeglądarce nazwy hosta, na którym zainstalowany został Comarch ERP XL oraz portu wskazanego podczas instalacji, np. https://localhost:8000, zostanie wyświetlony ekran logowania się do programu.

Po wpisaniu identyfikatora operatora oraz hasła program Comarch ERP XL zostanie uruchomiony w przeglądarce.

Comarch ERP XL Web Podręcznik Użytkownika

Logowanie

Ekran logowania

Po uruchomieniu w przeglądarce programu Comarch ERP XL wyświetlony zostaje ekran logowania jak poniżej.

Dane Użytkownika

W polu Użytkownik należy wpisać identyfikator operatora zdefiniowanego w programie Comarch ERP XL, w polu Hasło należy wprowadzić hasło wpisanego operatora.

Uwaga

W celu zabezpieczenia się przed zalogowaniem nieuprawnionego Użytkownika na ekranie logowania nie ma możliwości wyświetlenia listy operatorów. Identyfikator operatora należy każdorazowo wpisać w pole Użytkownik.

Informacje o bazie danych i wersji programu

U dołu ekranu logowania wyświetlana jest informacja z nazwą bazy danych, do której loguje się Użytkownik oraz numer wersji programu.

Uwaga

Podczas logowania nie ma możliwości zmiany bazy – Użytkownik może się zalogować wyłącznie do bazy wskazanej podczas instalacji programu.

Wskazówka

Zmiany parametrów logowania takich jak nazwa serwera SQL oraz nazwa bazy danych można dokonać poprzez edycję stosownych ustawień w plikach appsettings znajdujących się w katalogach podrzędnych katalogu XLRestApi w folderze, w którym zainstalowany jest program Comarch ERP XL Web.

Ekran startowy (dashboard) aplikacji

W wersji 2024.0 systemu Comarch ERP XL Web udostępniony został ekran startowy, tzw. dashboard aplikacji.

Wyświetlenie dashboardu

Budowa dashboardu

Ekran startowy podzielony jest na trzy panele: Skróty, Statystyki i Zamówienia sprzedaży.

W wersji 2024.0 systemu Comarch ERP XL Web obsługiwane są wyłącznie zamówienia sprzedaży, stąd dane prezentowane na ekranie startowym dotyczą tylko tego obszaru.

Wraz z pojawieniem się funkcjonalności z kolejnych obszarów dashboard będzie stosownie rozbudowywany.

Panel Skróty

W panelu Skróty znajdują się przyciski szybkiej obsługi pozwalające wykonać określoną akcję.

W wersji 2024.0 aktywny jest wyłącznie przycisk do dodawania nowego zamówienia sprzedaży. W kolejnych wersjach wraz z rozwojem funkcjonalności aktywowane będą kolejne przyciski.

Panel Statystyki

Panel Statystyki zawiera dwa wykresy:

Dla każdego z wykresów można wskazać okres, za jaki mają zostać zaprezentowane dane:

Po najechaniu kursorem na słupek wykresu Wartość zamówień Twojego centrum prezentowana jest szczegółowa informacja dotycząca zamówień w danym okresie.

Najeżdżając kursorem na wybrany fragment wykresu Zamówione towary wg wartości można zobaczyć szczegóły dotyczące danego towaru.

Uwaga

Wartości na wykresach dotyczą zamówień, których właścicielem jest centrum, w którym zalogowany jest Użytkownik.

Uwaga

Zarówno na wykresie słupkowym, jak i na wykresie kołowym wartości prezentowane są w przeliczeniu na walutę systemową.

Panel Zamówienia sprzedaży

W panelu Zamówienia sprzedaży prezentowana jest lista 10 ostatnich zamówień sprzedaży wystawionych w centrum, w którym zalogowany jest Użytkownik.

Po naciśnięciu przycisku Pokaż więcej wyświetlona zostaje pełna lista zamówień sprzedaży.

Po prawej stronie listy zamówień znajdują się przyciski prezentujące informacje związane z realizacją zamówień:

Po naciśnięciu któregokolwiek przycisku Użytkownik przenoszony jest na listę zamówień sprzedaży.

Uwaga

Filtry na listach implementowane będą w kolejnych wersjach systemu. Docelowo po naciśnięciu danego przycisku wyświetlona zostanie lista zamówień odfiltrowana do dokumentów w stanie realizacji zgodnym z opisem na przycisku.

Poruszanie się po programie

Po zalogowaniu się Użytkownika aplikacja wyświetlana jest w układzie jak poniżej.

Na ekranie programu można wyróżnić trzy podstawowe elementy:

Panel boczny nawigacji

W panelu bocznym nawigacji wyświetlane są przyciski pozwalające na przejście do wybranego obszaru programu.

W pierwszej wersji dostępne są następujące obszary:

Uwaga

W pierwszej wersji programu obsługiwany jest wyłącznie obszar zamówień sprzedaży. Po naciśnięciu przycisków Kontrahenci oraz Towary wyświetlany jest jedynie ekran informacyjny.

Za pomocą przycisku można zwijać/rozwijać panel boczny.

Panel górny nawigacji

W panelu górnym nawigacji dostępne są następujące przyciski:

Pomoc

Naciśnięcie przycisku Pomoc powoduje otwarcie okna, w którym wyświetlana jest informacja o programie oraz dostępne są przekierowania do stron pomocy dla programu Comarch ERP XL oraz stron społeczności Comarch ERP.

Informacje o operatorze

Na przycisku z informacją o operatorze wyświetlana jest nazwa centrum, do którego zalogowany jest operator oraz identyfikator i nazwisko operatora.

Po rozwinięciu przycisku Operator ma dostępną opcję wylogowania się z programu.

Uwaga

Po rozwinięciu przycisku wyświetlana jest lista centrów, do których dołączony jest zalogowany operator, w wersji 2024.0 nie ma natomiast możliwości zmiany centrum (zmiany kontekstu operatora).

Lista zamówień sprzedaży

Układ listy zamówień

Po naciśnięciu w panelu bocznym przycisku Zamówienia sprzedaży na ekranie głównym aplikacji wyświetlana jest lista zamówień sprzedaży.

Na liście wyświetlane są wszystkie dokumenty widoczne w centrum, w którym zalogowany jest Użytkownik.

Lista zawiera następujące kolumny:

Uwaga

W aplikacji webowej znany z wersji standardowej Stan dokumentu wyświetlany jest w rozbiciu na Status i Stan realizacji.

Powiązania pomiędzy Stanem dokumentu a Statusem i Stanem realizacji prezentuje poniższa tabela:

Stan w standardowym interfejsie	Status w interfejsie webowym	Stan realizacji w interfejsie webowym
Niepotwierdzone	Niezatwierdzony	-
Potwierdzone	Zatwierdzony	Do realizacji
W realizacji	Zatwierdzony	W realizacji
Zrealizowane	Zamknięty	Zrealizowany
Odrzucone	Anulowany	Niezrealizowany
Anulowane potwierdzone	Anulowany	Niezrealizowany
Zamknięte potwierdzone	Zamknięty	Niezrealizowany
Zamknięte w realizacji	Zamknięty	Częściowo zrealizowany
Korygowane potwierdzone	Korygowany	Do realizacji
Korygowane w realizacji	Korygowany	W realizacji

Uwaga

W aplikacji webowej kontrahent główny wyświetlany jest jako Nabywca, a kontrahent docelowy jako Odbiorca.

Obsługa listy zamówień

Na liście Użytkownik może wykonywać następujące operacje:

Dodawanie zamówienia sprzedaży

Układ formularza zamówienia

Po naciśnięciu na liście zamówień przycisku Dodaj wyświetlony zostaje formularz nowego zamówienia sprzedaży.

Pola obowiązkowe do wypełnienia oznaczone są gwiazdką. Pomiędzy sekcjami formularza można poruszać się za pomocą nawigacji dostępnej z prawej strony.

Nagłówek zamówienia

W nagłówku zamówienia wyświetlane są następujące elementy:

Uwaga

Numer zamówienia generowany jest po dodaniu kontrahenta na dokument.

Przed dodaniem kontrahenta w miejscu numeru wyświetlany jest opis Numer zamówienia. 

Uwaga

Jeżeli do zamówienia dodany został kontrahent i wygenerowany został numer dokumentu, to po naciśnięciu przycisku Wróć do listy zamówień sprzedaży zamówienie zostanie zapisane ze statusem Niezatwierdzony.

Dodawanie kontrahenta na zamówienie

Po ustawieniu kursora w polu Wybierz kontrahenta Użytkownik ma możliwość dodania kontrahenta na zamówienie.

Istnieją dwa sposoby na dodanie kontrahenta:

Nabywca i odbiorca na zamówieniu

Po wybraniu kontrahenta w zależności od ustawień na kartotece kontrahenta na dokument pobierane są dane nabywcy i odbiorcy.

Dane nagłówkowe

Na formularzu nowo dodawanego zamówienia przed dodaniem kontrahenta na dokument w sekcji Dane nagłówkowe wyświetlane są następujące pola:

Po dodaniu kontrahenta na zamówienie w sekcja Dane nagłówkowe zostaje uzupełniona o następujące pola:

Uwaga

W standardowej wersji systemu odpowiednikiem pola Centrum jest pole Właściciel.

Pozycje zamówienia

Pozycje zamówienia przed dodaniem kontrahenta

Na formularzu nowo dodawanego zamówienia sprzedaży przed dodaniem kontrahenta na dokument w sekcji Pozycje wyświetlane są wyłącznie nagłówki kolumn i nie ma możliwości dodania pozycji.

Wyświetlany jest także stosowny komunikat informujący, że dodanie pozycji będzie możliwe po wybraniu kontrahenta.

Pozycje zamówienia po dodaniu kontrahenta

Po wybraniu kontrahenta w sekcji Pozycje zostaje wyświetlony wiersz, w którym można dodawać pozycje do zamówienia.

Układ listy pozycji zamówienia

Lista pozycji zamówienia sprzedaży zawiera następujące kolumny:

Dodawanie pozycji na zamówienie

Dodawanie pozycji przez edycję pola Towar

Po ustawieniu kursora w polu Towar Użytkownik ma możliwość dodania pozycji na zamówienie. Istnieją dwa sposoby na dodanie pozycji:

Wiersz do dodawania nowej pozycji wyświetlany jest zawsze jako pierwszy.

Pobieranie danych o towarze na pozycje zamówienia

Dodawanie pozycji z uproszczonej listy towarów

W wersji 2024.0 systemu Comarch ERP XL Web na formularzu zamówienia sprzedaży udostępniona została możliwość dodawania pozycji zamówienia z uproszczonej listy towarów.

Wywołanie uproszczonej listy towarów

Na zamówieniu sprzedaży Użytkownik może wywołać uproszczoną listę towarów na dwa sposoby:

Obsługa uproszczonej listy towarów

Po wyborze opcji do dodawania towarów z listy wyświetlona zostaje uproszczona lista towarów w następującym układzie.

W celu wyboru towaru, który ma zostać dodany na zamówienie, Użytkownik może:

Jeżeli na karcie towaru zdefiniowane są jednostki pomocnicze, to na uproszczonej liście na tym towarze Użytkownik może wskazać, w jakiej jednostce towar ma zostać dodany do zamówienia.

Po naciśnięciu przycisku Dodaj zaznaczone towary zostaną dodane na zamówienie w ilościach i jednostkach ustalonych na uproszczonej liście towarów.

Wskazówka

Jeżeli na kartotece towaru jednostka pomocnicza oznaczona została, jako proponowana przy sprzedaży, to na uproszczonej liście towarów jednostka ta będzie się domyślnie proponować dla danego towaru.

Wskazówka

Jeżeli Użytkownik chce dodać do zamówienia ilość towaru inną niż 1, to powinien to zrobić korzystając z uproszczonej listy towarów – w wersji 2024.0 nie ma możliwości edycji ilości towaru bezpośrednio na liście pozycji zamówienia.

Zapisywanie zamówienia

W stopce zamówienia znajduje się przycisk pozwalający na zapisanie dokumentu.

Po naciśnięciu przycisku weryfikowane jest, czy obowiązkowe pola zostały uzupełnione oraz czy dane na dokumencie są poprawne – jeżeli na zamówieniu występuje błąd, wyświetlany jest stosowny komunikat, pole, w którym występuje błąd jest odpowiednio podświetlane a przycisk Zapisz jest dezaktywowany aż do usunięcia błędu.

Jeżeli próba zapisu zakończy się sukcesem, system wraca do listy zamówień sprzedaży.

Architektura rozwiązania

Opis

Architektura Comarch ERP XL wydziela część dostępu do danych (backend) od części prezentacyjnej (frontend). W ramach części prezentacyjnej dostarczany jest interfejs WWW, który jest serwowany przy wykorzystaniu serwera nginx. Dodatkowo nginx służy jako API gateway i load balancer, rozdzielając zapytania do warstwy danych, do odpowiednich mikroserwisów. Sama warstwa danych składa się z wielu mikroserwisów odpowiadających za wybrane funkcjonalności systemu. Dzięki takiej architekturze możliwe jest skalowanie horyzontalne aplikacji oraz łatwe aktualizowanie pojedynczych serwisów przy zachowaniu ciągłości pracy. Aby mikroserwisy były osiągalne z poziomu frontendu, aby mogły się ze sobą komunikować oraz aby można było rozdzielać do nich ruch - konieczny jest mechanizm rejestracji serwisów, czyli Service Discovery. Służy do tego Consul - czyli repozytorium serwisów.

W konsekwencji do działania XL'a w wersji Web konieczne są aktywne procesy: nginx, consul, consul-template oraz procesy samych mikroserwisów (obecnie XL.Authorization, XL.Customers, XL.Orders, XL.Users oraz XL.Articles).

Proces uruchamiania Comarch ERP XL składa się zatem z uruchomienia usługi Consul, następnie uruchomienia mikroserwisów (które zarejestrują swój adres i port w Consul'u) - na tym etapie mamy już dostępne nowe Rest API dla XL'a. Następnie do uruchomienia frontend potrzebne jest jeszcze uruchomienie serwera nginx oraz usługi consul-template, której zadaniem jest odczytanie adresów i portów mikroserwisów z repozytorium Consul'a, oraz zapisanie ich w konfiguracji nginx. Jeżeli uruchomimy wiele instancji tego samego mikroserwisu, to nginx będzie przekierowywał żądania równomiernie do każdej instancji (tzw. metoda Round-Robin). Również w ramach wewnętrznej komunikacji między mikroserwisami funkcjonuje load balancing oparty o repozytorium Consul.

Przy domyślnej instalacji stan serwisów można monitorować z poziomu strony http://localhost:8500/. Dodatkowo wszystkie błędy i ostrzeżenia samych mikroserwisów są logowane w zdarzeniach systemowych Windows w sekcji "Aplikacja". Natomiast logi z warstwy prezentacji znajdują się w katalogu serwera nginx w podkatalogu logs. Ponieważ cała komunikacja wymaga zabezpieczenia przed nieautoryzowanym dostępem wdrożono wykorzystanie protokołu https. Aby to było możliwe konieczne jest posiadanie certyfikatu ssl - podczas instalacji jest kreowany certyfikat podpisany samodzielnie o nazwie localhost_xlweb. W przypadku potrzeby udostępnienia programu w sieci publicznej zalecane jest zakupienie certyfikatu w jednym z zaufanych centrów certyfikacji.

Uwaga

Przed zainstalowaniem Comarch ERP XL Web 2024.1 należy odinstalować poprzednią wersję aplikacji.

Uwaga

Podczas instalacji Comarch ERP XL Web 2024.1 na systemie Microsoft Windows 11 należy być zalogowanym na lokalne konto systemowe.

Dostosowanie systemu do pracy na monitorach o niskiej rozdzielczości

W wersji 2024.1 systemu Comarch ERP XL Web wprowadzone zostały usprawnienia pozwalające na wygodną obsługę programu na monitorach o niskiej rozdzielczości.

Od tej wersji system jest dostosowany do pracy od rozdzielczości 1366 x 768, co oznacza, że na tej oraz na każdej wyższej rozdzielczości aplikacja dostosowuje swój układ i rozmiar elementów do rozmiaru ekranu.

Układ ekranu startowego w zależności od rozdzielczości

Na ekranach o niskiej rozdzielczości elementy ekranu startowego prezentowane są w układzie pionowym, co obrazują poniższe rysunki.

Układ formularza zamówienia w zależności od rozdzielczości

Na ekranach o niskiej rozdzielczości zmienia się rozmiar poszczególnych pól na formularzu zamówienia.

Zmiany na liście zamówień sprzedaży

Kolumna Opis na liście zamówień

Na liście zamówień sprzedaży dodana została kolumna Opis.

Wyświetlanie nazwy kontrahenta w kolumnie Nabywca

W kolumnie Nabywca poza wyświetlanym dotychczasowo akronimem od wersji 2024.1 prezentowana jest także nazwa kontrahenta.

Wyświetlanie ulicy w kolumnie Adres nabywcy

W wersji 2024.1 w kolumnie z adresem nabywcy dodane zostało wyświetlanie ulicy i numeru domu.

Optymalizacja formularza zamówienia sprzedaży

W wersji 2024.1 systemu Comarch ERP XL Web na formularzu zamówienia sprzedaży wprowadzone zostały zmiany mające na celu optymalizacje układu dokumentu.

Zmiany w nagłówku zamówienia

W nagłówku dokumentu przycisk ze strzałką przekierowującą do listy zamówień umiejscowiony został na wysokości numeru zamówienia, usunięty został również opis przycisku ze strzałką.

Zmiany w sekcji Kontrahent

W sekcji Kontrahent wprowadzone zostały następujące zmiany:

Zmiany w sekcji Dane nagłówkowe

W sekcji Dane nagłówkowe wprowadzone zostały następujące zmiany:

Dodanie sekcji Pozostałe dane

W wersji 2024.1 systemu Comarch ERP XL Web na formularzy zamówienia sprzedaży dodana została sekcja Pozostałe dane, do której z sekcji Dane nagłówkowe przeniesione zostały pola Centrum oraz Odpowiedzialny.

Zmiany w stopce zamówienia

W wersji 2024.1 informacje o wartości zamówienia przeniesione zostały do stopki dokumentu.

Zmiana nabywcy na zamówieniu sprzedaży

W wersji 2024.1 umożliwiona została zmiana nabywcy na zamówieniu sprzedaży.

W celu zmiany nabywcy należy ustawić się w polu Nabywca i postępować analogicznie, jak podczas wyboru kontrahenta na zamówienie:

Uwaga

Aktualnie zmiana nabywcy na zamówieniu nie powoduje zmiany odbiorcy oraz płatnika.

Aktualizacja parametrów na zamówieniu po zmianie nabywcy

Jeżeli w definicji dokumentu ZS w centrum struktury zaznaczona jest aktualizacja danych po zmianie kontrahenta, to w wersji 2024.1 zmiana nabywcy na zamówieniu powoduje automatyczną aktualizację następujących parametrów związanych z kontrahentem:

Wskazówka

W następnych wersjach systemu implementowana będzie aktualizacja kolejnych parametrów związanych ze zmianą kontrahenta na dokumencie.

Uwaga

Aktualnie podczas zmiany nabywcy operator nie ma możliwości decydowania, czy dane parametry mają być aktualizowane. Taka opcja pojawi się w jednej z kolejnych wersji systemu.

Inne zmiany

W wersji 2024.1 zostały wprowadzone poprawki mające na celu zwiększenie bezpieczeństwa systemu Comarch ERP XL Web.

Uwaga

Przed zainstalowaniem Comarch ERP XL Web 2024.1 należy odinstalować poprzednią wersję aplikacji.

Uwaga

Podczas instalacji Comarch ERP XL Web 2024.1 na systemie Microsoft Windows 11 należy być zalogowanym na lokalne konto systemowe.

Comarch ERP XL Web Instrukcja instalacji

Proces instalacji

Uruchomienie pliku instalacyjnego Comarch XL Web.exe rozpoczyna proces instalacji systemu.

Ponieważ do prawidłowego działania wersji 2024.1 systemu wymagane są odpowiednie wersje komponentów .NET, w pierwszej kolejności instalator weryfikuje aktualność zainstalowanych programów .NET Microsoft Windows Desktop Runtime oraz .NET Microsoft Server Hosting i w razie potrzeby umożliwia ich aktualizację/instalację.

Po zaktualizowaniu/zainstalowaniu niezbędnych składników rozpoczyna się instalacja systemu Comarch ERP XL Web.

W kolejnym kroku Użytkownik może wybrać typ instalacji:

Następnie należy wskazać katalog instalacyjny.

Kolejny etap to podanie parametrów konfiguracyjnych takich jak:

Po naciśnięciu przycisku Dalej wyświetlony zostaje ekran, na którym można uruchomić instalację zgodnie z ustawionymi we wcześniejszych krokach parametrami.

Po rozpoczęciu instalacji wyświetlany jest stan procesu instalacyjnego.

Na zakończenie wyświetlany jest ekran z informacją o zakończeniu procesu instalacji.

Uruchomienie

Ekran logowania

Po wpisaniu w przeglądarce nazwy hosta, na którym zainstalowany został Comarch ERP XL oraz portu wskazanego podczas instalacji, np. https://localhost:8000, zostanie wyświetlony ekran logowania się do programu.

Po wpisaniu identyfikatora operatora oraz hasła program Comarch ERP XL zostanie uruchomiony w przeglądarce.

Comarch ERP XL Web Podręcznik Użytkownika

Logowanie

Ekran logowania

Po uruchomieniu w przeglądarce programu Comarch ERP XL wyświetlony zostaje ekran logowania jak poniżej.

Dane Użytkownika

W polu Użytkownik należy wpisać identyfikator operatora zdefiniowanego w programie Comarch ERP XL, w polu Hasło należy wprowadzić hasło wpisanego operatora.

Uwaga

W celu zabezpieczenia się przed zalogowaniem nieuprawnionego Użytkownika na ekranie logowania nie ma możliwości wyświetlenia listy operatorów. Identyfikator operatora należy każdorazowo wpisać w pole Użytkownik.

Uwaga

Od wersji Comarch ERP XL Web 2024.1 wprowadzono ok. 5-sekundowe opóźnienie po każdej nieudanej próbie logowania do Systemu, natomiast po pięciu nieudanych próbach i każdej kolejnej opóźnienie wyniesie 60 sekund.

Informacje o bazie danych i wersji programu

U dołu ekranu logowania wyświetlana jest informacja z nazwą bazy danych, do której loguje się Użytkownik oraz numer wersji programu.

Uwaga

Podczas logowania nie ma możliwości zmiany bazy – Użytkownik może się zalogować wyłącznie do bazy wskazanej podczas instalacji programu.

Wskazówka

Zmiany parametrów logowania takich jak nazwa serwera SQL oraz nazwa bazy danych można dokonać poprzez edycję stosownych ustawień w plikach appsettings znajdujących się w katalogach podrzędnych katalogu XLRestApi w folderze, w którym zainstalowany jest program Comarch ERP XL Web.

Ekran startowy (dashboard) aplikacji

Od wersji 2024.1 systemu Comarch ERP XL Web dostępny jest ekran startowy, tzw. dashboard aplikacji.

Wyświetlenie dashboardu

Budowa dashboardu

Ekran startowy podzielony jest na trzy panele: Skróty, Statystyki i Zamówienia sprzedaży.

W wersji 2024.1 systemu Comarch ERP XL Web obsługiwane są wyłącznie zamówienia sprzedaży, stąd dane prezentowane na ekranie startowym dotyczą tylko tego obszaru.

Wraz z pojawieniem się funkcjonalności z kolejnych obszarów dashboard będzie stosownie rozbudowywany.

Panel Skróty

W panelu Skróty znajdują się przyciski szybkiej obsługi pozwalające wykonać określoną akcję.

W wersji 2024.1 aktywny jest wyłącznie przycisk do dodawania nowego zamówienia sprzedaży. W kolejnych wersjach wraz z rozwojem funkcjonalności aktywowane będą kolejne przyciski.

Panel Statystyki

Panel Statystyki zawiera dwa wykresy:

Dla każdego z wykresów można wskazać okres, za jaki mają zostać zaprezentowane dane:

Po najechaniu kursorem na słupek wykresu Wartość zamówień Twojego centrum prezentowana jest szczegółowa informacja dotycząca zamówień w danym okresie.

Najeżdżając kursorem na wybrany fragment wykresu Zamówione towary wg wartości można zobaczyć szczegóły dotyczące danego towaru.

Uwaga

Wartości na wykresach dotyczą zamówień, których właścicielem jest centrum, w którym zalogowany jest Użytkownik.

Uwaga

Zarówno na wykresie słupkowym, jak i na wykresie kołowym wartości prezentowane są w przeliczeniu na walutę systemową.

Panel Zamówienia sprzedaży

W panelu Zamówienia sprzedaży prezentowana jest lista 10 ostatnich zamówień sprzedaży wystawionych w centrum, w którym zalogowany jest Użytkownik.

Po naciśnięciu przycisku Pokaż więcej wyświetlona zostaje pełna lista zamówień sprzedaży.

Po prawej stronie listy zamówień znajdują się przyciski prezentujące informacje związane z realizacją zamówień:

Po naciśnięciu któregokolwiek przycisku Użytkownik przenoszony jest na listę zamówień sprzedaży.

Uwaga

Filtry na listach implementowane będą w kolejnych wersjach systemu. Docelowo po naciśnięciu danego przycisku wyświetlona zostanie lista zamówień odfiltrowana do dokumentów w stanie realizacji zgodnym z opisem na przycisku.

Poruszanie się po programie

Po zalogowaniu się Użytkownika aplikacja wyświetlana jest w układzie jak poniżej.

Na ekranie programu można wyróżnić trzy podstawowe elementy:

Panel boczny nawigacji

W panelu bocznym nawigacji wyświetlane są przyciski pozwalające na przejście do wybranego obszaru programu.

W pierwszej wersji dostępne są następujące obszary:

Uwaga

W aktualnej wersji programu obsługiwany jest wyłącznie obszar zamówień sprzedaży. Po naciśnięciu przycisków Kontrahenci oraz Towary wyświetlany jest jedynie ekran informacyjny.

Za pomocą przycisku można zwijać/rozwijać panel boczny.

Panel górny nawigacji

W panelu górnym nawigacji dostępne są następujące przyciski:

Pomoc

Naciśnięcie przycisku Pomoc powoduje otwarcie okna, w którym wyświetlana jest informacja o programie oraz dostępne są przekierowania do stron pomocy dla programu Comarch ERP XL oraz stron społeczności Comarch ERP.

Informacje o operatorze

Na przycisku z informacją o operatorze wyświetlana jest nazwa centrum, do którego zalogowany jest operator oraz identyfikator i nazwisko operatora.

Po rozwinięciu przycisku Operator ma dostępną opcję wylogowania się z programu.

Uwaga

Po rozwinięciu przycisku wyświetlana jest lista centrów, do których dołączony jest zalogowany operator, w wersji 2024.1 nie ma natomiast możliwości zmiany centrum (zmiany kontekstu operatora).

Lista zamówień sprzedaży

Układ listy zamówień

Po naciśnięciu w panelu bocznym przycisku Zamówienia sprzedaży na ekranie głównym aplikacji wyświetlana jest lista zamówień sprzedaży.

Na liście wyświetlane są wszystkie dokumenty widoczne w centrum, w którym zalogowany jest Użytkownik.

Lista zawiera następujące kolumny:

Uwaga

W aplikacji webowej znany z wersji standardowej Stan dokumentu wyświetlany jest w rozbiciu na Status i Stan realizacji.

Powiązania pomiędzy Stanem dokumentu a Statusem i Stanem realizacji prezentuje poniższa tabela:

Stan w standardowym interfejsie	Status w interfejsie webowym	Stan realizacji w interfejsie webowym
Niepotwierdzone	Niezatwierdzony	-
Potwierdzone	Zatwierdzony	Do realizacji
W realizacji	Zatwierdzony	W realizacji
Zrealizowane	Zamknięty	Zrealizowany
Odrzucone	Anulowany	Niezrealizowany
Anulowane potwierdzone	Anulowany	Niezrealizowany
Zamknięte potwierdzone	Zamknięty	Niezrealizowany
Zamknięte w realizacji	Zamknięty	Częściowo zrealizowany
Korygowane potwierdzone	Korygowany	Do realizacji
Korygowane w realizacji	Korygowany	W realizacji

Uwaga

W aplikacji webowej kontrahent główny wyświetlany jest jako Nabywca, a kontrahent docelowy jako Odbiorca.

Obsługa listy zamówień

Na liście Użytkownik może wykonywać następujące operacje:

Dodawanie zamówienia sprzedaży

Układ formularza zamówienia

Po naciśnięciu na liście zamówień przycisku Dodaj wyświetlony zostaje formularz nowego zamówienia sprzedaży.

Pola obowiązkowe do wypełnienia oznaczone są gwiazdką.

Pomiędzy sekcjami formularza można poruszać się za pomocą nawigacji dostępnej z prawej strony.

Nagłówek zamówienia

W nagłówku zamówienia wyświetlane są następujące elementy:

Uwaga

Numer zamówienia generowany jest po dodaniu kontrahenta na dokument. Przed dodaniem kontrahenta w miejscu numeru wyświetlany jest opis Numer zamówienia. 

Uwaga

Jeżeli do zamówienia dodany został kontrahent i wygenerowany został numer dokumentu, to po naciśnięciu przycisku strzałki zamówienie zostanie zapisane ze statusem Niezatwierdzony.

Dodawanie kontrahenta na zamówienie

Po ustawieniu kursora w polu Wybierz kontrahenta Użytkownik ma możliwość dodania kontrahenta na zamówienie.

Istnieją dwa sposoby na dodanie kontrahenta:

Nabywca, odbiorca oraz płatnik na zamówieniu

Po wybraniu kontrahenta w zależności od ustawień na kartotece kontrahenta na dokument pobierane są dane nabywcy, odbiorcy oraz płatnika.

 Zmiana nabywcy na zamówieniu

W wersji 2024.1 umożliwiona została zmiana nabywcy na zamówieniu sprzedaży.

W celu zmiany nabywcy należy ustawić się w polu Nabywca i postępować analogicznie, jak podczas wyboru kontrahenta na zamówienie:

Uwaga

Aktualnie zmiana nabywcy na zamówieniu nie powoduje zmiany odbiorcy oraz płatnika.

Aktualizacja parametrów zamówienia po zmianie nabywcy

Jeżeli w definicji dokumentu ZS w centrum struktury zaznaczona jest aktualizacja danych po zmianie kontrahenta, to w wersji 2024.1 zmiana nabywcy na zamówieniu powoduje automatyczną aktualizacje następujących parametrów związanych z kontrahentem:

Pozycje zamówienia

Pozycje zamówienia przed dodaniem kontrahenta

Na formularzu nowo dodawanego zamówienia sprzedaży przed dodaniem kontrahenta na dokument w sekcji Pozycje wyświetlane są wyłącznie nagłówki kolumn i nie ma możliwości dodania pozycji.

Wyświetlany jest także stosowny komunikat informujący, że dodanie pozycji będzie możliwe po wybraniu kontrahenta.

Pozycje zamówienia po dodaniu kontrahenta

Po wybraniu kontrahenta w sekcji Pozycje zostaje wyświetlony wiersz, w którym można dodawać pozycje do zamówienia.

Układ listy pozycji zamówienia

Lista pozycji zamówienia sprzedaży zawiera następujące kolumny:

Pozostałe dane

W sekcji Pozostałe dane wyświetlane są następujące pola:

Wiersz do dodawania nowej pozycji wyświetlany jest zawsze jako pierwszy.

Pobieranie danych o towarze na pozycje zamówienia

Dodawanie pozycji z uproszczonej listy towarów

Od wersji 2024.1 systemu Comarch ERP XL Web na formularzu zamówienia sprzedaży udostępniona została możliwość dodawania pozycji zamówienia z uproszczonej listy towarów.

Wywołanie uproszczonej listy towarów

Na zamówieniu sprzedaży Użytkownik może wywołać uproszczoną listę towarów na dwa sposoby:

Obsługa uproszczonej listy towarów

Po wyborze opcji do dodawania towarów z listy wyświetlona zostaje uproszczona lista towarów w następującym układzie.

W celu wyboru towaru, który ma zostać dodany na zamówienie, Użytkownik może:

Jeżeli na karcie towaru zdefiniowane są jednostki pomocnicze, to na uproszczonej liście na tym towarze Użytkownik może wskazać, w jakiej jednostce towar ma zostać dodany do zamówienia.

Po naciśnięciu przycisku Dodaj zaznaczone towary zostaną dodane na zamówienie w ilościach i jednostkach ustalonych na uproszczonej liście towarów.

Uwaga

Jeżeli na kartotece towaru jednostka pomocnicza oznaczona została, jako proponowana przy sprzedaży, to na uproszczonej liście towarów jednostka ta będzie się domyślnie proponować dla danego towaru.

Wskazówka

Jeżeli Użytkownik chce dodać do zamówienia ilość towaru inną niż 1, to powinien to zrobić korzystając z uproszczonej listy towarów – w wersji 2024.0 nie ma możliwości edycji ilości towaru bezpośrednio na liście pozycji zamówienia.

Zapisywanie zamówienia

W stopce zamówienia znajduje się przycisk pozwalający na zapisanie dokumentu.

Po naciśnięciu przycisku weryfikowane jest, czy obowiązkowe pola zostały uzupełnione oraz czy dane na dokumencie są poprawne – jeżeli na zamówieniu występuje błąd, wyświetlany jest stosowny komunikat, pole, w którym występuje błąd jest odpowiednio podświetlane a przycisk Zapisz jest dezaktywowany aż do usunięcia błędu.

Jeżeli próba zapisu zakończy się sukcesem, system wraca do listy zamówień sprzedaży.

Architektura rozwiązania

Opis

Architektura Comarch ERP XL wydziela część dostępu do danych (backend) od części prezentacyjnej (frontend). W ramach części prezentacyjnej dostarczany jest interfejs WWW, który jest serwowany przy wykorzystaniu serwera nginx. Dodatkowo nginx służy jako API gateway i load balancer, rozdzielając zapytania do warstwy danych, do odpowiednich mikroserwisów. Sama warstwa danych składa się z wielu mikroserwisów odpowiadających za wybrane funkcjonalności systemu. Dzięki takiej architekturze możliwe jest skalowanie horyzontalne aplikacji oraz łatwe aktualizowanie pojedynczych serwisów przy zachowaniu ciągłości pracy. Aby mikroserwisy były osiągalne z poziomu frontendu, aby mogły się ze sobą komunikować oraz aby można było rozdzielać do nich ruch - konieczny jest mechanizm rejestracji serwisów, czyli Service Discovery. Służy do tego Consul - czyli repozytorium serwisów.

W konsekwencji do działania XL'a w wersji Web konieczne są aktywne procesy: nginx, consul, consul-template oraz procesy samych mikroserwisów (obecnie XL.Authorization, XL.Customers, XL.Orders, XL.Users oraz XL.Articles).

Proces uruchamiania Comarch ERP XL składa się zatem z uruchomienia usługi Consul, następnie uruchomienia mikroserwisów (które zarejestrują swój adres i port w Consul'u) - na tym etapie mamy już dostępne nowe Rest API dla XL'a. Następnie do uruchomienia frontend potrzebne jest jeszcze uruchomienie serwera nginx oraz usługi consul-template, której zadaniem jest odczytanie adresów i portów mikroserwisów z repozytorium Consul'a, oraz zapisanie ich w konfiguracji nginx. Jeżeli uruchomimy wiele instancji tego samego mikroserwisu, to nginx będzie przekierowywał żądania równomiernie do każdej instancji (tzw. metoda Round-Robin). Również w ramach wewnętrznej komunikacji między mikroserwisami funkcjonuje load balancing oparty o repozytorium Consul.

Przy domyślnej instalacji stan serwisów można monitorować z poziomu strony http://localhost:8500/. Dodatkowo wszystkie błędy i ostrzeżenia samych mikroserwisów są logowane w zdarzeniach systemowych Windows w sekcji "Aplikacja". Natomiast logi z warstwy prezentacji znajdują się w katalogu serwera nginx w podkatalogu logs. Ponieważ cała komunikacja wymaga zabezpieczenia przed nieautoryzowanym dostępem wdrożono wykorzystanie protokołu https. Aby to było możliwe konieczne jest posiadanie certyfikatu ssl - podczas instalacji jest kreowany certyfikat podpisany samodzielnie o nazwie localhost_xlweb. W przypadku potrzeby udostępnienia programu w sieci publicznej zalecane jest zakupienie certyfikatu w jednym z zaufanych centrów certyfikacji.

Uwaga

Przed zainstalowaniem Comarch ERP XL Web 2025.0 należy odinstalować poprzednią wersję aplikacji.

Zmiany na ekranie logowania

Nowy ekran logowania

W wersji 2025.0 systemu Comarch ERP XL Web zaimplementowany został nowy ekran logowania.

Obsługa błędów na ekranie logowania

Jeżeli podczas logowania do systemu wystąpi błąd, na ekranie logowania pojawia się stosowny komunikat ze wskazaniem możliwej przyczyny problemu.

Lista towarów

W wersji 2025.0 dodane zostało wyświetlanie listy towarów z poziomu głównego ekranu systemu.

Po wyborze w panelu bocznym opcji Towary wyświetlona jest lista w układzie jak poniżej:

Na liście wyświetlane są następujące kolumny:

Wskazówka

Ilość do sprzedaży oraz ilość na magazynie wyświetlana jest w odniesieniu do wszystkich magazynów dostępnych w centrum, w którym zalogowany jest Użytkownik.

Wyszukiwarka na liście towarów

Nad listą towarów znajduje się pole wyszukiwarki, dzięki któremu Użytkownik może zawęzić listę do pozycji zawierających frazę wpisaną w polu wyszukiwania.

Wyszukiwanie odbywa się po wartości w polach Kod towaru, Nazwa towaru, EAN oraz Symbol.

Wskazówka

Wyszukiwanie pozycji rozpoczyna się po naciśnięciu przycisku lupki w wyszukiwarce lub po naciśnięciu przycisku <ENTER>

Uwaga

Przycisk x służy do usuwania treści wpisanej w polu wyszukiwarki.

W celu usunięcia filtrowania należy użyć przycisku Wyczyść filtry lub usunąć frazę filtrowania przyciskiem x i następnie nacisnąć lupkę lub <ENTER>

Zmiany na liście zamówień sprzedaży

Wyszukiwanie zamówień

Na liście zamówień dodana została wyszukiwarka dokumentów.

Lista dokumentów może zostać zawężona do pozycji, które w numerze dokumentu lub w danych znajdujących się w kolumnie Nabywca zawierają wpisaną w wyszukiwarce frazę.

Wskazówka

Wyszukiwanie pozycji rozpoczyna się po naciśnięciu przycisku lupki w wyszukiwarce lub po naciśnięciu przycisku <ENTER>

Uwaga

Przycisk x służy do usuwania treści wpisanej w polu wyszukiwarki.

W celu usunięcia filtrowania należy użyć przycisku Wyczyść filtry lub usunąć frazę filtrowania przyciskiem x i następnie nacisnąć lupkę lub <ENTER>

Filtrowanie po statusie dokumentu

W wersji 2025.0 dodana została możliwość filtrowania listy zamówień po statusie dokumentu.

Filtrowanie uruchamiane jest po zaznaczeniu wybranych w kontrolce statusów i naciśnięciu przycisku Potwierdź.

Filtrowanie po stanie realizacji zamówienia

W wersji 2025.0 dodana została możliwość filtrowania listy zamówień po stanie realizacji dokumentu.

Filtrowanie uruchamiane jest po zaznaczeniu wybranych w kontrolce stanów realizacji i naciśnięciu przycisku Potwierdź.

Usuwanie zamówień

Na liście zamówień sprzedaży umożliwiono usuwanie dokumentów.

Usuwanie pojedynczego dokumentu

W celu usunięcia pojedynczego dokumentu należy w menu dostępnym pod przyciskiem wybrać opcję Usuń.

Przycisk Usuń jest aktywny wyłącznie na zamówieniu o statusie Niezatwierdzony.

Po naciśnięciu przycisku Usuń wyświetlone zostanie okno, w którym Użytkownik może potwierdzić chęć usunięcia zamówienia.

Usuwanie wielu dokumentów

W celu usunięcia wielu zamówień należy zaznaczyć na liście pozycje do usunięcia.

Jeżeli wśród zaznaczonych dokumentów jest chociaż jedno zamówienie o stanie Niezatwierdzony, to w belce pod listą pojawia się przycisk Usuń.

Po naciśnięciu przycisku Usuń i potwierdzeniu chęci usunięcia wybranych pozycji zaznaczone zamówienia w stanie niezatwierdzonym zostaną usunięte.

Zmiany na formularzu zamówienia

Poprawa ergonomii formularza

W wersji 2025.0 wprowadzono szereg zmian poprawiających ergonomię formularza zamówienia sprzedaży.

Usunięcie bocznego panelu nawigacji

W celu lepszego rozmieszczenia kontrolek na formularzu oraz umożliwienia wyświetlenia większej ilości danych usunięty został prawy panel nawigacji.

Ukrycie danych nagłówkowych przed dodaniem kontrahenta na zamówienie

Ponieważ dane nagłówkowe uzupełniane są dopiero po dodaniu kontrahenta na zamówienie przed dodaniem kontrahenta sekcja jest ukrywana.

Zmiany w nagłówku zamówienia

W wersji 2025.0 w nagłówku zamówienia numer dokumentu przeniesiono do pierwszego wiersza, tak, aby nagłówek nie ograniczał miejsca dla głównych danych na formularzu.

Dokowanie nagłówka i stopki dokumentu

W najnowszej wersji systemu nagłówek i stopka dokumentu zostały zadokowane.

Dzięki temu Użytkownik przez cały czas pracy z dokumentem ma dostęp do najistotniejszych informacji.

 

Optymalizacja układu kafla z danymi kontrahenta

W kaflu z danymi kontrahenta numer telefonu oraz adres e-mail umieszczone zostały w jednym wierszu, dzięki czemu udało się pozyskać dodatkowy wiersz na wyświetlenie innych danych na dokumencie.

Optymalizacja w sekcji Dane nagłówkowe

W celu zoptymalizowania układu formularza w sekcji Dane nagłówkowe wprowadzone zostały następujące zmiany:

Zmiany w sekcji Kontrahent

Wyświetlanie pełnej nazwy kontrahenta

W polu z wyborem kontrahenta, nabywcy oraz odbiorcy a także w kaflu prezentującym dane nabywcy, odbiorcy oraz płatnika od wersji 2025.0 wyświetlana jest pełna nazwa kontrahenta.

Jeżeli nazwa nie mieści się w polu, to po najechaniu na nią wskaźnikiem w tooltipie wyświetlona zostanie pełna wartość.

Aktualizacja danych odbiorcy po zmianie nabywcy

Jeżeli w definicji dokumentu ZS ustawiona jest aktualizacja danych po zmianie kontrahenta, to po zmianie nabywcy na dokumencie aktualizowane są również dane odbiorcy.

Aktualizacja danych płatnika po zmianie nabywcy

Jeżeli w definicji dokumentu ZS ustawiona jest aktualizacja danych po zmianie kontrahenta, to po zmianie nabywcy na dokumencie aktualizowane są również dane płatnika.

Zmiana odbiorcy na dokumencie

Od wersji 2025.0 na zamówieniu Użytkownik ma możliwość zmiany odbiorcy.

W celu zmiany odbiorcy należy ustawić się w polu Odbiorca i postępować analogicznie, jak podczas wyboru kontrahenta lub zmiany nabywcy:

Jeżeli w definicji dokumentu ZS ustawiona jest aktualizacja danych po zmianie kontrahenta, to po zmianie odbiorcy na dokumencie aktualizowane są również:

Uwaga

W wersji 2025.0 zablokowane jest dodawanie kontrahenta, dla którego jako płatnik ustawiony jest bank, urząd lub pracownik.

Przy próbie dodania takiego kontrahenta lub podczas próby zmiany nabywcy na takiego kontrahenta wyświetlany jest błąd:

Zmiany w sekcji Dane nagłówkowe

Edycja pola Data aktywacji rezerwacji

W wersji 2025.0 umożliwiona została edycja daty aktywacji rezerwacji.

Zmiana daty może być wykonana poprzez:

Edycja pola Numer obcy

W wersji 2025.0 umożliwiona została edycja pola Numer obcy.

Zmiany w sekcji Pozycje zamówienia

Nowe pola w sekcji

W wersji 2025.0 w sekcji Pozycje zamówienia dodane zostały następujące kontrolki:

Uwaga

W wersji 2025.0 pola związane z listą pozycji są w trybie tylko do odczytu. Edycja wartości w tych polach udostępniona zostanie w kolejnych wersjach systemu.

Wyświetlanie 15 pozycji na liście

Od wersji 2025.0 po ustawieniu 15 lub 20 elementów na stronie wyświetlanych jest 15 wierszy bez konieczności skrolowania listy.

Usuwanie pozycji zamówienia

Na liście pozycji zamówienia umożliwione zostało usuwanie pozycji.

W celu usunięcia pozycji należy w menu dostępnym pod przyciskiem wybrać opcję Usuń.

Edycja ilości na pozycji zamówienia

W wersji 2025.0 udostępniona została edycja ilości na pozycjach zamówienia.

Wyszukiwarka na uproszczonej liście towarów

W wersji 2025.0 na liście towarów wyświetlanej po naciśnięciu przycisku Dodaj z listy pojawiła się wyszukiwarka ułatwiająca odnalezienie pożądanych towarów.

Wyszukiwanie odbywa się po wartości w polach Towar, EAN oraz Symbol.

Sekcja Dane handlowe

W wersji 2025.0 pod listą pozycji zamówienia dodana została sekcja Dane handlowe.

Rodzaj transakcji

W polu Rodzaj transakcji prezentowana jest informacja czy zamówienie jest dokumentem krajowym, wewnątrzwspólnotowym czy innym zagranicznym (poza unijnym).

Edycja rodzaju transakcji

W wersji 2025.0 umożliwiono także edycję wartości w polu Rodzaj transakcji.

Użytkownik ma możliwość wyboru wartości z listy rozwijanej w kontrolce:

Cecha transakcji

W sekcji Dane handlowe wyświetlane jest pole Cecha transakcji prezentujące wartość cechy dokumentu.

Edycja wartości w polu Cecha transakcji

W wersji 2025.0 umożliwiono:

Jeżeli na liście wartości nie ma pożądanej cechy Użytkownik może dodać nową wartość za pomocą przycisku Dodaj spoza listy.

Po naciśnięciu przycisku wyświetlone zostaje okno, w którym Użytkownik może dodać nowy sposób dostawy.

W oknie kontrolowana jest unikalność wartości – system nie pozwoli na dodanie już istniejącej cechy.

Uwaga

Po zapisaniu nowo dodana wartość jest automatycznie dopisywana do listy wartości dla słownika cech.

Wskazówka

Nowo dodana cecha jest automatycznie wstawiana w pole Cecha transakcji na dokumencie, jest również od razu dostępna na liście wartości w kontrolce.

Forma i termin płatności

W sekcji Dane handlowe dodane zostały pola związane z formą i terminem płatności.

Edycja formy i terminu płatności

W wersji 2025.0 umożliwiono edycję formy i terminu płatności.

Zmiana formy płatności możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Jeżeli na liście dostępnych form płatności znajduje się więcej niż 10 pozycji, to wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie pożądanej formy.

Uwaga

Jeżeli dla formy płatności zdefiniowany jest termin > 0 dni, to jest on wyświetlany w nawiasie obok formy płatności.

Termin dla wybranej formy płatności jest automatycznie wstawiany w pole Dni do zapłaty.

Zmiana terminu płatności możliwa jest przez edycję wartości w polu Dni do zapłaty.

Sposób dostawy

W sekcji Dane handlowe dodane zostało pole Sposób dostawy prezentujące metodę dostawy wybraną na dokumencie.

Edycja sposobu dostawy

W wersji 2025.0 umożliwiono edycję sposobu dostawy na zamówieniu przez:

Uwaga

Jeśli na liście wartości znajduje się więcej niż 10 pozycji, to w kontrolce wyświetlona zostanie wyszukiwarka umożliwiająca szybkie znalezienie pożądanego sposobu dostawy.

Pole Sposób dostawy nie jest obowiązkowe i może być puste, dlatego Użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Jeżeli na liście wartości nie ma pożądanego sposobu dostawy Użytkownik może dodać nową wartość za pomocą przycisku Dodaj spoza listy.

Po naciśnięciu przycisku wyświetlone zostaje okno, w którym Użytkownik może dodać nową cechę.

W oknie kontrolowana jest unikalność wartości – system nie pozwoli na dodanie już istniejącego sposobu dostawy.

Uwaga

Po zapisaniu nowo dodana wartość jest automatycznie dopisywana do listy wartości dla słownika sposobów dostawy.

Wskazówka

Nowo dodany sposób dostawy jest automatycznie wstawiany w pole Sposób dostawy na dokumencie, jest również od razu dostępny na liście wartości w kontrolce.

Pola związane z walutą transakcji

W sekcji Dane handlowe dodane zostały następujące pola związane z walutą:

Uwaga

W wersji 2025.0 pola związane z walutą wyświetlane są w trybie tylko do odczytu. Edycja wartości w tych polach udostępniona zostanie w kolejnych wersjach systemu.

Uwaga

Pola Kurs oraz Jednostka kursu są ukrywane, jeśli na dokumencie wybrana jest waluta systemowa.

Sekcja Dane transakcji

W wersji 2025.0 na formularzu zamówienia dodana została sekcja Dane transakcji.

Uwaga

Sekcja Dane transakcji jest ukrywana, jeśli w polu Rodzaj transakcji wybrana jest wartość Krajowa.

Kraj przeznaczenia

W sekcji Dane transakcji dodane zostało pole Kraj przeznaczenia.

Zmiana kraju przeznaczenia

W wersji 2025.0 umożliwiona została także zmiana wartości w polu Kraj przeznaczenia.

Zmiana kraju przeznaczenia możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Na liście wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie danego kraju.

Uwaga

Jeśli transakcja jest wewnątrzwspólnotowa, to lista wartości w kontrolce jest zawężona do krajów należących do grupy UE

Rodzaj transportu

W sekcji Dane transakcji dodane zostało pole Rodzaj transportu.

Zmiana rodzaju transportu

W wersji 2025.0 umożliwiona została zmiana rodzaju transportu na dokumencie.

Zmiana rodzaju transportu możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Pole Rodzaj transportu nie jest obowiązkowe i może być puste, dlatego Użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Rodzaj transakcji celnej

W sekcji Dane transakcji dodane zostało pole prezentujące rodzaj transakcji celnej.

Zmiana rodzaju transakcji celnej

W wersji 2025.0 umożliwiono edycję rodzaju transakcji celnej.

Zmiana możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Na liście wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie pożądanego rodzaju transakcji celnej.

Pole Rodzaj transakcji celnej nie jest obowiązkowe i może być puste, dlatego Użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Symbol incoterms

W sekcji Dane transakcji dodane zostało pole Symbol Incoterms.

Zmiana symbolu Incoterms

W wersji 2025.0 umożliwiona została zmiana symbolu Incoterms na dokumencie.

Zmiana możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Na liście wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie pożądanego symbolu Incoterms.

Pole Symbol Incoterms nie jest obowiązkowe i może być puste, dlatego Użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Miejsce incoterms

W sekcji Dane transakcji dodane zostało pole Miejsce Incoterms.

Edycja miejsca Incoterms

W wersji 2025.0 umożliwiono edycję miejsca Incoterms na zamówieniu przez:

Uwaga

Jeśli na liście wartości znajduje się więcej niż 10 pozycji, to w kontrolce wyświetlona zostanie wyszukiwarka umożliwiająca szybkie znalezienie pożądanego miejsca Incoterms.

Pole Miejsce Incoterms nie jest obowiązkowe i może być puste, dlatego Użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Jeżeli na liście wartości nie ma pożądanego sposobu dostawy Użytkownik może dodać nową wartość za pomocą przycisku Dodaj spoza listy.

Po naciśnięciu przycisku wyświetlone zostaje okno, w którym Użytkownik może dodać nowe miejsce Incoterms.

W oknie kontrolowana jest unikalność wartości – system nie pozwoli na dodanie już istniejącego miejsca Incoterms.

Uwaga

Po zapisaniu nowo dodana wartość jest automatycznie dopisywana do listy wartości dla słownika miejsc Incoterms.

Wskazówka

Nowo dodane miejsce Incoterms jest automatycznie wstawiane w pole Miejsce Incoterms na dokumencie, jest również od razu dostępne na liście wartości w kontrolce.

Zmiany w sekcji Pozostałe dane

W sekcji Pozostałe dane dodane zostało pole Opis.

Edycja pola Opis

W wersji 2025.0 umożliwiona została edycja pola Opis.

 

Zmiana operatora odpowiedzialnego

W wersji 2025.0 umożliwiona została edycja pola Odpowiedzialny.

Zmiana możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Uwaga

Zmiany operatora odpowiedzialnego można dokonać po dodaniu kontrahenta na zamówienie. Przed dodaniem kontrahenta pole jest w trybie tylko do odczytu.

Usuwanie zamówienia

W wersji 2025.0 dodana została możliwość usuwania dokumentu podczas wychodzenia z formularza zamówienia.

Po naciśnięciu przycisku wyświetlone zostaje okno, w którym Użytkownik może zadecydować, jaką akcje chce wykonać:

Inne zmiany

Tworzenie rezerwacji zasobowych

W wersji 2025.0 podczas dodawania pozycji na zamówienie tworzone są rezerwacje zasobowe, jeżeli spełnione są poniższe warunki:

Produkcja

Obszar Produkcja w nawigacji

W wersji 2025.0 w Panelu bocznym nawigacji dodano obszar: Produkcja, w ramach którego udostępniono opcje: Zasoby, Gniazda robocze i Technologie.

Uwaga

W tej wersji programu obsługiwany jest wyłącznie obszar Zasoby. Obsługa Gniazd roboczych oraz Technologii planowana jest w kolejnej wersji Comarch ERP XL Web.

Lista zasobów produkcyjnych

Po naciśnięciu w panelu bocznym przycisku Zasoby, na ekranie głównym aplikacji wyświetlana jest lista zasobów produkcyjnych.

Na liście wyświetlane są wszystkie zasoby produkcyjne zdefiniowane w systemie Comarch ERP XL.

Na liście możliwe są podstawowe operacje związane z pracą na listach, takie jak filtrowanie, wyszukiwanie i sortowanie zasobów produkcyjnych.

Domyślnie na liście nie są widoczne zasoby oznaczone jako archiwalne. Aby je wyświetlić, należy włączyć filtr: Pokaż tylko archiwalne.

Podgląd zasobu

W wersji 2025.0 aplikacji udostępniony został podgląd karty zasobu produkcyjnego.

Układ karty podglądu zasobu

Po kliknięciu na liście zasobów w kod konkretnego zasobu (link znajdujący się w kolumnie Kod zasobu) lub po naciśnięciu przycisku (znajdującego się na końcu każdej z pozycji listy) i wybraniu opcji: Podgląd, podnoszone jest okno Zasób z danymi wskazanego zasobu w trybie podglądu.

W oknie podglądu zasobu, na zakładce [Ogólne] wyświetlone są podstawowe parametry zasobu produkcyjnego, zdefiniowanego w Comarch ERP XL (aplikacji desktopowej).

Funkcjonalność dodawania, edycji i usuwania zasobu w Comarch ERP XL WEB oraz udostępnienie kolejnych parametrów zasobu zostanie opublikowana w następnej wersji aplikacji.

Uwaga

Przed zainstalowaniem Comarch ERP XL Web 2025.0 należy odinstalować poprzednią wersję aplikacji.

Comarch ERP XL Web Instrukcja instalacji

Proces instalacji

Uruchomienie pliku instalacyjnego Comarch ERP XL Web.exe rozpoczyna proces instalacji systemu.

Ponieważ do prawidłowego działania wersji 2025.0 systemu wymagane są odpowiednie wersje komponentów .NET, w pierwszej kolejności instalator weryfikuje aktualność zainstalowanych programów .NET Microsoft Windows Desktop Runtime oraz .NET Microsoft Server Hosting i w razie potrzeby umożliwia ich aktualizację/instalację.

Po zaktualizowaniu/zainstalowaniu niezbędnych składników rozpoczyna się instalacja systemu Comarch ERP XL Web.

W kolejnym kroku Użytkownik może wybrać typ instalacji:

Następnie należy wskazać katalog instalacyjny.

Kolejny etap to podanie parametrów konfiguracyjnych takich jak:

Po naciśnięciu przycisku Dalej wyświetlony zostaje ekran, na którym można uruchomić instalację zgodnie z ustawionymi we wcześniejszych krokach parametrami.

Po rozpoczęciu instalacji wyświetlany jest stan procesu instalacyjnego.

Na zakończenie wyświetlany jest ekran z informacją o zakończeniu procesu instalacji.

Uruchomienie

Ekran logowania

Po wpisaniu w przeglądarce nazwy hosta, na którym zainstalowany został Comarch ERP XL oraz portu wskazanego podczas instalacji, np. https://localhost:8000, zostanie wyświetlony ekran logowania się do programu.

Po wpisaniu identyfikatora operatora oraz hasła program Comarch ERP XL zostanie uruchomiony w przeglądarce.

Comarch ERP XL Web Podręcznik Użytkownika

Uwaga

W wersji 2025.0 nie ma możliwości konfigurowania systemu z poziomu interfejsu webowego.

Wszystkie ustawienia konfiguracyjne, o których jest mowa w niniejszym dokumencie, mogą być weryfikowane i modyfikowane z poziomu standardowej wersji systemu Comarch ERP XL.

Opis konfiguracji systemu Comarch ERP XL dostępny jest pod adresem: https://pomoc.comarch.pl/xl/index.php/kategorie/konfiguracja-systemu/

Logowanie

Ekran logowania

Po uruchomieniu w przeglądarce programu Comarch ERP XL wyświetlony zostaje ekran logowania jak poniżej.

Jeżeli podczas logowania do systemu wystąpi błąd, na ekranie logowania pojawia się stosowny komunikat ze wskazaniem możliwej przyczyny problemu.

Dane Użytkownika

W polu Użytkownik należy wpisać identyfikator operatora zdefiniowanego w programie Comarch ERP XL, w polu Hasło należy wprowadzić hasło wpisanego operatora.

Uwaga

W celu zabezpieczenia się przed zalogowaniem nieuprawnionego Użytkownika na ekranie logowania nie ma możliwości wyświetlenia listy operatorów. Identyfikator operatora należy każdorazowo wpisać w pole Użytkownik.

Uwaga

Na ekranie logowania wprowadzone jest ok. 5-sekundowe opóźnienie po każdej nieudanej próbie logowania do Systemu, natomiast po pięciu nieudanych próbach i każdej kolejnej opóźnienie wyniesie 60 sekund.

Informacje o bazie danych

U dołu ekranu logowania wyświetlana jest informacja z nazwą bazy danych, do której loguje się Użytkownik.

Uwaga

Podczas logowania nie ma możliwości zmiany bazy – Użytkownik może się zalogować wyłącznie do bazy wskazanej podczas instalacji programu.

Wskazówka

Zmiany parametrów logowania takich jak nazwa serwera SQL oraz nazwa bazy danych można dokonać poprzez edycję stosownych ustawień w plikach appsettings znajdujących się w katalogach podrzędnych katalogu XLRestApi w folderze, w którym zainstalowany jest program Comarch ERP XL Web.

Ekran startowy (dashboard) aplikacji

Od wersji 2024.1 systemu Comarch ERP XL Web dostępny jest ekran startowy, tzw. dashboard aplikacji.

Wyświetlenie dashboardu

Dashboard wyświetlany jest w następujących sytuacjach:

Budowa dashboardu

Ekran startowy podzielony jest na trzy panele: Skróty, Statystyki i Zamówienia sprzedaży.

W wersji 2025.0 systemu Comarch ERP XL Web dane prezentowane na ekranie startowym dotyczą tylko obszaru zamówień sprzedaży.

Wraz z pojawieniem się funkcjonalności z kolejnych obszarów dashboard będzie stosownie rozbudowywany.

Panel Skróty

W panelu Skróty znajdują się przyciski szybkiej obsługi pozwalające wykonać określoną akcję.

W wersji 2025.0 aktywny jest wyłącznie przycisk do dodawania nowego zamówienia sprzedaży. W kolejnych wersjach wraz z rozwojem funkcjonalności aktywowane będą kolejne przyciski.

Panel Statystyki

Panel Statystyki zawiera dwa wykresy:

Dla każdego z wykresów można wskazać okres, za jaki mają zostać zaprezentowane dane:

Po najechaniu kursorem na słupek wykresu Wartość zamówień Twojego centrum prezentowana jest szczegółowa informacja dotycząca zamówień w danym okresie.

Najeżdżając kursorem na wybrany fragment wykresu Zamówione towary wg wartości można zobaczyć szczegóły dotyczące danego towaru.

Uwaga

Wartości na wykresach dotyczą zamówień, których właścicielem jest centrum, w którym zalogowany jest Użytkownik.

Uwaga

Zarówno na wykresie słupkowym, jak i na wykresie kołowym wartości prezentowane są w przeliczeniu na walutę systemową.

Panel Zamówienia sprzedaży

W panelu Zamówienia sprzedaży prezentowana jest lista 10 ostatnich zamówień sprzedaży wystawionych w centrum, w którym zalogowany jest Użytkownik.

Po naciśnięciu przycisku Pokaż więcej wyświetlona zostaje pełna lista zamówień sprzedaży.

Po prawej stronie listy zamówień znajdują się przyciski prezentujące informacje związane z realizacją zamówień:

Po naciśnięciu któregokolwiek przycisku Użytkownik przenoszony jest na listę zamówień sprzedaży.

Uwaga

Filtry na listach implementowane będą w kolejnych wersjach systemu. Docelowo po naciśnięciu danego przycisku wyświetlona zostanie lista zamówień odfiltrowana do dokumentów w stanie realizacji zgodnym z opisem na przycisku.

Poruszanie się po programie

Po zalogowaniu się Użytkownika aplikacja wyświetlana jest w układzie jak poniżej.

Na ekranie programu można wyróżnić trzy podstawowe elementy:

Panel boczny nawigacji

W panelu bocznym nawigacji wyświetlane są przyciski pozwalające na przejście do wybranego obszaru programu.

W aktualnej wersji dostępne są następujące obszary:

Uwaga

W aktualnej wersji programu po naciśnięciu przycisków Kontrahenci, Gniazda robocze oraz Technologie wyświetlany jest jedynie ekran informacyjny.

Za pomocą przycisku można zwijać/rozwijać panel boczny.

Panel górny nawigacji

W panelu górnym nawigacji dostępne są następujące przyciski:

Pomoc

Naciśnięcie przycisku Pomoc powoduje otwarcie okna, w którym wyświetlana jest informacja o programie oraz dostępne są przekierowania do stron pomocy dla programu Comarch ERP XL oraz stron społeczności Comarch ERP.

Informacje o operatorze

Na przycisku z informacją o operatorze wyświetlana jest nazwa centrum, do którego zalogowany jest operator oraz identyfikator i nazwisko operatora.

Po rozwinięciu przycisku Operator ma dostępną opcję wylogowania się z programu.

Uwaga

Po rozwinięciu przycisku wyświetlana jest lista centrów, do których dołączony jest zalogowany operator, w wersji 2025.0 nie ma natomiast możliwości zmiany centrum (zmiany kontekstu operatora).

Lista zamówień sprzedaży

Układ listy zamówień

Po naciśnięciu w panelu bocznym przycisku Zamówienia sprzedaży na ekranie głównym aplikacji wyświetlana jest lista zamówień sprzedaży.

Na liście wyświetlane są wszystkie dokumenty widoczne w centrum, w którym zalogowany jest Użytkownik.

Lista zawiera następujące kolumny:

 

Uwaga

W aplikacji webowej znany z wersji standardowej Stan dokumentu wyświetlany jest w rozbiciu na Status i Stan realizacji.

Powiązania pomiędzy Stanem dokumentu a Statusem i Stanem realizacji prezentuje poniższa tabela:

Stan w standardowym interfejsie	Status w interfejsie webowym	Stan realizacji w interfejsie webowym
Niepotwierdzone	Niezatwierdzony	-
Potwierdzone	Zatwierdzony	Do realizacji
W realizacji	Zatwierdzony	W realizacji
Zrealizowane	Zamknięty	Zrealizowany
Odrzucone	Anulowany	Niezrealizowany
Anulowane potwierdzone	Anulowany	Niezrealizowany
Zamknięte potwierdzone	Zamknięty	Niezrealizowany
Zamknięte w realizacji	Zamknięty	Częściowo zrealizowany
Korygowane potwierdzone	Korygowany	Do realizacji
Korygowane w realizacji	Korygowany	W realizacji

Uwaga

W aplikacji webowej kontrahent główny wyświetlany jest jako Nabywca, a kontrahent docelowy jako Odbiorca.

Obsługa listy zamówień

Na liście Użytkownik może wykonywać następujące operacje:

Wyszukiwanie zamówień

Na liście zamówień znajduje się wyszukiwarka dokumentów.

Lista dokumentów może zostać zawężona do pozycji, które w numerze dokumentu lub w danych znajdujących się w kolumnie Nabywca zawierają wpisaną w wyszukiwarce frazę.

Wskazówka

Wyszukiwanie pozycji rozpoczyna się po naciśnięciu przycisku lupki w wyszukiwarce lub po naciśnięciu przycisku <ENTER>.

Uwaga

Przycisk x służy do usuwania treści wpisanej w polu wyszukiwarki.

W celu usunięcia filtrowania należy użyć przycisku Wyczyść filtry lub usunąć frazę filtrowania przyciskiem x i następnie nacisnąć lupkę lub <ENTER>.

Filtrowanie po statusie dokumentu

Nad listą zamówień znajduje się filtr Status.

Filtrowanie uruchamiane jest po zaznaczeniu wybranych w kontrolce statusów i naciśnięciu przycisku Potwierdź.

Filtrowanie po stanie realizacji zamówienia

Filtrowanie uruchamiane jest po zaznaczeniu wybranych w filtrze stan realizacji wartości i naciśnięciu przycisku Potwierdź.

Usuwanie zamówień

Usuwanie pojedynczego dokumentu

W celu usunięcia pojedynczego dokumentu należy w menu dostępnym pod przyciskiem wybrać opcję Usuń.

Przycisk Usuń jest aktywny wyłącznie na zamówieniu o statusie Niezatwierdzony.

Po naciśnięciu przycisku Usuń wyświetlone zostanie okno, w którym użytkownik może potwierdzić chęć usunięcia zamówienia.

Usuwanie wielu dokumentów

W celu usunięcia wielu zamówień należy zaznaczyć na liście pozycje do usunięcia.

Jeżeli wśród zaznaczonych dokumentów jest chociaż jedno zamówienie o stanie Niezatwierdzony, to w belce pod listą pojawia się przycisk Usuń.

Po naciśnięciu przycisku Usuń i potwierdzeniu chęci usunięcia wybranych pozycji zaznaczone zamówienia w stanie niezatwierdzonym zostaną usunięte.

Dodawanie zamówienia sprzedaży

Układ formularza zamówienia

Po naciśnięciu na liście zamówień przycisku Dodaj wyświetlony zostaje formularz nowego zamówienia sprzedaży.

Na formularzu aktywne jest wyłącznie pole do wyboru kontrahenta, sekcje Pozycje zamówienia oraz Pozostałe dane są w trybie tylko do odczytu.

Po dodaniu kontrahenta wyświetlone zostaję wszystkie sekcje formularza w trybie do edycji.

Formularz składa się z następujących elementów:

Pola obowiązkowe do wypełnienia oznaczone są gwiazdką.

Uwaga

Sekcja Dane transakcji jest ukrywana, jeśli w polu Rodzaj transakcji wybrana jest wartość Krajowa.

Nagłówek oraz stopka formularza są dokowane.

Dzięki temu użytkownik przez cały czas pracy z dokumentem ma dostęp do najistotniejszych informacji.

Nagłówek zamówienia

W nagłówku zamówienia wyświetlane są następujące elementy:

Uwaga

Numer zamówienia generowany jest po dodaniu kontrahenta na dokument.

Przed dodaniem kontrahenta w miejscu numeru wyświetlany jest opis Numer zamówienia.

Wychodzenie z formularza zamówienia

Jeżeli na nowo dodawanym zamówieniu nie został jeszcze wybrany kontrahent to naciśnięcie przycisku powoduje wyjście z formularza bez zapisywania zmian i bez żadnego komunikatu ze strony systemu.

Uwaga

W bazie danych zamówienie tworzone jest dopiero po dodaniu kontrahenta na dokument, dlatego wyjście z formularza przed dodaniem kontrahenta nie wymaga dodatkowego potwierdzenia ze strony Użytkownika.

Jeśli na dokumencie wybrany został kontrahent to naciśnięcie przycisku powoduje wyświetlenie okna, w którym Użytkownik może zdecydować, jaką akcje chce wykonać:

Dodawanie kontrahenta na zamówienie

Po ustawieniu kursora w polu Wybierz kontrahenta Użytkownik ma możliwość dodania kontrahenta na zamówienie.

Istnieją dwa sposoby na dodanie kontrahenta:

Na liście wartości w polu z wyborem kontrahenta wyświetlana jest pełna nazwa kontrahenta. Jeżeli nazwa nie mieści się w polu, to po najechaniu na nią wskaźnikiem w tooltipie wyświetlona zostanie pełna wartość.

Nabywca, odbiorca oraz płatnik na zamówieniu

Po wybraniu kontrahenta w zależności od ustawień na kartotece kontrahenta na dokument pobierane są dane nabywcy, odbiorcy oraz płatnika.

To:

• Kontrahent jest ustawiany jako Nabywca, Odbiorca oraz Płatnik
• Aktualny adres kontrahenta ustawiony jest jako Adres Nabywcy, Adres odbiorcy oraz Adres płatnika [/su_list]

To: To: To:

Uwaga

W wersji 2025.0 zablokowane jest dodawanie kontrahenta, dla którego jako płatnik ustawiony jest bank, urząd lub pracownik.

Przy próbie dodania takiego kontrahenta lub podczas próby zmiany nabywcy na takiego kontrahenta wyświetlany jest błąd:

Uwaga

W wersji 2025.0 na dodawanym zamówieniu można zmienić Nabywcę oraz Odbiorcę. Zmiana Płatnika dostępna będzie w jednej z kolejnych wersji systemu

.

Zmiana nabywcy na zamówieniu

W celu zmiany nabywcy należy ustawić się w polu Nabywca i postępować analogicznie, jak podczas wyboru kontrahenta na zamówienie:

Wskazówka

W następnych wersjach systemu implementowana będzie aktualizacja kolejnych parametrów związanych ze zmianą kontrahenta na dokumencie.

Uwaga

Aktualnie podczas zmiany nabywcy operator nie ma możliwości decydowania, czy dane parametry mają być aktualizowane. Taka opcja pojawi się w jednej z kolejnych wersji systemu.

Zmiana odbiorcy na dokumencie

W celu zmiany odbiorcy należy ustawić się w polu Odbiorca i postępować analogicznie, jak podczas wyboru kontrahenta lub zmiany nabywcy:

Jeśli w definicji dokumentu ZS ustawiona jest aktualizacja danych po zmianie kontrahenta oraz w konfiguracji systemu ustawione jest naliczanie rabatów dla kontrahenta docelowego, to po zmianie odbiorcy na dokumencie aktualizowane są również rabaty na zamówieniu.

Uwaga

Aktualnie podczas zmiany odbiorcy operator nie ma możliwości decydowania, czy dane parametry mają być aktualizowane. Taka opcja pojawi się w jednej z kolejnych wersji systemu.

Dane nagłówkowe

Po dodaniu kontrahenta na zamówienie wyświetlona zostaje sekcja Dane nagłówkowe składająca się z następujących pól:

Uwaga

W wersji 2025.0 w sekcji Dane nagłówkowe dostępne do edycji są pola Data aktywacji rezerwacji oraz Numer obcy.

Możliwość edycji pozostałych pól pojawi się w kolejnych wersjach systemu.

Edycja pola Data aktywacji rezerwacji

Zmiana daty może być wykonana poprzez:

Edycja pola Numer obcy

Edycja numeru obcego możliwa jest przez wpisanie wartości bezpośrednio w kontrolce.

Pozycje zamówienia

Pozycje zamówienia przed dodaniem kontrahenta

Na formularzu nowo dodawanego zamówienia sprzedaży przed dodaniem kontrahenta na dokument w sekcji Pozycje wyświetlane są wyłącznie nagłówki kolumn i nie ma możliwości dodania pozycji.

Wyświetlany jest także stosowny komunikat informujący, że dodanie pozycji będzie możliwe po wybraniu kontrahenta.

Pozycje zamówienia po dodaniu kontrahenta

Po wybraniu kontrahenta w sekcji wyświetlone zostają:

Pola związane z pozycjami zamówienia

Nad listą pozycji wyświetlane są pola związane z pozycjami zamówienia.

Uwaga

W wersji 2025.0 w pola związane z pozycjami zamówienia wyświetlane są w trybie tylko do odczytu. Możliwość edycji pojawi się w kolejnych wersjach systemu.

Magazyn źródłowy

W polu wyświetlany jest kod magazynu, który na definicji dokumentu ZS w centrum, w którym zalogowany jest Użytkownik, ustawiony jest jako magazyn domyślny.

Jeśli do zamówienia tworzone są rezerwacje, to są one rejestrowane na magazynie wskazanym w polu Magazyn źródłowy.

Cena

W polu prezentowana jest nazwa typu ceny, która jest stosowana jako cena początkowa dla pozycji dodawanych na zamówienie.

Cena ta pobierana jest z kartoteki kontrahenta wskazanego na dokumencie jako Nabywca.

Uwaga

Jeżeli na kartotece towaru dodawanego jako pozycja zamówienia nie ma zdefiniowanej ceny o typie wskazanym na dokumencie, to towar dodany zostanie z ceną 0,00.

Rabat płatności

W polu prezentowana jest wartość procentowa rabatu ustalonego dla formy płatności wybranej na zamówieniu.

Wartość rabatu pobierana jest na podstawie ustawień na definicji formy płatności w konfiguracji systemu.

Rabat ogólny

W polu prezentowana jest suma wartości procentowej rabatów zastosowanych na dokumencie.

Przykładowo jeżeli na zmówieniu wybrana została forma płatności, dla której ustalony jest rabat, a nabywca ustalony na dokumencie ma na kartotece kontrahenta ustalony rabat kontrahenta, to w polu Rabat ogólny wyświetlona będzie zsumowana wartość rabatu płatności i rabatu kontrahenta.

Cena początkowa i promocje wg daty

W polu wyświetlana jest informacja, która data jest podstawą dla ceny początkowej i promocji: data wystawienia czy data realizacji.

Jeżeli w systemie zdefiniowane są promocje, to o zastosowaniu promocji będzie decydowało to, czy wskazana w parametrze data zawiera się w okresie obowiązywania promocji.

Wartość parametru pobierana jest z definicji dokumentu ZS dla centrum, w którym zalogowany jest Użytkownik.

Realizuj zamówienie w całości

Parametr decydujący o tym, czy zamówienie będzie mogło być realizowane częściowo. Jeżeli parametr jest zaznaczony, to system nie pozwoli na realizację zamówienia, gdy brakuje pełnej ilości dla wszystkich zamówionych towarów.

Wartość parametru pobierana jest z definicji dokumentu ZS dla centrum, w którym zalogowany jest Użytkownik.

Układ listy pozycji zamówienia

Lista pozycji zamówienia sprzedaży zawiera następujące kolumny:

Użytkownik ma możliwość określenia, jaka ilość elementów ma być wyświetlana na stronie: 10, 15 czy 20.

Przy ustawieniu 10 lub 15 elementów na stronie cała strona jest wyświetlana bez konieczności skrolowania formularza.

Przy ustawieniu 20 elementów na stronie przejście do pozycji od 16 do 20 wymaga przeskrolowania formularza.

Dodawanie pozycji na zamówienie

Dodawanie pozycji przez edycję pola Towar

Po ustawieniu kursora w polu Towar Użytkownik ma możliwość dodania pozycji na zamówienie.

Istnieją dwa sposoby na dodanie pozycji:

Wiersz do dodawania nowej pozycji wyświetlany jest zawsze jako pierwszy.

Pobieranie danych o towarze na pozycje zamówienia

Po wybraniu towaru na pozycję zamówienia pobierane są następujące dane z kartoteki towaru:

[alertJjeżeli na kartotece towaru dodawanego jako pozycja zamówienia nie ma zdefiniowanej ceny o typie wskazanym na dokumencie, to towar dodany zostanie z ceną 0,00.[/alert]

Dodawanie pozycji z uproszczonej listy towarów

Od wersji 2024.0 systemu Comarch ERP XL Web na formularzu zamówienia sprzedaży udostępniona została możliwość dodawania pozycji zamówienia z uproszczonej listy towarów.

Wywołanie uproszczonej listy towarów

Na zamówieniu sprzedaży Użytkownik może wywołać uproszczoną listę towarów na dwa sposoby:

Obsługa uproszczonej listy towarów

Po wyborze opcji do dodawania towarów z listy wyświetlona zostaje uproszczona lista towarów w następującym układzie.

W celu wyboru towaru, który ma zostać dodany na zamówienie, Użytkownik może:

Jeżeli na karcie towaru zdefiniowane są jednostki pomocnicze, to na uproszczonej liście na tym towarze Użytkownik może wskazać, w jakiej jednostce towar ma zostać dodany do zamówienia.

Po naciśnięciu przycisku Dodaj zaznaczone towary zostaną dodane na zamówienie w ilościach i jednostkach ustalonych na uproszczonej liście towarów.

Uwaga

Jeżeli na kartotece towaru jednostka pomocnicza oznaczona została, jako proponowana przy sprzedaży, to na uproszczonej liście towarów jednostka ta będzie się domyślnie proponować dla danego towaru.

Wyszukiwarka na uproszczonej liście towarów

Nad listą dostępna jest wyszukiwarka ułatwiająca odnalezienie pożądanych towarów.

Wyszukiwanie odbywa się po wartości w polach Towar, EAN oraz Symbol.

Wskazówka

Wyszukiwanie pozycji rozpoczyna się po naciśnięciu przycisku lupki w wyszukiwarce lub po naciśnięciu przycisku <ENTER>.

Uwaga

Przycisk x służy do usuwania treści wpisanej w polu wyszukiwarki.

W celu usunięcia filtrowania należy użyć przycisku Wyczyść filtry lub usunąć frazę filtrowania przyciskiem x i następnie nacisnąć lupkę lub <ENTER>.

Usuwanie pozycji zamówienia

W wersji 2025.0 na liście pozycji zamówienia możliwe jest usuwanie pozycji. W celu usunięcia pozycji należy w menu dostępnym pod przyciskiem wybrać opcję Usuń.

Edycja ilości na pozycji zamówienia

W wersji 2025.0 udostępniona została edycja ilości na pozycjach zamówienia.

Dane handlowe

W wersji 2025.0 pod listą pozycji zamówienia dodana została sekcja Dane handlowe.

Rodzaj transakcji

W polu Rodzaj transakcji prezentowana jest informacja czy zamówienie jest dokumentem krajowym, wewnątrzwspólnotowym czy innym zagranicznym (poza unijnym).

Wartość w polu pobierana jest z ustawień na kartotece kontrahenta wybranego na zamówieniu jako nabywca.

W wersji 2025.0 możliwa jest edycja wartości w polu Rodzaj transakcji.

Użytkownik ma możliwość wyboru wartości z listy rozwijanej w kontrolce:

Cecha transakcji

W sekcji Dane handlowe wyświetlane jest pole Cecha transakcji prezentujące wartość cechy dokumentu.

Edycja wartości w polu Cecha transakcji

W wersji 2025.0 umożliwiono:

Uwaga

Jeśli na liście wartości znajduje się więcej niż 10 pozycji, to w kontrolce wyświetlona zostanie wyszukiwarka umożliwiająca szybkie znalezienie pożądanej cechy.

Pole Cecha transakcji nie jest obowiązkowe i może być puste, dlatego użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Jeżeli na liście wartości nie ma pożądanej cechy użytkownik może dodać nową wartość za pomocą przycisku Dodaj spoza listy.

Po naciśnięciu przycisku wyświetlone zostaje okno, w którym użytkownik może dodać nową cechę.

W oknie kontrolowana jest unikalność wartości – system nie pozwoli na dodanie już istniejącej cechy.

Uwaga

Po zapisaniu nowo dodana wartość jest automatycznie dopisywana do listy wartości dla słownika cech.

Wskazówka

Nowo dodana cecha jest automatycznie wstawiana w pole Cecha transakcji na dokumencie, jest również od razu dostępna na liście wartości w kontrolce.

Forma i termin płatności

W sekcji Dane handlowe dodane zostały pola związane z formą i terminem płatności.

Edycja formy i terminu płatności

W wersji 2025.0 umożliwiono edycję formy i terminu płatności.

Zmiana formy płatności możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Jeżeli na liście dostępnych form płatności znajduje się więcej niż 10 pozycji, to wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie pożądanej formy.

Uwaga

Jeżeli dla formy płatności zdefiniowany jest termin > 0 dni, to jest on wyświetlany w nawiasie obok formy płatności.

Termin dla wybranej formy płatności jest automatycznie wstawiany w pole Dni do zapłaty.

Zmiana terminu płatności możliwa jest przez edycję wartości w polu Dni do zapłaty.

Sposób dostawy

W sekcji Dane handlowe dodane zostało pole Sposób dostawy prezentujące metodę dostawy wybraną na dokumencie.

Edycja sposobu dostawy

W wersji 2025.0 umożliwiono edycję sposobu dostawy na zamówieniu przez:

Uwaga

Jeśli na liście wartości znajduje się więcej niż 10 pozycji, to w kontrolce wyświetlona zostanie wyszukiwarka umożliwiająca szybkie znalezienie pożądanego sposobu dostawy.

Pole Sposób dostawy nie jest obowiązkowe i może być puste, dlatego Użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Jeżeli na liście wartości nie ma pożądanego sposobu dostawy użytkownik może dodać nową wartość za pomocą przycisku Dodaj spoza listy.

Po naciśnięciu przycisku wyświetlone zostaje okno, w którym użytkownik może dodać nowy sposób dostawy.

W oknie kontrolowana jest unikalność wartości – system nie pozwoli na dodanie już istniejącego sposobu dostawy.

Uwaga

Po zapisaniu nowo dodana wartość jest automatycznie dopisywana do listy wartości dla słownika sposobów dostawy.

Wskazówka

Nowo dodany sposób dostawy jest automatycznie wstawiany w pole Sposób dostawy na dokumencie, jest również od razu dostępny na liście wartości w kontrolce.

Pola związane z walutą transakcji

W sekcji Dane handlowe wyświetlane są następujące pola związane z walutą:

Uwaga

W wersji 2025.0 pola związane z walutą wyświetlane są w trybie tylko do odczytu. Edycja wartości w tych polach udostępniona zostanie w kolejnych wersjach systemu.

Uwaga

Pola Kurs oraz Jednostka kursu są ukrywane, jeśli na dokumencie wybrana jest waluta systemowa.

Sekcja Dane transakcji

W wersji 2025.0 na formularzu zamówienia dodana została sekcja Dane transakcji.

Uwaga

Sekcja Dane transakcji jest ukrywana, jeśli w polu Rodzaj transakcji wybrana jest wartość Krajowa

Kraj przeznaczenia

W sekcji Dane transakcji dodane zostało pole Kraj przeznaczenia.

Zmiana kraju przeznaczenia

W wersji 2025.0 umożliwiona została także zmiana wartości w polu Kraj przeznaczenia.

Zmiana kraju przeznaczenia możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Na liście wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie danego kraju.

Uwaga

Jeśli transakcja jest wewnątrzwspólnotowa, to lista wartości w kontrolce jest zawężona do krajów należących do grupy UE.

Rodzaj transportu

W sekcji Dane transakcji dodane zostało pole Rodzaj transportu.

Zmiana rodzaju transportu

W wersji 2025.0 umożliwiona została zmiana rodzaju transportu na dokumencie.

Zmiana rodzaju transportu możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Pole Rodzaj transportu nie jest obowiązkowe i może być puste, dlatego użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Rodzaj transakcji celnej

W sekcji Dane transakcji dodane zostało pole prezentujące rodzaj transakcji celnej.

Zmiana rodzaju transakcji celnej

W wersji 2025.0 umożliwiono edycję rodzaju transakcji celnej. Zmiana możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Na liście wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie pożądanego rodzaju transakcji celnej.

Pole Rodzaj transakcji celnej nie jest obowiązkowe i może być puste, dlatego użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Symbol incoterms

W sekcji Dane transakcji dodane zostało pole Symbol Incoterms.

Zmiana symbolu Incoterms

W wersji 2025.0 umożliwiona została zmiana symbolu Incoterms na dokumencie.

Zmiana możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Na liście wyświetlana jest wyszukiwarka ułatwiająca szybkie znalezienie pożądanego symbolu Incoterms.

Pole Symbol Incoterms nie jest obowiązkowe i może być puste, dlatego użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Miejsce incoterms

W sekcji Dane transakcji dodane zostało pole Miejsce Incoterms.

Edycja miejsca Incoterms

W wersji 2025.0 umożliwiono edycję miejsca Incoterms na zamówieniu przez:

Uwaga

Jeśli na liście wartości znajduje się więcej niż 10 pozycji, to w kontrolce wyświetlona zostanie wyszukiwarka umożliwiająca szybkie znalezienie pożądanego miejsca Incoterms.

Pole Miejsce Incoterms nie jest obowiązkowe i może być puste, dlatego użytkownik ma możliwość usunięcia wartości z kontrolki za pomocą przycisku Wyczyść znajdującego się pod listą wartości.

Jeżeli na liście wartości nie ma pożądanego sposobu dostawy użytkownik może dodać nową wartość za pomocą przycisku Dodaj spoza listy.

Po naciśnięciu przycisku wyświetlone zostaje okno, w którym użytkownik może dodać nowe miejsce Incoterms.

W oknie kontrolowana jest unikalność wartości – system nie pozwoli na dodanie już istniejącego miejsca Incoterms.

Uwaga

po zapisaniu nowo dodana wartość jest automatycznie dopisywana do listy wartości dla słownika miejsc Incoterms.

Wskazówka

Nowo dodane miejsce Incoterms jest automatycznie wstawiane w pole Miejsce Incoterms na dokumencie, jest również od razu dostępne na liście wartości w kontrolce.

Pozostałe dane

W sekcji Pozostałe dane wyświetlane są następujące pola:

Uwaga

W standardowej wersji systemu odpowiednikiem pola Centrum jest pole Właściciel.

Uwaga

Pole Opis jest wyświetlane po dodaniu kontrahenta na zamówienie.

Edycja pola Opis

W wersji 2025.0 umożliwiona została edycja pola Opis.

Zmiana operatora odpowiedzialnego

W wersji 2025.0 umożliwiona została edycja pola Odpowiedzialny. Zmiana możliwa jest poprzez wybór z listy wartości rozwijanej w kontrolce.

Uwaga

Zmiany operatora odpowiedzialnego można dokonać po dodaniu kontrahenta na zamówienie. Przed dodaniem kontrahenta pole jest w trybie tylko do odczytu.

Tworzenie rezerwacji zasobowych

W wersji 2025.0 podczas dodawania pozycji na zamówienie tworzone są rezerwacje zasobowe, jeżeli spełnione są poniższe warunki:

Zapisywanie zamówienia

W stopce zamówienia znajduje się przycisk pozwalający na zapisanie dokumentu.

Po naciśnięciu przycisku weryfikowane jest, czy obowiązkowe pola zostały uzupełnione oraz czy dane na dokumencie są poprawne – jeżeli na zamówieniu występuje błąd, wyświetlany jest stosowny komunikat, a pole, w którym występuje błąd jest odpowiednio podświetlane.

Jeżeli próba zapisu zakończy się sukcesem, system wraca do listy zamówień sprzedaży.

Architektura rozwiązania

Opis

Architektura Comarch ERP XL wydziela część dostępu do danych (backend) od części prezentacyjnej (frontend). W ramach części prezentacyjnej dostarczany jest interfejs WWW, który jest serwowany przy wykorzystaniu serwera nginx. Dodatkowo nginx służy jako API gateway i load balancer, rozdzielając zapytania do warstwy danych, do odpowiednich mikroserwisów. Sama warstwa danych składa się z wielu mikroserwisów odpowiadających za wybrane funkcjonalności systemu. Dzięki takiej architekturze możliwe jest skalowanie horyzontalne aplikacji oraz łatwe aktualizowanie pojedynczych serwisów przy zachowaniu ciągłości pracy. Aby mikroserwisy były osiągalne z poziomu frontendu, aby mogły się ze sobą komunikować oraz aby można było rozdzielać do nich ruch - konieczny jest mechanizm rejestracji serwisów, czyli Service Discovery. Służy do tego Consul - czyli repozytorium serwisów.

W konsekwencji do działania XL'a w wersji Web konieczne są aktywne procesy: nginx, consul, consul-template oraz procesy samych mikroserwisów (obecnie XL.Authorization, XL.Customers, XL.Orders, XL.Users oraz XL.Articles).

Proces uruchamiania Comarch ERP XL składa się zatem z uruchomienia usługi Consul, następnie uruchomienia mikroserwisów (które zarejestrują swój adres i port w Consul'u) - na tym etapie mamy już dostępne nowe Rest API dla XL'a. Następnie do uruchomienia frontend potrzebne jest jeszcze uruchomienie serwera nginx oraz usługi consul-template, której zadaniem jest odczytanie adresów i portów mikroserwisów z repozytorium Consul'a, oraz zapisanie ich w konfiguracji nginx. Jeżeli uruchomimy wiele instancji tego samego mikroserwisu, to nginx będzie przekierowywał żądania równomiernie do każdej instancji (tzw. metoda Round-Robin). Również w ramach wewnętrznej komunikacji między mikroserwisami funkcjonuje load balancing oparty o repozytorium Consul.

Przy domyślnej instalacji stan serwisów można monitorować z poziomu strony http://localhost:8500/. Dodatkowo wszystkie błędy i ostrzeżenia samych mikroserwisów są logowane w zdarzeniach systemowych Windows w sekcji "Aplikacja". Natomiast logi z warstwy prezentacji znajdują się w katalogu serwera nginx w podkatalogu logs. Ponieważ cała komunikacja wymaga zabezpieczenia przed nieautoryzowanym dostępem wdrożono wykorzystanie protokołu https. Aby to było możliwe konieczne jest posiadanie certyfikatu ssl - podczas instalacji jest kreowany certyfikat podpisany samodzielnie o nazwie localhost_xlweb. W przypadku potrzeby udostępnienia programu w sieci publicznej zalecane jest zakupienie certyfikatu w jednym z zaufanych centrów certyfikacji.

Modyfikacja interfejsu

Comarch ERP XL Web umożliwia modyfikację interfejsu. Mechanizm pozwalający modyfikować wygląd i funkcje interfejsu przez Klientów opiera się o kod pisany w języku JavaScript. Każdy komponent interfejsu wywołuje 2 metody podczas tworzenia i niszczenia komponentu. Wpinając swoje metody do tych funkcji można dowolnie modyfikować dokument korzystając z elementów modelu DOM. Można tworzyć własne kontrolki, modyfikować istniejące, wykonywać swoje akcje na zdarzeniach przeglądarki itd. Jest również dostęp do globalnego obiektu store, zawierającego dane takie jak zalogowany operator czy aktualne centrum.

Do interakcji z bazą zalecane jest używanie istniejącego API Rest lub tworzenie własnych serwisów z własnym połączeniem do bazy danych.

Miejscem wpięcia dodatków hydry jest skrypt Hydra.js w katalogu z dystrybucją XL Web.

Przykłady

Przeciążenie metody CallbackOnInit oraz przykładowe operacje na kontrolkach komponentu logowania oraz stronie startowej.

Hydra.js

Przyklad

import { LoginAddOns } from "./AddOns/Login.js"; import { DashboardAddOns } from "./AddOns/Dashboard.js"; window.CallbackOnInit=CallbackOnInit; window.CallbackOnDestroy=CallbackOnDestroy; function CallbackOnInit(componentName){ switch(componentName){ case "LoginComponent": LoginAddOns(); break; case "DashboardComponent": DashboardAddOns(); break; }; } function CallbackOnDestroy(n){}

W podkatalogu AddOns umieszczone są skrypty podzielone na poszczególne komponenty. Przykładowy skrypt dla okna logowania.

Login.js

Przyklad

export function LoginAddOns() { //modyfikacja istniejących kontrolek var loginBtn = window.document.getElementById("login-login-btn"); loginBtn.style.background = "green"; //Dodawanie kontrolki var newButton = document.createElement("button"); newButton.appendChild(document.createTextNode("Hydra")); loginBtn.parentElement.appendChild(newButton); newButton.classList.add("cds-button-primary"); newButton.setAttribute("cdsbutton", ""); //Dodawanie kontrolki var newHideButton = document.createElement("button"); newHideButton.appendChild(document.createTextNode("Ukryj")); loginBtn.parentElement.appendChild(newHideButton); newHideButton.classList.add("cds-button-primary"); newHideButton.setAttribute("cdsbutton", ""); //Zdarzenia newButton.addEventListener("click", (event) => { window.location.href = "AddOns/HydraPage.html"; }); newHideButton.addEventListener("click", (event) => { if (loginBtn.style.display == "none") { loginBtn.style.display = "inline-flex"; } else { loginBtn.style.display = "none"; } }); //Zablokuj logowanie po cancel na oknie z pytaniem document.addEventListener("click", (ev) => { if (ev.target.id == loginBtn.id) { if (window.confirm("Czy napewno chcesz się zalogować ?") != true) { ev.preventDefault(); ev.stopPropagation(); } } }, true); }