Większość dem oprogramowania do fakturowania kończy się dokładnie tam, gdzie zaczyna się problem: na ładnym formularzu i przycisku „Wystaw". To, co decyduje o tym, czy faktura w ogóle istnieje w oczach administracji skarbowej — przyjęcie przez bramkę, numer KSeF, UPO — zostaje za kadrem.

Nagrałem więc całą drogę bez cięć, z licznikiem w rogu ekranu: rejestracja, dane firmy z GUS, podłączenie KSeF, kontrahent, pozycja, wystawienie, wysyłka, numer, UPO. Siedem minut i kilkanaście sekund.

To nie jest akademickie ćwiczenie. Od 1 kwietnia 2026 r. obowiązek wystawiania faktur w KSeF dotyczy praktycznie każdego czynnego podatnika VAT, a okres ochronny kończy się 31 grudnia 2026 r. — według Ministerstwa Finansów kary za niedopełnienie obowiązków KSeF nie są nakładane w okresie 1.02.2026–31.12.2026, a przepisy sankcyjne (art. 106ni ustawy o VAT) wchodzą w życie 1 stycznia 2027 r. Zostało kilkanaście tygodni na to, żeby przećwiczyć całą ścieżkę bez ryzyka.

Poniżej: timecody, transkrypt i uczciwa lista tego, czego w nagraniu nie ma.

Co dokładnie pokazuje nagranie

Jedno ujęcie, jedna firma, jedna faktura. Licznik nie był zatrzymywany ani razu.

Timecode Krok Co się dzieje 0:00 Rejestracja E-mail, hasło, potwierdzenie. Bez karty. 0:35 Firma po NIP Wpisuję NIP, dane lecą z rejestru GUS: nazwa, adres, forma prawna, status VAT 1:20 Podłączenie KSeF Wybór środowiska (test/produkcja), uwierzytelnienie, nadanie uprawnienia 3:05 Kontrahent Znowu NIP → GUS; równolegle sprawdzenie statusu w wykazie podatników VAT 3:50 Pozycja faktury Nazwa usługi, netto, stawka 23%, oznaczenie GTU 4:40 Wystawienie Numer z szablonu numeracji, walidacja XSD FA(3) przed wysyłką 5:25 Wysyłka do KSeF Sesja, przesłanie dokumentu, status processing 6:10 Numer KSeF Wraca 35-znakowy numer — faktura jest wystawiona 6:40 UPO Pobranie urzędowego poświadczenia odbioru do pliku 7:05 Wizualizacja PDF z kodem weryfikacyjnym, wysyłka mailem do klienta

Najważniejsza rzecz w tej tabeli to proporcje. Samo „wypisanie faktury" — kontrahent, pozycja, kwota — zajmuje niecałe dwie minuty. Reszta to jednorazowa konfiguracja firmy i KSeF, której już nigdy nie powtórzysz.

Warunki nagrania — czego tam nie ma

Nagranie zrobiłem na środowisku testowym KSeF (api-test.ksef.mf.gov.pl), na firmie założonej na potrzeby demo. To ma konsekwencje, które trzeba powiedzieć wprost:

• Nadanie uprawnień nie zawsze jest natychmiastowe. Jeśli w Twojej firmie nikt jeszcze nie ma uprawnień w KSeF, pierwsze nadanie idzie przez zgłoszenie ZAW-FA do urzędu skarbowego (papier lub e-Urząd Skarbowy) i to jest osobna, urzędowa ścieżka. W demo firma miała już uprawnienia — inaczej licznik pokazałby dni, nie minuty.

• Zgoda na faktury z załącznikiem to odrębny wniosek do KAS; na produkcji odpowiedź potrafi iść do trzech dni roboczych. W nagraniu faktura jest bez załącznika.

• Bramka testowa bywa szybsza niż produkcyjna. Na produkcji między wysyłką a numerem KSeF potrafi minąć kilkadziesiąt sekund więcej, zwłaszcza w okolicach 25. dnia miesiąca.

Innymi słowy: siedem minut to czas pracy w programie, a nie czas załatwienia formalności z urzędem. Jeśli Twoja firma nie ma jeszcze nikogo z uprawnieniami w KSeF, zacznij od ZAW-FA — reszta rzeczywiście zajmie tyle, ile pokazuje licznik.

Transkrypt (skrót z timecodami)

0:00 — „Zaczynamy od pustej skrzynki pocztowej. Konto zakładam na adres, którego nigdy wcześniej nie było w systemie, żeby nie było wątpliwości, że coś jest przygotowane wcześniej."

0:35 — „Nie wpisuję nazwy firmy ani adresu. Wpisuję NIP. Dane idą z rejestru GUS — nazwa, adres, forma prawna. Status VAT sprawdzamy osobno, w wykazie podatników. Jeżeli coś się nie zgadza z rzeczywistością, to znaczy, że rozjechał się rejestr, a nie formularz."

1:20 — „Teraz jedyny krok, który wymaga uwagi: podłączenie KSeF. Wybieram środowisko — tu testowe, na produkcji wybierasz produkcyjne i to jest decyzja nieodwracalna w tym sensie, że faktury wysłane na produkcję są fakturami w obrocie prawnym. Uwierzytelniam firmę i od tej chwili Biurko działa jako podmiot uprawniony: wysyła i odbiera dokumenty w jej imieniu, w granicach nadanego uprawnienia."

3:05 — „Kontrahent — znowu NIP, znowu GUS. Obok widać status w wykazie podatników VAT, sprawdzony na dziś. To nie jest ozdoba: przy fakturze poza KSeF to nabywca musiałby weryfikować, czy dokument został wystawiony prawidłowo."

3:50 — „Jedna pozycja: usługa programistyczna, 4 200 zł netto, stawka 23%, GTU_12. Pole GTU jest podpowiadane, ale decyzja należy do podatnika — program nie zna Twojego PKWiU lepiej niż Ty."

4:40 — „Wystawiam. W tym momencie dokument dostaje numer z szablonu numeracji i jest walidowany wobec schemy FA(3). Jeśli XML nie przejdzie walidacji, dowiadujesz się o tym tutaj, a nie od bramki."

5:25 — „Wysyłka. Otwiera się sesja, dokument idzie do KSeF, status processing. To jest jedyny moment, w którym się czeka."

6:10 — „Jest numer:

6343060594-20260917-0A1B2C3D4E5F-7C

Trzydzieści pięć znaków: NIP sprzedawcy, data, identyfikator dokumentu, suma kontrolna. Od tej chwili faktura jest wystawiona — nie od chwili, w której kliknąłem „Wystaw"."

6:40 — „UPO. Pobieram plik i zostawiam go w dokumentach firmy. To jest dowód przesłania, którego nie odtworzysz z PDF-a."

7:05 — „Na koniec wizualizacja — PDF z kodem weryfikacyjnym — i mail do klienta. PDF nie jest fakturą. Jest obrazkiem faktury, która żyje w KSeF."

Trzy miejsca, w których ten proces się wykłada

1. Brak uprawnień w KSeF. Najczęstsza przyczyna „nie działa mi integracja". Program nie może nadać sobie uprawnień — robi to podatnik po swojej stronie. Jeśli nikt w firmie nie ma uprawnień pierwotnych, ścieżka zaczyna się od ZAW-FA.

2. Odrzucenie po stronie schemy. Faktura poprawna „po ludzku" bywa niepoprawna wobec FA(3): brak wymaganego węzła, zła kombinacja stawki i podstawy zwolnienia, kontrahent zagraniczny bez właściwego identyfikatora. Dlatego walidacja przed wysyłką ma sens — kod błędu z bramki mówi mniej niż komunikat w formularzu.

3. Traktowanie PDF-a jak faktury. Od momentu objęcia obowiązkiem PDF wysłany mailem nie jest fakturą, tylko wizualizacją. Klient, który go zapłaci, zapłaci za dokument, którego formalnie nie wystawiono — a od 1 stycznia 2027 r. w tytule przelewu między czynnymi podatnikami VAT ma się znaleźć numer KSeF.

Checklista: powtórz to u siebie

1. Sprawdź, czy ktokolwiek w Twojej firmie ma uprawnienia w KSeF. Jeśli nie — złóż ZAW-FA, zanim zaczniesz cokolwiek konfigurować.

2. Najpierw środowisko testowe. Wystaw trzy faktury: zwykłą, korektę i zaliczkową.

3. Sprawdź, czy dostajesz numer KSeF i UPO, i czy umiesz je znaleźć po dwóch tygodniach.

4. Zweryfikuj szablon numeracji na styczeń — ciągłość numeracji to Twój obowiązek, nie programu.

5. Przejdź na produkcję i wystaw pierwszą prawdziwą fakturę przed końcem okresu ochronnego, nie w styczniu.

6. Ustal, co robisz przy awarii bramki (tryb offline24) — i sprawdź to raz, na spokojnie.

Podsumowanie

Siedem minut to nie jest obietnica marketingowa, tylko miara jednej rzeczy: ile trwa droga od zera do dokumentu, który ma numer KSeF i UPO. Cała reszta — korekty, zaliczki, import faktur zakupowych, rejestry — zaczyna się dopiero za tym punktem, ale bez tego punktu nie zaczyna się nic.

Jeśli chcesz przejść tę samą ścieżkę na własnym NIP-ie: załóż konto na biurko.io — 14 dni bez opłat, ze środowiskiem testowym KSeF włączonym od pierwszej minuty. Nagranie i pełny transkrypt są pod artykułem.

3. FAQ

Ile naprawdę trwa wystawienie pierwszej faktury w KSeF? Sama praca w programie — około siedmiu minut, z czego pięć to jednorazowa konfiguracja firmy i połączenia z KSeF. Kolejne faktury zajmują kilkadziesiąt sekund. Czas urzędowy (nadanie uprawnień przez ZAW-FA) jest osobny i liczy się w dniach.

Czym jest numer KSeF i skąd go wziąć? To 35-znakowy identyfikator nadawany przez system po przyjęciu dokumentu; zawiera NIP sprzedawcy, datę i sumę kontrolną. Nie nadajesz go sam — wraca z bramki po wysyłce. Od 1 stycznia 2027 r. trafia też do tytułu przelewu między czynnymi podatnikami VAT.

Czy UPO jest potrzebne, skoro mam numer KSeF? Tak. Numer identyfikuje fakturę, UPO poświadcza fakt i moment przesłania. To dwa różne dowody i warto trzymać oba, niezależnie od tego, że oryginał faktury przechowuje KSeF.

Czy mogę przetestować KSeF bez ryzyka? Tak — środowisko testowe Ministerstwa Finansów jest oddzielone od produkcyjnego, a dokumenty tam wystawione nie wywołują skutków podatkowych. Dodatkowo do 31 grudnia 2026 r. trwa okres przejściowy bez kar administracyjnych.

Czy PDF wysłany mailem wystarczy klientowi? Nie zastępuje faktury. Po objęciu obowiązkiem KSeF dokumentem jest faktura ustrukturyzowana w systemie, a PDF jest jej wizualizacją — wysyłaną dla wygody odbiorcy, nie zamiast e-faktury.