KSeF Demo — Pierwsza Faktura Bez Ryzyka

Zanim wystawisz pierwszą prawdziwą fakturę w KSeF — wystaw pięć fałszywych. Środowisko DEMO jest po to, żeby się zorientować, co robi system, gdzie są pola, jak wyglądają błędy walidacji i jak działa numer KSeF. Bez Profilu Zaufanego, bez certyfikatu, bez konsekwencji. Tutaj jest dokładnie, jak to zrobić w 15 minut.

KSeF ma trzy oddzielne środowiska: DEMO, TEST i PROD. Wszystkie trzy działają identycznie z punktu widzenia API i interfejsu — różnią się tym, kto może wejść i co się dzieje z fakturami.

DEMO jest publiczne i otwarte dla każdego. To piaskownica — sprawdzasz, jak wygląda formularz, klikasz, popełniasz błędy, uczysz się. Faktury z DEMO nie istnieją w księgowości i nie mają żadnego znaczenia prawnego.

1. 01

   Wejdź na ksef-demo.mf.gov.pl

   Otwórz adres w przeglądarce. Nie loguj się — środowisko DEMO nie wymaga konta. Zobaczysz interfejs identyczny z prawdziwym KSeF.

2. 02

   Wybierz "Wystaw fakturę"

   W menu głównym kliknij "Wystaw fakturę". Otworzy się formularz z polami: dane wystawcy, dane nabywcy, pozycje, podsumowanie VAT.

3. 03

   Wpisz fikcyjny NIP wystawcy

   W polu NIP wystawcy wpisz dowolne 10 cyfr (np. 1234567890). DEMO nie waliduje NIP-u w bazie REGON — możesz wpisać cokolwiek. Adres firmy i nazwa: cokolwiek (np. "Warsztat Testowy, ul. Testowa 1, 50-001 Wrocław").

4. 04

   Wpisz fikcyjnego klienta

   W sekcji Nabywca wpisz drugi NIP i dane. Mogą być różne dla testowania scenariuszy: VAT-owiec firma, osoba fizyczna (z PESEL zamiast NIP), klient zagraniczny (UE z NIP-em VAT).

5. 05

   Dodaj pozycję faktury

   Kliknij "Dodaj pozycję". Wpisz: nazwa usługi (np. "Wymiana oleju silnikowego"), ilość (1), cena netto (300.00), stawka VAT (23%). System obliczy VAT i brutto automatycznie (300 + 69 = 369 zł brutto).

6. 06

   Sprawdź podsumowanie i wyślij

   Na dole formularza zobaczysz podsumowanie VAT w rozbiciu na stawki. Kliknij "Wyślij do KSeF". W ciągu 2-5 sekund dostaniesz numer KSeF (długi ciąg cyfr z myślnikami, np. 1234567890-20260201-A1B2C3-AB).

7. 07

   Pobierz UPO

   UPO (Urzędowe Poświadczenie Odbioru) to potwierdzenie, że KSeF przyjął Twoją fakturę. W DEMO UPO ma rzeczywistą postać — PDF z pieczęcią Ministerstwa Finansów (oczywiście oznaczony "DEMO"). Pobierz go, żeby zobaczyć, jak wygląda.

Po pierwszej udanej fakturze — pograj się z błędami. Każdy z poniższych scenariuszy zobaczysz w PROD prędzej czy później; lepiej je poznać teraz, w piaskownicy.

Test 1: Nieprawidłowy NIP klienta

Wystaw fakturę z NIP-em klienta 0000000000 (10 zer). KSeF odrzuci ją z błędem walidacji: "Nieprawidłowy NIP — nie spełnia algorytmu kontrolnego". Tak samo zobaczysz w PROD, jeśli pomylisz cyfrę w prawdziwym NIP-ie.

Test 2: Błędna stawka VAT

Dodaj pozycję ze stawką VAT 15% (która nie istnieje w polskim systemie VAT). KSeF zwróci błąd: "Nieprawidłowa stawka VAT — dozwolone wartości: 23, 8, 5, 0, zw, np". Ucz się prawidłowych oznaczeń: zw = zwolniona, np = nie podlega.

Test 3: Data sprzedaży w przyszłości

Wystaw fakturę z datą sprzedaży za 2 lata. KSeF odrzuci: "Data dokonania dostawy/wykonania usługi nie może być w przyszłości dłużej niż 7 dni". Faktury muszą dokumentować już wykonane prace.

Test 4: Suma pozycji ≠ wartość faktury

Wpisz ręcznie wartość brutto inną niż suma pozycji × VAT. Większość programów warsztatowych liczy to automatycznie, ale w aplikacji podatnika można wpisać dowolną wartość. KSeF wykryje niezgodność: "Suma kwot brutto pozycji ≠ wartość brutto faktury".

Test 5: Korekta bez referencji do faktury pierwotnej

Wystaw fakturę korygującą, ale nie wpisz numeru KSeF faktury, do której się odnosi. Błąd: "Faktura korygująca musi zawierać numer KSeF faktury korygowanej". To częsty problem przy ręcznym wystawianiu korekt w aplikacji podatnika — program robi to automatycznie.

DEMO to nie cel — to wstęp. Przejdź do TEST (środowisko z prawdziwym certyfikatem, ale fakturami nieliczonymi w księgowości), kiedy spełnisz wszystkie poniższe warunki:

• Wystawiłeś minimum 5 udanych faktur w DEMO (różne stawki VAT, różne typy klientów).
• Przetestowałeś co najmniej 3 błędy z sekcji 3 i wiesz, jak system reaguje.
• Pobrałeś certyfikat KSeF z e-Urzędu Skarbowego (instrukcja).
• Wgrałeś certyfikat do swojego programu warsztatowego (albo aplikacji podatnika).
• Wiesz, kiedy KSeF Cię obowiązuje (sprawdź daty).

Środowiska DEMO/TEST/PROD są po stronie Ministerstwa Finansów. Po Twojej stronie wybierasz, czym wysyłasz faktury: bezpośrednio aplikacją podatnika MF lub przez dedykowany program (np. mWarsztat).

Praktyczna rekomendacja:

• Pierwsze 5-10 faktur DEMO — wystaw przez aplikację podatnika na ksef-demo.mf.gov.pl. Zobacz, jak działa "surowy" KSeF.
• Kolejne testy w DEMO + cały TEST — przez Twój docelowy program warsztatowy. Większość programów (mWarsztat, comarch ERP XL, eSowa) ma przełącznik DEMO/TEST/PROD w ustawieniach. Tak testujesz rzeczywistą integrację, nie samo API.
• PROD od daty obowiązku — wyłącznie przez program. Jeśli masz więcej niż 30 faktur miesięcznie, aplikacja podatnika jest stratą czasu.