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/certyfikatem/profilem zaufanym, test połączenia i pierwsza faktura 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, certyfikatu albo profilu zaufanego. 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. Aktywuj licencję — plan darmowy nie wymaga karty.

Krok 2. Przygotuj autoryzację w KSeF

Najprościej wygenerować token autoryzacyjny w aplikacji KSeF Ministerstwa Finansów dla swojego NIP. Token nie wymaga podpisu kwalifikowanego. Alternatywy to certyfikat KSeF i profil zaufany — porównanie znajdziesz w artykule token czy certyfikat.

Krok 3. Wprowadź dane w ustawieniach wtyczki

W ustawieniach Prosta Faktura KSeF dodaj konto KSeF: wklej token (lub wskaż certyfikat), wybierz środowisko i zapisz. Wtyczka szyfruje dane uwierzytelniające i zarządza sesją — odświeża ją automatycznie, więc nie musisz logować się przy każdej fakturze.

Ś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 testu połączenia. Jeśli wtyczka nawiąże sesję i pobierze dane, jesteś gotowy. Dobra praktyka to wystawienie najpierw kilku faktur na koncie z planu darmowego 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.