SlideShare a Scribd company logo
Krajowy System e-Faktur
Technicznie i praktycznie
Tomasz Gibulski
tomasz@gibulski.com
www.gibulski.com
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
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
Rodzaje handlu
• B2B (Business To Business)
• B2C (Business To Customer)
• B2G (Business To Government)
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.
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)
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.
Schemat
XSD (2)
definicja struktury faktury
Numer faktury KSeF
• Każda faktura pomyślnie zarejestrowana / wystawiona w systemie
KSeF otrzymuje unikalny numer tzw. numer KSeF.
Numer faktury KSeF
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
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ń).
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.)
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/
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
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
KSeF API
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
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
Metody HTTP
•
KSeF API
KSeF API (2)
KSeF API (3)
Inicjalizacja
sesji
1. Pobranie wyzwania autoryzacyjnego
1. Pobranie wyzwania autoryzacyjnego
2. Inicjalizacja sesji
a. Poprzez podpis kwalifikowany
b. Poprzez token autoryzacyjny
Wysłanie
i pobieranie
faktury
1. Wysłanie faktury
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
Podsumowanie spotkania
Poruszane tematy:
• Informacje techniczne związane z KSeF
• Dostęp do systemu poprzez Aplikację Podatnika KSeF
• Komunikacja z system KSeF poprzez API
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/
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 ...
Dziękuję za uwagę :)

More Related Content

Similar to Krajowy System e-Faktur KSEF technicznie i praktycznie

V doc prezentacja_szablon_05-2010
V doc prezentacja_szablon_05-2010V doc prezentacja_szablon_05-2010
V doc prezentacja_szablon_05-2010
Artur Zasiewski
 
Jak efektywnie pracować z pulpitami cash flow?
Jak efektywnie pracować z pulpitami cash flow?Jak efektywnie pracować z pulpitami cash flow?
Jak efektywnie pracować z pulpitami cash flow?
ControllingSystems.pl
 
Dokumentacja cen transferowych według nowych przepisów
Dokumentacja cen transferowych według nowych przepisów Dokumentacja cen transferowych według nowych przepisów
Dokumentacja cen transferowych według nowych przepisów
PwC Polska
 
Isof dla biur rachunkowych
Isof dla biur rachunkowychIsof dla biur rachunkowych
Isof dla biur rachunkowych
244624
 
Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę
Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę
Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę
Mindbox
 
Webinarium e faktury prezentacja
Webinarium e faktury prezentacjaWebinarium e faktury prezentacja
Webinarium e faktury prezentacja
PwC Polska
 
Automatyzacja raportowania-podatkowego-finansowego
Automatyzacja raportowania-podatkowego-finansowegoAutomatyzacja raportowania-podatkowego-finansowego
Automatyzacja raportowania-podatkowego-finansowego
PwC Polska
 
Wybrane wdrożenia Comarch w sektorze administracji publicznej i utilities
Wybrane wdrożenia Comarch w sektorze administracji publicznej i utilitiesWybrane wdrożenia Comarch w sektorze administracji publicznej i utilities
Wybrane wdrożenia Comarch w sektorze administracji publicznej i utilities
Comarch
 
07.10.2021 Prezentacja o strefach praktycznie
07.10.2021 Prezentacja o strefach praktycznie07.10.2021 Prezentacja o strefach praktycznie
07.10.2021 Prezentacja o strefach praktycznie
PwC Polska
 
Zwinny_Analityk_SIW_Panel
Zwinny_Analityk_SIW_PanelZwinny_Analityk_SIW_Panel
Zwinny_Analityk_SIW_Panel
Rafal Stanczak »scrumdo(.)pl
 
Zastosowania systemu BCC ECM
Zastosowania systemu BCC ECMZastosowania systemu BCC ECM
Zastosowania systemu BCC ECM
BCC_Group
 
Rozliczanie projektów
Rozliczanie projektówRozliczanie projektów
Rozliczanie projektów
AEGEE-Warszawa
 
Wojciech Kosiński Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...
Wojciech Kosiński   Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...Wojciech Kosiński   Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...
Wojciech Kosiński Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...
nexik
 
ePUAP: Prezentacja Architektury
ePUAP: Prezentacja ArchitekturyePUAP: Prezentacja Architektury
ePUAP: Prezentacja Architektury
Comarch
 
Summit EOIF GigaCon 2017 - katalog
Summit EOIF GigaCon 2017 - katalogSummit EOIF GigaCon 2017 - katalog
Summit EOIF GigaCon 2017 - katalog
Justyna Cieślak
 
SSC Master overview
SSC Master overviewSSC Master overview
SSC Master overview
Krzysztof Lapacz
 

Similar to Krajowy System e-Faktur KSEF technicznie i praktycznie (20)

V doc prezentacja_szablon_05-2010
V doc prezentacja_szablon_05-2010V doc prezentacja_szablon_05-2010
V doc prezentacja_szablon_05-2010
 
Jak efektywnie pracować z pulpitami cash flow?
Jak efektywnie pracować z pulpitami cash flow?Jak efektywnie pracować z pulpitami cash flow?
Jak efektywnie pracować z pulpitami cash flow?
 
Dokumentacja cen transferowych według nowych przepisów
Dokumentacja cen transferowych według nowych przepisów Dokumentacja cen transferowych według nowych przepisów
Dokumentacja cen transferowych według nowych przepisów
 
Isof dla biur rachunkowych
Isof dla biur rachunkowychIsof dla biur rachunkowych
Isof dla biur rachunkowych
 
Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę
Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę
Automatyzacja Procesów Biznesowych (RPA) - Zmieniamy teorię w praktykę
 
EOD
EODEOD
EOD
 
Softmax
SoftmaxSoftmax
Softmax
 
Webinarium e faktury prezentacja
Webinarium e faktury prezentacjaWebinarium e faktury prezentacja
Webinarium e faktury prezentacja
 
Automatyzacja raportowania-podatkowego-finansowego
Automatyzacja raportowania-podatkowego-finansowegoAutomatyzacja raportowania-podatkowego-finansowego
Automatyzacja raportowania-podatkowego-finansowego
 
Wybrane wdrożenia Comarch w sektorze administracji publicznej i utilities
Wybrane wdrożenia Comarch w sektorze administracji publicznej i utilitiesWybrane wdrożenia Comarch w sektorze administracji publicznej i utilities
Wybrane wdrożenia Comarch w sektorze administracji publicznej i utilities
 
07.10.2021 Prezentacja o strefach praktycznie
07.10.2021 Prezentacja o strefach praktycznie07.10.2021 Prezentacja o strefach praktycznie
07.10.2021 Prezentacja o strefach praktycznie
 
Wiz Countbuuu
Wiz CountbuuuWiz Countbuuu
Wiz Countbuuu
 
Wiz Countbuuu
Wiz CountbuuuWiz Countbuuu
Wiz Countbuuu
 
Zwinny_Analityk_SIW_Panel
Zwinny_Analityk_SIW_PanelZwinny_Analityk_SIW_Panel
Zwinny_Analityk_SIW_Panel
 
Zastosowania systemu BCC ECM
Zastosowania systemu BCC ECMZastosowania systemu BCC ECM
Zastosowania systemu BCC ECM
 
Rozliczanie projektów
Rozliczanie projektówRozliczanie projektów
Rozliczanie projektów
 
Wojciech Kosiński Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...
Wojciech Kosiński   Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...Wojciech Kosiński   Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...
Wojciech Kosiński Zarzadzanie Procesami Biznesowymi Jako Kluczowa Funkcja O...
 
ePUAP: Prezentacja Architektury
ePUAP: Prezentacja ArchitekturyePUAP: Prezentacja Architektury
ePUAP: Prezentacja Architektury
 
Summit EOIF GigaCon 2017 - katalog
Summit EOIF GigaCon 2017 - katalogSummit EOIF GigaCon 2017 - katalog
Summit EOIF GigaCon 2017 - katalog
 
SSC Master overview
SSC Master overviewSSC Master overview
SSC Master overview
 

Krajowy System e-Faktur KSEF technicznie i praktycznie

  • 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.
  • 9. Numer faktury KSeF • Każda faktura pomyślnie zarejestrowana / wystawiona w systemie KSeF otrzymuje unikalny numer tzw. numer 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
  • 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
  • 24. Inicjalizacja sesji 1. Pobranie wyzwania autoryzacyjnego 1. Pobranie wyzwania autoryzacyjnego 2. Inicjalizacja sesji a. Poprzez podpis kwalifikowany b. Poprzez token autoryzacyjny
  • 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 ...