Szybki start

Tak to działa: faktura w Stripe zostaje sfinalizowana, my automatycznie składamy ją do KSeF, a Ty dostajesz UPO i numer KSeF. Numer KSeF zapisujemy w metadanych faktury w Stripe, a UPO znajdziesz w panelu KSeF Kit.

Konfiguracja to trzy kroki; 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 połączone ze Stripe. Od tej pory każda sfinalizowana faktura trafia do nas automatycznie: webhook konfigurujemy za Ciebie, więc w Stripe Developers nic nie ustawiasz.

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 Cię przez trzy kroki.

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 dane sprzedawcy.
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 w kolejce, dopóki nie połączysz konta.

3. Pierwsza faktura testowa

Po połączeniu KSeF ze środowiskiem TEST 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. 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 stan „Działasz 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: Przejście na produkcję.
• Co przechowujemy i jak: Dane i bezpieczeństwo.

KSeF jest już obowiązkowy (terminy i wyjątki: Przejście na produkcję). Lista gotowości w aplikacji prowadzi Cię krok po kroku.