Integracja systemów ERP z KSeF-link
Wpis #292 z dnia: 18-08-2025
Uniwersalny program do integracji dowolnego systemu ERP z elektronicznym systemem e-faktur KSeF.
Program KSeF-link pracuje lokalnie w komputerze (komputerach) użytkownika w oparciu o bazę danych MS SQL Server (może być bezpłatna wersja Express).
Wszystkie dane i faktury zapisywane są tylko w lokalnej bazie danych użytkownika bez wysyłania do zdalnych serwerów sieciowych. Oczywiście poza oficjalnym serwisem KSeF od MF, jeżeli wysyłamy takie żądania. Użytkownik ma pełną kontrolę nad swoimi danymi, komunikacja z https://ksef.mf.gov.pl jest w pełni transparentna i dokumentowana w zdarzeniach log, który również jest zapisywany w bazie MS SQL Server programu.
Wystarczy pobrać i zainstalować program z naszej strony, wprowadzić swój token (wygenerowany na stronie MF serwisu KSeF) i program jest gotowy do pracy. Od razu możemy pobierać faktury zakupu w formie listy, szczegółowych zapisów XML, oraz wizualizacji graficznej. Faktury można eksportować do Excel.
Do wysyłania własnych faktur sprzedaży, należy skorzystać z gotowych rozwiązań dla faktur w wersji XML, lub opracować procedury do generowania faktur XML za pomocą naszych interfejsów API lub Excel. Szczegóły w dalszej części naszej dokumentacji.
Aplikacja KSeF-link może być wykorzystana do integracji z systemami ERP wg kilku scenariuszy:
- Uniwersalny i dostępny dla wszystkich użytkowników, jest import faktur z pliku Excel. Funkcja dostępna w Menu/Narzędzia/Import faktur z Excel, lub bezpośrednio w Rejestrze faktur: Menu/Kartoteki SQL/Faktury sprzedaży/[Import z Excel]. Plik Excel należy przygotować wg wymaganego formatu, przykład dostępny jest w Kreatorze importu. Dane można wprowadzić ręcznie, metodą kopiuj/wklej, lub za pomocą odpowiednich programów przygotowanych przez własny zespół informatyczny.
- Jeżeli Twój system ERP ma już możliwość generowania faktur w formacie FA.XML (3), wystarczy uruchomić funkcję: Menu/Kartoteki SQL/Faktury sprzedaży/[Dodaj faktury]. Program umożliwia import pojedynczych faktur, lub serii faktur z podanego katalogu. Dodane do sytemu faktury wysyłamy przyciskiem [Wyślij/sprawdź].
- Faktury XML można też wygenerować z plików JPK_FA (3) lub JPK_FA (4). Są to pliki obowiązujące już od kilku lat, składane na życzenie do MF i prawie każdy system potrafi takie JPK generować. Należy jednak pamiętać, że tak utworzone faktury XML dla KSeF, będą zawierać tylko podstawowe informacje, pomimo tego że będą zgodne ze schematem i można je wysłać na bramkę KSeF. Pliki JPK_FA nie zawierają wszystkich danych, w większości opcjonalnych.
- Przykłady pracy programu w trybie interaktywnym użytkownika:
Dostępne są również zaawansowane rozwiązania dla integratorów:
- Baza danych (MS SQL Server) programu KSeF-link zawiera tabele tymczasowe, tzw. Bufor do wypełnienia danymi przez programistów. Dane dostępne są w naszej aplikacji w Menu/Bufor/ERP/Faktury robocze. Faktury w wersji XML użytkownik generuje za pomocą przycisku [Generuj FA.XML do Rejestru KSeF] skąd zostaną wysłane do MF.
- Programista może zapisać fakturę do Bufora i od razu wysłać do serwisu MF wygenerowaną przez nasz system wersję XML poprzez wywołanie żądania http do naszego serwera http-Link Server: api/invoices/SendTmpInvoice
- Programista może pominąć proces wypełniania tabel tymczasowych i przygotować dane faktury w uproszczonej strukturze Json. Taką fakturę wysyłamy za pomocą żądania: api/invoices/SendJInvoice
- Jeżeli system ERP generuje gotowe faktury XML, to można je zdalnie dodać do naszego systemu za pomocą: api/invoices/ImportXmlInvoice
- Najbardziej zawansowana metoda polega na przygotowaniu skryptów C# za pomocą naszego wbudowanego API i zdalne wywołanie za pomocą żądań http. Metody zostaną opisane w szczegółowej dokumentacji programu.
- Przykłady szczegółowych opisów dla integratorów:
Następny dokument 293 : Przykład-01 faktury dla systemu KSeF.