KSeF krok po kroku — pierwsza faktura w systemie

Krajowy System e-Faktur (KSeF) to centralny system Ministerstwa Finansów do wystawiania i odbierania faktur ustrukturyzowanych. Jeśli wystawiasz pierwszą fakturę przez KSeF, oto co faktycznie musisz zrobić — krok po kroku, bez żargonu.

Krok 1: token albo certyfikat

Żeby system mógł wysłać fakturę do KSeF w Twoim imieniu, potrzebuje jednego z dwóch sposobów uwierzytelnienia:

• Token KSeF — generujesz go w portalu Ministerstwa Finansów, logując się danymi swojej firmy (NIP + podpis kwalifikowany, profil zaufany albo pieczęć firmy).
• Certyfikat XAdES — certyfikat kwalifikowany, jeśli Twoja firma go już ma.

Bez jednego z nich system nie wyśle faktury do KSeF — i nie udaje, że wysłał. Dostaniesz jasny komunikat, że brakuje autoryzacji, zamiast fałszywego potwierdzenia.

Krok 2: środowisko TEST czy produkcyjne

Ministerstwo Finansów udostępnia osobne środowisko testowe (TEST) i produkcyjne (PRD). Jeśli pierwszy raz masz kontakt z KSeF, zacznij od TEST — token z portalu testowego działa tylko tam, więc nic realnie nie wyślesz do systemu produkcyjnego przez pomyłkę. Gdy oswoisz się z procesem, przełączasz firmę na środowisko produkcyjne i wklejasz token produkcyjny.

Krok 3: wystawiasz fakturę

Z perspektywy wystawiania faktura wygląda tak samo jak każda inna — dane nabywcy, pozycje, stawki VAT, termin płatności. Różnica jest niewidoczna dla Ciebie: po zatwierdzeniu system pakuje fakturę w ustrukturyzowany format XML (schemat FA), podpisuje sesję Twoim tokenem i wysyła do KSeF.

Krok 4: numer KSeF

Jeśli wysyłka się powiedzie, faktura dostaje unikalny numer identyfikacyjny KSeF — to on jest dowodem, że dokument trafił do systemu, nie sama data wystawienia. Numer KSeF widoczny jest na fakturze i w historii dokumentu.

Co może pójść nie tak

• Brak autoryzacji — token wygasł albo nie został wklejony. Rozwiązanie: wygeneruj nowy w portalu MF.
• Błąd walidacji XML — najczęściej brakujący albo źle sformatowany NIP nabywcy. System pokaże dokładnie, którego pola dotyczy błąd.
• Awaria systemu MF — zdarza się, KSeF bywa niedostępny. To osobny temat, który rozwijamy w kolejnym wpisie.

Jedno zdanie na koniec: żadna z tych rzeczy nie dzieje się „w tle bez Twojej wiedzy". Każdy etap — wysyłka, numer KSeF, ewentualny błąd — jest widoczny na koncie, zanim uznasz sprawę za załatwioną.