Wprowadzenie możliwości dodania jednego punktu ACD połączonego z wieloma obiegami
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 umożliwiono dodanie jednego punktu ACD dla wielu różnych obiegów dla punktów konfiguracyjnych ACD typu:
Import dokumentów zakupu z KSeF
Współpraca z dowolnym programem OCR
Współpraca z Comarch OCR
Zmiana ta ma na celu uproszczenie i uelastycznienie konfiguracji punktów ACD w Comarch BPM, a także optymalizację obsługi dokumentów.
W tym celu dla wymienionych powyżej typów punktów ACD wprowadzono następujące zmiany:
Podczas konfiguracji punktu ACD na zakładce „Ogólne” w ramach pola „Typ obiegu” umożliwiono wybór wielu typów obiegów – po kliknięciu w pole rozwijana jest lista wszystkich typów obiegów dostępnych w systemie, a administrator powinien zaznaczyć checkbox obok jednego lub więcej typu obiegu – liczba zaznaczonych typów obiegów może być dowolna. Jeśli lista jest długa, po prawej stronie dostępny jest suwak.
Uwaga
Aby możliwy był zapis punktu konfiguracyjnego ACD, konieczne jest wybranie co najmniej jednego typu obiegu w polu „Typ obiegu”.
Gdy operator zaznaczy typy obiegów i kliknie obok listy, wówczas zostanie ona zamknięta, a w polu „Typ obiegu“ będzie widoczny napis „Wybrano: [liczba wybranych typów obiegów]“.
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF”, gdy w polu „Typ obiegu“ jest wybieranych wiele typów obiegów
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Współpraca z dowolnym programem OCR”, gdy w polu „Typ obiegu“ jest wybieranych wiele typów obiegów
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Współpraca z Comarch OCR”, gdy w polu „Typ obiegu“ jest wybieranych wiele typów obiegów
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” po wyborze w polu „Typ obiegu“ 3 typów obiegów
Zmodyfikowano zakładkę „Kontrolki” dostępną podczas konfiguracji punktu ACD w taki sposób, aby możliwe było odrębne definiowanie mapowania kontrolek dla każdego typu obiegu wybranego na zakładce „Ogólne”.
W tym celu w górnej części zakładki dodano pole, po kliknięciu w które rozwijana jest lista typów obiegów przypisanych do danego punktu ACD na zakładce „Ogólne“. Gdy zostanie wybrany typ obiegu, wówczas poniżej dostępny będzie obszar, w ramach którego można zdefiniować kontrolki dla danego typu obiegu. Pozostałe ustawienia dotyczące zakładki „Kontrolki“ nie ulegają zmianie – aby dodać kontrolkę do mapowania, należy kliknąć w przycisk [Dodaj], a następnie wprowadzić odpowiednie zapytanie SQL w polu znajdującym się po prawej stronie okna. Mapowanie danej kontrolki można usunąć, klikając w ikonę kosza na prawo od nazwy kontrolki
Uwaga
Jeśli dany typ obiegu zostanie odznaczony w polu „Typ obiegu” na zakładce „Ogólne” podczas konfiguracji punktu ACD, wówczas nie będzie również dostępny do wyboru na zakładce „Kontrolki”.
Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” przed wyborem typu obiegu
Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” z listą typów obiegów przypisanych do danego punktu ACD do wyboru
Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” po wyborze typu obiegu wraz ze zdefiniowanym mapowaniem kontrolek
W ramach okna pracującego punktu ACD w ramach podglądu dokumentu umożliwiono wybór typu obiegu, dla którego ma zostać wyświetlony podgląd mapowania kontrolek.
W tym celu pod polem „Punkt konfiguracyjny” dodano pole „Typ obiegu”, w ramach którego z rozwijanej listy można wybrać nazwę typu obiegu przypisanego do danego punktu ACD – musi to być również typ obiegu, do którego operator ma przyznane uprawnienia do inicjowania. Domyślnie wyświetlany jest pierwszy typ obiegu na liście. Po wyborze typu obiegu zostaną dla niego wyświetlone mapowania kontrolek, zgodnie z zakładką „Kontrolki”.
Jeśli dany operator nie ma uprawnień do inicjowania dokumentów w żadnym z typów obiegów przypisanych do danego punktu ACD, wówczas zamiast pola „Typ obiegu” wyświetlany jest napis: „Brak uprawnienia do inicjowania dokumentów dla typu obiegu na wybranym punkcie.”.
W przypadku, jeśli na którymś z typów obiegów wartość/wartości nie zostały zmapowane, wówczas będą widoczne następujące oznaczenia:
Obok danego dokumentu na liście wyświetlona zostanie czerwona ikona wykrzyknika
Obok nazwy danego typu obiegu, w którym brakuje danego mapowania, w polu „Typ obiegu” zostanie wyświetlona czerwona ikona wykrzyknika
Pole, w którym brakuje mapowania, zostanie zaznaczone na czerwono
Gdy wartość/wartości zostaną uzupełnione, wówczas powyższe oznaczenia znikną.
Widok punktu ACD typu „Import dokumentów zakupu z KSeF” podczas dokonywania wyboru typu obiegu w polu „Typ obiegu“
Widok punktu ACD typu „Import dokumentów zakupu z KSeF” po wyborze typu obiegu w polu „Typ obiegu“
Widok punktu ACD typu „Współpraca z Comarch OCR” po wyborze w polu „Typ obiegu“ typu obiegu
Zmodyfikowano proces generowania dokumentu do obiegu – jeśli operator ma uprawnienia co najmniej do jednego z typów obiegów przypisanych do danego punktu ACD, wtedy po wyborze wartości w polu „Dokumenty” i po kliknięciu w przycisk [Generuj] wyświetlone zostanie okno, w ramach którego należy wybrać z listy typ obiegu, do którego ma zostać wygenerowany dany dokument/dokumenty. Lista składa się z typów obiegów, do których dany operator ma uprawnienie do inicjowania dokumentów; jeżeli lista jest długa, obok dostępny jest suwak. W ramach okna dostępne są następujące przyciski:
[OK] – kliknięcie w ten przycisk potwierdza wybór typu obiegu z listy – jeśli przedtem wybrano obieg, wówczas okno zostanie zamknięte, a dokument (dokumenty) zostanie wygenerowany do wybranego typu obiegu; jeśli operator kliknie w przycisk, a nie wybrał przedtem typu obiegu, wówczas ono nie zostanie zamknięte, a dokument(dokumenty) nie jest generowany ;
[Anuluj] – naciśnięcie tego przycisku powoduje zamknięcie okna, anuluje wybór typu obiegu i zatrzymuje generowanie dokumentów
X – kliknięcie w ten przycisk powoduje zamknięcie okna, anuluje wybór typu obiegu oraz zatrzymuje generowanie dokumentów
Okno wyświetlone po kliknięciu w przycisk „Generuj” – w tym oknie należy wybrać typ obiegu, do którego mają zostać wygenerowane dane dokumenty
Okno wyświetlone po kliknięciu w przycisk „Generuj” z przykładową listą typów obiegów
Jeżeli operator nie ma uprawnień do inicjowania w żadnym z typów obiegów przypisanych do danego punktu ACD, wówczas przycisk [Generuj] pozostanie wyszarzony.
Okno punktu ACD, gdy dany operator nie ma uprawnień do inicjowania dokumentów w żadnym typie obiegu spośród przypisanych do danego punktu ACD
W obiekcie Globals w klasie ACD dodano metodę SetDocumentFlow(string) – metoda ustawia jeden wybrany obieg, co umożliwia uruchomienie automatyzacji procesu wskazywania typu obiegu dokumentów, którym ma posługiwać się program procesu.
Metoda Globals.ACD.SetDocumentFlow(string):
Ma parametr wejściowy: nazwę typu obiegu – jest to parametr obowiązkowy
Zwraca wyniki:
0 – operacja wykonała się poprawnie
-1 – wystąpił błąd
-2 – podany obieg dokumentów nie istnieje
Wprowadzanie kodu na zakładce „Edytor skryptów” na zakładce „Konfiguracja automatycznego trybu pracy” – widoczna jest metoda Globals.ACD.SetDocumentFlow(string)
Zgłoszenia zrealizowane w wersji 2026.0.0
Zmiany funkcjonalne w wersji 2026.0.0
Naprawiono błąd inicjowania przewalutowania kursów walut, gdy dla ODUsera ustawiono język niemiecki albo angielski;
Naprawiono błąd braku obserwacji przez kontrolkę typu Lista kontrolek typu: Liczba stałoprzecinkowa, Towar, Kontrahent, Liczba całkowita, Lista, Dane tabelaryczne, Liczba rzeczywista, Tekst;
Rozwiązano problem dotyczący wyświetlania opisu analitycznego na kontrolce typu Dokument ERP XL w aplikacji mobilnej na system Android;
Naprawiono błąd dotyczący braku automatycznego wylogowania operatora w aplikacji web Comarch BPM, gdy ten sam operator zaloguje się do aplikacji desktop;
Naprawiono błąd braku zaokrąglania liczby po przecinku w kontrolce typu Liczba rzeczywista w aplikacji web;
Rozwiązano problem związany z niewyświetlaniem się sekcji i kontrolek w aplikacji web;
Naprawiono błąd dotyczący braku zmiany wartości w kontrolkach typu Liczba rzeczywista, Liczba stałoprzecinkowa i Liczba całkowita po klikaniu strzałki w górę i strzałki w dół na klawiaturze;
Wprowadzono ustawienie „Load User Profile“ na True w ustawieniach puli przy instalacji za pomocą instalatora, aby zapobiec problemom z zapisywaniem logów;
Naprawiono problem dotyczący nieprawidłowych podpowiedzi przy wyszukiwaniu pozycji z listy w kolumnie typu Lista w kontrolce typu Dane tabelaryczne w aplikacji desktop;
Naprawiono błąd polegający na możliwości ustawienia inicjowania kontrolki za pomocą C#Script pomimo braku licencji BPM Premium;
Rozwiązano problem z wyszukiwaniem wartości i wyświetlaniem wyników w kontrolce typu Dokumenty w obiegu w aplikacji desktop, jeśli usunięto dokument z kontrolki, a następnie próbowano ponownie wkleić numer dokumentu;
Naprawiono błąd polegający na znikaniu wartości wybranej wcześniej w kontrolce typu Lista w aplikacji desktop;
Naprawiono błąd polegający na możliwości ustawienia limitu znaków w kontrolce typu Tekst do 0 znaków w aplikacji desktop;
Naprawiono błąd polegający na możliwości zapisania hasła bez znaku specjalnego;
Naprawiono błąd dotyczący przenoszenia użytkownika do następnego dokumentu po przekazaniu dokumentu do następnego etapu, do którego ten użytkownik jest uprawniony, gdy ustawiono opcję „Po przekazaniu dokumentu: Przejdź do następnego dokumentu“;
Rozwiązano problem związany z tym, że aplikacja nie wykrywa dokumentu po automatycznym zapisie i gdy jednocześnie kontrolka typu Tekst jest oznaczona jako wymagana i jest na niej zaznaczony parametr „Rejestruj kody kreskowe“;
Dodano mechanizm blokujący jednoczesną zmianę uprawnień przez kilku użytkowników w Comarch BPM Repozytorium;
Naprawiono błąd w aplikacji web dotyczący braku możliwości wyboru elementu w kontrolce typu Lista w trybie wyszukiwania po dowolnym ciągu znaków w przypadku, gdy obserwuje inną kontrolkę typu Lista;
Naprawiono błąd w aplikacji web dotyczący braku zawężania wartości w kontrolce typu Lista, która obserwuje inną kontrolkę typu Lista;
Naprawiono błąd polegający na braku mapowania wartości dla kontrolki typu Lista podczas procesowania przez OCR dokumentu z załącznika w aplikacji web;
Naprawiono błąd dotyczący braku pola „Adres e-mail administratora“ w oknie „Klucz licencji“ podczas aktualizacji za pomocą instalatora;
Rozwiązano problem z zapisywaniem do Comarch BPM Repozytorium plików PDF z punktu ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium“ w aplikacji Comarch BPM w przypadku, gdy w zawartości tekstowej PDF znajduje się znak „<“ ;
Naprawiono błąd w aplikacji desktop dotyczący niepoprawnego działania widoczności dokumentu przy zawężeniu uprawnień;
Rozwiązano problem dotyczący braku zmiany danych lub usunięcia pracownika w czasie rzeczywistym na zakładce „Struktura organizacyjna“ w aplikacji desktop;
Naprawiono błąd dotyczący nieprzenoszenia się kwoty do opisu analitycznego w kontrolce typu Dokument ERP XL w aplikacji desktop;
Rozwiązano problem dotyczący znikania mapowania typu dokumentu na kontrolce typu Dokument elektroniczny, po tym, jak operator przeszedł na inną zakładkę na definicji typu obiegu;
Naprawiono błąd braku odświeżenia nazwy etapu w kolumnie „Nazwa etapu“ na liście dokumentów po przekazaniu dokumentu z listy do kolejnego etapu;
Naprawiono błąd polegający na tym, że gdy w kontrolce typu Liczba rzeczywista wprowadzono wartość z jednym lub dwoma zerami po przecinku, wówczas zera były ucinane;
Rozwiązano problem dotyczący otwierania dokumentu w Comarch BPM w przypadku dużej ilości danych w kontrolce typu Dane tabelaryczne;
Rozwiązano problem dotyczący wyświetlania komunikatu „Upłynął limit czasu wykonywania. Limit upłynął przed ukończeniem operacji lub serwer nie odpowiada” podczas inicjalizacji dokumentu albo przy przechodzeniu na dokument z listy dokumentów;
Naprawiono błąd dotyczący ograniczania wyświetlania listy w kolumnie typu Lista w kontrolce typu Dane tabelaryczne do danych wprowadzonych za pierwszym razem do kolumny;
Rozwiązano problem dotyczący występowania timeoutu przy uruchomieniu sPrinta;
Rozwiązano problem dotyczący rozbieżności przy wyborze lokalizacji zapisu załącznika do Comarch BPM Repozytorium z poziomu aplikacji desktop i aplikacji web Comarch BPM;
Rozwiązano problem dotyczący zapisywania do Comarch BPM Repozytorium z poziomu punktu ACD Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium) plików PDF, które mają w treści znak „<”;
Naprawiono błąd dotyczący braku pola „Adres e-mail administratora” w oknie „Klucze licencji” podczas aktualizacji aplikacji Comarch BPM;
Naprawiono błąd polegający na tym, że instalator nie nawiązywał połączenia z serwerem, jeśli w haśle użytkownika SQL znajdował się średnik;
Usunięto predefiniowanego zapytania SQL z okna importu struktury organizacyjnej z Comarch ERP Optima;
Rozwiązano problem dotyczący wyszukiwania więcej niż 50 wartości w kolumnie typu Lista w kontrolce typu Dane tabelaryczne w aplikacji desktop.
Umożliwienie generowania dokumentów typu (S)FZ (spinacz nagłówkowy faktury zakupu) do Comarch ERP XL
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 wprowadzono możliwość generowania dokumentów typu (S)FZ (spinacz nagłówkowy zakupu) z poziomu Comarch BPM do Comarch ERP XL Operator może utworzyć dokument spinacza nagłówkowego, do którego można dodać jako pozycje dokumentu dokumenty PZ z Comarch ERP XL. Na formatce Dokument ERP XL widoczne są numery dokumentów oraz pozycje dokumentów, które dodano do spinacza.
Spinacz nagłówkowy faktury zakupu w aplikacji desktop Comarch BPM
Formatka spinacza nagłówkowego faktury zakupu w aplikacji desktop
Od wersji 2026.0.0 formatka spinacza nagłówkowego faktury zakupu składa się z następujących 3 zakładek:
Spinacz faktury
Spięte dokumenty
Opis analityczny
Widok formatki spinacza nagłówkowego faktury zakupu
Zakładka „Spinacz faktury”
Zakładka, na której znajdują się:
Dane nagłówkowe dokumentu – pola, których obsługa odbywa się tak samo, jak w przypadku innych typów dokumentów:
Kontrahent
Seria dokumentu
Rodzaj zakupu
Płatnik
Rejestr VAT
Numer KSeF
Data przyjęcia KSeF
Lista elementów – lista dokumentów PZ spiętych do spinacza nagłówkowego, dodanych z Comarch ERP XL po kliknięciu w przycisk + (zob. poniżej Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji desktop).
Dopóki dokument (S)FZ nie został wygenerowany, poszczególne pozycje można usunąć, klikając w ikonę kosza, znajdującą się po prawej stronie danej pozycji; do tego momentu można również dodać pozycję spinacza, naciskając w ikonę plusa pod listą elementów. Spinane dokumenty mogą być wystawione na różnych kontrahentów,
Jeżeli dla danego dokumentu PZ, który użytkownik próbuje dodać do listy, nie ustalono wartości dostawy (TrN_KosztUstalono=0 w tabeli cdn.TraNag w bazie Comarch ERP XL), wówczas przy próbie dodania takiego dokumentu zostanie wyświetlony komunikat „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu”. -Dokumenty bez ustalonego kosztu dostawy: [numery dokumentów]”. Okno komunikatu należy zamknąć, klikając w przycisk [Zamknij] lub X – dokument nie zostanie dodany do listy elementów w formatce.
Komunikat wyświetlony w przypadku, gdy dla danego dokumentu PZ, który operator próbuje dodać do listy elementów na formatce Dokument ERP XL, nie ustalono wartości dostawy
Zakładka „Spięte dokumenty”
Zakładka, na której może zostać wyświetlony dokument PZ.
Aby wybrać dany dokument PZ spośród dokumentów dodanych na zakładce „Spinacz faktury”, należy w ramach pola „Wyświetl dokument” wybrać daną pozycję – wówczas poniżej zostanie wyświetlona zawartość tego dokumentu.
Uwaga
Zmiana wartości w polach na dokumentach w zakładce „Spięte dokumenty” nie jest możliwa.
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu – przed wyborem dokumentu
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu – po wyborze dokumentu
Zakładka „Opis analityczny”
Zakładka działa analogicznie jak dotychczas na dokumencie spinacza faktury. W ramach tej zakładki operator może utworzyć i dodać opis analityczny do tworzonego dokumentu (S)FZ. Opis analityczny może być aktualizowany oraz uzupełniany również po wygenerowaniu dokumentu (S)FZ do Comarch ERP XL. W ramach opisu analitycznego uwzględnione są pozycje wszystkich dokumentów PZ, które dodano do spinacza faktury.
Widok zakładki „Opis analityczny” na formatce spinacza nagłówkowego faktury zakupu – uwzględnione są wszystkie spięte dokumenty PZ
Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji desktop
Od wersji 2026.0.0 proces generowania dokumentu (S)FZ do Comarch ERP XL w aplikacji desktop Comarch BPM ma następujący przebieg:
Na dokumencie Comarch BPM w ramach kontrolki typu Dokument ERP XL, dla której w ustawieniach wybrano spinacz nagłówkowy faktury zakupu, operator klika w przycisk [Dodaj];
Po prawej stronie okna zostaje otwarta formatka „Dokument ERP XL”; w ramach zakładki „Spinacz faktury” operator klika w przycisk [Dodaj];
W otwartym wówczas oknie z listą dokumentów zakupowych z Comarch ERP XL operator wybiera dokumenty do spięcia do (S)FZ i zatwierdza wybór, klikając znak potwierdzenia . Lista dokumentów zakupowych zostaje zamknięta. Istnieje możliwość dodania kolejnych pozycji na liście elementów za pomocą przycisku [Dodaj] lub usunięcia za pomocą ikony kosza obok danej pozycji (zob. Zakładka „Spinacz faktury”).
Uwaga
W odróżnieniu od pracy z dokumentem (S)FZ w wersjach wcześniejszych niż 2026.0.0 operator:
Musi wybrać takie dokumenty PZ, które jeszcze nie są spięte do żadnego spinacza
Ma możliwość wyboru więcej niż jednego dokumentu.
W przypadku, jeżeli:
operator zaznaczył dokumenty, które są już spięte z innym spinaczem, wówczas te dokumenty wyświetlane są na czerwono w Comarch ERP XL– są pomijane przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu listy PZ wyświetlony zostaje komunikat: „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu. Dokumenty związane z innym spinaczem: [numer pominiętego dokumentu].”.
Operator zaznaczył dokument PZ, który jest w buforze, wówczas ten dokument zostanie pominięty przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu okna z Comarch ERP XL z listą PZ wyświetlany jest komunikat: „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu. Dokumenty w buforze: [numer pominiętego dokumentu].”
Komunikat wyświetlany, gdy próbowano dodać dokument, który dodano już do innego spinacza nagłówkowego
Komunikat wyświetlany, gdy próbowano dodać dokument z bufora do spinacza nagłówkowego
Operator zaznaczył dokument, który nie jest dokumentem PZ, wówczas ten dokument zostanie pominięty przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu okna z Comarch ERP XL z listą PZ wyświetlany jest komunikat: „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu. Dokumenty, o typie innym niż PZ: [numer pominiętego dokumentu].”
Komunikat wyświetlany, gdy próbowano dodać dokument inny niż PZ do spinacza nagłówkowego
Operator zaznaczył dokumenty PZ, które są już spięte z innym spinaczem oraz te, które są w buforze, wówczas te dokumenty zostają pominięte przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu listy PZ wyświetlany jest komunikat informujący o braku możliwości dodania takich dokumentów.
Operator musi uzupełnić dane na zakładce „Opis analityczny“ (zob. Zakładka „Opis analityczny” )
Zostaje aktywowana ikona [Generuj dokument] – operator musi kliknąć w tę ikonę, aby wygenerować dokument (S)FZ do Comarch ERP XL
Dokument (S)FZ został wygenerowany – wówczas:
w ramach kontrolki typu Dokument ERP XL widoczny jest numer wygenerowanego dokumentu jako link. Jeśli operator w niego kliknie, wówczas wyświetlany jest podgląd dokumentu w Comarch ERP XL
jeśli operator kliknie w ikonę lupy obok numeru dokumentu, wtedy po prawej stronie okna zostanie otwarta formatka Dokument ERP XL na zakładce „Spinacz faktury“ – formatka jest dostępna tylko do odczytu – nie ma możliwości edycji danych, można jedynie uzupełnić opis analityczny i zaktualizować go na danym dokumencie w Comarch ERP XL
Dołączanie dokumentu (S)FZ z Comarch ERP XL do kontrolki typu Dokument ERP XL w aplikacji desktop Comarch BPM
Dołączanie dokumentu spinacza nagłówkowego faktury zakupu (wiązanie dokumentów) jest analogiczne jak w przypadku innych typów dokumentów, a mianowicie:
Dane z dokumentu ERP XL zawsze zostaną nadpisane na dokument w Comarch BPM;
Operator nie może edytować dokumentu dowiązanego z ERP XL z poziomu powiązanego dokumentu w Comarch BPM
Na dokumencie dowiązanym z ERP XL można aktualizować jedynie opis analityczny
Widok komunikatu pokazującego różnice pomiędzy dokumentem w Comarch BPM i w Comarch ERP XL
W ramach komunikatu, który porównuje wartości na danym dokumencie w Comarch ERP XL i Comarch BPM, sprawdzane są następujące wartości:
Na zakładce „Spinacz faktury”
Kontrahent
Płatnik
Seria dokumentu
Rodzaj zakupu
Rejestr VAT
Numer KSeF
Data przyjęcia KSeF
Razem netto
Razem brutto
Lista spiętych dokumentów
Na zakładce „Opis analityczny”:
Nazwa
Data analityczna
Kategoria finansowa
Wartości z tabelki: Pozycja, Procent, Wartość i pozostałe wynikające z konfiguracji OA w Comarch ERP XL dla danego typu dokumentu
Spinacz nagłówkowy faktury zakupu w aplikacji web
W wersji 2026.0.0 umożliwiono generowanie dokumentów typu (S)FZ (spinacz nagłówkowy zakupu) z poziomu aplikacji web Comarch BPM do Comarch ERP XL.
Formatka spinacza nagłówkowego faktury zakupu w aplikacji web
Od wersji 2026.0.0 formatka spinacza nagłówkowego faktury zakupu składa się z następujących 3 zakładek:
Spinacz faktury
Spięte dokumenty
Opis analityczny
Widok formatki spinacza nagłówkowego faktury zakupu w aplikacji web
Zakładka „Spinacz faktury”
Zakładka, na której znajdują się:
Dane nagłówkowe dokumentu – pola, których obsługa odbywa się tak samo, jak w przypadku innych typów dokumentów:
Kontrahent
Seria dokumentu
Rodzaj zakupu
Płatnik
Rejestr VAT
Numer KSeF
Data przyjęcia KSeF
Tabela „Elementy” – tabela z listą dokumentów PZ, które mają zostać spięte do spinacza nagłówkowego, dodanych z Comarch ERP XL po kliknięciu w przycisk [+Dodaj dokument] – zostaje wówczas otwarte okno „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego”, w którym należy dokonać wyboru dokumentów PZ (zob. Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji web).
Lista dokumentów dostępna w oknie „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego” może być filtrowana według miesiąca i roku – aby został uaktywniony filtr wyboru miesiąca, należy najpierw wybrać rok. Możliwe jest również filtrowanie listy według kontrahenta.
Okno „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego” – wybór filtra miesiąca
Tabela „Dokumenty” składa się z następujących kolumn:
Numer dokumentu
Kontrahent
Wartość netto
Wartość VAT
Wartość brutto
Dopóki dokument (S)FZ nie został wygenerowany, poszczególne pozycje z tabeli „Dokumenty” można usunąć, klikając w ikonę kosza, znajdującą się po prawej stronie danej pozycji; do tego momentu można również dodać pozycję spinacza, naciskając w przycisk [+Dodaj dokument] pod tabelą. Spinane dokumenty mogą być wystawione na różnych kontrahentów
Widok listy dokumentów w tabeli „Dokumenty” na zakładce „Spinacz faktury” na formatce spinacza nagłówkowego faktury zakupu
Zakładka „Spięte dokumenty”
Zakładka, na której może zostać wyświetlony podgląd dokumentów PZ, które mają zostać dodane do spinacza nagłówkowego faktury zakupu.
Uwaga
Zmiana wartości w polach na dokumentach w zakładce „Spięte dokumenty” nie jest możliwa.
Aby wybrać dany dokument PZ spośród dokumentów dodanych na zakładce „Spinacz faktury”, należy w ramach pola „Wybierz spięty dokument” wybrać daną pozycję – wówczas poniżej zostanie wyświetlona zawartość tego dokumentu.
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu w aplikacji web – przed wyborem dokumentu
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu w aplikacji web – po wyborze dokumentu
Zakładka „Opis analityczny”
Zakładka działa analogicznie jak dotychczas na dokumencie spinacza faktury. W ramach tej zakładki operator może utworzyć i dodać opis analityczny do tworzonego dokumentu (S)FZ. Opis analityczny może być aktualizowany oraz uzupełniany również po wygenerowaniu dokumentu (S)FZ do Comarch ERP XL. W ramach opisu analitycznego uwzględnione są pozycje wszystkich dokumentów PZ, które dodano do spinacza faktury.
Widok zakładki „Opis analityczny” na formatce spinacza nagłówkowego faktury zakupu
Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji web
Od wersji 2026.0.0 proces generowania dokumentu (S)FZ do Comarch ERP XL w aplikacji desktop Comarch BPM ma następujący przebieg:
W ramach kontrolki typu Dokument ERP XL, dla której ustawiono typu dokumentu „Spinacz nagłówkowy faktury zakupu”, operator klika w przycisk [Dodaj];
Po prawej stronie okna zostaje otwarta formatka „Dokument ERP XL”; w ramach zakładki „Spinacz faktury” operator klika w przycisk [Dodaj dokument];
W otwartym wówczas oknie „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego” z listy dokumentów zakupowych z Comarch ERP XL operator wybiera dokumenty do spięcia do (S)FZ , zaznaczając checkboxy obok danych pozycji, a następnie zatwierdza wybór, klikając w przycisk [Dodaj]. Lista dokumentów zakupowych zostaje zamknięta. Istnieje możliwość dodania kolejnych pozycji na liście elementów za pomocą przycisku „+ Dodaj dokument” lub usunięcia za pomocą ikony kosza obok danej pozycji (zob. Zakładka „Spinacz faktury”).
Uwaga
Od wersji 2026.0.0 operator:
Musi wybrać takie dokumenty PZ, które jeszcze nie są spięte do żadnego spinacza
Ma możliwość wyboru więcej niż jednego dokumentu.
Operator musi uzupełnić dane na zakładce „Opis analityczny“ (zob. Zakładka „Opis analityczny”)
Następnie, gdy ustalono wartość dostawy dla wszystkich spiętych dokumentów PZ, zostaje aktywowana ikona [Generuj] do ERP] – operator musi kliknąć w tę ikonę, aby wygenerować dokument (S)FZ do Comarch ERP XL
Dokument (S)FZ został wygenerowany – wówczas w ramach kontrolki typu Dokument ERP XL widoczny jest numer wygenerowanego dokumentu. Jeśli operator kliknie w znajdujca się obok ikonę z lupą , wtedy po prawej stronie okna zostanie otwarta formatka Dokument ERP XL na zakładce „Spinacz faktury“ – formatka jest dostępna tylko do odczytu – nie ma możliwości edycji danych, można jedynie uzupełnić opis analityczny i zaktualizować go na danym dokumencie w Comarch ERP XL
Dołączanie dokumentu (S)FZ z Comarch ERP XL do kontrolki typu Dokument ERP XL w aplikacji web w Comarch BPM
Dołączanie dokumentu spinacza nagłówkowego faktury zakupu (wiązanie dokumentów) jest analogiczne jak w przypadku innych typów dokumentów, a mianowicie:
Dane z dokumentu ERP XL zawsze zostaną nadpisane na dokument w Comarch BPM;
Operator nie może edytować dokumentu dowiązanego z ERP XL z poziomu powiązanego dokumentu w Comarch BPM
Na dokumencie dowiązanym z ERP XL można aktualizować jedynie opis analityczny
Zmiany i poprawki dotyczące interfejsu aplikacji web
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 w aplikacji web Comarch BPM wprowadzono następujące zmiany dotyczące interfejsu:
Nowy komunikat wyświetlany przy próbie przekazania z listy, gdy warunki przekazania nie zostały spełnione
W przypadku, gdy zostały spełnione obydwa poniższe kryteria:
Dla danego typu obiegu zdefiniowano warunki, których spełnienie jest konieczne do przekazania dokumentu do danego etapu
Dla danego typu obiegu dla danego etapu zaznaczono możliwość przekazania dokumentu z poziomu listy
wówczas jeśli określone warunki przekazania nie zostały spełnione, a w aplikacji web operator podejmuje próbę przekazania dokumentu z listy, wyświetlony zostaje następujący komunikat: Nie przekazano dokumentu.Nie można przekazać dokumentu do następnego etapu, ponieważ nie zostały spełnione warunki przekazania. Wprowadź zmiany i spróbuj ponownie.
Nowy komunikat wyświetlany przy próbie przekazania dokumentu z listy, gdy nie spełniono warunków przekazania do kolejnego etapu
Rozszerzenie pola „Komentarz”
Zarówno w aplikacji web, jak i w Repozytorium zwiększono liczbę znaków, które można wprowadzić w ramach pola „Komentarz”, znajdującego się w panelu szczegółów przekazania – z 255 znaków do 900 znaków. Tak jak dotychczas operator może rozciągnąć pole komentarza, chwytając w prawym dolnym rogu i rozciągając je. Jeżeli ilość znaków przekracza dostępne miejsce w polu komentarza, wówczas zostanie wyświetlony suwak.
Pole komentarza, w którym wprowadzono 900 znaków (aplikacja web)
Wprowadzenie separacji tysięcy w kontrolkach i kolumnach liczbowych
Wartość w kontrolkach i kolumnach liczbowych (typu Liczba całkowita, Liczba stałoprzecinkowa i Liczba rzeczywista) jest prezentowana w formacie, który umożliwia oddzielenie części tysięcy za pomocą spacji, np. 999 939.
Widok przykładowych wartości w kolumnach liczbowych w kontrolce typu Dane tabelaryczne
Zmiany dotyczące wyboru daty w kontrolce typu Data i godzina
W ramach kontrolki typu Data i godzina umożliwiono ręczne wprowadzanie daty, bez konieczności otwierania kalendarza, aby wybrać datę. Datę można wprowadzić zgodnie z formatem dd.mm.rrrr, wprowadzona data musi też odpowiadać rzeczywistości (nie można wprowadzić takiej daty jak np. 33.77.2012).
Data wprowadzona ręcznie w kontrolce typu Data i godzina
Ręczne wprowadzenie daty jest równoznaczne z zaznaczeniem jej w kalendarzu – jeśli operator otworzy kalendarz, np. klikając w przycisk „Enter” w ramach danej kontrolki typu Data, wówczas poprawnie wprowadzona data jest oznaczona na niebiesko w kalendarzu.
Umożliwiono obsługę klawiatury dla kontrolki typu Data i godzina – wobec tego:
Wybór daty można zatwierdzić za pomocą przycisku „Enter”, zaś po kliknięciu w przycisk „Tab” nastąpi przejście do kolejnego elementu;
Operator może przejść do poprzedniego elementu, wybierając kombinację przycisków „Shift” + „Tab”
Jeśli focus jest ustawiony na danym elemencie, wówczas za pomocą przycisku „Enter” operator może wywołać akcję – przykładowo kliknięcie w strzałkę w lewo zmieni miesiąc na poprzedni, a w strzałkę w prawo – na następny;
Operator może poruszać się w obrębie danego miesiąca w kalendarzu za pomocą strzałek w lewo/w prawo – jedynie w obrębie jednego miesiąca, z wyjątkiem pierwszego i ostatniego tygodnia miesiąca. Klikanie w strzałki góra/dół pozwala na zmianę miesiąca na poprzedni/następny;
Jeśli dla kontrolki wybrano opcję „Tak” dla parametru „Czas”, wówczas operator może zmienić godziny i minuty za pomocą strzałek góra/dół
Aktualizacja bibliotek komponentu KSeFConnector
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 zaktualizowano biblioteki KSeFConnector.dll oraz KSeFConnector2.dll do najnowszych wersji, w związku ze zmianami adresacji, które zostały ogłoszone przez Ministerstwo Finansów.
Wprowadzenie klucza “KSeFProdVersion“ do przełączania wersji produkcyjnej KSeF
Zmiany funkcjonalne w wersji 2026.0.0
Uwaga
W wersji 2026.0.0 wprowadzono nowy klucz “KSeFProdVersion“, który ma umożliwić zmianę wersji KSeF dla pracy w trybie produkcyjnym. Klucz może przyjmować jedną z następujących wartości:
1 – wartość domyślna w wersji 2026.0.0; możliwa jest praca w trybie produkcyjnym KSeF 1.0
2 – możliwa jest praca w trybie produkcyjnym KSeF 2.0
Praca w trybie produkcyjnym KSeF 2.0 będzie możliwa jedynie wtedy, gdy <add key=”KSeFWorkMode” value=”Production” /> oraz <add key=”KSeFProdVersion” value=”2″ /> – ten tryb pracy będzie aktywny dopiero po uruchomieniu przez Ministerstwo Finansów środowiska produkcyjnego KSeF 2.0, tj. po 01.02.2026.
Klucz “KSeFProdVersion“ nie wpływa na pracę w trybie „Test“ oraz „Demo“.
Ustawiono także wartość „Production“ jako wartość domyślną dla klucza KSeFWorkMode.
Widok klucza “KSeFProdVersion“
Współpraca z Comarch sPrint – poprawa wydajności oraz umożliwienie pracy w aplikacji web
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 wprowadzono następujące zmiany dotyczące współpracy Comarch BPM z Comarch sPrint:
Modyfikacja trybu uruchamiania Comarch sPrint
Wprowadzono modyfikację trybu uruchamiania Comarch sPrint, aby poprawić wydajność – po pierwszym wywołaniu wydruku sPrint albo konfiguratora wydruków sPrint uruchomiona aplikacja Comarch sPrint jest przechowywana w tle aż do czasu zakończenia sesji danego operatora w Comarch BPM.
Aplikacja Comarch sPrint nie jest uruchamiana wraz z uruchomieniem Comarch BPM – operator może podczas danej sesji nie korzystać z wydruków/konfiguratora Comarch sPrint.
Umożliwienie pracy z wydrukami sPrint w aplikacji web
Od wersji 2026.0.0 w przypadku, jeśli w aplikacji desktop Comarch BPM w ramach zakładki [Kreator raportów i dashboardów] w zakładce „Uprawnienia” nadano danemu operatorowi prawo do pracy z danymi wydrukami sPrint, wówczas te wydruki sPrint są dostępne w aplikacji web Comarch BPM w zakładce [Raporty].
Wydruki sPrint w aplikacji web są oznaczone napisem [sPrint] przed nazwą wydruku. Sortowanie alfabetyczne wszystkich raportów i dashboardów odbywa się według nazwy, bez informacji o aplikacji, z której pochodzi wydruk. Wywoływane raporty otwierają się w nowym oknie.
Widok przykładowej listy raportów i dashboardów na zakładce „Raporty” w aplikacji web – widoczny jest predefiniowany wydruk sPrint
Jeżeli danemu operatorowi w aplikacji desktop przyznano uprawnienia do danych wydruków sPrint, a także wybrano miejsca wywoływania danego wydruku – z listy dokumentów, ze szczegółów dokumentu albo zarówno z listy dokumentów, jak i ze szczegółów dokumentu – wówczas w aplikacji web Comarch BPM dany operator ma dostęp do wybranego wydruku sPrint zgodnie z tymi ustawieniami:
W przypadku dostępu z poziomu listy dokumentów – wydruk sPrint znajduje się na liście widocznej po kliknięciu w przycisk [Więcej akcji], a następnie [Wygeneruj raport];
Widok przykładowej listy dokumentów w aplikacji web – na liście dostępnej po kliknięciu w opcję „Wygeneruj raport” widoczny jest wydruk sPrint
W przypadku dostępu z poziomu szczegółów dokumentu – wydruk sPrint znajduje się na liście widocznej po kliknięciu w przycisk [Więcej akcji], a następnie [Wygeneruj raport];
Widok przykładowych szczegółów dokumentu w aplikacji web – na liście dostępnej po kliknięciu w opcję „Wygeneruj raport” widoczny jest wydruk sPrint
W obydwóch przypadkach na liście dostępnej po kliknięciu w „wygeneruj raport” wydruki sPrint są poprzedzone napisem (sPrint).
Jeżeli dany wydruk sPrint wymaga podania parametrów do wywołania wydruku, wówczas po kliknięciu w nazwę wydruku w aplikacji web na zakładce [Raporty] albo z poziomu listy dokumentów zostanie wyświetlone okno, w którym operator może wprowadzić parametry. W przypadku konieczności podania jako parametru numeru dokumentu, gdy wydruk sPrint jest wywoływany z poziomu szczegółów dokumentu, parametr jest automatycznie uzupełniany, a okno do wprowadzania parametrów nie zostaje wywołane. W ramach okna do wprowadzania parametrów dostępne są następujące przyciski:
X – przycisk, za pomocą którego można zamknąć okno – wówczas wydruk sPrint nie zostanie utworzony;
[Anuluj] – po kliknięciu w ten przycisk wprowadzone zmiany zostaną anulowane, okno do wprowadzania parametrów zamknie się, a wydruk sPrint nie zostanie utworzony
[Zapisz] – jeśli operator kliknie w ten przycisk, wówczas dane, które wprowadził, zostaną zapisane i zostanie utworzony wydruk sPrint
Widok przykładowego okna „Wprowadź parametry” dla parametrów „Data od“ i „Data do“ w aplikacji web Comarch BPM
Wprowadzenie automatycznego odświeżania karty obiegu po wykonaniu własnej akcji
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 umożliwiono automatyczne odświeżanie karty obiegu po wykonaniu akcji określonej w kontrolce typu Własna akcja. W tym celu w aplikacji desktop w ramach ustawień kontrolki typu Własna akcja dodano checkbox „Odśwież po wykonaniu”.
Jeśli checkbox „Odśwież po wykonaniu” jest zaznaczony, wówczas po wykonaniu akcji określonej w danej kontrolce karta obiegu zostanie przeładowana bez zapisywania obiegu.
Uwaga
Jeśli operator zaznaczył parametr „Odśwież po wykonaniu”, a nie zaznaczył parametru „Zapisz przed uruchomieniem”, wówczas zmiany, które wprowadzono w innych kontrolkach, nie zostaną zapisane, zaś uruchomienie własnej akcji spowoduje utratę niezapisanych zmian. Okno z pytaniem o zapis zmian nie jest wyświetlane.
Za pomocą funkcjonalności „Odśwież po wykonaniu” można np. zaktualizować wartości kontrolek, które zostały zainicjowane uruchomieniem własnej akcji.
Widok ustawień przykładowej kontrolki typu Własna akcja w aplikacji desktop Comarch BPM z zaznaczonym parametrem „Odśwież po wykonaniu”
Funkcjonalność odświeżania karty obiegu, jeśli w aplikacji desktop zaznaczono parametr „Odśwież po wykonaniu”, dotyczy wszystkich platform Comarch BPM (aplikacji desktop, web i mobilnych).
Wprowadzenie możliwości pobierania potwierdzeń dostarczenia dla wysyłki do usługi e-Doręczenia
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 umożliwiono pobieranie potwierdzeń dostarczenia wysyłki do usługi e-Doręczenia. W tym celu:
utworzono skrypt C#, umożliwiający pobranie potwierdzenia otrzymania wiadomości z usługi e-Doręczenia oraz zapisanie potwierdzenia.
przygotowano przykładowy typ obiegu i rozszerzono opis pobierania potwierdzeń dostarczenia oraz zapisywania ich w kontrolce typu Załącznik na tym typie obiegu: oprócz kontrolek „Do:”, „Temat:”, „Treść:”, „Załączniki”, „Wyślij wiadomość” i kontrolki typu Komunikat, skonfigurowanych zgodnie z opisem dostępnym na stronie https://pomoc.comarch.pl/bpm/index.php/dokumentacja/wysylanie-wiadomosci-do-uslugi-e-doreczenia/, dodano następujące kontrolki:
Pobierz potwierdzenie dostarczenia (identyfikator: Pobierz_potwierdzenie) – to kontrolka typu Własna akcja, po kliknięciu w którą nastąpi pobranie potwierdzenia dostarczenia; należy na niej zaznaczyć opcję „Odśwież po wykonaniu“, która pozwala na przeładowanie dokumentu (zob. Wprowadzenie automatycznego odświeżania karty obiegu po wykonaniu własnej akcji), a następnie zapisanie pliku z bazy w kontrolce typu Załącznik; w ramach kontrolki należy wprowadzić następujący skrypt:
var eDorClient = EDorService.CreateClient();
string messageId = Globals.MainFrame.messageId.Text;
int documentId = Globals.Common.DocumentId ?? 0;
// nazwa (identyfikator) kontrolki załącznik, która ma przechowywać zapisane potwierdzenie
string attachmentControlName = "Potwierdzenie_dostarczenia";
try
{
eDorClient.FetchReceiptEvidence(messageId, documentId, attachmentControlName);
//Globals.MainFrame.Pobierz_potwierdzenie_CSSCRIPT.Text = messageId;
}
catch (Exception ex)
{
throw ex;
}
Powyższy kod C#Script umożliwia pobranie potwierdzenia dostarczenia oraz zapisanie go w kontrolce typu Załącznik „Potwierdzenie dostarczenia“ (identyfikator: Potwierdzenie_dostarczenia);
Potwierdzenie dostarczenia (identyfikator: Potwierdzenie_dostarczenia) – to kontrolka typu Załącznik;w kontrolce zostaje dodany dokument PDF potwierdzenia dostarczenia po tym, jak pomyślnie wykonano akcję po kliknięciu w kontrolkę „ Pobierz potwierdzenie dostarczenia“;
Potwierdzenie dostarczenia (identyfikator: Czy_Potwierdzono) – kontrolka typu Tekst, obserwująca kontrolkę „Pobierz potwierdzenie dostarczenia (identyfikator: Pobierz_potwierdzenie) i samą siebie (jest dodana w polu „Kontrolki powiązane“); dla kontrolki należy wprowadzić następujące zapytania:
W polu „Inicjowanie“ po wyborze „SQL OD“:
select 'Nie dokonano sprawdzenia dostarczenia wiadomości.'
W polu „Wzór na wartość“ po wyborze „SQL OD“:
SELECT
CASE
WHEN EXISTS (
SELECT 1
FROM do.DF_WorkCF wcf
JOIN do.DF_ConfCFCardDokFlow dko ON wcf.DWC_DKOId = dko.DKO_ID
JOIN do.DF_WorkCFBin bin ON wcf.DWC_ID = bin.DWB_DWCID
WHERE wcf.DWC_DWDId = @^DocumentId@
-- nazwa (identyfikator) kontrolki załącznik przechowującej potwierdzenie
AND dko.DKO_Name = 'Potwierdzenie_dostarczenia'
AND bin.DWB_Archival = 0
) THEN 'Potwierdzenie jest dostępne do pobrania.'
ELSE 'Dostarczenie nie zostało jeszcze potwierdzone.'
END
W ramach kontrolki wyświetlana jest informacja dotycząca pobierania potwierdzenia dostarczenia:
Jeśli nie wykonano jeszcze własnej akcji z kontrolki „Pobierz potwierdzenie dostarczenia” – wyświetlana jest informacja: „Nie dokonano sprawdzenia dostarczenia wiadomości.”
Jeśli wykonano własną akcję z kontrolki „Pobierz potwierdzenie dostarczenia” i potwierdzenie zostało poprawnie zapisane w bazie – widoczna jest informacja: „Potwierdzenie jest dostępne do pobrania”
Jeśli wykonano własną akcję z kontrolki „Pobierz potwierdzenie dostarczenia”, ale potwierdzenie jeszcze nie istnieje w bazie – widoczna jest informacja: „Dostarczenie nie zostało jeszcze potwierdzone.“
Zmiana sposobu wyświetlania danych dla aktualnego etapu w historii przekazania dokumentu w aplikacjach Comarch BPM
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 dokonano zmiany sposobu wyświetlania informacji dotyczących aktualnego etapu w historii przekazania dokumentu – w aplikacji web nie jest już wyświetlana nazwa operatora na aktualnym etapie, zaś sama nazwa etapu została wyśrodkowana w stosunku do znajdującej się w polu ikony.