Prezentacja dotycząca Krajowego Systemem e-Faktur KSEF od strony technicznej i praktycznej ze spotkania Gorzów IT w dniu 01.02.2024

1. Krajowy System e-Faktur
Technicznie i praktycznie
Tomasz Gibulski
tomasz@gibulski.com
www.gibulski.com

2. Planowany przebieg spotkania
• Przedstawienie ogólnych i technicznych informacji dotyczących KSeF
• Część praktyczna
o Aplikacja Podatnika KSeF przygotowana przez MF
o Aplikacja komunikująca się z KSeF poprzez API
▪ Nawiązanie połączenia
▪ Wysłanie faktury do KSeF
▪ Odebranie faktury z KSeF
• Zakończenie i podsumowanie spotkania

3. Faktury w Polsce
• Faktury papierowe
o Wystawiane komputerowo i drukowane
o Wypisywane ręcznie
• Faktury przekazywane w formie elektronicznej
o PDF
o Inne formaty przedstawiające graficzny obraz faktury
• Faktury elektroniczne
o Różne formaty
▪ EDI
▪ Formaty producentów oprogramowania
o PEF (faktury - zamówienia publiczne)
o Ustrukturyzowana forma KSeF

4. Rodzaje handlu
• B2B (Business To Business)
• B2C (Business To Customer)
• B2G (Business To Government)

5. Krajowy System
e-Faktur (KSeF)
• Ogólnopolski system teleinformatyczny
stworzony w celu cyfryzacji procesu
fakturowania.
• Centralna baza faktur,
• System umożliwiający podatnikom wystawi
anie, udostępnianie i odbieranie faktur
ustrukturyzowanych.

6. Faktura
ustrukturyzowana
format XML
XML (ang. Extensible Markup Language, rozszerzalny język znaczników) – uniwersalny język znaczników przeznaczony do
reprezentowania różnych danych w strukturalizowany sposób)

7. Schemat
XSD
definicja struktury faktury
XML Schema Definition (XSD) standard służący do definiowania struktury dokumentu XML wykorzystywany do komunikacji
pomiędzy systemami teleinformatycznymi.

8. Schemat
XSD (2)
definicja struktury faktury

9. Numer faktury KSeF
• Każda faktura pomyślnie zarejestrowana / wystawiona w systemie
KSeF otrzymuje unikalny numer tzw. numer KSeF.

10. Numer faktury KSeF

11. Podstawy
korzystania z
KSeF
• Uwierzytelnienie i autoryzacja danej osoby w systemie
• Po uwierzytelnieniu w systemie
o Przeglądanie faktur
o Wystawianie faktur
o Otrzymywanie faktur
o Nadawanie, zmiana lub odbieranie uprawnień:
▪ Elektronicznie poprzez aplikację webową
(ksef.mf.gov.pl)
▪ Papierowej przez złożenie urzędu skarbowego
zawiadomienia ZAW-FA

12. Uwierzytelnianie
podmiotów
• Kwalifikowany podpis elektroniczny
• Kwalifikowana pieczęć elektroniczna
• Profil zaufany
• Token autoryzacyjny
(ciąg znaków alfanumerycznym przypisanym do podatnika lub podmiotu
uprawnionego i jego uprawnień).

13. Uwierzytelnianie i Autoryzacja
• Uwierzytelnianie
to potwierdzenie, że jesteśmy tym, za kogo się podajemy,
czyli inaczej mówiąc potwierdzenie swojej tożsamości
• Autoryzacja
to proces określania uprawnień danego podmiotu.
Pozwala na stwierdzenie czy dany podmiot (np. osoba)
posiada dostęp do danego zasobu (np. folderu, funkcji, itp.)

14. KSeF - Dostępne środowiska
• Środowisko testowe
https://ksef-test.mf.gov.pl/
• Środowisko przedprodukcyjne
https://ksef-demo.mf.gov.pl/
• Środowisko produkcyjne
https://ksef.mf.gov.pl/

15. Aplikacja webowa
• Środowisko testowe
https://ksef-test.mf.gov.pl/web
• Środowisko przedprodukcyjne
https://ksef-demo.mf.gov.pl/web
• Środowisko produkcyjne
https://ksef.mf.gov.pl/web

16. Demo
Aplikacja Podatnika KSeF
• Uwierzytelnienie i autoryzacja w aplikacji webowej
• Omówienie funkcjonalności dostępnej w aplikacji webowej
o Wystawianie faktury
o Lista faktur
o Historia sesji
o Nadawanie i zarządzanie uprawnieniami
o Generowanie i unieważnianie tokenów

17. KSeF API

18. KSeF API
• Środowisko testowe
https://ksef-test.mf.gov.pl/api
• Środowisko przedprodukcyjne
https://ksef-demo.mf.gov.pl/api
• Środowisko produkcyjne
https://ksef.mf.gov.pl/api

19. Dokumentacja OpenApi
• Kontrakt interfejsów interaktywnych
https://ksef-test.mf.gov.pl/openapi/gtw/svc/api/KSeF-online.yaml
• Kontrakt wysyłki wsadowej
https://ksef-test.mf.gov.pl/openapi/gtw/svc/api/KSeF-batch.yaml
• Kontrakt interfejsów wspólnych
https://ksef-test.mf.gov.pl/openapi/gtw/svc/api/KSeF-batch.yaml

20. Metody HTTP
•

21. KSeF API

22. KSeF API (2)

23. KSeF API (3)

24. Inicjalizacja
sesji
1. Pobranie wyzwania autoryzacyjnego
1. Pobranie wyzwania autoryzacyjnego
2. Inicjalizacja sesji
a. Poprzez podpis kwalifikowany
b. Poprzez token autoryzacyjny

25. Wysłanie
i pobieranie
faktury
1. Wysłanie faktury

26. Demo
Komunkacja z KSeF
poprzez API
• Nawiązanie sesji z usługą KSeF
• Wysłanie faktury do KSeF
• Pobranie statusu wysłanej faktury i nr KSeF
• Pobranie faktury
• Rozłączenie się z usługą KSeF

27. Podsumowanie spotkania
Poruszane tematy:
• Informacje techniczne związane z KSeF
• Dostęp do systemu poprzez Aplikację Podatnika KSeF
• Komunikacja z system KSeF poprzez API

28. Przydatne linki dotyczące KSeF
• Krajowy System e-Faktur
https://www.podatki.gov.pl/ksef/
• Krajowa Administracja Skarbowa
https://www.gov.pl/web/kas/krajowy-system-e-faktur
• Specyfikacje interfejsu produkcyjnego
https://ksef.mf.gov.pl/
• Pliki do pobrania KSeF
https://www.podatki.gov.pl/ksef/baza-wiedzy-ksef/pliki-do-pobrania-ksef/

29. Proponowane tematy kolejnych spotkań
• Tworzenie aplikacji webowych w Blazor
• Tworzenie aplikacji mobilnych w .Net MAUI
• Narzędzia usprawniające pracę z komputerem
• Tematy, z którymi chcecie się podzielić z innymi ...

30. Dziękuję za uwagę :)