| Środowisko | Adres API | Do czego służy |
|---|---|---|
| Test | https://api-test.ksef.mf.gov.pl |
Rozwój i testy integracji (dane fikcyjne) |
| Demo (przedprodukcja) | https://api-demo.ksef.mf.gov.pl |
Końcowa walidacja w warunkach zbliżonych do produkcji |
| Produkcja | https://api.ksef.mf.gov.pl |
Faktury o pełnej mocy prawnej |
Przewodnik
Integracja z KSeF — kompletny przewodnik dla firm i programistów (2026)
Kompletny przewodnik po integracji z KSeF dla firm i programistów: ścieżki wdrożenia, architektura API, środowiska, koszty i najczęstsze pytania.
Czym jest KSeF i kogo obowiązuje?
KSeF (Krajowy System e-Faktur) to centralny system Ministerstwa Finansów, przez który przechodzą faktury ustrukturyzowane. Obowiązek wystawiania faktur w KSeF wchodzi etapami: od 1 lutego 2026 r. dla firm o sprzedaży powyżej 200 mln zł (za 2024 r.), od 1 kwietnia 2026 r. dla pozostałych podatników VAT, a od 1 stycznia 2027 r. dla najmniejszych wystawców.
Uwaga: terminy i zasady okresu przejściowego weryfikuj na ksef.podatki.gov.pl — ten akapit zaktualizujesz w Customizerze.
Trzy ścieżki integracji z KSeF
01
Gotowy system — ksefix
Fakturowanie z wbudowaną obsługą KSeF: wysyłka, odbiór faktur zakupowych, faktury cykliczne. Startujesz od ręki, bez projektu IT.
02
Integracja API na zamówienie
Łączymy Twój system (ERP, fakturowanie, e-commerce) bezpośrednio z KSeF API — z kolejkami, obsługą błędów i trybu offline.
03
Program księgowy lub ERP
Jeśli Twój program księgowy ma moduł KSeF, sprawdź jego zakres: odbiór zakupowych, uprawnienia i automatyzacja często wymagają dodatkowej integracji.
Jak wygląda architektura integracji z KSeF API?
Sprawdzony układ to osobny moduł integracji między Twoim systemem a KSeF: kolejkuje wysyłki, waliduje XML przed wysłaniem, ponawia próby przy niedostępności KSeF i archiwizuje numery KSeF oraz UPO.
System firmyERP / fakturowanie / e-commerce
Moduł integracjikolejki · retry · walidacja XML
KSeF APIuwierzytelnienie · wysyłka · pobieranie
Numer KSeF + UPOpotwierdzenie i archiwizacja
Środowiska KSeF: test, demo, produkcja
Ile kosztuje i jak długo trwa integracja z KSeF?
Koszt zależy od zakresu: sama wysyłka faktur to inna skala niż pełny obieg z odbiorem zakupowych i obsługą uprawnień. Poniższe widełki uzupełnij w Customizerze — mało kto je publikuje, a to najczęstsze pytanie klientów.
| Zakres | Czas wdrożenia | Koszt |
|---|---|---|
| Gotowy system (ksefix) | od ręki | abonament |
| Wysyłka faktur z Twojego systemu | 2–4 tyg. | (uzupełnij widełki) |
| Pełna integracja (wysyłka + odbiór + uprawnienia) | 4–8 tyg. | (uzupełnij widełki) |
ksefix — gotowa integracja z KSeF
System fakturowania z obsługą KSeF: wysyłka, odbiór faktur zakupowych, faktury cykliczne i odporność na awarie KSeF. Zapytaj o demo — bez zobowiązań.