Jak połączyć WordPress z KSeF krok po kroku

Zespół Prosta Faktura KSeF24 maja 20266 min czytania

Instrukcja połączenia WordPress z KSeF: instalacja wtyczki, autoryzacja tokenem lub certyfikatem, test połączenia i pierwsza faktura w formacie FA(3).

Czego potrzebujesz

Połączenie WordPress z KSeF wymaga trzech rzeczy: wtyczki łączącej się z API KSeF (np. Prosta Faktura KSeF), konta w KSeF oraz sposobu autoryzacji — tokenu autoryzacyjnego albo certyfikatu XAdES. Połączenie wychodzące HTTPS do api.ksef.mf.gov.pl musi być dozwolone na Twoim hostingu (zwykle jest).

Krok 1. Zainstaluj wtyczkę

W panelu WordPress wejdź w Wtyczki → Dodaj nową → Wyślij wtyczkę, wgraj plik i aktywuj. Następnie na ekranie Licencja aktywuj klucz — dostępny jest 30-dniowy trial Pro za darmo, który nie wymaga karty.

Krok 2. Przygotuj autoryzację w KSeF

Najprościej wygenerować token autoryzacyjny w aplikacji KSeF Ministerstwa Finansów dla swojego NIP (do samej aplikacji MF zalogujesz się m.in. profilem zaufanym). Token nie wymaga podpisu kwalifikowanego. Wtyczka łączy się z KSeF tokenem albo certyfikatem XAdES — porównanie znajdziesz w artykule token czy certyfikat.

Krok 3. Wprowadź dane w ustawieniach wtyczki

W menu e-Faktura KSeF kreator onboardingu przeprowadzi Cię krok po kroku: dodajesz konto KSeF (token autoryzacyjny lub certyfikat XAdES), wybierasz środowisko (test lub produkcja) i zapisujesz. Wtyczka szyfruje dane uwierzytelniające i zarządza sesją — odświeża ją automatycznie, więc nie musisz logować się przy każdej fakturze. Obsługuje też wiele kont KSeF (multi-NIP) i sama dobiera właściwe.

Środowisko testowe vs produkcyjne

KSeF udostępnia środowisko testowe i produkcyjne. Faktury wystawione na produkcji są realnymi dokumentami — testy rób na środowisku testowym, dopóki nie potwierdzisz, że wszystko działa.

Krok 4. Przetestuj połączenie

Użyj przycisku „Testuj połączenie”. Jeśli wtyczka nawiąże sesję i pobierze dane, jesteś gotowy. Dobra praktyka to wystawienie najpierw kilku faktur na środowisku testowym KSeF i sprawdzenie, czy wracają numer KSeF oraz UPO.

Krok 5. Włącz wystawianie faktur

Od tego momentu wystawisz fakturę ręcznie z panelu albo automatycznie z zamówienia — patrz jak wysłać fakturę do KSeF z WooCommerce. Faktura powstaje w formacie FA(3) i trafia do KSeF.

Gdy coś nie działa

Błąd autoryzacji — sprawdź, czy token jest aktywny i przypisany do właściwego NIP.
Brak połączenia — upewnij się, że hosting nie blokuje ruchu do api.ksef.mf.gov.pl.
Faktura „w trakcie” — to normalne; numer KSeF i UPO przychodzą po przetworzeniu, a w razie niedostępności KSeF zapiszesz fakturę i ponowisz wysyłkę (tryb offline KSeF).

Szerszą listę przyczyn odrzuceń i jak je czytać znajdziesz w artykule błędy KSeF i odrzucone faktury.