Historia strony

Dotyczy wersji systemu: 20.0.380.283305

...

W celu aktywacji środowiska dla danej firmy należy zalogować się na stronę: https://ap-demo.ksef.mf.gov.pl/web/, gdzie po dokonaniu autoryzacji można pobrać token przeznaczony dla środowiska demonstracyjnego KSeF.

• • Produkcyjne-przełączenie parametru na tę wartość oznacza komunikację programu ze środowiskiem produkcyjnym Krajowego Systemu e-Faktur. 

...

• Wysyłaj XML do KSeF w wersji - parametr określa, w jakiej strukturze plik XML zostanie wygenerowany w programie i wysłany na platformę KSeF. Struktura FA(3) obowiązuje dla w środowiska produkcyjnego KSeF 2.0.
• Możliwość otwierania i zamykania sesji wysyłki przez użytkownika - parametr domyślnie ustawiony jest na wartość Tak. Zmiana na Nie spowoduje brak możliwości uruchamiania sesji przez użytkownika (w oknie Sesja wysyłki KSeF nie będzie dostępny przycisk Otwórz sesję). W tej sytuacji żądanie otwarcia sesji wysyłki KSeF będzie wykonywane każdorazowo przez system podczas wysyłania dokumentu lub zbioru dokumentów i automatycznie zamykane po wykonaniu tej czynności.
• Możliwość pełnej edycji dokumentu po utworzeniu pliku XML - parametr jest dostępny dla użytkowników o uprawnieniach administratora. Stosowany jest w kontekście użytkownika i może przyjąć 3 wartości:

...

Ustawienie to może mieć zastosowanie, w sytuacji, gdy w ramach testowania funkcjonalności dokumenty wystawiane na bazie produkcyjnej systemu Streamsoft były wysyłane na środowisko demonstracyjne KSeF, a następnie zmieniono wartość parametru konfiguracyjnego Środowisko KSeF na Produkcyjne. UWAGA! Działanie takie nie jest zalecane. Do testowania obsługi KSeF w systemie Streamsoft rekomendujemy wykorzystanie osobnej instalacji programu - środowiska testowego.

• • Tak (zawsze pełna edycja) - umożliwia zawsze pełną edycję dokumentu po wygenerowaniu pliku XML bez względu na to, w jakim środowisku dokument został wystawiony. UWAGA! Zastosowanie tego ustawienia w kontekście komunikacji ze środowiskiem produkcyjnym KSeF umożliwia dokonanie zmian w dokumentach wysłanych do KSeF również w zakresie obowiązkowych elementów faktury, np. wpływających na zestawienie VAT. Skutkować to będzie rozbieżnościami pomiędzy dokumentami wystawionymi w systemie Streamsoft a dokumentami znajdującymi się na platformie krajowego Systemu e-Faktur. W związku z tym wysokość podatku w pliku JPK_V7 wygenerowanym w programie Streamsoft może być inna od wartości wynikającej z dokumentów znajdujących się w KSeF, co skutkować może konsekwencjami prawno-skarbowymi.

• Kotwica
  param_wizualizacje param_wizualizacje

  Wizualizacja dokumentów KSeF - umożliwia zmianę sposobu prezentacji podglądu graficznego (widok HTML) dokumentów KSeF. Do wyboru są wartości:
  
  • Wizualizacja podstawowa - widok dokumentu oparty jest o wizualizację przygotowaną przez Ministerstwo Finansów 
  • Wizualizacja Streamsoft - umożliwia prezentację dokumentu w formie wizualizacji predefiniowanej (utworzonej przez Streamsoft) lub wizualizacji utworzonej przez użytkownika w języku XSLT. Szczegółowy opis funkcjonalności znajduje się pod linkiem: Wizualizacje dokumentów KSeF
• Możliwość wysyłania dokumentu do KSeF dla kontrahenta jednorazowego - parametr domyślnie ustawiony jest na wartość Tak. Zmiana na Nie spowoduje blokadę wysyłki dokumentu wystawionego na kontrahenta jednorazowego. W przypadku konieczności wysyłki dokumentu wystawionego na kontrahenta jednorazowego Możliwość wysyłania dokumentu do KSeF dla kontrahenta jednorazowego - parametr domyślnie ustawiony jest na wartość Tak. Zmiana na Nie spowoduje blokadę wysyłki dokumentu wystawionego na kontrahenta jednorazowego. W przypadku konieczności wysyłki dokumentu wystawionego na kontrahenta jednorazowego prowadzącego działalność, należy najpierw wprowadzić jego dane do słownika Kontrahenci.
• Blokuj wysyłanie do KSeF faktur z ujemną wartością - włączenie parametru powoduje brak możliwości wysłania dokumentu sprzedaży z ujemną wartością. Przy próbie wysyłki takiego dokumentu system wyświetli komunikat informujący, że dokument nie podlega wysyłce do KSeF.
• Rodzaj grupy kontrahentów dla słownika "Widoczność kontrahentów w KSeF" - grupy kontrahentów o rodzaju wskazanym w parametrze, będą możliwe do wskazania w opcji Widoczność kontrahentów w KSeF (dostępnej w menu System - Krajowy System e-Faktur). Za pomocą grup można nadać uprawnienia do dostępu do faktur wybranych kontrahentów dla poszczególnych użytkowników przypiętych do tokena lub certyfikatu.
• Dodaj do pliku KSeF w sekcji "Rozliczenia" jako obciążenia/odliczenia pozycje z dok. opakowań z kartotekami oznaczonymi rodzajem grupy kartotekowej do wskazania opakowań w systemie kaucyjnym (tylko dla dok. w PLN)  - domyślnie ustawiony na „Tak”. Powoduje dodanie do pliku XML wysyłanego do KSeF pozycji opakowań i kwot kaucji z powiązanego dokumentu OPKs, jako obciążenia (wydanie) lub odliczenia (zwrot). Opcja wymaga skonfigurowanego systemu kaucyjnego zgodnie z osobną instrukcją: System kaucyjny od 1.10.2025.

...

• • • Jakość połączenia internetowego
    • Ilość i częstotliwość wysyłanych dokumentów do KSeF
    • Sposób wysyłki dokumentów (przez 1 osobę czy więcej osób w tym samym czasie)
• Częstotliwość (w minutach) z jaką system sprawdza dostępność UPO dla zamkniętych sesji wysyłek na platformie KSeF (0-wyłaczone) - domyślna wartość to 0 (wyłączone). Ustawienie wartości większej niż 0 włącza na danym stanowisku cykliczne sprawdzanie dostępności UPO co podaną liczbę minut dla zamkniętych sesji wysyłek. Mechanizm obejmuje sesje z dnia bieżącego i poprzedniego, dla których nie pobrano UPO. Wysyła zapytanie do platformy KSeF i po pobraniu uzupełnia Nr KSeF oraz daty ich nadania dla dokumentów o statusie „Wysłano, oczekuje”.
• Automatycznie odświeżaj okno po otrzymaniu nr KSeF - włączenie parametru spowoduje, że podczas cyklicznego sprawdzania nadania nr KSeF dla wysłanych dokumentów, system po otrzymaniu odpowiedzi zwrotnej z platformy automatycznie odświeży dane w oknie i wyświetli informacje o KSeF dla pozycji.
• Czas (w sekundach, min to 10), jaki system poświęci na przetworzenie i wykonanie polecenia wysyłki dokumentu do KSeF przez mechanizm REST - parametr dotyczy wysyłki dokumentów do KSeF za pomocą dedykowanych rozwiązań opartych o serwer REST.
• Minimalny interwał odczytu z bazy trybu pracy z systemem KSeF (w sekundach) - pozwala na określenie minimalnego przedziału czasowego, w którym system będzie pobierał informację o trybie pracy z krajowym Systemem e-Faktur. 
• Nazwa wtyczki do edycji eksportowanego XML: we(Id_Nagl, verKSeF: integer; XML_in: string) wy(XML_out: string) - umożliwia podpięcie dodatkowego rozwiązania pozwalającego na edycję wygenerowanego pliku XML, przed jego wysyłką na platformę KSeF. Do jej wykorzystania niezbędne jest posiadanie menadżera rozszerzeń w licencji programu.
• Katalog schematów XSD - parametr umożliwia ręczne wskazanie katalogu plików ze schematem XSD, według którego walidowany jest plik wygenerowany z systemu. Standardowo pliki faktur ustrukturyzowanych generowane w systemie są porównywane ze schematem XSD dostępnym on-line. Uzupełnienie wartości parametru jest zalecane tylko w szczególnych przypadkach (np. gdy w przedsiębiorstwie występują blokady połączeń internetowych i walidacja pliku nie może nastąpić standardowo on-line). W przypadku wykorzystywania parametru należy pamiętać o aktualizacji jego wartości po udostępnieniu nowego schematu przez Ministerstwo Finansów.
• Katalog do zapisu plików XML -umożliwia wskazanie lokalizacji, w której zapisywane będą wygenerowane w programie pliki dokumentów sprzedaży w formacie XML zgodnym ze specyfikacją KSeF. Zapis zostanie wykonany po użyciu opcji w oknie dokumentów sprzedaży → menu kontekstowe → Krajowy System e-Faktur → Zapisz plik XML.

• Kotwica
  spos_prezent_listy_dok spos_prezent_listy_dok

  Sposób prezentacji listy dokumentów na platformie KSeF - parametr dotyczy dokumentów sprzedaży jak i zakupu. Określa sposób pobierania i prezentacji listy dokumentów z Krajowego Systemu e-Faktur, co wpływa na liczbę zapytań wysyłanych do serwera MF. Może przyjąć wartości:
  • Pobieraj dokumenty w podziale na strony (wartość domyślna) - system pobiera pełną listę dokumentów z danego okresu, ale w przypadku dużej liczby dokumentów może wykonywać wielokrotne zapytania, ponieważ jedno zapytanie zwraca maksymalną liczbę dokumentów zgodnie z limitami KSeF
  • Pobieraj wszystkie dokumenty - lista prezentowana jest w podziale na strony zawierające maksymalnie 250 dokumentów, a system pobiera dane dla każdej strony osobno na żądanie jej wyświetlenia, przy czym wyświetlane są wszystkie pozycje z danego okresu (zarówno pobrane, jak i niepobrane), a niepobrane dokumenty mogą być widoczne jako puste wpisy, co przy dużym zakresie dat może powodować, że pierwsze strony wydają się puste, a dane pojawiają się dopiero na kolejnych stronach.
• Prezentacja listy dokumentów zakupu na platformie KSeF w kontekście podmiotu trzeciego - ustawienie parametru na wartość Tak umożliwi prezentację dokumentów KSeF w kontekście podmiotu innego na oknie Platforma KSeF – dokumenty zakupu.
• Prezentacja listy dokumentów zakupu na platformie KSeF w kontekście podmiotu upoważnionego - Ustawienie parametru na wartość Tak umożliwi prezentację dokumentów KSeF w kontekście podmiotu upoważnionego na oknie Platforma KSeF – dokumenty zakupu.

• Kotwica
  param_stan_weryfik param_stan_weryfik

  Sposób obsługi pola "Stan weryfikacji" w buforze importu dokumentów z KSeF (sposób reagowania na realizację z bufora) - umożliwia obsługę pola Stan weryfikacji w oknie edycyjnym bufora importu dokumentu z KSeF. Pole to odpowiada za kontrolę realizacji dokumentów zaimportowanych z KSeF do systemu. Opcja ta rozszerza konieczność weryfikacji poprawności danych przez użytkowników odpowiedzialnych za wprowadzenie dokumentów do systemu. Parametr może przyjąć wartości:
  
  • Brak - pole Stan weryfikacji nie jest widoczne w oknie edycyjnym bufora importu dokumentu i nie jest obsługiwane podczas realizacji z bufora.
  • Informuj gdy "Niezweryfikowany" i blokuj gdy "Niezaakceptowany" - uruchamia obsługę pola Stan weryfikacji. W przypadku próby realizacji dokumentu określonego jako Niezweryfikowany system w raporcie realizacji wyświetli ostrzeżenie: Stan weryfikacji: Niezweryfikowany. Przy próbie realizacji dokumentu o stanie Niezaakceptowany, system wyświetli informację w raporcie i przerwie proces realizacji.
  • Blokuj gdy inny niż "Zaakceptowany" -  uruchamia obsługę pola Stan weryfikacji i pozwala na realizację wyłącznie dokumentów o stanie Zaakceptowany. W innym przypadku proces zostanie zatrzymany, a w raporcie realizacji pojawi się odpowiednia informacja.
• Przepisz informacje (pole Stopka-Informacje) dokumentu KSeF do pola "Opis" przy procesowaniu w DMS - działanie parametru dotyczy pozycji z bufora importu z KSeF z zaznaczoną opcją Procesuj w DMS. Ustawienie wartości na Tak spowoduje, że podczas realizacji do system przeniesie wartości z sekcji Stopka - Informacje w pliku XML z KSeFdo pola Opis dokumentu w oknie obiegu DMS.
Włącz
• Włącz pobieranie dokumentów z KSeF do bufora importu z użyciem paczek plików (import wsadowy ograniczający ilość zapytań do API KSeF) - uruchamia opcje importu wsadowego, czyli pobieranie z KSeF paczek dokumentów, zamiast pojedynczych plików. Szczegółowy opis opcji dostępny jest pod linkiem: Import wsadowy z KSeF
• Procedura uruchamiana po imporcie dokumentu do Bufora importu z KSeF - umożliwia wskazanie procedury definiowanej, która zostanie automatycznie uruchomiona po pobraniu dokumentu z KSeF i zaimportowaniu go do bufora importu. Procedurę można utworzyć w module Raporty i formularze wybierając rodzaj „KSeF - Po imporcie dokumentu do Bufora importu z KSeF”. 
• Procedura uruchamiana przed zapisem edytowanego dokumentu w Buforze importu z KSeF - umożliwia wskazanie procedury definiowanej, która zostanie uruchomiona przed zapisem edytowanego dokumentu w buforze importu z KSeF.  Procedurę można utworzyć w module Raporty i formularze wybierając rodzaj "KSeF - Przed zapisem edytowanego dokumentu w Buforze importu z KSeF".  Procedura pełni funkcję walidacji danych dokumentu. Zwrócenie wartości „1” w parametrze WYNIK oznacza, że dokument jest poprawny. W przeciwnym razie dokument nie zostanie oznaczony jako poprawny i wyświetlony zostanie komunikat z parametru KOMUNIKAT.
• Procedura definiowana uruchamiana przed importem dokumentu w celu szukania kontrahenta -umożliwia podpięcie utworzonej indywidualnie procedury definiowanej mającej na celu powiązanie kontrahentów z dokumentów KSeF z kontrahentami istniejącymi w systemie, przed importem dokumentów z platformy do Bufora importu z KSEF.
• Procedura uruchamiana przed zmianą statusu dokumentu w buforze importu KSeF / Procedura definiowana uruchamiana po zmianie statusu dokumentu w buforze importu KSeF - umożliwiają podpięcie utworzonych indywidualnie procedur definiowanychdotyczących dokumentów umieszczonych w buforze importu KSeF.
• Import z plików KSeF - umożliwia import dokumentów sprzedaży i zakupu z pliku w formacie XML, zgodnego ze strukturą logiczną dla e-Faktur (FA). Po włączeniu parametru dostępne są dodatkowe ustawienia importu. Szczegółowy opis funkcjonalności znajduje się w osobnym materiale: Import z pliku KSeF.

...

Po uruchomieniu obsługi KSeF w menu System dostępna będzie opcja Krajowy System e-Faktur, gdzie możliwe jest zarządzanie certyfikatami oraz tokenami służącymi do uwierzytelniania, sesjami KSeF oraz weryfikacja błędnych połączeń do platformy KSeF.

Image RemovedImage Added

Tryb pracy KSeF

...

W oknie prezentowany jest wykaz nieprawidłowości w trakcie komunikacji z KSeF. W szczegółach danej pozycji dostępne są zakładki Żądanie i Błąd, które wyświetlają odpowiednio żądanie wysłane z programu do serwera KSeF oraz treść błędu. Dane te mogą stanowić pomoc przy analizie nieprawidłowości w komunikacji z Krajowym Systemem e-Faktur.

Sposoby płatności

Kotwica
wizualizacje wizualizacje

Wizualizacje dokumentów KSeF

Słownik domyślnie zawiera predefiniowane wpisy: Wizualizacja podstawowa i Wizualizacja Streamsoft oraz umożliwia dodanie wizualizacji dokumentów w języku transformacji dokumentów XSLT. 

Wizualizacje znajdujące się w słowniku można wskazać jako domyślną prezentację dokumentu KSeF:

• w konfiguracji systemu → parametr Wizualizacja dokumentów KSeF - będzie domyślna dla wszystkich dokumentówwysłanych i pobranych z KSeF.
• W menu Słowniki → Definicje dokumentów → wybrana definicja dokumentu sprzedaży/zakupu → zakładka 1 Podstawowe → pole Wizualizacja dokumentu KSeF - będzie domyślna dla dokumentów KSeF wystawionych lub zaimportowanych w tej definicji.

Podczas uruchamiania podglądu dokumentu KSeF (Widoku HTML) system w pierwszej kolejności weryfikuje, czy w definicji dokumentu wskazany został typ domyślnej wizualizacji, w przypadku braku wskazania odwołuje się do wartości parametru w konfiguracji.

Image Added 

Przykład dokumentu w Wizualizacji Streamsoft 

Image Added

Przykład dokumentu w Wizualizacji podstawowej

Image Added

W słowniku wizualizacji, za pomocą opcji Dodaj (F3) można zdefiniować własną wizualizację, w oknie edycyjnym należy podać nazwę oraz wczytać plik z rozszerzeniem XSL. 

Image Added

Image Added

Sposoby płatności

W menu Słowniki → Słowniki dla dokumentów → Sposoby W menu Słowniki → Słowniki dla dokumentów → Sposoby płatności istnieje możliwość połączenia zdefiniowanych w systemie sposobów płatności z zawężonym słownikiem udostępnionym w specyfikacji KSeF. Służy do tego pole Płatność KSeF znajdujące się na zakładce 1 Podstawowe.

...

Na definicjach dokumentów, które dotyczą transakcji gospodarczych objętych obowiązkiem eksportu do KSeF, na zakładce 1 Podstawowe dodane zostały parametry:

Image AddedImage Removed

• Wysyłka do KSeF - warunkuje on możliwość obsługi w KSeF tego typu dokumentów i domyślnie jest zaznaczony.

...

• Formularz dla dod. pól do KSeF - umożliwia wskazanie formularza zawierającego dodatkowe, opcjonalne pola, które będą przekazywane do pliku XML dokumentu wysyłanego do KSeF z danego miejsca sprzedaży. Szczegółowy opis działania formularzy znajduje się w  rozdziale:Formularze dla dodatkowych pól do KSeF.
• Szablon XML do KSeF - umożliwia wskazanie szablonu, wg którego będą generowane dokumenty sprzedaży, wysyłane do Krajowego Systemu e-Faktur. Szablony umożliwiają bardzo szeroki zakres edycji struktury pliku XML. Szczegółowy opis funkcjonalności znajduje się osobnym materiale: Szablony XML do KSeF.
• Wyślij automatycznie do KSeF - zaznaczenie parametru spowoduje wysyłkę dokumentu na platformę KSeF od razu po jego wystawieniu.
• Wizualizacja dokumentu KSeF - umożliwia wskazanie typu wizualizacji ze słownika, w której prezentowany będzie podgląd dokumentu KSeF wystawionego w systemie w danej definicji. Szczegółowy opis opcji dostępny jest w rozdziale Wizualizacje dokumentów KSeF.

Miejsca sprzedaży

W oknie Miejsce sprzedaży na zakładce 10 KSeF dodano pole Podlega KSeF. Domyślnie jest ono zaznaczone i dotyczy wszystkich miejsc sprzedaży podlegających księgowaniu. Brak znacznika skutkować będzie blokadą wysyłki do KSeF dokumentów wystawionych w danym miejscu sprzedaży.

...

• z zakładki 7 Cechy - gdy oznaczono "Drukuj wartości cech dokumentu"

wersja 7.1 2 z dnia 2026-0405-1507