Jak połączyć program do faktur z KSeF — krok po kroku

Dariusz Zaktualizowano: 26 marca 2026 Czas czytania: ~5 min

Autoryzacja w KSeF 2.0 — certyfikat, token czy Profil Zaufany?

Od 1 lutego 2026 r. KSeF 2.0 jest obowiązkowy dla dużych firm (obroty >200 mln zł), a od 1 kwietnia 2026 r. — dla wszystkich podatników VAT. Żeby połączyć program do faktur z KSeF, musisz najpierw wybrać metodę autoryzacji.

KSeF 2.0 oferuje trzy metody:

MetodaDla kogoWażnośćUwagi
Certyfikat KSeFWszyscyDo 2 latDocelowa metoda. Generujesz w Aplikacji Podatnika. Dwa typy: Typ I (API online) i Typ II (podpis offline)
TokenWszyscyDo 31.12.2026Rozwiązanie tymczasowe. Generujesz w MCU. Od 2027 tokeny przestają działać
Profil ZaufanyOsoby fizyczne (JDG)BezterminowoNie służy do integracji API — tylko do logowania w Aplikacji Podatnika i generowania certyfikatów/tokenów

Rekomendacja: Wybierz certyfikat — działa dłużej (2 lata vs koniec 2026 dla tokenu) i obsługuje tryb offline. Token to dobre rozwiązanie tymczasowe, ale od stycznia 2027 r. i tak będziesz potrzebować certyfikatu.

Spółki i inne podmioty niebędące osobami fizycznymi nie mogą się zalogować Profilem Zaufanym. Potrzebują kwalifikowanej pieczęci elektronicznej z NIP lub formularza ZAW-FA (wersja 3, obowiązuje od 1.02.2026) złożonego w urzędzie skarbowym. ZAW-FA nadaje uprawnienia właścicielskie jednej osobie, która potem zarządza dostępem elektronicznie.

Więcej o tym, czym jest KSeF i kogo obowiązuje: KSeF — co to jest i jak się przygotować.

Jak wygenerować certyfikat w KSeF — krok po kroku

Procedura jest taka sama niezależnie od programu, który potem podłączysz:

  1. Wejdź na ap.ksef.mf.gov.pl/web (Aplikacja Podatnika KSeF 2.0)
  2. Zaloguj się Profilem Zaufanym, podpisem kwalifikowanym lub pieczęcią kwalifikowaną
  3. Podaj NIP firmy i nawiąż sesję
  4. Przejdź do zakładki CertyfikatyWnioskuj o certyfikat
  5. Wpisz nazwę (np. „Certyfikat dla wFirma") i ustaw hasło — zapamiętaj je, bo nie da się odzyskać
  6. Kliknij Generuj — pobierz plik .key (klucz prywatny)
  7. Wybierz cel: „Uwierzytelnienie w systemie KSeF" (Typ I)
  8. Opcjonalnie zmień daty ważności (domyślnie 2 lata)
  9. Kliknij Wyślij wniosek — po przetworzeniu pobierz plik .crt

Teraz masz parę plików: .crt (certyfikat) + .key (klucz prywatny). Oba wgrywasz do programu do faktur. Plik .key jest nieodwracalny — jeśli go zgubisz, musisz generować nowy certyfikat.

Jeśli wolisz token (szybsze, ale tymczasowe): w Aplikacji Podatnika przejdź do MCU (Moduł Certyfikatów i Uprawnień) → Generuj token → skopiuj 40-znakowy kod. Token wyświetla się tylko raz.

wFirma — integracja z KSeF

Ścieżka: PRZYCHODY → KSeF → KONFIGURACJA INTEGRACJI

wFirma oferuje trzy warianty połączenia:

  1. Mam certyfikat — wgrywasz .crt i .key z Aplikacji Podatnika + podajesz hasło
  2. Mam token — wklejasz token z MCU
  3. Nie mam certyfikatu/tokenu — wFirma generuje certyfikaty za Ciebie. Pobierasz plik metadanych z KSeF, wgrywasz do wFirma, system sam tworzy certyfikaty

Co działa po podłączeniu:

  • Automatyczna wysyłka faktur B2B do KSeF po zapisaniu
  • Automatyczne pobieranie faktur zakupowych (codziennie w godzinach nocnych → WYDATKI → WERSJE ROBOCZE)
  • Ręczny import z zakresem dat: WYDATKI → KSIĘGOWANIE → IMPORTUJ Z KSEF
  • Statusy przy fakturach: niebieski = przetwarzanie, czerwony = błąd

Ograniczenie: Po wysłaniu do KSeF faktura jest zablokowana — edytujesz tylko skutek księgowy. Zmiany treści wymagają korekty.

Pełna recenzja: wFirma — recenzja i cennik 2026.

inFakt — integracja z KSeF

Ścieżka: Ustawienia → Faktury → Integracja z KSeF

inFakt ma najszybszą ścieżkę dla JDG — połączenie przez Profil Zaufany zajmuje mniej niż minutę:

  1. Wybierz Profil Zaufany w ustawieniach integracji
  2. Postępuj zgodnie z instrukcjami — system automatycznie wygeneruje i wgra certyfikat
  3. Gotowe

Alternatywnie: token (wklejasz z MCU) lub certyfikat (wgrywasz .crt + .key).

Co działa po podłączeniu:

  • Ręczna lub zbiorcza wysyłka faktur (przycisk „Wyślij do KSeF" lub zaznaczenie wielu na liście)
  • Darmowa infolinia KSeF — dedykowana pomoc telefoniczna

Ograniczenie: Brak automatycznej wysyłki — każdą fakturę musisz wysłać ręcznie lub zbiorczo. Faktury wysłane mailem i faktury z przyszłą datą nie mogą trafić do KSeF.

Pełna recenzja: inFakt — recenzja i cennik 2026.

Fakturownia — integracja z KSeF

Ścieżka: Ustawienia → Integracje i dodatki → KSeF → Aktywuj

Fakturownia oferuje unikatową autoryzację automatyczną — system sam generuje certyfikaty w KSeF:

  1. Kliknij Aktywuj i wybierz Uwierzytelnienie automatyczne
  2. Wybierz firmę po NIP
  3. Pobierz plik uwierzytelniający
  4. Podpisz go Profilem Zaufanym na podpis.gov.pl
  5. Wgraj podpisany plik z powrotem do Fakturowni
  6. System automatycznie tworzy certyfikaty w KSeF

Alternatywnie: ręczne wgranie .crt + .key z Aplikacji Podatnika.

Co działa po podłączeniu:

  • Automatyczna wysyłka faktur sprzedaży do KSeF po utworzeniu
  • Automatyczne pobieranie faktur kosztowych do sekcji Wydatki
  • Tryb hybrydowy (do 1.04.2026) — odbiór kosztów z KSeF + dobrowolna wysyłka sprzedaży. Przydatny dla mikroprzedsiębiorców przed obowiązkowym terminem

Ograniczenie: Limity certyfikatów — max 100 aktywnych na NIP (300 wniosków/30 dni). Po wysłaniu do KSeF faktura jest zablokowana.

Pełna recenzja: Fakturownia — recenzja i cennik 2026.

FakturaXL — integracja z KSeF

Ścieżka: Przychody → KSeF 2.0

FakturaXL wspiera certyfikat (zalecany) i token:

  1. Wygeneruj certyfikat w Aplikacji Podatnika (procedura opisana wyżej)
  2. W FakturaXL: Przychody → KSeF 2.0
  3. Wgraj .key i .crt + podaj hasło
  4. Kliknij przycisk połączenia

Co działa po podłączeniu:

  • Ręczna, zbiorcza lub automatyczna wysyłka (o konfigurowalnych godzinach)
  • Automatyczne pobieranie faktur kosztowych 4 razy dziennie (7:30, 15:30, 19:30, 23:30)
  • Pobieranie pojedynczej faktury po numerze KSeF

Ograniczenie: Nie generuje certyfikatów wewnętrznie — musisz je pobrać z Aplikacji Podatnika. Dla spółek wymagane ręczne nadanie uprawnień w zakładce Uprawnienia.

Pełna recenzja: FakturaXL — recenzja 2026.

Porównanie integracji — co wspiera który program

FunkcjawFirmainFaktFakturowniaFakturaXL
Certyfikat KSeFTakTakTakTak
Token (do 12/2026)TakTakTakTak
Generowanie cert. w aplikacjiTakTak (przez PZ)Tak (automatyczne)Nie
Auto-wysyłka sprzedażyTakNieTakTak (o wybranych godz.)
Auto-pobieranie zakupówTak (nocne)TakTak (4×/dzień)
Tryb hybrydowyTak

Werdykt: Jeśli zależy Ci na pełnej automatyzacji (wysyłka + pobieranie bez klikania), najlepiej wypadają wFirma i Fakturownia. inFakt wymaga ręcznej wysyłki, ale rekompensuje to najprostszym procesem połączenia (Profil Zaufany w minutę). Pełne porównanie programów: ranking programów do fakturowania 2026.

Najczęstsze błędy przy łączeniu — i jak je naprawić

  1. Tokeny z KSeF 1.0 nie działają w 2.0 — nie są migrowane. Jeśli integrowałeś program przed 1 lutego 2026, musisz wygenerować nowy token/certyfikat w MCU. Stare tokeny przestały działać.
  2. Błąd 415 (brak uprawnień) — najczęściej pieczęć kwalifikowana nie zawiera NIP lub nie złożono ZAW-FA. Dla spółek: sprawdź czy osoba wyznaczona w ZAW-FA nadała uprawnienia operacyjne (wysyłanie/odbieranie faktur) — samo ZAW-FA daje tylko uprawnienia administracyjne.
  3. Mieszanie środowisk test/produkcja — certyfikat z wersji testowej nie zadziała na produkcji i odwrotnie. Upewnij się, że generujesz certyfikat w środowisku produkcyjnym (ap.ksef.mf.gov.pl, nie ap-test.ksef.mf.gov.pl).
  4. Zgubiony plik .key — klucz prywatny nie jest odzyskiwalny. Jedyne rozwiązanie: wygeneruj nowy certyfikat.
  5. Token obcięty przy wklejaniu — niektóre programy akceptują tylko 64-znakowy fragment tokenu z MCU. Jeśli pojawia się błąd formatu, sprawdź dokumentację swojego programu.
  6. Wygasły Profil Zaufany — wielu użytkowników odkrywa to dopiero przy próbie logowania do KSeF. Profil Zaufany ważny jest 3 lata — sprawdź datę ważności na pz.gov.pl.
  7. Firewall/VPN blokuje KSeF — firmowe sieci często blokują endpointy rządowe. Jeśli dostajesz błąd HTTP 12175 lub timeout, poproś dział IT o odblokowanie domen ksef.mf.gov.pl.

Jeśli KSeF nie działa (awaria systemowa, nie błąd po Twojej stronie), sprawdź jak wystawiać faktury w trybie offline: KSeF nie działa — co robić.

O autorze

Komentarze

Brak komentarzy. Bądź pierwszy, który podzieli się swoimi przemyśleniami!

Zostaw komentarz