Pomoc i pierwsze kroki

A. Instalacja

1. Zainstaluj aplikację KSeF Connect na swoim koncie Stripe (z Marketplace lub z otrzymanego linku instalacyjnego).
2. Po instalacji Stripe otworzy ekran ustawień aplikacji. Aplikację znajdziesz też w menu Apps w panelu Stripe.

B. Uzyskanie poświadczenia KSeF

Potrzebujesz jednego z dwóch sposobów uwierzytelnienia w KSeF. Zalecamy certyfikat — tokeny przestają działać z końcem 2026 roku.

Wariant 1 (zalecany): certyfikat KSeF

1. Zaloguj się do aplikacji KSeF Ministerstwa Finansów (środowisko produkcyjne: ksef.podatki.gov.pl; do testów użyj środowiska demo).
2. Wygeneruj certyfikat dla swojego podmiotu. W wyniku otrzymasz plik certyfikatu (.crt lub .pem), plik klucza prywatnego (.key) oraz hasło chroniące klucz.
3. Zachowaj wszystkie trzy elementy — będą potrzebne w kroku C.

Wariant 2: token autoryzacyjny

1. W Aplikacji Podatnika KSeF wygeneruj token autoryzacyjny dla swojego NIP.
2. Skopiuj token — wkleisz go w ustawieniach aplikacji (krok C).

C. Konfiguracja w aplikacji (Stripe → Ustawienia)

1. Wybierz środowisko KSeF — Testowe (demo) do prób lub Produkcyjne do faktur rzeczywistych.
2. Wybierz metodę uwierzytelniania — Certyfikat (zalecane) lub Token.
3. Dla certyfikatu kliknij „Otwórz okno uploadu". Otworzy się osobna karta na naszym serwerze (Stripe nie przyjmuje tych typów plików w oknie aplikacji). Wgraj plik certyfikatu (.crt/.pem), plik klucza (.key) i wpisz hasło, a następnie zatwierdź. Okno ustawień odświeży się automatycznie po wgraniu.
4. Uzupełnij dane sprzedawcy — wpisz NIP i kliknij „Pobierz z CEIDG", aby automatycznie uzupełnić nazwę i adres (dla jednoosobowych działalności). Spółki uzupełniają dane ręcznie.
5. Ustaw moment wysyłki — po wystawieniu faktury, po opłaceniu lub ręcznie — oraz zdecyduj, czy zapisywać numer KSeF w metadanych faktury Stripe.
6. Kliknij „Testuj połączenie", aby potwierdzić, że poświadczenia działają.

D. Codzienne działanie

1. Po skonfigurowaniu faktury są wysyłane do KSeF zgodnie z wybranym momentem wysyłki.
2. Strona główna aplikacji pokazuje liczby wg statusów oraz listę faktur wymagających uwagi, z możliwością ponowienia nieudanych wysyłek.
3. Dla każdej faktury możesz pobrać UPO (potwierdzenie KSeF) oraz wygenerowany plik XML FA(3).

E. Rozwiązywanie problemów

1. Faktura „pominięta": najczęściej brak NIP nabywcy (faktura B2C). KSeF obsługuje wyłącznie faktury B2B.
2. Błąd uwierzytelnienia / certyfikatu: sprawdź, czy wgrałeś właściwy certyfikat i klucz oraz poprawne hasło, a wybrane środowisko (Testowe/Produkcyjne) odpowiada certyfikatowi.
3. Niepoprawne dane sprzedawcy: uzupełnij NIP i adres; dla spółek wpisz dane ręcznie.
4. Zmiana środowiska: po przełączeniu między Testowym a Produkcyjnym wykonaj ponownie „Testuj połączenie".

Kontakt

Potrzebujesz pomocy? Napisz na support@ksef-connect.pl.