Do czego wykorzystać pliki XML faktur pobrane z KSeF?
Paczka XML z KSeF to komplet oryginalnych dokumentów źródłowych faktur, gotowych do trzech rzeczy: importu do programu księgowego lub systemu ERP (dane 1:1, bez przepisywania), długoterminowego archiwum własnej kopii oryginałów oraz audytu i kontroli podatkowej. Jeśli plik ma być tylko do czytania, z tego samego kompletu pobierzesz też PDF lub Excel. Portal MF udostępnia XML pojedynczo, faktura po fakturze – zbiorcze pobranie całego zakresu buduje za Ciebie KSeF Import, pakując oryginały w jedną, posegregowaną paczkę ZIP.
- Plik XML to oryginał faktury ustrukturyzowanej (schemat FA(3)), a nie wyciąg danych – to dokument, który KSeF prawnie zarejestrował.
- Najczęstsze zastosowania: import do programu księgowego i ERP, długoterminowe archiwum oryginałów oraz materiał dowodowy na kontrolę.
- Portal Ministerstwa Finansów udostępnia XML pojedynczo; zbiorczego pobrania całego zakresu nie ma – dlatego paczkę buduje KSeF Import.
- Paczka ZIP jest posegregowana w foldery – z podziałem na NIP i miesiąc, a każdy plik nazwany numerem KSeF; faktury kosztowe i sprzedażowe pobierasz osobnym przyciskiem.
- Gdy XML ma służyć tylko do czytania, z tego samego kompletu pobierzesz PDF lub Excel. Eksport XML działa w planach Firma, Grupa i Biuro (Solo obejmuje Arkusze Google).
W tym artykule
Od problemu do efektu
PWEPliki XML są ustrukturyzowane dla maszyn, nie dla człowieka: otwarte w przeglądarce wyglądają jak techniczny bełkot ze znacznikami. Bez pomysłu, do czego ich użyć, leżą nietknięte, a Ty i tak przepisujesz dane ręcznie.
XML to format wymiany danych: ten sam plik zaimportujesz do programu księgowego lub ERP, odłożysz do archiwum oryginałów i przedstawisz podczas kontroli. KSeF Import dostarcza go w posegregowanej paczce, a gdy potrzebujesz wersji do czytania, ten sam komplet pobierzesz jako PDF lub Excel.
Zamiast przepisywać faktury do arkusza masz jedno źródło: XML do systemów i archiwum, PDF do wglądu, Excel do analizy. Komplet oryginałów za dany okres przygotujesz jednym zleceniem, bez klikania faktura po fakturze w portalu.
Skąd bierze się posegregowana paczka XML
Każda faktura w Krajowym Systemie e-Faktur powstaje jako plik XML zgodny ze schematem FA(3) (starsze dokumenty: FA(2)). To właśnie ten plik jest oryginałem faktury ustrukturyzowanej – dokumentem, który Ministerstwo Finansów zarejestrowało i nadało mu numer KSeF. Problem w tym, że portal MF udostępnia ten oryginał pojedynczo: gotowego przycisku „pobierz wszystkie XML za miesiąc” po prostu nie ma.
KSeF Import łączy się z API Twoim certyfikatem, pobiera oryginalne pliki z wybranego zakresu i pakuje je w jeden plik ZIP. Zakres wskazujesz sam. Faktury kosztowe (otrzymane) i sprzedażowe (wystawione) to dwie osobne sekcje z własnym przyciskiem eksportu, więc jednym zleceniem pobierasz jeden rodzaj. Dalej wybierasz okres lub konkretne daty, a pole NIP jest opcjonalne: zostaw „Wszystkie NIP-y”, by wziąć wszystkie swoje firmy naraz, albo wskaż jeden NIP, gdy potrzebujesz tylko jednej firmy. Mechanizm i limity API opisaliśmy w osobnym poradniku o zbiorczym eksporcie XML z KSeF.
W archiwum nie dostajesz jednego worka plików. Wewnątrz ZIP-a oryginały są uporządkowane w strukturę folderów NIP → miesiąc, a każdy plik nosi nazwę z numerem KSeF faktury. Gdy eksportujesz kilka firm naraz, każda ma swój katalog – od razu wiesz, co trafia do której księgowości.
Czym różni się XML od PDF i Excela
Z jednej faktury w KSeF można zrobić trzy różne pliki i łatwo je pomylić. XML to oryginał źródłowy – ustrukturyzowany, czytelny dla programów, ale nie dla oka. PDF to czytelna wizualizacja tej samej faktury z kodem QR. Excel lub CSV to wyciąg wybranych pól (kwoty, daty, kontrahenci) do analizy. Wszystkie trzy pochodzą z tego samego dokumentu, ale odpowiadają na inne potrzeby.
Surowy plik XML pokazuje znaczniki i pola techniczne, bo to zapis dla programów, nie dla oka. Nie musisz go „czytać” ręcznie: program księgowy, system ERP czy integracja wczytają go automatycznie i przeniosą dane 1:1. Człowiekowi zostają wygodne wersje tej samej faktury – PDF do wglądu i Excel do analizy.
Nie musisz wybierać raz na zawsze. Z tego samego kompletu faktur pobierzesz każdy z formatów – porównanie i wybór znajdziesz na stronie eksportu faktur z KSeF. Oryginały XML trzymasz jako archiwum, a do bieżącej pracy generujesz PDF lub Excel wtedy, gdy są potrzebne.
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Do czego wykorzystać pliki XML – zestawienie
Oryginalny XML przydaje się wszędzie tam, gdzie liczy się sam dokument źródłowy, a nie jego wyciąg. Poniżej najczęstsze scenariusze i to, co realnie z plikiem robisz.
| Cel | Co robisz z XML | Dlaczego XML, a nie PDF/Excel |
|---|---|---|
| Import do programu księgowego | Wgrywasz plik XML faktury zamiast wpisywać dane ręcznie | Dane 1:1 ze źródła, bez literówek i pominięć |
| Zasilenie systemu ERP | Podajesz XML na wejście modułu zakupów lub sprzedaży | Maszynowo czytelny format wymiany danych |
| Długoterminowe archiwum | Odkładasz oryginały we własnym zasobie (dysk, chmura) | Twoja kopia dokumentu, niezależna od portalu MF |
| Audyt i kontrola podatkowa | Przekazujesz komplet oryginałów za okres | Dowód w postaci wystawionego pliku FA(3) z numerem KSeF |
| Przekazanie biuru rachunkowemu | Wysyłasz jeden ZIP zamiast dawać dostęp do KSeF | Biuro dostaje oryginały bez logowania na Twoje konto |
| Integracje, BI, hurtownia danych | Parsujesz pola XML do własnych raportów | Struktura FA(3) opisuje każde pole jednoznacznie |
Wiele firm korzysta z kilku ścieżek równolegle: XML idzie do programu księgowego i do archiwum, a równolegle powstaje paczka PDF do wglądu dla zespołu.
Import XML do programu księgowego lub ERP – krok po kroku
Najczęstsze zastosowanie paczki to zasilenie księgowości bez ręcznego przepisywania. Ścieżka jest prosta i powtarzalna co miesiąc.
-
1
Pobierz paczkę XML dla zakresu
W panelu wskaż okres i opcjonalnie NIP, a następnie zleć zbiorczy eksport XML. Odbierasz jeden plik ZIP z posegregowanymi oryginałami faktur.
-
2
Rozpakuj i wejdź do właściwego folderu
ZIP jest już poukładany w katalogi NIP i miesiąc. Wchodzisz do firmy i miesiąca, który właśnie księgujesz, i bierzesz tylko te pliki – reszta czeka na swój etap.
-
3
Zaimportuj XML w programie
W programie księgowym lub ERP wybierz import faktur ustrukturyzowanych i wskaż pliki XML. Większość systemów rozpoznaje schemat FA(3) i uzupełnia dane kontrahenta, kwoty i stawki VAT automatycznie.
-
4
Zweryfikuj po numerze KSeF
Każda faktura ma unikalny numer KSeF, który zapobiega zdublowaniu tego samego dokumentu przy imporcie. Na koniec porównujesz liczbę zaimportowanych faktur z liczbą plików w folderze – ta kontrola wychwytuje ewentualne pominięcia.
Część starszych programów księgowych nie importuje jeszcze XML z KSeF. Wtedy z tego samego kompletu pobierasz plik CSV lub Excel z kolumnami pod dany program i wgrywasz jego standardowym importem. Oryginały XML zostają w archiwum.
Archiwum, audyt i przekazanie biuru
Poza importem paczka XML pełni rolę Twojej niezależnej kopii oryginałów. To ważne, bo KSeF jest rejestrem rządowym, a nie Twoim prywatnym archiwum. Eksport obejmuje zakres dostępny w panelu, więc archiwum warto budować na bieżąco, miesiąc po miesiącu, zamiast liczyć na jednorazowe sięgnięcie po całą przeszłość.
- Własna kopia oryginałów – KSeF przechowuje faktury przez 10 lat, ale to zasób Ministerstwa Finansów. Paczka XML daje Ci ten sam oryginał u siebie, niezależnie od dostępności portalu.
- Gotowość na kontrolę – urząd lub audytor oczekuje wystawionych dokumentów. Komplet oryginalnych plików FA(3) za dany okres przygotujesz jednym zleceniem, bez zbierania faktury po fakturze.
- Przekazanie biuru rachunkowemu – zamiast udostępniać dostęp do swojego KSeF, wysyłasz jeden plik ZIP z oryginałami za okres. Biuro pracuje na dokumentach, a Ty zachowujesz kontrolę nad kontem.
- Kopia na wypadek zmian – masz oryginały u siebie, więc nie jesteś zależny od tego, jak długo dane pozostaną wygodnie dostępne w samym portalu.
Nie zawsze potrzebujesz całego archiwum. Pojedynczy plik XML pobierzesz wprost z listy faktur w panelu, jednym kliknięciem przy wybranym dokumencie, bez logowania do portalu Ministerstwa Finansów.
Podsumowując: paczka XML to nie kolejny plik do odłożenia i zapomnienia, tylko oryginał, który realnie pracuje – w księgowości, w archiwum i podczas kontroli. Cały komplet formatów, w tym XML, znajdziesz w eksporcie faktur z KSeF, a mechanizm samego pobierania w poradniku o zbiorczym eksporcie XML.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Tak. Plik XML zgodny ze schematem FA(3) to oryginał faktury ustrukturyzowanej – dokładnie ten dokument, który został wystawiony i zarejestrowany w Krajowym Systemie e-Faktur, wraz z numerem KSeF. PDF i Excel to jedynie wygodne wersje tej samej faktury do czytania i analizy.
Do odczytu przez człowieka nie otwieraj surowego XML w przeglądarce, bo zobaczysz znaczniki techniczne. Zamiast tego pobierz z tego samego kompletu wersję PDF, która pokazuje czytelną fakturę z kodem QR. Surowy XML jest przeznaczony dla programów księgowych i systemów ERP, które odczytują go automatycznie.
Zwykle tak – większość programów obsługujących KSeF przyjmuje import faktur ustrukturyzowanych w schemacie FA(3). Jeśli Twój program jeszcze tego nie potrafi, pobierz z tego samego zakresu plik CSV lub Excel z kolumnami dopasowanymi do programu i użyj jego standardowego importu, a oryginały XML zachowaj w archiwum.
KSeF to rejestr Ministerstwa Finansów, a nie Twoja prywatna kopia. Trzymając oryginalne pliki XML u siebie, masz dokumenty niezależnie od dostępności portalu i możesz je w każdej chwili przekazać księgowej, audytorowi czy urzędowi bez logowania do systemu rządowego.
Portal Ministerstwa Finansów udostępnia oryginalny plik XML pojedynczo, dla każdej faktury osobno. Zbiorczego pobrania całego zakresu naraz tam nie ma, dlatego przy większej liczbie faktur buduje ją za Ciebie KSeF Import, pakując posegregowane oryginały w jeden plik ZIP.
Eksport XML, zarówno zbiorczy, jak i pojedynczy, działa w planach Firma, Grupa i Biuro – tak samo jak eksport do Excela, CSV i PDF. Plan Solo obejmuje wyłącznie eksport do Arkuszy Google. Siedmiodniowy okres próbny daje pełny dostęp do limitów planu Biuro, więc pliki XML pobierzesz od pierwszego dnia.
Inżynier integracji KSeF. Odpowiada za połączenia z API Krajowego Systemu e-Faktur, automatyzacje i parsowanie struktury logicznej FA(3).