Integracja z KSeF — sklep internetowy, CRM i system firmy przez API

Integracja z KSeF: faktura ze sklepu lub CRM trafia do systemu sama

Jeśli faktury powstają w Twoim sklepie, CRM albo systemie zamówień, to ten system musi umieć rozmawiać z Krajowym Systemem e-Faktur. Łączę go z API KSeF tak, żeby nikt nie przepisywał faktur ręcznie — i żeby awaria po stronie Ministerstwa nie zatrzymała sprzedaży.

BEZPOŚREDNIO

API KSeF 2.0

ŹRÓDŁO FAKTUR

Sklep / CRM

ŚRODOWISKA MF

Test → prod

Czy potrzebujesz integracji z KSeF?

KSeF jest obowiązkowy dla dużych firm od 1 lutego 2026, dla pozostałych od 1 kwietnia 2026, a dla najmniejszych (sprzedaż fakturowana do 10 tys. zł miesięcznie) od 1 stycznia 2027 — według harmonogramu Ministerstwa Finansów. To, czy potrzebujesz integracji, zależy od tego, gdzie powstają Twoje faktury:

Program księgowy czy integracja?

	Wystarczy program księgowy	Potrzebna integracja
Gdzie powstaje faktura	W programie (wFirma, inFakt, Fakturownia…)	W sklepie, CRM, systemie zamówień
Liczba faktur	Kilka–kilkadziesiąt miesięcznie, ręcznie	Dziesiątki i setki, automatycznie
Co robisz	Włączasz KSeF w programie	Łączę Twój system z API KSeF albo z programem

Jeśli wszystkie faktury wystawiasz w programie księgowym, który ma już KSeF, prawdopodobnie nie potrzebujesz niczego więcej. Integracja jest potrzebna, gdy faktury rodzą się gdzie indziej, a dziś ktoś je przepisuje albo eksportuje ręcznie.

KSeF w sklepie internetowym

Najczęstszy przypadek: sklep na WooCommerce, Shopify albo sklep na zamówienie, który po opłaceniu zamówienia ma wystawić fakturę. Są dwie drogi:

Sklep → program księgowy → KSeF. Sklep przekazuje dane zamówienia do programu z gotową integracją KSeF. Mniej kodu, ale zależysz od tego, co program potrafi przyjąć.
Sklep → API KSeF bezpośrednio. Sklep sam buduje e-fakturę w strukturze FA(3), wysyła ją i zapisuje numer KSeF przy zamówieniu. Pełna kontrola i log każdej wysyłki.

Którą drogę wybrać, zależy od Twojej księgowości, liczby kanałów sprzedaży i tego, czy wystawiasz faktury konsumentom — to ustalam na początku, razem z Twoim księgowym.

Bezpieczna integracja z KSeF — gdzie są pułapki

Samo wysłanie faktury to najmniejsza część pracy. O tym, czy integracja działa spokojnie, decydują przypadki brzegowe:

Co musi obsłużyć dobra integracja

1
Uprawnienia i tokeny
Bezpieczne przechowywanie danych dostępowych — nigdy w kodzie ani w arkuszu.
2
Mapowanie danych
Nabywca, pozycje, stawki VAT, płatność, waluty — poprawnie w strukturze e-faktury.
3
Korekty i zaliczki
Faktury korygujące, zaliczkowe i końcowe, nie tylko „zwykła” sprzedaż.
4
Niedostępność KSeF
Kolejka, ponowienie, tryb awaryjny — sprzedaż nie staje, gdy system nie odpowiada.
5
Odrzucenia i log
Powiadomienie, gdy faktura nie przejdzie walidacji, i pełna historia wysyłek.

Każdą integrację najpierw testuję na środowisku testowym udostępnianym przez Ministerstwo Finansów, a dopiero potem przełączam na produkcję. Szerzej o całym procesie piszę w tekście integracja z KSeF krok po kroku.

Jak pracuję

Krótki opis faktur

Gdzie powstają, ile ich jest, jakie rodzaje (korekty, zaliczki, konsumenci).

Wybór drogi

Bezpośrednio przez API KSeF albo przez program księgowy — z konkretną wyceną.

Budowa i testy

Integracja na środowisku testowym MF, próby na prawdziwych przypadkach.

Produkcja i monitoring

Przełączenie, obserwacja pierwszych wysyłek, przekazanie dokumentacji.

Najczęstsze pytania

›Ile kosztuje integracja z KSeF?

Zależy od tego, ile miejsc w firmie wystawia faktury i jakich rodzajów. Połączenie jednego sklepu z programem księgowym to zwykle niewielki moduł; bezpośrednia integracja z API z korektami i pobieraniem faktur kosztowych to osobny projekt. Wycenę podaję po krótkim opisie Twoich faktur.

›Czy integruje się WooCommerce i Shopify z KSeF?

Tak. W obu przypadkach można przekazywać zamówienia do programu księgowego z KSeF albo wysyłać faktury bezpośrednio. Dla Shopify zwykle wygodniejsza jest droga przez program, dla WooCommerce i sklepów na zamówienie — obie są możliwe.

›Co się stanie, gdy KSeF nie działa?

Przepisy przewidują tryby awaryjne i offline. Dobra integracja odkłada faktury do kolejki i wysyła je, gdy system wróci — sprzedaż w sklepie trwa normalnie.

›Czy pobierzesz też faktury kosztowe?

Tak — integracja może automatycznie pobierać faktury zakupowe z KSeF i przekazywać je do księgowości albo przypisywać do projektów i zleceń.

›Mam już program z KSeF. Czy to wystarczy?

Jeśli wszystkie faktury wystawiasz w nim — prawdopodobnie tak. Integracja ma sens wtedy, gdy faktury powstają poza programem i dziś ktoś przepisuje je ręcznie.