Integracja z KSeF: jak połączyć sklep lub system firmy z Krajowym Systemem e-Faktur
KSeF jest obowiązkowy dla większości firm od 2026 roku. Kiedy wystarczy program księgowy, a kiedy własny sklep, CRM czy system zamówień musi łączyć się z KSeF przez API.
Krajowy System e-Faktur (KSeF) jest obowiązkowy dla dużych przedsiębiorców od 1 lutego 2026 roku, dla pozostałych firm od 1 kwietnia 2026, a dla najmniejszych — których sprzedaż dokumentowana fakturami nie przekracza 10 tys. zł miesięcznie — od 1 stycznia 2027. Jeśli wystawiasz faktury w programie księgowym, zwykle wystarczy jego integracja z KSeF. Jeśli faktury powstają w Twoim sklepie, CRM albo systemie zamówień, ten system musi sam rozmawiać z KSeF przez API — albo przekazywać dane do narzędzia, które to robi.
Harmonogram obowiązkowego KSeF
Etapy wdrożenia KSeF 2.0
1
1 lutego 2026
Obowiązek dla dużych przedsiębiorców oraz odbieranie faktur przez KSeF.
2
1 kwietnia 2026
Obowiązek dla wszystkich pozostałych przedsiębiorców wystawiających faktury — poza najmniejszymi.
3
1 stycznia 2027
Obowiązek także dla firm, których sprzedaż dokumentowana fakturami nie przekracza 10 tys. zł miesięcznie.
Co się zmienia w praktyce
Faktura przestaje być plikiem PDF wysyłanym mailem. Jest ustrukturyzowanym dokumentem XML według schemy Ministerstwa Finansów, który trafia do KSeF i dostaje tam swój numer. Odbiorca pobiera fakturę z systemu, a nie ze skrzynki mailowej. Dla firmy oznacza to, że każde miejsce, w którym dziś powstają faktury, musi umieć wysłać je do KSeF — i odebrać faktury kosztowe.
Trzy sposoby wystawiania faktur w KSeF
Jak firma może korzystać z KSeF
Program z integracją
Własny system przez API
Dla kogo
Faktury wystawiane ręcznie lub w programie księgowym
Faktury generowane automatycznie: sklep, CRM, system zamówień
Co trzeba zrobić
Włączyć integrację i nadać uprawnienia
Zbudować połączenie z API KSeF i obsługę błędów
Ręczna praca
Przy każdej fakturze
Brak — faktura wysyła się po opłaceniu zamówienia
Kontrola
Po stronie dostawcy programu
Po Twojej stronie, z pełnym logiem wysyłek
Trzecią drogą są bezpłatne narzędzia Ministerstwa Finansów do ręcznego wystawiania faktur — wystarczające przy kilku fakturach miesięcznie, ale niepraktyczne, gdy faktur są dziesiątki albo setki.
CRM lub system zleceń generuje faktury z wycen i umów.
Sprzedajesz w kilku kanałach i faktury powstają w różnych miejscach, a księgowość chce mieć je w jednym.
Potrzebujesz automatycznie pobierać faktury kosztowe i księgować je albo przypisywać do projektów.
Jak wygląda integracja z API KSeF
Integracja krok po kroku
1
Uprawnienia i uwierzytelnienie
Nadanie systemowi uprawnień do wystawiania lub odbierania faktur w imieniu firmy i bezpieczne przechowywanie danych dostępowych.
2
Mapowanie danych
Pola z Twojego systemu (nabywca, pozycje, stawki VAT, płatność) na strukturę e-faktury.
3
Wysyłka i numer KSeF
Wysłanie dokumentu, odebranie statusu i numeru KSeF, zapis przy zamówieniu.
4
Obsługa błędów i niedostępności
Ponawianie, kolejka, powiadomienie, gdy faktura zostanie odrzucona — oraz procedury na czas awarii systemu.
5
Testy na środowisku testowym
Ministerstwo udostępnia środowiska testowe — integrację sprawdza się na nich, zanim trafi do produkcji.
Najwięcej pracy nie wymaga samo wysłanie faktury, tylko przypadki brzegowe: korekty, zaliczki, faktury dla konsumentów, niedostępność systemu, odrzucenie dokumentu przez walidację. To one decydują o tym, czy integracja działa spokojnie, czy co tydzień ktoś coś poprawia ręcznie.
Ile to kosztuje
Koszt zależy od tego, ile rodzajów faktur i ile miejsc w firmie je generuje. Integracja jednego sklepu z KSeF to zwykle moduł do istniejącego projektu, a połączenie kilku systemów z automatycznym pobieraniem faktur kosztowych — osobny projekt. Szczegółowo wyceniam po krótkim opisie Twoich faktur; widełki pakietów znajdziesz w cenniku. Integracje i automatyzacje to jedna z moich usług, a o tym, co jeszcze warto zautomatyzować przy okazji, piszę w tekście o automatyzacji procesów.
Najczęstsze pytania
›Czy faktury dla osób prywatnych też idą przez KSeF?
Zasady dla faktur konsumenckich różnią się od faktur między firmami. To kwestia, którą warto potwierdzić z księgowym dla Twojego modelu sprzedaży, zanim zaprojektuje się integrację.
›Co, jeśli KSeF nie działa?
Przepisy przewidują tryby awaryjne i offline z późniejszym przesłaniem faktur. Integracja powinna to obsługiwać automatycznie — kolejką i ponowną wysyłką — zamiast zatrzymywać sprzedaż.
›Mój program księgowy już ma KSeF. Czy potrzebuję czegoś więcej?
Jeśli wszystkie faktury wystawiasz w tym programie — prawdopodobnie nie. Integracja jest potrzebna wtedy, gdy faktury powstają gdzie indziej (sklep, CRM) i dziś ktoś przepisuje je ręcznie.
Chcesz przegadać swój projekt?
Odpowiadam osobiście w ciągu 24h w dni robocze — bez handlowca po drodze.