KSeF Integrator — jedno API do Krajowego Systemu e-Faktur.

Obowiązkowy Krajowy System e-Faktur oznacza, że każda faktura B2B musi przejść przez rządową platformę — z jej limitami, statusami, sesjami i zmieniającą się specyfikacją. KSeF Integrator zamyka tę złożoność za jednym, stabilnym API: Twój system ERP, FK lub e-commerce przekazuje dokument, a Integrator zarządza uwierzytelnianiem, sesją interaktywną, numerami KSeF i pobieraniem UPO.

Systemy, które nie potrafią (lub nie powinny) samodzielnie wytworzyć pełnego pliku XML FA(3), mogą skorzystać z uproszczonego API oraz elastycznych mechanizmów integracji systemów legacy — różnych formatów plików i procesów ETL. Wstępną konfigurację połączenia z KSeF ułatwia aplikacja desktop, która uzyskuje token autoryzacyjny (docelowo certyfikat) i bezpiecznie umieszcza go w rozwiązaniu.

Każdy dokument jest walidowany względem aktualnej schemy FA(3), zanim opuści Twoją infrastrukturę. Na tym jednak nie kończymy: wbudowane walidatory merytoryczne sprawdzają spójność biznesową danych — m.in. czy kwoty netto i VAT sumują się do brutto, czy podsumowania pozycji zgadzają się z wartościami faktury oraz czy pola wymagane dla danego typu dokumentu są wypełnione poprawnie.

Dzięki temu błędy wychwytujesz po swojej stronie, z czytelnym opisem problemu — zamiast odrzutu z bramki KSeF i poprawiania dokumentów pod presją terminów. Integrator zapobiega też wysłaniu do KSeF duplikatu faktury.

Po przyjęciu faktury przez KSeF i nadaniu numeru Integrator sam powiadamia system źródłowy — nie musisz cyklicznie odpytywać o status dokumentu. Elastyczny mechanizm filtrów decyduje, do którego systemu trafi informacja.

Do wyboru są różne kanały: webhook, e-mail, komunikat na kolejkę lub szynę integracyjną, a także pliki umieszczane na zasobie sieciowym (NFS, S3, WebDAV, FTP). Kolejkowanie i automatyczne ponawianie wysyłek zapewnia, że dokumenty docierają do KSeF także po przerwach w dostępności platformy.

Integrator cyklicznie sprawdza, czy w KSeF pojawiły się nowe faktury zakupowe dla wskazanych numerów NIP. Na podstawie zdefiniowanych filtrów przekazuje dokument do właściwego systemu — jako XML wraz z wizualizacją PDF — tym samym zestawem kanałów co przy sprzedaży: webhook, e-mail, kolejka integracyjna lub zasób plikowy.

Wizualizacja faktury w PDF jest zgodna z przepisami i maksymalnie zbliżona do tej znanej z Aplikacji Podatnika, więc dokumenty można od razu przekazywać do księgowości i kontrahentów.

Integrator wdrożysz w dowolnym środowisku kontenerowym on-prem (Kubernetes, OpenShift, Docker Swarm) lub w chmurze (Azure, GCP, AWS); oferujemy też model SaaS. Proces wytwarzania i utrzymania jest zaprojektowany zgodnie z normami ISO 27001, 27017 i 27018 oraz rekomendacjami OWASP (w szczególności ASVS).

Wdrożenie wspieramy kompleksowo — od szkolenia z KSeF, przez identyfikację i mapowanie procesów fakturowania oraz mapowanie danych na pola FA(2)/FA(3) (we współpracy z doradztwem podatkowym), po rekomendacje zmian procesowych i testy end-to-end. Obsługujemy również proces nadawania uprawnień do samofakturowania.