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 — żadnych 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 środowisko TEST (domyślnie zaznaczone), 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ę przez normalny pipeline do piaskownicy. Gdy wróci UPO, wiesz, że wszystko działa — 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ż na cały świat.
• Zrozumiesz przepływ: Jak działa składanie.
• Sprzedaż w walucie obcej i kurs wymagany prawem: Waluty i NBP.
• Przełącz się na PROD, gdy testy działają — świadomie, z potwierdzeniem: Przejście na produkcję.
• Co przechowujemy i jak: Dane i bezpieczeństwo.

KSeF jest obowiązkowy od 1 stycznia 2027. Warto być gotowym wcześniej — checklista gotowości w aplikacji prowadzi krok po kroku.