INTEGRACJA · KSeF
Integracja KSeF — faktury na Twoim serwerze
OpenLinker wystawia faktury przez Krajowy System e-Faktur — FA(3), clearance, numer KSeF i UPO, korekty KOR — do zamówień z Twojego sklepu i z Allegro. Self-hosted, bez opłaty od faktury. KSeF działa obok inFaktu i Subiekta nexo, w tej samej instancji.
CO DZIAŁA DZIŚ
KSeF w jednym systemie z zamówieniami
- → Wystawianie FA(3) z clearance. OpenLinker buduje fakturę w schemacie FA(3), wysyła ją do KSeF przez API 2.0 i przeprowadza clearance — czyli urzędowe zatwierdzenie dokumentu — bez ręcznego wgrywania XML-a w portalu.
- → Numer KSeF i UPO. Po zatwierdzeniu dokument dostaje numer KSeF, a system pobiera UPO (urzędowe poświadczenie odbioru) i wiąże je z fakturą oraz zamówieniem. Masz dowód wystawienia po swojej stronie.
- → Korekty KOR. Faktury korygujące (KOR) idą tym samym, odpornym torem: wysyłka → odpytywanie o status → UPO. Model asynchroniczny oznacza, że nic nie wisi w połowie — system dopyta i domknie, gdy KSeF odpowie.
- → Faktura do zamówienia, nie osobny krok. Faktura powstaje z danych zamówienia, które OpenLinker już ma — ze sklepu albo z Allegro. Nie przepisujesz pozycji z panelu do panelu.
- → Model async, odporny na przerwy. KSeF potrafi odpowiadać z opóźnieniem. Cały tor jest asynchroniczny i można go wznowić — jeśli coś się zatrzyma, system wie, na czym skończył, i podejmie pracę od właściwego miejsca.
- → Bez opłaty od faktury. OpenLinker nie nalicza opłaty za dokument. KSeF jest rządowy i darmowy; my nie dokładamy do niego własnego licznika.
JAK TO DZIAŁA
Faktury z Allegro automatycznie — bez przepisywania do osobnego programu
KSeF jest w OpenLinkerze kolejnym adapterem na tym samym porcie fakturowania, na którym działają już Subiekt nexo i inFakt. Zamówienie — ze sklepu albo z Allegro — trafia do jednej kolejki obsługi, a faktura powstaje z jego danych i idzie do KSeF: FA(3), clearance, numer KSeF, UPO. Ten sam wzorzec, do którego podłączysz kolejny system księgowy, gdy będzie gotowy.
Wszystko działa na Twoim serwerze. Dane faktur i klientów zostają po Twojej stronie, nie przechodzą przez cudzą chmurę, a licencja Apache 2.0 pozwala kod czytać, audytować i rozszerzać. To ważne akurat przy dokumentach księgowych, które i tak musisz umieć odtworzyć na żądanie.
Szczegóły techniczne — schemat FA(3), tor clearance i obsługę UPO — opisujemy w dokumentacji OpenLinkera: dokumentacja integracji KSeF →
JESTEŚ JUŻ NA KSeF
Fakturę do KSeF wysyłasz dziś. Kary zaczynają się w grudniu.
Sklepy internetowe i sprzedawcy marketplace wystawiają w KSeF od 1 kwietnia 2026 — to już za Tobą, nie przed Tobą. Okres bez kar kończy się 31 grudnia 2026. Pytanie nie brzmi więc „czy zdążę”, tylko „czym to robię”: modułem, który wypuszcza sam PDF, gotowym SaaS-em z opłatą od dokumentu, czy systemem, który wystawia realny dokument z clearance i trzyma go u Ciebie.
Tu jest różnica, której nie da Ci żadne inne pojedyncze narzędzie: Allegro, KSeF, inFakt i Subiekt nexo działają w OpenLinkerze w jednej instancji self-hosted — zamówienia i faktury w tym samym miejscu, bez opłaty od faktury i bez opłaty od zamówienia.
UCZCIWIE
Co jest, a czego jeszcze nie ma
OpenLinker jako całość jest w fazie alpha, pre-1.0 — ale integracja KSeF działa produkcyjnie. Weszła w wydaniu v0.1.0 i obejmuje wystawianie FA(3) z clearance, numer KSeF i UPO oraz korekty KOR w modelu asynchronicznym; wystawia realne dokumenty w KSeF, a nie próbne PDF-y. Ponieważ to jednak obszar podatkowo-prawny o wysokiej stawce, radzimy zachować zdrowy odruch: zanim oprzesz na niej całe rozliczenia, przetestuj ją na własnych dokumentach i sprawdź bieżący zakres na liście integracji. To nie eksperyment — KSeF jest jedną z naszych działających produkcyjnie integracji.
FAQ
Częste pytania
Czym jest KSeF i od kiedy obowiązuje?
KSeF (Krajowy System e-Faktur) to rządowy system e-fakturowania w Polsce. Duże firmy wystawiają w nim od 1 lutego 2026, a wszyscy podatnicy odbierają faktury; sklepy internetowe, jednoosobowe działalności i sprzedawcy marketplace wystawiają od 1 kwietnia 2026. Okres przejściowy bez kar kończy się 31 grudnia 2026, a najmniejsze firmy dołączają od 1 stycznia 2027. W praktyce, jeśli sprzedajesz online, najpewniej wystawiasz w KSeF już teraz.
Czy OpenLinker wystawia faktury do zamówień z Allegro automatycznie?
Tak. Faktura powstaje z danych zamówienia, które OpenLinker już pobrał — ze sklepu albo z Allegro — i idzie do KSeF jako FA(3): clearance, numer KSeF, UPO. Nie przepisujesz pozycji z panelu Allegro do osobnego programu do faktur. To ten sam system, który obsługuje oferty i zamówienia.
Czym integracja KSeF różni się od modułu Allegro albo gotowego SaaS-a?
Moduł Allegro potrafi wygenerować PDF faktury, ale to nie to samo co wystawienie dokumentu w KSeF z clearance i UPO. Gotowe SaaS-y to robią, ale zwykle w cudzej chmurze i często z opłatą od dokumentu lub abonamentem rosnącym ze sprzedażą. OpenLinker wystawia realny dokument KSeF, trzyma go po Twojej stronie i nie nalicza opłaty od faktury.
Czy płacę za każdą fakturę wystawioną w KSeF?
Nie po naszej stronie. Sam KSeF jest rządowy i darmowy, a OpenLinker jest self-hosted i open-source (Apache 2.0) — płacisz za serwer, który i tak utrzymujesz, nie za każdy dokument. To inny kompromis niż opłata od faktury w modelu SaaS.
Czy integracja KSeF jest gotowa na produkcję?
Tak — integracja KSeF działa produkcyjnie, mimo że OpenLinker jako całość jest jeszcze w fazie alpha (pre-1.0). Adapter KSeF wszedł w v0.1.0 i obejmuje wystawianie FA(3) z clearance, numer KSeF, UPO oraz korekty KOR; wystawia realne dokumenty w KSeF. Ponieważ to obszar podatkowo-prawny, i tak warto przetestować ją na własnych dokumentach i sprawdzić bieżący zakres na liście integracji, zanim oprzesz na niej całe rozliczenia.
Wypróbuj wersję, którą masz na własność.
Repo jest publiczne, Apache 2.0. Stack deweloperski wstaje jedną komendą Dockera.