KSEF Okno Sesji: Różnice pomiędzy wersjami

Z OgnikWiki
Przejdź do nawigacji Przejdź do wyszukiwania
 
(Nie pokazano 28 wersji utworzonych przez 2 użytkowników)
Linia 1: Linia 1:
Okno sesji służy do nawiązywania sesji z KSeF, wysyłania i odbierania faktur.
Okno OGNIK.KSeF służy do nawiązywania sesji z KSeF. Sesja KSeF to czasowe połączenie użytkownika (lub systemu firmy) z systemem KSeF w kontekście wybranego numeru NIP/Firmy, w ramach którego można wykonywać różne operacje, np.: pobierać faktury, wysyłać faktury do KSeF


{{Green|Co to jest Sesja KSeF? Zobacz artykuł: [[KSEF_Sesja|Sesja KSeF]]}}
Zobacz nasz filmik [https://www.youtube.com/watch?v=UdB9iCdei-E '''Jak połączyć się z KSeF w Ogniku'''] na YouTube.


==Panel górny==
==Panel górny==
* Tu widać kontekst w jakim możesz pracować w KSEF - zwykle to numer NIP-u jednostki.
* '''NIP kontekstu''' - Tu widać kontekst w jakim możesz pracować w KSEF - jest to numer NIP-u jednostki.
* opcjonalny ID. Wewn. (w DEMO  nieaktywny)
* '''ID. Wewn''' - opcjonalny ID. Wewn.
* ramkę z komunikatami
* '''Środowisko''' -  na jakie łączymy się w kontekście danego podmiotu.
* przycisk Zamknij okno (po jego użyciu okno zniknie, ale sesja pozostanie aktywna w tle)
* '''Ramkę z komunikatami'''
[[Plik:Panel gorny sesja ksef.jpg|brak]]
* '''Zamknij okno''' (po jego użyciu okno zniknie, ale sesja pozostanie aktywna w tle)
[[Plik:Panel gorny sesja ksef1.jpg|brak]]


==Lista sesji==
==Lista sesji==
Linia 18: Linia 19:
Aby nawiązać połączenie (sesję) z KSeF potrzebujesz:
Aby nawiązać połączenie (sesję) z KSeF potrzebujesz:


* certyfikatu kwalifikowanego, lub
* [[Certyfikatu kwalifikowanego|certyfikatu kwalifikowanego]], lub
* profilu zaufanego, lub
* [[Profilu Zaufanego|profilu zaufanego]], lub
* [[KSEF_Certyfikat|certyfikatu ksef]]
* [[KSEF_Certyfikat|certyfikatu ksef]]


Linia 26: Linia 27:
Okienko się zmieni i zobaczysz trzy opcje do wyboru, wybierz odpowiednią do narzędzia autoryzacyjnego jakie posiadacz i kliknij ją.
Okienko się zmieni i zobaczysz trzy opcje do wyboru, wybierz odpowiednią do narzędzia autoryzacyjnego jakie posiadacz i kliknij ją.


[[Plik:Inicjuj nowa sesje.jpg|brak]]
[[Plik:Inicjuj nowa sesje1.jpg|brak]]
 




W przypadku:
W przypadku:


* Certyfikatu kwalifikowanego - program poprosi o wskazanie certyfikatu a następnie o podanie PIN-u analogicznie, jak przy podpisywaniu dokumentów czy też wysyłaniu JPK czy e-Deklaracji. Jeśli podane dane są prawidłowe a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.
* '''[[Certyfikatu kwalifikowanego]]''' - program poprosi o wskazanie certyfikatu a następnie o podanie PIN-u analogicznie, jak przy podpisywaniu dokumentów czy też wysyłaniu JPK czy e-Deklaracji. Jeśli podane dane są prawidłowe a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.


* Profilu Zaufanego - program wygeneruje plik i zaproponuje zapisanie go na dysku komputera. Odszukaj ten plik. Podpisz go na stronie MF, pobierz podpisany na swój komputer i wczytaj do programu. (Analogicznie działasz np. przy wysyłaniu niektórych deklaracji przez strony MF.) Po wczytaniu pliku - jeśli został on prawidłowo podpisany a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.
* '''Certyfikatu KSeF''' - po kliknięciu zobaczysz liczbę dostępnych certyfikatów KSEF. Wybierz jeden i kliknij '''[Połącz używając certyfikatu KSEF]'''. Jeśli zapisując w programie certyfikat z KSeF zostało zapisane również hasło - program zapyta o PIN, który tam nadałeś. Jeśli nie podałeś hasła - program zapyta o hasło. Jeśli podane dane są prawidłowe a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.


* Certyfikatu KSeF - po kliknięciu zobaczysz liczbę dostępnych certyfikatów KSEF. Wybierz jeden i kliknij '''[Połącz używając certyfikatu KSEF]'''. Jeśli zapisując w programie certyfikat z KSeF zostało zapisane również hasło - program zapyta o PIN, który tam nadałeś. Jeśli nie podałeś hasła - program zapyta o hasło. Jeśli podane dane są prawidłowe a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.
* '''[[Profilu Zaufanego]]''' - program wygeneruje plik i zaproponuje zapisanie go na dysku komputera. Odszukaj ten plik. Podpisz go na stronie MF, pobierz podpisany na swój komputer i wczytaj do programu. (Analogicznie działasz np. przy wysyłaniu niektórych deklaracji przez strony MF.) Po wczytaniu pliku - jeśli został on prawidłowo podpisany a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.




[[Plik:Polacz za pomoca.jpg|brak]]
[[Plik:Polacz za pomoca1.jpg|brak]]


Po nawiązaniu sesji z KSeF zostanie ona zapisana na liście sesji i aktywowana. Jeśli masz w KSeF stosowne uprawnienie - możesz teraz pobierać faktury z KSeF.
Po nawiązaniu sesji z KSeF zostanie ona zapisana na liście sesji i aktywowana. Jeśli masz w KSeF stosowne uprawnienie (np. do przeglądania faktur) - możesz teraz pobierać faktury z KSeF.


=== Pobieranie faktur ===
=== Pobieranie faktur ===


Do ustawienia masz tylko dwie opcje
Do ustawienia masz opcje


* rodzaj faktur
* rodzaj faktur


** Podmiot1 - czyli te, gdzie to Ty jesteś sprzedawcą
** '''Podmiot1''' - czyli te, gdzie to Ty jesteś sprzedawcą
** Podmiot2 - faktury zakupu
** '''Podmiot2''' - faktury zakupu
** Podmiot3 - gdzie występujesz w dodatkowych rolach
** '''[[Podmiot3]]''' - gdzie występujesz w dodatkowych rolach. (Pole zawierający dane podmiotu trzeciego np. faktora albo płatnika)
** PodmiotUP - opcjonalnie, zwykle nie potrzebujesz pobierać tych faktur.
** '''[[PodmiotUP]]''' - opcjonalnie, zwykle nie potrzebujesz pobierać tych faktur. (tj. komornik sądowy, organ egzekucyjny i przedstawiciel podatkowy)


Domyślnie zaznaczone są opcje Podmiot1 i Podmiot2.
Domyślnie zaznaczone są opcje Podmiot1 i Podmiot2.


* okres za jaki chcesz pobrać faktury - tu musisz podać daty od i do.
* '''okres za jaki chcesz pobrać faktury''' - tu musisz podać daty od i do. Możesz również skorzystać z możliwości wybrania konkretnego okresu czasu klikając ''Podstaw daty...''.
 
 
{{Yellow|KSeF pozwala pobrać '''16 faktur na minutę''' oraz maksymalnie '''64 faktur na godzinę'''.}}
 
 
[[Plik:Pobieranie.jpg|brak]]
 


{{Red|Ważne: KSeF pozwala wybrać maksymalnie okres o długości trzech miesięcy. Zalecamy znacznie krótsze okresy.}}
{{Red|Ważne: KSeF pozwala wybrać maksymalnie okres o długości trzech miesięcy. Zalecamy znacznie krótsze okresy.}}
Linia 67: Linia 74:


{{Green|Program nie pozwoli na zapisanie w bazie duplikatów faktury KSEF}}
{{Green|Program nie pozwoli na zapisanie w bazie duplikatów faktury KSEF}}
[[Plik:Pobierz i zapisz faktury ksef.jpg|brak]]


==Ponowne użycie sesji==
==Ponowne użycie sesji==
Linia 74: Linia 83:
* wyłączenia programu
* wyłączenia programu


Po powrocie do firmy, również po restarcie OGNIKA czy komputera - w większości przypadków możesz wznowić sesję przyciskiem "Użyj ten sesji" o ile:
Po powrocie do firmy, również po restarcie OGNIKA czy komputera - w większości przypadków możesz wznowić sesję przyciskiem "Użyj wybranej sesji" o ile:
* jest ona jeszcze ważna.
* jest ona jeszcze ważna.
* nie została zamknięta niezależnie od OGNIKA lub w innej instancji OGNIKA.
* nie została zamknięta niezależnie od OGNIKA lub w innej instancji OGNIKA.
Linia 80: Linia 89:
Sesje, których nie zamkniesz zamykają się wraz z upływem ich ważności. Ognik nie pozwoli na użycie sesji, której ważność wygasła.
Sesje, których nie zamkniesz zamykają się wraz z upływem ich ważności. Ognik nie pozwoli na użycie sesji, której ważność wygasła.
Żeby zamknąć aktywną sesję - musisz mieć aktywną jakąś sesję. Jeśli wszystkie sesje wygasły nie trzeba nic więcej z nimi robić.
Żeby zamknąć aktywną sesję - musisz mieć aktywną jakąś sesję. Jeśli wszystkie sesje wygasły nie trzeba nic więcej z nimi robić.
[[Plik:Wybrana sesja.jpg|brak]]


==Okno logów==
==Okno logów==
Linia 85: Linia 96:
Ramka na dole zawiera szczegółowe logi z operacji, jakie wykonuje program. Mogą one być przydatne, w razie kłopotów z dostępem do KSeF.
Ramka na dole zawiera szczegółowe logi z operacji, jakie wykonuje program. Mogą one być przydatne, w razie kłopotów z dostępem do KSeF.
Logi są dodatkowo zapisywane w katalogu programu, w podkatalogu LOG, jako pliki o nazwie zawierającej symbol firmy, datę i dopisek ksef-log, np. SYSTEM_20260201_ksef_log.txt
Logi są dodatkowo zapisywane w katalogu programu, w podkatalogu LOG, jako pliki o nazwie zawierającej symbol firmy, datę i dopisek ksef-log, np. SYSTEM_20260201_ksef_log.txt
[[Plik:Log.jpg|brak]]


{{Green|Ważne: logi nie zawierają pełnych tokenów dostępowych do sesji, certyfikatów, czy haseł - te dane są "obcięte" do początkowych kilkudziesięciu znaków}}
{{Green|Ważne: logi nie zawierają pełnych tokenów dostępowych do sesji, certyfikatów, czy haseł - te dane są "obcięte" do początkowych kilkudziesięciu znaków}}
{{Yellow|Ważne: logi mogą zwierać dane pobranych faktur.}}
{{Yellow|Ważne: logi mogą zwierać dane pobranych faktur.}}

Aktualna wersja na dzień 08:43, 10 kwi 2026

Okno OGNIK.KSeF służy do nawiązywania sesji z KSeF. Sesja KSeF to czasowe połączenie użytkownika (lub systemu firmy) z systemem KSeF w kontekście wybranego numeru NIP/Firmy, w ramach którego można wykonywać różne operacje, np.: pobierać faktury, wysyłać faktury do KSeF

Zobacz nasz filmik Jak połączyć się z KSeF w Ogniku na YouTube.

Panel górny

  • NIP kontekstu - Tu widać kontekst w jakim możesz pracować w KSEF - jest to numer NIP-u jednostki.
  • ID. Wewn - opcjonalny ID. Wewn.
  • Środowisko - na jakie łączymy się w kontekście danego podmiotu.
  • Ramkę z komunikatami
  • Zamknij okno (po jego użyciu okno zniknie, ale sesja pozostanie aktywna w tle)
Panel gorny sesja ksef1.jpg

Lista sesji

Tabela zawiera listę nawiązanych przez Ciebie sesji z KSeF. Zacznijmy od nawiązania pierwszej sesji.

Pierwsza sesja z KSeF

Aby nawiązać połączenie (sesję) z KSeF potrzebujesz:

Nawiązywanie sesji

Kliknij przycisk [Inicjuj nową sesję] Okienko się zmieni i zobaczysz trzy opcje do wyboru, wybierz odpowiednią do narzędzia autoryzacyjnego jakie posiadacz i kliknij ją.

Inicjuj nowa sesje1.jpg


W przypadku:

  • Certyfikatu kwalifikowanego - program poprosi o wskazanie certyfikatu a następnie o podanie PIN-u analogicznie, jak przy podpisywaniu dokumentów czy też wysyłaniu JPK czy e-Deklaracji. Jeśli podane dane są prawidłowe a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.
  • Certyfikatu KSeF - po kliknięciu zobaczysz liczbę dostępnych certyfikatów KSEF. Wybierz jeden i kliknij [Połącz używając certyfikatu KSEF]. Jeśli zapisując w programie certyfikat z KSeF zostało zapisane również hasło - program zapyta o PIN, który tam nadałeś. Jeśli nie podałeś hasła - program zapyta o hasło. Jeśli podane dane są prawidłowe a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.
  • Profilu Zaufanego - program wygeneruje plik i zaproponuje zapisanie go na dysku komputera. Odszukaj ten plik. Podpisz go na stronie MF, pobierz podpisany na swój komputer i wczytaj do programu. (Analogicznie działasz np. przy wysyłaniu niektórych deklaracji przez strony MF.) Po wczytaniu pliku - jeśli został on prawidłowo podpisany a Ty masz uprawnienia do zalogowania się w kontekście danego podmiotu - sesja zostanie nawiązana. Stosowne komunikaty zobaczysz w ramce na dole okna.


Polacz za pomoca1.jpg

Po nawiązaniu sesji z KSeF zostanie ona zapisana na liście sesji i aktywowana. Jeśli masz w KSeF stosowne uprawnienie (np. do przeglądania faktur) - możesz teraz pobierać faktury z KSeF.

Pobieranie faktur

Do ustawienia masz opcje

  • rodzaj faktur
    • Podmiot1 - czyli te, gdzie to Ty jesteś sprzedawcą
    • Podmiot2 - faktury zakupu
    • Podmiot3 - gdzie występujesz w dodatkowych rolach. (Pole zawierający dane podmiotu trzeciego np. faktora albo płatnika)
    • PodmiotUP - opcjonalnie, zwykle nie potrzebujesz pobierać tych faktur. (tj. komornik sądowy, organ egzekucyjny i przedstawiciel podatkowy)

Domyślnie zaznaczone są opcje Podmiot1 i Podmiot2.

  • okres za jaki chcesz pobrać faktury - tu musisz podać daty od i do. Możesz również skorzystać z możliwości wybrania konkretnego okresu czasu klikając Podstaw daty....


KSeF pozwala pobrać 16 faktur na minutę oraz maksymalnie 64 faktur na godzinę.


Pobieranie.jpg


Ważne: KSeF pozwala wybrać maksymalnie okres o długości trzech miesięcy. Zalecamy znacznie krótsze okresy.

Jeśli napotkasz problemy z pobieraniem faktur - wybierz tylko jeden rodzaj podmiotu, skróć okres, za jaki pobierasz faktury i spróbuj ponownie.

W razie problemów z pobieraniem faktur sprawdzaj oficjalne komunikaty o działaniu/awariach KSeF

Lista pobranych faktur

Jeśli program znajdzie w KSeF faktury pasujące do podanych parametrów wyświetli je na liście. Kliknij [Pobierz i zapisz faktury do OGNIK.SOD] a program zapisze je w bazie.

Program nie pozwoli na zapisanie w bazie duplikatów faktury KSEF

Pobierz i zapisz faktury ksef.jpg

Ponowne użycie sesji

Jeśli sesja została już uruchomiona, po wejściu to okno zobaczysz informację w górnej ramce. Uruchomiona sesja z KSef utrzymuje się do czasu:

  • zmiany firmy
  • wyłączenia programu

Po powrocie do firmy, również po restarcie OGNIKA czy komputera - w większości przypadków możesz wznowić sesję przyciskiem "Użyj wybranej sesji" o ile:

  • jest ona jeszcze ważna.
  • nie została zamknięta niezależnie od OGNIKA lub w innej instancji OGNIKA.

Sesje, których nie zamkniesz zamykają się wraz z upływem ich ważności. Ognik nie pozwoli na użycie sesji, której ważność wygasła. Żeby zamknąć aktywną sesję - musisz mieć aktywną jakąś sesję. Jeśli wszystkie sesje wygasły nie trzeba nic więcej z nimi robić.

Wybrana sesja.jpg

Okno logów

Ramka na dole zawiera szczegółowe logi z operacji, jakie wykonuje program. Mogą one być przydatne, w razie kłopotów z dostępem do KSeF. Logi są dodatkowo zapisywane w katalogu programu, w podkatalogu LOG, jako pliki o nazwie zawierającej symbol firmy, datę i dopisek ksef-log, np. SYSTEM_20260201_ksef_log.txt

Log.jpg

Ważne: logi nie zawierają pełnych tokenów dostępowych do sesji, certyfikatów, czy haseł - te dane są "obcięte" do początkowych kilkudziesięciu znaków

Ważne: logi mogą zwierać dane pobranych faktur.