Integracja Insert GT z Krajowym Systemem e-Faktur pozwala wystawiać i odbierać faktury ustrukturyzowane bezpośrednio z poziomu programu.

Na czym polega ta usługa

Konfiguracja obejmuje połączenie Insert GT z Krajowym Systemem e-Faktur, ustawienie automatycznego przesyłania wystawianych dokumentów oraz przetestowanie poprawności ich formatu.

Dla kogo ma sens

Usługa jest przydatna dla firm korzystających z Insert GT, które muszą lub chcą dostosować się do obowiązku fakturowania przez KSeF.

Ile to trwa

Konfiguracja integracji z KSeF mieści się z reguły w standardowym czasie do 3 dni.

Warunki

Diagnoza wstępna i wycena są bezpłatne, a usługa objęta jest gwarancją do 12 miesięcy.

Wymagania techniczne i przygotowanie systemu Insert GT do KSeF

Prawidłowe uruchomienie komunikacji między pakietem Insert GT (w szczególności programami Subiekt GT oraz Rewizor GT) a Krajowym Systemem e-Faktur wymaga spełnienia określonych warunków technicznych po stronie infrastruktury informatycznej przedsiębiorstwa. Pierwszym elementem jest wersja samego oprogramowania. Integracja wymaga zaktualizowania systemu Insert GT do wersji posiadającej wbudowaną obsługę struktur logicznych e-faktury oraz aktywny abonament na ulepszenia. Starsze wydania systemu nie posiadają modułów odpowiedzialnych za generowanie plików w wymaganym formacie.

Kolejnym aspektem jest środowisko bazy danych Microsoft SQL Server (oprogramowanie zarządzające relacyjnymi bazami danych). Baza podmiotu musi zostać poddana konwersji do aktualnej wersji schematu bazy danych. Wymaga to odpowiednich uprawnień administracyjnych na serwerze SQL (uprawnienia użytkownika sa). Na serwerze lub stacji roboczej, z której realizowana jest wysyłka, konieczne jest zapewnienie bezpiecznego połączenia sieciowego z wykorzystaniem protokołu TLS 1.2 lub nowszego (protokół kryptograficzny zapewniający bezpieczną transmisję danych w sieci). W przypadku starszych systemów operacyjnych Windows, które domyślnie korzystają z wycofanych standardów szyfrowania, niezbędna bywa modyfikacja rejestru systemowego oraz doinstalowanie odpowiednich poprawek systemowych.

Do poprawnej autoryzacji w bramce ministerialnej niezbędne jest również założenie Konta InsERT powiązanego z licencją danego podmiotu oraz wygenerowanie danych uwierzytelniających. W zależności od przyjętego w firmie modelu pracy może to być certyfikat kwalifikowany (podpis elektroniczny o mocy prawnej podpisu własnoręcznego) lub unikalny token autoryzacyjny (ciąg znaków kryptograficznych przypisany do numeru NIP podatnika, generowany w rządowej Aplikacji Podatnika KSeF).

Etapy wdrożenia i konfiguracji połączenia z Krajowym Systemem e-Faktur

Proces integracji jest realizowany wieloetapowo, aby zagwarantować ciągłość pracy działu handlowego i księgowego oraz wyeliminować ryzyko przestojów w wystawianiu dokumentów sprzedażowych:

Wykonanie kopii bezpieczeństwa (backup bazy danych podmiotu) przed rozpoczęciem jakichkolwiek modyfikacji struktur danych, co zabezpiecza całą historię operacji gospodarczych firmy.
Aktualizacja oprogramowania Insert GT oraz powiązanych bibliotek systemowych na serwerze i stanowiskach klienckich.
Konfiguracja parametrów KSeF w module administracyjnym programu, w tym wprowadzenie danych identyfikacyjnych podmiotu, numeru NIP oraz bezpiecznego tokena autoryzacyjnego.
Weryfikacja i dostosowanie kartotek kontrahentów oraz kartotek towarowych, w tym poprawności kodów pocztowych, prefiksów państw, kodów CN (Nomenklatura Scalona) oraz oznaczeń procedur podatkowych.
Przeprowadzenie testów w środowisku przedprodukcyjnym (KSeF Demo lub KSeF Test), polegające na wygenerowaniu, podpisaniu i przesłaniu próbnych dokumentów oraz weryfikacji odbioru UPO (Urzędowe Poświadczenie Odbioru, czyli formalny dowód doręczenia dokumentu do systemu rządowego).
Konfiguracja uprawnień użytkowników programu, określająca, którzy pracownicy mają prawo wysyłać dokumenty, pobierać faktury zakupowe oraz zarządzać kluczami dostępu.
Przełączenie systemu na środowisko produkcyjne i asysta przy wystawianiu pierwszych rzeczywistych dokumentów handlowych.

Warianty problemów podczas integracji i ich diagnostyka

W trakcie uruchamiania i codziennego użytkowania modułu komunikacji z Krajowym Systemem e-Faktur mogą wystąpić zróżnicowane trudności techniczne. Można je podzielić na kilka głównych kategorii w zależności od źródła usterki:

Pierwszym wariantem są błędy autoryzacji (zazwyczaj kod błędu 401 Unauthorized lub 403 Forbidden). Oznaczają one, że bramka KSeF odrzuciła próbę połączenia z powodu nieprawidłowego tokena, wygaśnięcia uprawnień lub niezgodności numeru NIP przypisanego do certyfikatu z danymi firmy wprowadzonymi w parametrach programu Subiekt GT. Problem pojawia się również wtedy, gdy token został wygenerowany z ograniczonym zakresem uprawnień, na przykład z prawem wyłącznie do odczytu dokumentów bez prawa ich wysyłania.

Drugim wariantem są błędy strukturalne i walidacji schematu XML (kody błędów z grupy 400 i 422). Występują one w sytuacji, gdy wystawiany dokument nie spełnia rygorystycznych wymogów formalnych określonych przez Ministerstwo Finansów. Przyczyną bywa brak wymaganych pól w kartotece kontrahenta (np. brak poprawnego formatu numeru NIP, niepełny adres), nieprawidłowy format daty, ujemne wartości w pozycjach niedozwolonych przez schemat lub brak przypisanej stawki podatkowej. W takim przypadku system odrzuca dokument przed nadaniem numeru KSeF.

Trzecim wariantem są błędy komunikacji sieciowej i protokołów szyfrowania. Objawiają się one komunikatami o niemożności nawiązania bezpiecznego połączenia SSL/TLS lub przekroczeniu limitu czasu odpowiedzi serwera (timeout). W środowiskach ze starszymi systemami operacyjnymi lub restrykcyjnie skonfigurowaną zaporą sieciową (firewall) pakiety kierowane do serwerów rządowych mogą być blokowane lub odrzucane z powodu braku obsługi nowoczesnych algorytmów kryptograficznych.

Czwartym wariantem są problemy związane z kolejkowaniem i pobieraniem UPO. Po wysłaniu dokumentu do KSeF otrzymuje on status przetwarzania (kod 100). Przy dużym obciążeniu serwerów ministerialnych czas oczekiwania na ostateczną walidację i nadanie unikalnego numeru identyfikacyjnego KSeF może ulec wydłużeniu. Wymaga to prawidłowej konfiguracji mechanizmu asynchronicznego sprawdzania statusów w programie Insert GT.

Błędy przy próbach samodzielnego wdrożenia integracji

Samodzielne próby konfiguracji integracji z KSeF bez odpowiedniego przygotowania technicznego niosą ze sobą ryzyko błędów operacyjnych i zakłóceń w fakturowaniu:

Jednym z najczęstszych błędów jest pomijanie środowiska testowego i konfigurowanie parametrów bezpośrednio na środowisku produkcyjnym. Wysłanie nieprawidłowo sformatowanego dokumentu na bramkę produkcyjną powoduje, że dokument staje się prawnie wiążącą fakturą w obrocie gospodarczym, której nie można w prosty sposób usunąć, a jedynie skorygować.

Kolejnym błędem jest brak weryfikacji spójności danych słownikowych przed wdrożeniem. Wieloletnie bazy danych programów Subiekt GT często zawierają zdublowane kartoteki kontrahentów, niekompletne dane teleadresowe lub niestandardowe jednostki miar. Wprowadzenie automatycznej wysyłki bez wcześniejszego uporządkowania bazy prowadzi do seryjnego odrzucania dokumentów przez bramkę walidacyjną.

Często spotykanym problemem jest także niewłaściwe zarządzanie uprawnieniami do tokenów autoryzacyjnych. Zapisywanie tokena w niezabezpieczonych plikach tekstowych lub nadawanie pełnych uprawnień administracyjnych wszystkim stanowiskom roboczym w sieci lokalnej stwarza ryzyko nieautoryzowanego dostępu do danych finansowych przedsiębiorstwa.

Błędem jest również brak opracowania wewnętrznych procedur awaryjnych na wypadek braku dostępu do sieci internetowej lub oficjalnej niedostępności bramek ministerialnych. Użytkownicy często nie wiedzą, jak postępować w trybie offline (wystawianie faktur w procedurze awaryjnej z późniejszym dosłaniem do KSeF), co w przypadku braku łączności całkowicie wstrzymuje wydawanie towarów z magazynu.

Kiedy to nie jest usterka programu Insert GT

W trakcie eksploatacji systemu mogą pojawić się sytuacje, w których brak możliwości przesłania dokumentu nie wynika z błędu programu Insert GT ani jego złej konfiguracji:

Pierwszym przypadkiem są oficjalne okna serwisowe i awarie infrastruktury Ministerstwa Finansów. W czasie prac konserwacyjnych serwery KSeF mogą zwracać błędy niedostępności usługi (np. błąd 500, 502 lub 503). W takiej sytuacji system Insert GT działa prawidłowo, a wstrzymanie transmisji leży wyłącznie po stronie serwerów rządowych.

Drugim przypadkiem są ograniczenia formalno-prawne w urzędzie skarbowym. Jeśli przedsiębiorca nie złożył odpowiedniego zawiadomienia ZAW-FA (formularz zgłoszenia uprawnień do korzystania z KSeF) lub pełnomocnictwo dla osoby reprezentującej firmę nie zostało jeszcze przetworzone przez urząd, bramka KSeF odrzuci próbę uwierzytelnienia pomimo poprawnego wprowadzenia danych w programie.

Trzecim przypadkiem są blokady na poziomie lokalnej infrastruktury sieciowej. Zewnętrzne oprogramowanie antywirusowe, systemy inspekcji pakietów (UTM) lub błędnie skonfigurowane serwery pośredniczące (proxy) mogą blokować ruch na portach wychodzących, co jest interpretowane przez program jako brak odpowiedzi serwera KSeF.

Wsparcie techniczne na miejscu w siedzibie firmy

Konfiguracja i rozwiązywanie problemów z integracją systemów ERP (oprogramowanie do planowania zasobów przedsiębiorstwa) z systemami państwowymi wymaga bezpośredniego dostępu do środowiska serwerowego oraz stacji roboczych. Serwisanci realizują prace bezpośrednio w siedzibie firmy klienta, obsługując cały obszar Warszawy oraz okoliczne powiaty w promieniu 40 kilometrów, w tym powiat grodziski, legionowski, otwocki, piaseczyński, pruszkowski, warszawski zachodni oraz wołomiński. Punktem wyjazdu ekipy technicznej jest biuro przy Alei Stanów Zjednoczonych 72.

Bezpośrednia wizyta pozwala na dokładne zweryfikowanie konfiguracji sieci lokalnej, uprawnień systemu bazy danych Microsoft SQL Server oraz przetestowanie komunikacji na rzeczywistych stanowiskach sprzedażowych i księgowych. Na życzenie klienta przed przystąpieniem do prac podpisywana jest umowa o zachowaniu poufności (NDA), co gwarantuje pełne bezpieczeństwo wrażliwych danych handlowych i finansowych przetwarzanych w systemie Insert GT. Zgłoszenia przyjmowane są pod numerem telefonu 22 378 48 09 przez całą dobę, 7 dni w tygodniu.

Najczęściej zadawane pytania o integrację Insert GT z KSeF

Jak zmienia się numeracja faktury po jej przesłaniu do KSeF?

W programie Subiekt GT dokument zachowuje swój dotychczasowy, wewnętrzny numer handlowy zgodny ze zdefiniowanym w firmie schematem numeracji (na przykład FV/2026/08/001). Po pomyślnym przetworzeniu przez bramkę ministerialną dokument otrzymuje dodatkowo unikalny, 35-znakowy numer KSeF nadawany przez system rządowy. Numer ten jest automatycznie zapisywany w bazie danych programu przy danym dokumencie i stanowi oficjalny identyfikator faktury w relacjach z urzędem skarbowym i kontrahentami.

Czy po wysłaniu faktury do KSeF można ją edytować lub skasować w Subiekcie GT?

Po przesłaniu dokumentu do Krajowego Systemu e-Faktur i odebraniu urzędowego poświadczenia odbioru (UPO), dokument zostaje w programie zablokowany przed modyfikacją i usunięciem. Zgodnie z przepisami prawa e-faktura zarejestrowana w systemie staje się dokumentem ostatecznym. Wszelkie zmiany danych, ilości, cen lub stawek podatkowych mogą być wprowadzone wyłącznie poprzez wystawienie faktury korygującej, która również musi zostać przesłana do KSeF.

Czy każdy pracownik wystawiający dokumenty musi posiadać własny podpis kwalifikowany?

Nie ma konieczności zakupu podpisu kwalifikowanego dla każdego stanowiska komputerowego w firmie. Podstawowym i najwygodniejszym rozwiązaniem w systemie Insert GT jest wygenerowanie ogólnego tokena autoryzacyjnego dla podmiotu w rządowej Aplikacji Podatnika KSeF. Token ten jest wprowadzany jednorazowo do konfiguracji programu w module administracyjnym, dzięki czemu wszyscy uprawnieni pracownicy mogą wystawiać i przesyłać dokumenty bez konieczności podłączania fizycznych czytników kart kryptograficznych.

Co zrobić w sytuacji awarii internetu w firmie lub niedostępności bramek KSeF?

W przypadku braku dostępu do sieci internetowej lub oficjalnej awarii po stronie Ministerstwa Finansów, program umożliwia wystawianie faktur w tak zwanym trybie awaryjnym (tryb offline). Dokumenty są rejestrowane lokalnie w bazie Subiekta GT i mogą zostać wydrukowane lub przekazane odbiorcy z kodem weryfikacyjnym QR (kod dwuwymiarowy umożliwiający weryfikację autentyczności dokumentu). Po przywróceniu łączności lub zakończeniu prac serwisowych po stronie KSeF, system automatycznie lub na żądanie użytkownika przesyła zaległe dokumenty do bramki ministerialnej w ustawowym terminie.

Czy integracja z KSeF wymaga wymiany serwera lub sprzętu komputerowego?

W większości przypadków nie ma konieczności wymiany fizycznego sprzętu, o ile spełnia on minimalne wymagania dla aktualnych wersji pakietu Insert GT. Kluczowym elementem jest zgodność systemu operacyjnego z protokołami bezpiecznej komunikacji TLS 1.2 oraz odpowiednia wydajność silnika Microsoft SQL Server do obsługi dodatkowych operacji zapisu metadanych i plików XML. W przypadku starszych komputerów z niewspieranymi systemami operacyjnymi wystarczająca bywa aktualizacja oprogramowania systemowego lub optymalizacja bazy danych.

Prawidłowe wdrożenie e-faktur w systemie Insert GT

Właściwe przygotowanie systemu Insert GT do współpracy z Krajowym Systemem e-Faktur pozwala zachować pełną ciągłość sprzedaży oraz uniknąć błędów walidacji dokumentów handlowych. Kompleksowa weryfikacja środowiska bazodanowego, aktualizacja oprogramowania, precyzyjne ustawienie parametrów autoryzacji oraz przeprowadzenie kontrolowanych testów na środowisku przedprodukcyjnym gwarantują stabilne i bezpieczne fakturowanie zgodnie z obowiązującymi wymogami technicznymi.

22 378 48 09

Integracja Insert GT z Krajowym Systemem e-Faktur (KSeF)