Aktualizacja integracji z systemem KSeF #
Od pierwszego października 2025 Ministerstwo Finansów zaczęło proces przenoszenia systemu KSeF do nowej wersji. Został udostępniony środowisko testowe a kolejne elementy systemu będą udostępniane zgodnie z planowanym harmonogramem.
Wdrożenie interfejsu 2.0 i schemy 3 #
Pierwsza zmiana, jaka została wdrożona w Navigatorze jest mało widoczna dla użytkownika ale stanowi podstawę innych modyfikacji. Jest to dostosowanie systemu do współpracy z KSeF zgodnie ze schemą 3 i interfejsem API 2.0. Zmiana ta nie spowodowała bezpośrednich zmian w samym Navigatorze jednak został całkowicie przebudowany serwis do komunikacji z KSeF. Sam serwis jest opisany w osobnym artykule, który będzie sukcesywnie uzupełniany o nowe informacje. Z punktu widzenia projektanta aplikacji w Navigatorze365 należy pamiętać, że zmieniła się struktura jJSONa oraz endpointy, które należy wywołać w celu wysłania faktury.
Główne zmiany to konieczność użycia dwóch endpointów:
Do generowania XML z danymi faktury
Oraz endpoint do wysyłania pliku XML do KSeF
Akcja Utwórz archiwum #
Obok pojedynczego wysyłania faktur pojawiła się też możliwość wysyłania paczki faktur. Służy do tego osobny endpoint.
Jak widzimy do wysłania paczki faktur potrzebujemy pliku ZIP z plikami XML dla faktur. Służy do tego dedykowana akcja, tworząca plik ZIP z podanymi dokumentami. Możemy jej użyć np. w pętli – wybieramy listę faktur jako źródło pętli a w akcji Utwórz archiwum podajemy kolejne dokumenty. Akcja dodaje kolejne pliki do jednego archiwum, które po zakończeniu pętli zostanie zapisane we wskazanym miejscu.
Akcję można oczywiście użyć do innych celów, nie tylko do KSeF.
Hash pliku #
Przy wysyłaniu i pobieraniu masowym faktur trzeba je jakoś zidentyfikować. W systemie KSeF wprowadzono skrót czyli hash pliku XML i poprzez ten identyfikator można jednoznacznie wskazać dokument. W systemie Navigator został rozbudowany atrybut Załączniki, teraz gdy dodajemy dowolny plik system liczy hash takiego pliku i zapisuje go w bazie. Do hasha mamy dostęp przez mentionsy
Obsługa QR kodu #
Wraz z KSeF 2.0 wchodzi obsługa trybów offline oraz awaryjnego, czyli trybów wysyłania faktur w sytuacji gdy komunikacja z KSeF nie jest możliwa. Może to być spowodowane awarią infrastruktury KSeF lub infrastruktury lokalnej (np. niedostępność Internetu).
Obsługę kodów QR odbywa się poprzez endpointy, które generują kod QR na podstawie hasha faktury. Rezultat zwracany jest jako obraz, który możemy zapisać na formularzu i nanieść na wydruk faktury.
Rozbudowa akcji Zmień wartość zmiennej procesowej #
Rozbudowana została akcja Zmień wartość zmiennej procesowej. Teraz można w jednej akcji zmienić wartość wielu zmiennych, istnieje też możliwość użycia mentionsów czy wyrażeń SQL do wyliczania wartości zmiennej.
Rozbudowa konfiguracji uprawnień #
Dodana została nowa funkcjonalność do zarządzania uprawnieniami – Uprawnienia z atrybutów. Jest to sekcja w zakładce Uprawnienia na konfiguracji firmularza, w której możemy zdefiniować pola, które przechowują użytkowników lub grupy oraz uprawnienia przypisane do tych atrybutów. Jeżeli na dokumencie w polu zostanie zapisana nowa wartość – niezależnie czy dodana ręcznie przez użytkownika czy poprzez akcję na procesie – system nada osobie lub grupie uprawnienia zgodnie z definicją. W ten sposób można zarówno dodawać jak i odbierać uprawnienia – poprzez zwykłe dodawanie lub usuwanie elementów z atrybutu.
Operator Nie W w filtrze listy #
Konfiguracja filtrów na liście została rozbudowana o nowy operator – Nie W – odpowiadający klauzuli SQL NOT IN. Użycie tego operatora pozwala na znalezienie tych elementów listy, które nie pasują do jakiejś kolekcji danych.
Kopiowanie filtrów #
W konfiguracji filtrów na listach został dodany przełącznik, który umożliwia przełączenie trybu konfiguracji z graficznego (drzewo) na kod. Samo rozwiązanie nie wnosi zbyt wiele w możliwości edycji gdyż tryb graficzny jest znacznie wygodniejszy ale znacząco zwiększa możliwości systemu gdyż umożliwia łatwe przenoszenie filtrów. Gdy skonfigurujemy skomplikowany filtr i chcemy go przenieść w inne miejsce wystarczy przełączyć się w tryb tekstowy, skopiować cały kod i wkleić go w inne miejsce. W nowym miejscu, po przełączeniu w tryb graficzny, mamy ładnie skonfigurowany filtr.
Możliwość zmiany nazwy atrybutu na widoku #
Dodana została możliwość zmiany nazwy na widoku. W zakładce Ogólne konfiguracji atrybutu na widoku dodany został checkboks Dziedzicz ustawienia z formularza, po jego odznaczeniu mamy możliwość zmiany nazwy formularza i dodanie opisu.
Zmiany w konfiguracji skrzynek mailowych #
Dodany został przycisk „Sprawdź połączenie”, który będzie walidował poprawność wprowadzonych danych (czyli czy połączenie ze skrzynką jest realizowane).
Dodatkowo dodany został checkboks „Wyłącz walidację certyfikatów SSL/TLS”. Po jego zaznaczeniu połączenia będą nawiązywane nawet do serwerów z nieprawidłowymi lub niezweryfikowanymi certyfikatami.
Filtry na liści #
Dodane zostały proste filtry które są wyświetlane na liście. Filtry konfigurujemy tak samo jak filtry do wyszukiwarki globalnej w zakłądce Wyszukiwarka na formularzu:
Tak zbudowany filtr jest wyświetlany na liście opartej o formularz, w którym jest zdefiniowany filtr.
