Jak importować faktury zakupowe z KSeF — krok po kroku

Wprowadzenie

Import faktur zakupowych z KSeF to jedno z najważniejszych zadań, z którym mierzą się biura rachunkowe po wejściu obowiązkowego e-fakturowania. W tym poradniku pokażemy krok po kroku, jak skonfigurować automatyczny import faktur z Krajowego Systemu e-Faktur.

Czym różni się import z KSeF od tradycyjnego?

Tradycyjnie biuro rachunkowe otrzymywało faktury zakupowe klientów na kilka sposobów: skan e-mailem, plik PDF, zdjęcie z telefonu, a czasem nawet papierowa faktura pocztą. Każdą z nich trzeba było ręcznie wprowadzić do systemu księgowego.

Import z KSeF eliminuje ten chaos. Każda faktura wystawiona w Polsce trafia do centralnego rejestru w ustrukturyzowanym formacie XML. Biuro rachunkowe może je pobrać automatycznie, bez czekania na klienta.

Korzyści importu z KSeF

• Eliminacja ręcznego wprowadzania — dane faktury są już w formacie cyfrowym
• Gwarancja autentyczności — faktura z KSeF jest oryginałem, nie kopią
• Kompletność danych — wszystkie pola wypełnione zgodnie ze schematem MF
• Szybkość — import dziesiątek faktur w sekundy, nie godziny
• Brak zaginionych faktur — system KSeF przechowuje wszystkie dokumenty

Metody uwierzytelniania w KSeF

Zanim zaczniesz importować faktury, musisz uzyskać dostęp do KSeF. System oferuje trzy metody uwierzytelniania.

Metoda 1: Token autoryzacyjny (API Token)

Najprostsza metoda. Token generujesz w portalu KSeF (ksef.mf.gov.pl) po zalogowaniu profilem zaufanym lub podpisem kwalifikowanym.

Jak uzyskać token:

1. Zaloguj się do portalu KSeF
2. Przejdź do sekcji „Zarządzanie tokenami"
3. Wygeneruj nowy token z uprawnieniem „Pobieranie faktur"
4. Skopiuj token i zapisz w bezpiecznym miejscu

Ważne: Token ma ograniczony czas ważności. Ustaw przypomnienie o odnowieniu.

Metoda 2: Certyfikat kwalifikowany (PFX/P12)

Wyższy poziom bezpieczeństwa. Certyfikat kwalifikowany kupujesz od dostawcy (Certum, KIR, PWPW) w formie pliku .pfx lub .p12.

Zalety:

• Dłuższy okres ważności (1-2 lata)
• Wymagany dla niektórych zaawansowanych operacji
• Wyższe zaufanie

Konfiguracja:

1. Kup certyfikat kwalifikowany od autoryzowanego dostawcy
2. Pobierz plik .pfx/.p12 wraz z hasłem
3. Wgraj certyfikat do swojego oprogramowania
4. System użyje certyfikatu do autoryzacji w KSeF API

Metoda 3: Certyfikat wydany przez KSeF

Bezpłatna alternatywa. KSeF może wydać certyfikat na podstawie autoryzacji profilem zaufanym.

Jak uzyskać:

1. Zaloguj się do portalu KSeF profilem zaufanym
2. Wygeneruj certyfikat systemowy
3. Pobierz i zainstaluj w oprogramowaniu

Import krok po kroku

Krok 1: Przygotowanie konfiguracji

Przed pierwszym importem potrzebujesz:

• Token lub certyfikat KSeF dla każdego klienta
• NIP klienta (identyfikator w KSeF)
• Oprogramowanie z integracją KSeF API v2

Krok 2: Konfiguracja połączenia

W swoim oprogramowaniu:

1. Dodaj nowego klienta (lub wybierz istniejącego)
2. Wejdź w ustawienia KSeF
3. Wybierz metodę uwierzytelniania (token/certyfikat)
4. Wklej token lub wgraj plik certyfikatu
5. Przetestuj połączenie — system powinien potwierdzić „Połączenie aktywne"

Krok 3: Pierwszy import

1. Wybierz zakres dat (np. ostatni miesiąc)
2. Kliknij „Importuj z KSeF"
3. System pobierze wszystkie faktury zakupowe z danego okresu
4. Sprawdź podsumowanie — liczba pobranych faktur, ewentualne ostrzeżenia
5. Zatwierdź import

Krok 4: Konfiguracja importu automatycznego

Dla biura obsługującego wielu klientów, ręczny import jest niepraktyczny. Skonfiguruj import cykliczny:

• Codziennie — dla klientów z dużym wolumenem (50+ faktur/miesiąc)
• Co tydzień — dla średnich klientów (10-50 faktur/miesiąc)
• Co miesiąc — dla małych klientów (<10 faktur/miesiąc)

System będzie automatycznie pobierał nowe faktury w ustalonym harmonogramie.

Krok 5: Weryfikacja i zatwierdzanie

Po imporcie faktury trafiają do panelu weryfikacji:

1. Klient loguje się do systemu (np. po NIP)
2. Przegląda pobrane faktury
3. Akceptuje prawidłowe, odrzuca błędne
4. Przypisuje centra kosztów (MPK) do zaakceptowanych faktur
5. Biuro generuje raport z zatwierdzonych faktur

Najczęstsze problemy i rozwiązania

Problem: „Błąd autoryzacji" przy łączeniu z KSeF

Przyczyny:

• Token wygasł — wygeneruj nowy w portalu KSeF
• Certyfikat jest nieprawidłowy — sprawdź datę ważności
• Brak uprawnień — klient musi udzielić upoważnienia biuru

Problem: Brakujące faktury po imporcie

Przyczyny:

• Za wąski zakres dat — poszerz okres importu
• Faktury nie zostały jeszcze wystawione w KSeF przez kontrahenta
• Filtr importu wyklucza niektóre typy faktur

Problem: Duplikaty faktur

Przyczyny:

• Import wykonany wielokrotnie dla tego samego okresu
• Rozwiązanie: dobre oprogramowanie automatycznie wykrywa duplikaty na podstawie numeru KSeF

Bezpieczeństwo przechowywania danych KSeF

Tokeny i certyfikaty KSeF to wrażliwe dane. Biuro rachunkowe przechowujące dane dziesiątek klientów powinno zadbać o:

• Szyfrowanie — tokeny szyfrowane AES-256-GCM w bazie danych
• Klucz per-instalacja — każda instancja systemu ma unikalny klucz szyfrowania
• Ograniczony dostęp — tylko upoważnieni pracownicy mogą zarządzać tokenami
• Audit log — logowanie każdego użycia tokenu/certyfikatu

Platformy takie jak BiLLU stosują te zabezpieczenia domyślnie, co eliminuje ryzyko wycieku danych uwierzytelniających.

Podsumowanie

Import faktur z KSeF to proces, który raz skonfigurowany, działa praktycznie bezobsługowo. Kluczowe kroki to:

1. Uzyskanie tokenów/certyfikatów od klientów
2. Konfiguracja połączenia w oprogramowaniu
3. Ustawienie automatycznego importu cyklicznego
4. Wdrożenie procesu weryfikacji z klientami

Im szybciej wdrożysz automatyczny import, tym więcej czasu zaoszczędzisz — szczególnie przy obsłudze wielu klientów jednocześnie.