(draft)
1. Dane DEMO dla KSeF. Kolejne kroki
2. ...
3. ...
4. Tematy powiązane
1. Dane DEMO dla KSeF. Kolejne kroki
Zadanie: Utworzyć przykładową firmę z danymi DEMO (MT Meble Tapicerowane)
i przygotować środowisko do pracy z KSeF.
Opisano kolejne kroki (czynności) przygotowania Trawers ERP do pracy z KSeF
z wykorzystaniem przykładowych danych DEMO.
13.07.2023 Kolejne kroki
Dopisanie firmy z danymi DEMO
Profil [2] Meble tapicerow Edukacyjne 07/2026
Karta firmy (podmiotu)
-----------------------------------------------------------------------
NIP 3393182435 REGON 790917672 ILN 2000000000000
----o----
|
v
NIP firmy DEMO
(zarejestrowany bez przeszkód w KSeF) #00054527
...
...
Status podatnika [0] Podatnik działający (domyślnie)
JPK_KR_PD: Rodzaj jednostki [7] Jedn.Pozostała CIT-Est [N] MSSF [N]
-----------------------------o----------------------------o----------o-
| | |
v v v
Rodzaj jednostki Jest podatnikiem Stosuje MSSF ?
CIT estońskiego ?
Utworzona firma DEMO ma NIP: 3393182435, który jest identyfikatorem umożliwiającym
dostęp do systemu KSeF oraz wystawianie i odbiór e-faktur.
Zbiory danych
Podczas dopisywania danych DEMO program utworzy zbiory dokumentów okresowych
(miesiące 01..12) roku 2026
Dopisane dane
Patrz PM > STATYSTYKI BAZ DANYCH
Zestawienie dopisanych danych --> Dane branżowe (demo)
Dane początkowe. BranżoweSprawdzanie certyfikatu
Certyfikaty KSeF dla NIP: 3393182435
P: Jak sprawdzić certyfikat ?
O: AD > Parametry AD > [AD_TPA20]
Środowisko KSeF --> [T] Środowisko Testowe
AD > KSeF > Tabele > Certyfikaty KSeF
W tabeli wskazać typ [U] + F2 > [2] Zaloguj do KSEF tym certyfikatem
Odpowiedz KSeF:
----------------------------------------------------------
Uwierzytelniono w KSeF. Pobrano AccessToken i RefreshToken
----------------------------------------------------------
Uprawnienia do certyfikatów i skrzynek
Oper AA: Oznaczyć [*] skrzynkę KSeF / Dać uprawnienia
AD > Operatorzy i role
Nadawanie uprawnień i warunków > Skrzynki KSeF
---------------------------------------------------------
| Adam Abacki Administrator--------o
| <AA BB DD GN
|NA Sprzedaż, należności
| NA0000 Główna (NA) .................. T - - -
|ZO Zakupy, zobowiązania
| ZO0000 Główna (ZO) .................. T - - -
---------------------------------------------------------
Przypisanie certyfikatu do operatora --> Certyfikaty KSeF [test] [AD_TCE01]
o-- Operatorzy uprawnieni do Certyfikatu KSeF --------------------------[X]o
| |
| Certyfikat U00001 Uwierzytelnienie Ważny do 2028.07.10 |
| Nr seryjny 01BFE28179FADC96 Typ U Uwierzytelnienie Status A |
|--------------------------------------------------------------------------|
| Operatorzy |
| ------------------------------------------ |
| AA Adam Abacki Administrator |
| |
o--------------------------------------------------------------------------o
Wystawianie faktury sprzedaży
AD > KSeF > Parametry KSeF. Harmonogram [AD_TPK22]
Wysyłać faktury do KSeF ? -->[T]
NA > Sprzedaż > Faktury sprzedaży [NA_DFA10]
------------------------------------------------
000001 Odbiorca 1 Hurtownia Mondis
Dokument FA0001/07/26
Poz. 1 /.USLUGW-1 Sprzedaż usługi własnej [Uw]
Il: 1.000 Cena: 240.00
------------------------------------------------
Przed zatwierdzeniem [ ] faktury:
Funkcje (zakładki):
KSeF: Pokaż fakturę KSeF FA(3) XML
KSeF: Wizualizacja faktury KSeF
KSeF: Zapis faktury wg wzoru z CRWDE
Po zatwierdzeniu [v] faktury:
Funkcje (zakładk):
KSeF: Przygotuj dla KSeF
Czy przygotować fakturę FA0001/07/26 dla KSeF (XML,SHA) - bez wysyłki ?
--> [Tak]
------------------------------------------------------------
Faktura FA0001/07/26 000001: Przygotowano dla KSeF (XML,SHA)
------------------------------------------------------------
Patrz opis: 3.2 Przygotowanie do wysłania
KSeF: Wyślij do KSeF
Kolejne kroki:
TODO opisać szczegółowo
KSeF [test]: Operator AA nie ma przypisanego Certyfikatu KSeF typu [U]
Trzeba:
Operatorzy uprawnieni do Certyfikatu KSeF
Operatorzy > F8-dopisz --> [AA] + Oznacz [*]
Powtórzenie: KSeF: Wyślij do KSeF
Błąd przetwarzania faktury KSeF: 440
'Duplikat faktury'
Szczegóły w F10
---------------------------------------------------------------------
Wysyłanie faktur do KSeF [test]: NA / NA0000 / Do wysłania [NA_DFA20]
(Sesja OnLine)
1/6 Sprawdzanie faktur do wysłania... (NA)
OK: Faktur do wysłania: 1
(FA) FA0001/07/26 000001 Odbiorca 1 Hurtownia Mondis
U2cFinwnVXl9LPFSMQuQ9feQ2nvfsHYjSd2QSvrRntg=
2/6 Łączenie z KSeF... (NA)
OK
3/6 Otwarcie sesji Online... (NA)
OK. Numer sesji: 20260713-SO-3F6D0CC000-3AAFB25903-81
4/6 Przygotowanie faktur do wysyłki... (NA)
OK
5/6 Wysyłanie faktur... (NA)
KSeF: Pokaż / Pobierz UPO (xml)
KSeF: Pokaż status faktury w Panelu KSeF
***************************************************************************************
***************************************************************************************
***************************************************************************************
Poniżej notatki ... - do uporządkowania
* Utworzyc dane demo MT Meble Tapicerowane
Dane 01-12/2026
* Oznaczyć (*) jako domyslną
* Parametry AD [AD_TPA20]
> Środowisko KSeF
T Środowisko Testowe
D Środowisko Demo
P Środowisko Produkcyjne
N Nie pracuje z KSeF
JD-->RK ktore wybrac w tym przypadku (dane demo),
dlaczego i jakie kolejne ustawienia ?
RK: Można przyjąć: Środowisko KSeF [T]
żeby KSEF był aktywny w TR, bo jest obowiązujący.
Ale: w karcie firmy MT użytkownik będzie musiał podać swój NIP
aby na ten NIP wygenerować sobie certyfikaty KSEF.
Ogólny NIP np. 1111111111 nie nadaje się do testów KSEF,
bo każdy w każdej chwili może unieważnić certyfikat
i utworzyć sobie nowy.
JD-->RK czy mogę w danych demo, dla testów, podać NIP Tresu?
NOTE RK: Tak, można. W środowisku Testowym KSEF
każdy może zalogować się na każdy NIP
i wykonywać wszystkie operacje.
Nie ma żadnych skutków prawnych.
Jest też ostrzeżenie, aby nie udostępniać w tym środowisku
danych wrażliwych.
Możemy w danych demo wpisać certyfikaty KSEF testowe.
Skrzynki KSEF przyjąć te, które tworzy FILL_482()
+ nadać uprawnienia operatorom do tych skrzynek
Foldery KSEF same się utworzą --> FILL_483()
W param KSEF Oznaczyć: Wysyłać faktury do KSeF ? [T]
Nie tworzyć Profili KSEF dla kontrahentów.
---- RK: koniec ----
* Skrzynki KSeF
Są 2 skrzynki - pokaz [AD_TBX00]
Są też foldery - pokaz
10 Pobrane
20 Zapisane
30 Wysłane
40 Do wysłania
50 SCAM
60 Ukryte
* Nadac uprawnienia do skrzynek operatorowi AA
Bo w Panel KSeF jest info:
Operator [AA] nie ma uprawnień do skrzynek KSeF [NA]
* W Parametry KSeF - harmonogram [AD_TPK22]
Oznacz: Wysyłać faktury do KSeF ? -->T
Pozostale param domyślnie ? Ustal, sprawdz
* Wystawiam FA Odbiorca 1
Sprzedaż USLUGW-1 1 kpl
Musi byc zatwierdzona [v] Zatwierdzam
* --> KSeF: Przygotuj do KSeF
Faktura FA0001/07/26 000001: Przygotowano dla KSeF (XML,SHA)
KSeF: Wyślij do KSeF
KSeF [demo]: Operator AA nie ma przypisanego Certyfikatu KSeF typu [U]
co dalej ? szukam F1: CERTYFIKAT TYPU
TYP CERTYFIKATU
Tu opis: fil_trawersksef10desc.html
A co i jak zrobic dla testow, ktore opisuje ?
W Krajowym Systemie e-Faktur (KSeF) funkcjonują dwa główne typy certyfikatów:
typu 1 (do uwierzytelniania) oraz typu 2 (do fakturowania offline).
NOTE RK: nie: 'dwa główne typy'
tak: 'dwa typy'
Jeśli pod pojęciem 'certyfikat KSeF typ U' masz na myśli certyfikat uwierzytelniający
(często tak oznaczany)
Certyfikat generuje się bezpłatnie bezpośrednio przez Aplikację Podatnika KSeF.
JD-->RK Co można zrobic bez certyfikatu ?
RK: Są tylko dwa typy certyfikatów KSeF:
[U] Uwierzytelnienie - używany do podpisu żądania autoryzacyjnego przy uwierzytelnianiu
[P] Podpis linku - do podpisu linku weryfikacyjnego --> KSEF_Link_2_Podpis()
--- JD: Opis nowy
W menu NA > Sprzedaż > Dokumenty > F2-cd:
i NA > Sprzedaż > Panel KSeF
Są funkcje, które nie wymagaja kontaktu z KSeF (lokalne)
i funkcje, które wymagają kontaktu z KSeF.
Aby kontaktować się z KSeF użytkownik musi mieć certyfikat [U] lub [P].
NOTE RK: nie: '[U] lub [P]'
tak: '[U] oraz [P]'
[U] aby się połączyć z KSEF (zawsze wymagany)
[P] aby podpisać link weryfikacyjny drukowany jako QR
na fakturze drukowanej (papier, pdf) w trybie OFFLINE.
Certyfikat [P] nie jest potrzebny, gdy pracujemy ONLINE.
Patrz niżej: NOTE RK CERTYFIKATY:
NOTE RK: Oznaczenia [U] [P] [ ] 'v' '-' nie są czytelne.
Proponuję opis słowny: Nie wymaga certyfikatów / Wymaga ...
Poniżej przedstawiono listę funkcji dotyczących KSeF wraz z określeniem,
czy wymagają certyfikatów KSeF.
Dok NA > F2-cd:
----------------------------------------- Wymaga certyfikatów KSeF ?
KSeF: Pokaż fakturę KSeF FA(3) XML Nie
KSeF: Wizualizacja faktury KSeF Nie / Wymaga [P], gdy wydruk dla klienta w trybie OFFLINE (bez numeru KSeF)
KSeF: Zapis faktury wg wzoru z CRWDE Nie
KSeF: Przygotuj dla KSeF Nie
KSeF: Wyślij do KSeF Wymaga [U]
KSeF: Pokaż / Pobierz UPO (xml) Nie / Wymaga [U] do pobrania
KSeF: Pokaż status faktury w Panelu KSeF Nie
(1) INFO: KSeF [test]: Operator AA nie ma przypisanego Certyfikatu KSeF typu [P]
lecz pokazuje fakturę TODO wyjaśnić
RK: Jest tak, aby umożliwić podgląd faktury każdemu (w celu sprawdzenia treści)
na różnych etapach przetwarzania faktury:
Gdy FA niezatwierdzona: bez kodów QR
Gdy FA zatwierdzona: bez kodów QR
Gdy FA zatwierdzona i wykonano 'Przygotuj dla KSeF' (ma XML,SHA): dwa kody QR:
Kod 1: 'Sprawdź fakturę w KSeF'
Kod 2: 'Zweryfikuj wystawcę' <-- do tego używany jest certyfikat [P]
Gdy nie ma, to nie drukuje tego kodu
Gdy FA zatwierdzona i jest numer KSeF: jeden kod QR:
Kod 1: <numer KSeF>
Certyfikat [P] jest wymagany, gdy chcemy przekazać wydruk/pdf klientowi w trybie OFFLINE,
bo wtedy musimy nanieść drugi kod QR z linkiem weryfikacyjnym podpisanym właśnie certyfikatem [P].
(2) INFO: KSeF [test]: Operator AA nie ma przypisanego Certyfikatu KSeF typu [U]
TODO wyjaśnić, czy wysyła gdy [P]
RK: Do wysyłki wymagany jest [U]. [P] nie jest związany z wysyłką (komunikacją)
(3) TODO czy jest opis uzyskanego raportu ?
RK: nie ma jeszcze opisów raportów KSEF
Panel KSeF
----------------------------------------- Wymaga certyfikatów KSeF ?
2 Wyślij do KSEF bieżącą fakturę Wymaga [U]
3 Metadane, status, UPO
1 Pokaż / Pobierz UPO (XML) faktur(y) Nie / Wymaga [U] do pobrania
2 Pokaż / Pobierz status faktur(y) Nie / Wymaga [U] do pobrania
3 Pokaż metadane faktury Nie
4 Pokaż status faktury Nie
7 Wizualizacja faktury KSEF (F4) Nie / Wymaga [P], gdy wydruk dla klienta w trybie OFFLINE (bez numeru KSeF)
8 Zapisz i pokaż wizualizację (CRWDE) Nie
9 Pokaż / Zapisz treść XML Nie
a Pokaż fakturę sprzedaży NA Nie
TODO: Wskazać różnice w porównaniu z: Dok NA > F2-cd:
TODO dla ZO
NOTE RK CERTYFIKATY:
Żeby dobrze zrozumieć ideę typów certyfikatów KSeF i kodów weryfikujących QR
warto przeczytać:
(A) https://github.com/CIRFMF/ksef-api/blob/main/certyfikaty-KSeF.md
(B) https://ksef.podatki.gov.pl/media/qzlha3vx/podrecznik-ksef-20-cz-ii-wystawianie-i-otrzymywanie-faktur-w-ksef-20260209.pdf
str. 83, p.5.4 Kody weryfikujące
(C) https://ksef.podatki.gov.pl/media/20shej34/aplikacja-podatnika-ksef-20-podrecznik-uzytkownika_01042026.pdf
str. 150, p.5.7 Certyfikaty
(D) https://ksef.podatki.gov.pl/media/sthoiadq/podrecznik-ksef-20-cz-i-rozpoczecie-korzystania-z-ksef-25032026.pdf
str. 41, p.2.5. Certyfikat KSeF
NOTE: W dokumentacji Aplikacji Podatnika (C)
jest pojęcie [Przeznaczenie certyfikatu]:
W polu [1] Przeznaczenie certyfikatu należy wybrać jedną z dwóch dostępnych opcji:
* Podpis linku weryfikacyjnego wystawcy
* Uwierzytelnienie w systemie KSeF
NOTE: W Aplikacji podatnika https://ap-test.ksef.mf.gov.pl/web/certificates/certificate-list
w menu Lista certyfikatów, jest tabelka z kolumną:
[Przeznaczenie]. Są tam dwie możliwe wartości:
Uwierzytelnienie
Podpis linku
NOTE: W dokumentacji (D) są pojęcia:
* CERTYFIKAT TYPU 1 DO UWIERZYTELNIENIA
Certyfikat KSeF typu 1 przeznaczony jest do uwierzytelniania się w systemie KSeF
* CERTYFIKAT TYPU 2 DO WYSTAWIANIA FAKTUR OFFLINE
Certyfikat KSeF typu 2 wymagany jest do oznaczenia faktury kodem umożliwiającym
potwierdzenie tożsamości wystawcy przy wystawianiu faktur w trybie OFFLINE (tj. w trybie
offline24, offline-niedostępność systemu, trybie awarii KSeF).
NOTE: W specyfikacji (A) jest pojęcie [Typ]
Typ
Authentication
Certyfikat przeznaczony do uwierzytelniania w systemie KSeF.
keyUsage: Digital Signature (80)
Offline
Certyfikat przeznaczony wyłącznie do wystawiania faktur w trybie offline.
Używany do potwierdzania autentyczności wystawcy i integralności faktury
poprzez kod QR II. Nie umożliwia uwierzytelnienia.
keyUsage: Non-Repudiation (40)
NOTE: W Trawersie przyjąłem pojęcie [Typ] (wg dokumentacji i specyfikacji)
a opisy typów z Aplikacji Podatnika KSEF (AP), żeby użytkownik widział
zgodność opisów w Trawers z AP, gdy :
[P] Podpis linku
[U] Uwierzytelnienie
--> class TrTab_ksef2_certType w __cls/TrKsef2CertOkno.prg
------ JD opis nowy - koniec
------ opis poprzedni
Dok NA/ZO > F2-cd:
Bez [U]
Można wszystkie funkcje z wyjątkiem wysyłki.
+ KSeF: Pokaż fakturę KSeF FA(3) XML
+ KSeF: Wizualizacja faktury KSeF
+ KSeF: Zapis faktury wg wzoru z CRWDE
+ KSeF: Przygotuj dla KSeF
Bez [P]
Można wszystkie funkcje z wyjątkiem wysyłki.
Nie pokaże kodu QR (link weryfikacyjny)
JD-->RK gdzie zwykle pokazuje kod QR (link weryfikacyjny) ?
Panel KSeF
Bez [U]
Bez [P]
Nie można wysłać ani pobrać z KSEF
Można
+ KSeF: Pokaż fakturę KSeF FA(3) XML
+ KSeF: Wizualizacja faktury KSeF
+ KSeF: Zapis faktury wg wzoru z CRWDE
+ KSeF: Przygotuj dla KSeF
---- opis poprzedni- koniec
***************************************************************************************
***************************************************************************************
***************************************************************************************
Tu opisuje fakturę KFZ do trzech faktur sprzedazy
Patrz Kolejne kroki by AI
FK Faktura korygująca zbiorcza [FKZ]
DECYZJA Czy rejestrowana jest korekta zbiorcza [FKZ] ?
Okres 2026/05 do 2026/07
| | Numer Data Numer FA / Numer KSeF [*] | |
| | ------------ -------- ---------------------------------------- - | |
| | FA0001/06/26 26.06.30 * | |
| | FA0001/07/26 26.07.02 * | |
Drukuj: 1 Lista dokumentów
2 Lista asortymentu
Wszystkie faktury są oznaczone [*]
Korekta będzie dotyczyła całego okresu
Na fakturze korekty zbiorczej można wybrać tylko pozycje [U] Rabat
Wprowadzamy: Rabat od całej faktury [U] - kwoty w podziale na stawki PTU
o------------------------------------------------------------------------------o
| Poz 1 |
| |
| PTU Stawka(%) Rabat(%) Kwota |
| 01 23.00 10.00 -66.42 |
| |
| Sprzedaż netto 540.00 |
| PTU należny 124.20 |
| --------- Dekretacja ---------------- Wartość |
| Netto-rabat AP-/ Korekta sprzedaży usług -54.00 |
| PTU-rabat AT-/ Korekta VAT (-) -12.42 |
o------------------------------------------------------------------------------o
| Razem -66.42 |
o------------------------------------------------------------------------------o
Przeglądamy fakturę korygującą:
o-- Faktura korygująca [FK] 2026/07 [NA_DFK10] -----------------------------[X]o
| Saldo odbiorcy = 664.20 |
o------------------------------------------------------------------------------o
| |
| |
o--- Pozycje -----------------------------------------------------------------o
|Poz --- Indeks ----- -Wartość korekty- |
|U 1 Rabat od wartości wg stawki PTU 01 -66.42 |
| |
o------------------------------------------------------------------------------o
| Razem -66.42 |
o------------------------------------------------------------------------------o
TODO: zatwierdzić, wysłać do KSeF