Integracja KSeF z iFirma — krok po kroku

Wprowadzenie

iFirma od dwóch lat ma moduł KSeF — i dla zdecydowanej większości użytkowników aktywacja zajmuje 30 minut, nie 3 dni jak straszą niektóre poradniki. Pułapki istnieją, ale są dobrze udokumentowane i większość z nich wyłapie środowisko testowe MF.

Ten przewodnik prowadzi od kliknięcia w zakładkę KSeF do pierwszej prawdziwej faktury w produkcji. Krok po kroku, z tym, na co realnie warto uważać.

Krok 1: Aktywacja modułu KSeF w iFirma

1. Zaloguj się do iFirma.
2. W menu po lewej znajdź zakładkę „KSeF” — w nowszych wersjach jest w sekcji Faktury sprzedaży, w starszych w Ustawieniach konta.
3. Kliknij Aktywuj KSeF.
4. Wybierz typ podmiotu: Osoba fizyczna (JDG) lub Spółka.
5. Potwierdź NIP i nazwę — muszą się zgadzać z tym, co masz w CEIDG/KRS.

To wszystko. Moduł jest aktywny — ale na razie tylko w trybie demo. Realnych faktur jeszcze nie wysyła.

Krok 2: Konfiguracja autoryzacji

KSeF wymaga, żebyś udowodnił, kim jesteś, zanim wystawi cokolwiek w twoim imieniu. Trzy ścieżki — wybierz jedną:

Dla zdecydowanej większości użytkowników iFirma wybór to Profil Zaufany. Ścieżka wygląda tak:

1. Kliknij w iFirma „Autoryzuj przez Profil Zaufany”.
2. iFirma przekierowuje cię na pz.gov.pl — logujesz się jak zwykle.
3. Zaakceptuj zakres uprawnień: wystawianie faktur, odbieranie faktur.
4. Wracasz do iFirma. Gotowe.

Krok 3: Środowisko testowe MF — przetestuj zanim wyślesz

To krok, którego nie warto pomijać. Ministerstwo Finansów udostępnia środowisko testowe pod adresem ksef-test.mf.gov.pl — identyczne API, dane testowe, faktury nie mają skutku prawnego.

W iFirma:

1. Zakładka KSeF → Ustawienia → Środowisko
2. Przełącz z Produkcyjne na Testowe (demo MF)
3. Wystaw 3–5 testowych faktur do różnych kontrahentów (testowych NIP-ów MF jest pełna lista w panelu)
4. Sprawdź, czy każda otrzymała numer KSeF (format 1234567890-20260328-AB12CD-XX)
5. Pobierz UPO (Urzędowe Poświadczenie Odbioru) — to PDF, który KSeF generuje jako dowód

Jeśli wszystko 3–5 razy pod rząd działa bez błędu — możesz przełączać na produkcję.

Przykład numeru KSeF
8901234567-20260328-AB12CD-7F
   NIP         data    losowy   suma kontrolna

Krok 4: Pierwsza prawdziwa faktura

Wracasz do produkcji: KSeF → Ustawienia → Środowisko → Produkcyjne.

Wystaw fakturę jak zwykle. Po zatwierdzeniu iFirma:

1. Generuje XML wg schematu FA(2) Ministerstwa Finansów
2. Wysyła do KSeF z twoim podpisem
3. Czeka na potwierdzenie (zwykle 1–3 sekundy)
4. Zapisuje numer KSeF w fakturze
5. Wysyła ci powiadomienie email z linkiem do UPO

Twój kontrahent dostaje fakturę przez KSeF, nie e-mailem:

• jeśli też używa iFirma — pojawi się u niego automatycznie w zakładce Faktury zakupu,
• jeśli używa innego programu — jego program też pobierze ją z KSeF.

Dla większości firm to wręcz wygodniejsze niż dzisiejsze wysyłanie PDF-ów e-mailem. Mniej pracy, mniej miejsc, w których można zgubić fakturę.

5 typowych błędów (i jak ich uniknąć)

Poniższe pięć błędów najłatwiej popełnić przy pierwszej wysyłce — wszystkie wynikają wprost z walidacji schemy FA(2) i z tego, jak iFirma mapuje na nią dane z formularza. Każdy z nich wyjdzie w czasie testów — jeśli przerobisz krok 3 — ale lepiej je znać wcześniej:

1. NIP kontrahenta w złym formacie

KSeF wymaga NIP bez kresek (8901234567, nie 890-123-45-67). iFirma normalizuje to automatycznie, ale jeśli importujesz kontrahentów z Excela — sprawdź.

2. Data wystawienia w przyszłości

KSeF odrzuca faktury z datą wystawienia po dacie wysyłki. Brzmi oczywiste, ale przy fakturach wystawianych późnym wieczorem różnica stref czasowych potrafi przesunąć datę o dobę — wtedy dostajesz error 4xx.

3. Brak NIP-u w nagłówku sprzedawcy

Jeśli wystawiasz fakturę jako osoba fizyczna nieprowadząca działalności — KSeF cię nie obsłuży. To są przypadki, gdzie faktyczna umowa cywilnoprawna nie jest fakturą VAT. Sprawdź typ dokumentu.

4. Sesja autoryzacyjna wygasła

Sesja KSeF jest ważna 2 godziny. Jeśli wystawiasz wiele faktur naraz po przerwie — iFirma poprosi cię o ponowną autoryzację. Nic strasznego, ale frustrujące pierwszego dnia.

5. Limit znaków w polu „Nazwa towaru/usługi”

KSeF ma limit 256 znaków w nazwie pozycji. Większość programów ostrzega, ale iFirma do niedawna nie ostrzegała — sprawdzaj długie opisy.

Co dalej

Po wdrożeniu KSeF następnym krokiem jest zwykle automatyzacja księgowania faktur zakupowych. iFirma robi to z urzędu — wszystkie faktury, które trafiają do ciebie przez KSeF, są automatycznie zaksięgowane w Faktury zakupu, gotowe do akceptacji.

Jeśli twoja firma używa innego systemu niż iFirma (Subiekt, Comarch, Symfonia) — proces wygląda podobnie, ale szczegóły aktywacji się różnią. Zobacz pełny pillar KSeF z porównaniem 3 ścieżek wdrożenia.

Podsumowanie

iFirma + KSeF to jedna z najprostszych ścieżek wdrożenia — 30 minut konfiguracji, tydzień testów na środowisku MF, potem realne faktury. Najważniejsze:

• Profil Zaufany wystarczy dla zdecydowanej większości solo działalności
• Tryb testowy to nie opcja — to obowiązkowy krok przed produkcją
• Pełnomocnictwo dla księgowej to osobne uprawnienie w KSeF — nie zapomnij

Jeśli wdrażasz KSeF w firmie używającej iFirma i utknąłeś — napisz do mnie. Wdrożenia robię fixed-price, od 6 tys. netto (typowo 8–14 tys.), orientacyjnie w ~1–3 tygodnie; dokładny termin po ustaleniu zakresu. Odpowiadam do następnego dnia roboczego. Zobacz pełną ofertę: wdrożenie KSeF.