Szybki start

Tak wygląda sukces: faktura w Stripe zostaje sfinalizowana, my składamy ją do KSeF, a Ty dostajesz UPO i numer KSeF, zapisane wprost na fakturze w Stripe. Automatycznie, bez Twojego udziału.

KSeF Kit doprowadza Cię tam w trzech krokach; pierwsza faktura testowa zajmuje minutę.

1. Zainstaluj aplikację Stripe

W panelu Stripe otwórz Apps → App Marketplace, wyszukaj KSeF Kit i kliknij Install. To edycja chmurowa: nic nie hostujesz. Po instalacji powstaje konto i aktywne połączenie ze Stripe; od tej pory każda sfinalizowana faktura trafia do nas webhookiem (ten webhook konfigurujemy za Ciebie, bez ręcznych ustawień w Stripe Developers).

Wolisz uruchomić u siebie? Zobacz Instalacja na własnym serwerze.

2. Onboarding (3 kroki)

Po instalacji otwórz aplikację z Stripe → Apps → KSeF Kit (albo zaloguj się bezpośrednio). Kreator prowadzi przez trzy kroki. Kolejny niezrobiony krok otwiera się sam.

1. Stripe. Połączenie powstaje przy instalacji aplikacji.
2. Dane firmy. Podaj NIP. Sprawdzamy sumę kontrolną i pobieramy nazwę oraz adres z rejestru (Biała lista MF / GUS). Te dane trafiają na fakturę jako sprzedawca.
3. Połączenie z KSeF. Najpierw wybierasz środowisko TEST (zaznaczone domyślnie), potem wklejasz token. Szczegóły: Połączenie z KSeF.

Krok KSeF możesz pominąć. Faktury czekają wtedy bezpiecznie w kolejce i nie są składane, dopóki nie połączysz konta.

3. Pierwsza faktura testowa

Po połączeniu KSeF ze środowiskiem TEST uruchamiamy moment „aha”: składamy przykładową fakturę do piaskownicy, tą samą drogą co każdą inną. Gdy wróci UPO, wiesz, że wszystko działa, jeszcze zanim przyjdzie pierwsza prawdziwa faktura.

UPO (urzędowe poświadczenie odbioru) to podpisany dokument, który KSeF zwraca po przyjęciu faktury, wraz z nadanym numerem KSeF. To Twój dowód prawny, że faktura została złożona. Przechowujemy go przy każdej przyjętej fakturze.

To wszystko dzieje się w środowisku TEST (piaskownica), bez żadnych skutków prawnych. Możesz testować bez obaw. Zobacz Dane i bezpieczeństwo.

Ważne. Nigdy nie składamy przykładowej faktury na PRODUKCJI. Fikcyjny dokument w krajowym rejestrze naruszałby prawo (art. 108 ustawy o VAT). Na koncie połączonym z produkcją, gdy nie ma jeszcze nic do złożenia, widzisz spokojny stan „Jesteś na żywo”, a Twoja pierwsza prawdziwa faktura ze Stripe składa się automatycznie. Aby poćwiczyć, przełącz się najpierw na TEST.

Co dalej

• Zobacz, które z Twoich sprzedaży stają się fakturami KSeF: Sprzedaż za granicę.
• Cały przepływ krok po kroku: Jak działa składanie.
• Sprzedaż w walucie obcej i kurs wymagany prawem: Waluty i NBP.
• Gdy testy działają, przełącz się na PROD, świadomie i z potwierdzeniem: Przejście na produkcję.
• Co przechowujemy i jak: Dane i bezpieczeństwo.

KSeF jest obowiązkowy od 1 stycznia 2027. Przygotuj się wcześniej: checklista gotowości w aplikacji prowadzi krok po kroku.