Dlaczego eksport faktur z KSeF nie pasuje do mojego programu księgowego?
Aplikacja Podatnika KSeF pozwala przejrzeć fakturę i pobrać ją jako XML lub PDF – pojedynczo albo w paczkach do 10 plików naraz – ale nie generuje gotowej tabeli w Excelu ani CSV z wybranymi kolumnami. Gotowe narzędzia zwykle dają jeden, sztywny układ kolumn, więc gdy program księgowy oczekuje innych nazw lub innej kolejności pól, plik trzeba poprawiać ręcznie przed każdym importem. W KSeF Import wybierasz, które z 32 pól mają się znaleźć w eksporcie i w jakiej kolejności – osobno dla faktur sprzedażowych i kosztowych – a układ zostaje zapamiętany na stałe.
- Aplikacja Podatnika KSeF nie eksportuje zbiorczo do Excela ani CSV – tylko podgląd/pobranie pojedynczej faktury (XML lub PDF).
- Najczęstsza przyczyna błędu importu do programu księgowego: nazwa, liczba lub kolejność kolumn w pliku nie zgadza się z tym, czego oczekuje program.
- W KSeF Import wybierasz do 32 pól i ustawiasz ich kolejność przeciąganiem – raz, nie przy każdym eksporcie.
- Sprzedaż i koszty mają osobny układ kolumn – inne pola liczą się przy fakturze kosztowej, inne przy sprzedażowej.
- Ten sam wybrany układ obowiązuje w Excelu, CSV i Arkuszach Google – konfigurujesz raz, korzystasz wszędzie.
W tym artykule
Od problemu do efektu
PWEDomyślny plik z fakturami ma stały zestaw kolumn w stałej kolejności. Gdy program księgowy oczekuje innego układu, ktoś przestawia kolumny i czyści plik po każdym pobraniu – zanim w ogóle dojdzie do importu.
KSeF Import pozwala włączyć tylko potrzebne pola z 32 dostępnych i ułożyć je tak, jak wymaga Twój program – osobno dla faktur sprzedażowych i kosztowych.
Kolejny eksport wychodzi w zapamiętanym układzie – bez ponownego przestawiania kolumn i bez większości ręcznych poprawek przed wysyłką do księgowej albo importem do programu.
Dlaczego domyślny eksport nie pasuje do programu księgowego
Krajowy System e-Faktur przechowuje dokumenty w formacie XML zgodnym ze strukturą logiczną FA(3) – ok. 80 pól zagnieżdżonych w sekcjach, zoptymalizowanych pod przetwarzanie maszynowe. Oficjalna Aplikacja Podatnika KSeF pozwala obejrzeć i pobrać dokumenty – pojedynczo albo w paczkach do 10 plików naraz – ale nie ma w niej zbiorczego eksportu do Excela ani CSV z gotową tabelą kolumn; jedyne, co pobierzesz wprost, to pliki XML lub PDF.
Gdy sięgasz po narzędzie, które samo zamienia XML na tabelę, pojawia się drugi problem: większość eksportów ma jeden, z góry ustalony układ kolumn. Program księgowy oczekuje własnych nazw nagłówków i własnej kolejności pól, więc w praktyce plik trzeba poprawić, zanim import się powiedzie:
- Nazwy kolumn muszą się zgadzać dokładnie – wielkość liter i dodatkowa spacja w nagłówku potrafią zablokować import.
- Liczba kolumn w każdym wierszu musi być identyczna – nadmiarowe pole, którego program nie rozpoznaje, przesuwa resztę danych.
- Kolejność pól – program mapuje dane po pozycji kolumny, więc inna kolejność oznacza netto tam, gdzie miała być data.
- Osobne wymagania dla sprzedaży i kosztów – sprzedaż potrzebuje oznaczeń GTU, koszty raczej kategorii kosztowej; jeden uniwersalny układ rzadko pasuje do obu.
Program księgowy zwykle nie zgłasza błędu opisowo – po prostu odrzuca wiersz albo wczytuje dane w złych kolumnach. Zanim zaczniesz szukać błędu w danych, sprawdź najpierw, czy nagłówki i kolejność kolumn w pliku odpowiadają dokładnie temu, czego program oczekuje.
Co możesz wybrać – 32 pola do eksportu
Zamiast jednego sztywnego szablonu, KSeF Import daje listę 32 pól faktury – włączasz tylko te, których naprawdę używasz, a resztę zostawiasz poza plikiem. Poniżej przykładowe grupy pól i do czego się przydają:
| Grupa pól | Przykłady | Do czego się przydaje |
|---|---|---|
| Identyfikacja | Numer KSeF, numer faktury, data wystawienia | Deduplikacja i jednoznaczne powiązanie z dokumentem w KSeF |
| Strony transakcji | NIP i nazwa sprzedawcy, NIP i nazwa nabywcy | Powiązanie z kontrahentem w programie księgowym |
| Kwoty i podatek | Netto, VAT, brutto, stawki VAT, waluta | Rozksięgowanie i odliczenie VAT |
| Oznaczenia handlowe | MPP, GTU, opis pozycji | Filtrowanie i kontrola oznaczeń wymaganych na fakturze |
Pełną listę 32 pól oraz sposób ich włączania i porządkowania opisujemy na stronie Konfiguracja pól eksportu – to ta sama konfiguracja, z której korzysta artykuł o eksporcie faktur z KSeF do Excela.
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Jak ustawić kolejność kolumn – krok po kroku
Konfigurację robisz raz na firmę i typ faktury. Każdy kolejny eksport – ręczny albo automatyczny – korzysta już z zapamiętanego układu.
-
1
Otwórz konfigurację eksportu
W panelu wchodzisz w ustawienia eksportu dla wybranego NIP-u – osobno dla faktur sprzedażowych i kosztowych.
-
2
Zaznacz potrzebne pola
Z listy 32 pól włączasz te, których faktycznie używasz przy imporcie – reszta nie trafia do pliku i nie zaśmieca danych.
-
3
Ustaw kolejność kolumn
Przeciągasz zaznaczone pola w kolejność zgodną z tym, czego oczekuje Twój program księgowy przy imporcie.
-
4
Zapisz układ
Konfiguracja zostaje zapamiętana. Zmieniasz ją tylko wtedy, gdy zmienią się wymagania programu, do którego importujesz dane.
-
5
Eksportuj w dowolnym formacie
Ten sam wybór pól i kolejność obowiązuje w pliku Excel, CSV oraz w danych wysyłanych do Arkuszy Google.
Po zmianie układu kolumn zrób najpierw próbny import kilku faktur, nie całego miesiąca. Jeśli program księgowy przyjmie plik bez ostrzeżeń, dopiero wtedy uruchamiaj pełny import.
Biuro rachunkowe: inny układ dla każdego klienta
Przy obsłudze kilku firm z jednego panelu problem mnoży się razy tyle, ilu masz klientów – każdy może korzystać z innego programu księgowego, z innym oczekiwanym układem kolumn.
Konfiguracja pól jest niezależna dla każdego NIP-u, więc jeden klient dostaje plik pod Comarch Optima, drugi pod inny program – bez ręcznego przerabiania eksportu za każdym razem. Eksport do Excela, CSV i PDF działa w planach Firma i wyższych; pełne porównanie limitów i cen znajdziesz w cenniku. Więcej o obsłudze wielu klientów z jednego panelu – w artykule Biuro rachunkowe: 20 klientów w KSeF do Excela/CSV.
Podsumowanie: mniej poprawek, szybszy import
Sztywny, jednakowy dla wszystkich eksport to główny powód, dla którego plik trzeba poprawiać po każdym pobraniu. Gdy sam wybierasz pola i ich kolejność w konfiguracji pól eksportu, plik zwykle wchodzi do programu księgowego bez ponownego przestawiania kolumn i bez ręcznego czyszczenia danych.
Jeśli dopiero zaczynasz z eksportem faktur z KSeF, zajrzyj też do artykułu o wyborze między Excelem a CSV – pomoże ustalić, który format i jaki zestaw pól pasuje do Twojego procesu.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Nie. Oficjalna aplikacja Ministerstwa Finansów pozwala obejrzeć i pobrać dokumenty jako XML lub PDF – pojedynczo albo w paczkach do 10 plików naraz – ale nie ma w niej zbiorczego eksportu do Excela ani CSV z gotową tabelą kolumn.
Najczęściej dlatego, że nazwy, liczba lub kolejność kolumn w pliku nie odpowiadają dokładnie temu, czego oczekuje program przy imporcie – nawet dodatkowa spacja w nagłówku potrafi zablokować wczytanie.
Do 32 pól faktury – od numeru KSeF i dat, przez dane stron transakcji i kwoty netto/VAT/brutto, po oznaczenia MPP i GTU. Włączasz tylko te, których faktycznie używasz.
Tak. To dwie niezależne konfiguracje – sprzedażowe i kosztowe mogą mieć zupełnie inny zestaw i inną kolejność pól, dopasowaną do tego, co księgujesz.
Ten sam wybór pól i ich kolejność obowiązuje we wszystkich formatach eksportu – pliku Excel, CSV oraz danych wysyłanych do Arkuszy Google.
Tak. Konfiguracja pól jest ustawiana per NIP, więc każdy klient może mieć układ dopasowany do swojego programu księgowego, bez ręcznego przerabiania pliku za każdym razem.
Inżynier integracji KSeF. Odpowiada za połączenia z API Krajowego Systemu e-Faktur, automatyzacje i parsowanie struktury logicznej FA(3).