Integracja Gratyfikanta GT z programem Płatnik pozwala uniknąć ręcznego przepisywania danych kadrowo-płacowych do rozliczeń ZUS.

Na czym polega ta usługa

Konfiguracja obejmuje ustawienie eksportu danych z Gratyfikanta GT do formatu obsługiwanego przez program Płatnik oraz przetestowanie poprawności przekazywanych informacji.

Dla kogo ma sens

Usługa jest przydatna dla firm korzystających z Gratyfikanta GT do obsługi kadr i płac, które chcą usprawnić rozliczenia z ZUS.

Ile to trwa

Konfiguracja integracji z Płatnikiem 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.

Zakres techniczny integracji Gratyfikanta GT z programem Płatnik

Proces połączenia systemu kadrowo-płacowego Gratyfikant GT z programem Płatnik polega na zdefiniowaniu spójnych reguł wymiany informacji o zatrudnionych pracownikach, naliczonych wynagrodzeniach, składkach ubezpieczeniowych oraz przysługujących świadczeniach i przerwach w pracy. Gratyfikant GT, działający w oparciu o bazę danych Microsoft SQL Server (oprogramowanie bazodanowe przechowujące wszystkie dane systemu InsERT GT), przetwarza operacje płacowe na deklaracje ubezpieczeniowe, które następnie są eksportowane w postaci ustrukturyzowanych plików do programu Płatnik.

Prawidłowe wdrożenie integracji wymaga konfiguracji parametrów systemowych w kilku kluczowych obszarach:

Kartoteki pracowników i ubezpieczonych: weryfikacja zgodności danych identyfikacyjnych, w tym numerów PESEL, NIP, serii i numerów dokumentów tożsamości, adresów zamieszkania oraz dokładnego zapisu imion i nazwisk (w tym drugich imion oraz nazwisk wieloczłonowych).
Kody tytułu ubezpieczenia: przypisanie właściwych sześciocyfrowych kodów tytułu ubezpieczenia (np. dla pracowników etatowych, zleceniobiorców, osób na urlopach macierzyńskich czy wychowawczych) wraz z informacją o prawie do emerytury lub renty oraz stopniu niepełnosprawności.
Schematy potrąceń i kody świadczeń: poprawne zmapowanie przerw w opłacaniu składek oraz wypłaconych świadczeń (takich jak wynagrodzenie chorobowe, zasiłek chorobowy, opiekuńczy czy macierzyński) zgodnie z kodami świadczeń i przerw wymaganymi przez Zakład Ubezpieczeń Społecznych.
Parametry stawek i funduszy: synchronizacja aktualnych stóp procentowych składek na ubezpieczenie wypadkowe, Fundusz Pracy (FP), Fundusz Solidarnościowy (FS) oraz Fundusz Gwarantowanych Świadczeń Pracowniczych (FGŚP).
Zasady rozliczania wypłat przesuniętych: właściwa konfiguracja miesięcy rozliczeniowych w powiązaniu z datą faktycznej wypłaty wynagrodzeń (zasada kasowa ZUS, zgodnie z którą wynagrodzenie za dany miesiąc wypłacone w kolejnym miesiącu musi zostać uwzględnione w deklaracji za miesiąc wypłaty).
Ścieżki wymiany danych: zdefiniowanie dedykowanych katalogów roboczych i uprawnień systemowych w środowisku Windows, umożliwiających bezproblemowy zapis i odczyt generowanych plików.

Struktura wymiany danych i formaty KEDU

Wymiana danych pomiędzy systemem Gratyfikant GT a programem Płatnik odbywa się za pośrednictwem formatu KEDU (Krajowy Elektroniczny Dokument Ubezpieczeniowy). Jest to ustandaryzowany format zapisu danych oparty o język znaczników XML, zdefiniowany przez ZUS. W zależności od wersji obu programów stosowane są odpowiednie wersje schematów KEDU (np. KEDU 4.0, KEDU 5.0, KEDU 5.2 czy KEDU 5.5), które precyzyjnie określają strukturę każdego elementu dokumentu oraz reguły walidacji schematem XSD (definicja struktury pliku XML).

W ramach integracji konfigurowany i testowany jest eksport dwóch głównych grup dokumentów ubezpieczeniowych:

Dokumenty zgłoszeniowe: ZUS ZUA (zgłoszenie do ubezpieczeń społecznych i zdrowotnego), ZUS ZZA (zgłoszenie wyłącznie do ubezpieczenia zdrowotnego), ZUS ZWUA (wyrejestrowanie ubezpieczonego z ubezpieczeń), ZUS ZIUA (zgłoszenie zmiany danych identyfikacyjnych ubezpieczonego) oraz ZUS ZCNA (zgłoszenie danych o członkach rodziny ubezpieczonego do ubezpieczenia zdrowotnego).
Dokumenty rozliczeniowe: ZUS DRA (deklaracja rozliczeniowa zbiorcza dla płatnika składek), ZUS RCA (imienny raport miesięczny o należnych składkach i wypłaconych świadczeniach), ZUS RSA (imienny raport miesięczny o wypłaconych świadczeniach i przerwach w opłacaniu składek) oraz ZUS RPA (imienny raport miesięczny o przychodach ubezpieczonego i okresach wykonywania pracy w szczególnych warunkach lub o szczególnym charakterze).

Prawidłowe zestawienie dokumentów w Gratyfikancie GT pozwala na wygenerowanie kompletnego zestawu rozliczeniowego w jednym pliku KEDU, który po zaimportowaniu do programu Płatnik tworzy spójny komplet rozliczeniowy za dany miesiąc bez konieczności ręcznego łączenia poszczególnych raportów.

Typowe warianty konfiguracji środowiska

Architektura integracji Gratyfikanta GT z programem Płatnik różni się w zależności od specyfiki przedsiębiorstwa oraz zastosowanej infrastruktury teleinformatycznej:

Stanowisko jednostanowiskowe: oba programy zainstalowane są na jednym komputerze, a wymiana danych odbywa się za pośrednictwem lokalnego folderu roboczego. W tym wariancie Płatnik najczęściej wykorzystuje bazę plikową Microsoft Access (.mdb), a Gratyfikant GT lokalną instancję Microsoft SQL Server Express.
Środowisko wielostanowiskowe w sieci lokalnej: Gratyfikant GT działa w architekturze klient-serwer z centralną bazą SQL Server na serwerze firmy, a program Płatnik jest zainstalowany na poszczególnych stacjach roboczych działu kadr i płac. Wymiana plików KEDU odbywa się poprzez zabezpieczony udział sieciowy (protokół SMB) z odpowiednio nadanymi uprawnieniami dostępu dla użytkowników domeny lub grupy roboczej.
Płatnik oparty na silniku Microsoft SQL Server: w przypadku większych przedsiębiorstw baza danych programu Płatnik zostaje przeniesiona z pliku Access do silnika Microsoft SQL Server. Konfiguracja takiego środowiska eliminuje ograniczenia wydajnościowe bazy plikowej i pozwala na bezpieczną, równoległą pracę wielu specjalistów ds. kadr i płac.
Środowisko serwera terminali (Pulpit Zdalny / RDP): praca odbywa się na serwerze terminalowym, gdzie zarówno Gratyfikant GT, jak i Płatnik są uruchamiane w sesjach użytkowników. Konfiguracja wymaga prawidłowego wyznaczenia katalogów tymczasowych dla poszczególnych sesji oraz konfiguracji przekierowania czytników kart kryptograficznych z podpisem elektronicznym.
Biura rachunkowe i obsługa wielopodmiotowa: środowisko wymaga zdefiniowania odrębnych profili płatnika w programie Płatnik dla każdego obsługiwanego podmiotu gospodarczego oraz powiązania ich z odpowiednimi podmiotami zarejestrowanymi w Gratyfikancie GT. Wymagane jest zachowanie przejrzystej struktury katalogów wymiany, aby wykluczyć ryzyko zaimportowania dokumentów do niewłaściwej kartoteki.

Najczęstsze błędy podczas samodzielnej konfiguracji

Próby samodzielnego uruchomienia eksportu lub rozwiązywania powstałych błędów bez pełnej znajomości struktury bazodanowej obu aplikacji często prowadzą do przestojów w pracy działu kadr oraz ryzyka przekroczenia terminów ustawowych ZUS. Do najczęściej powtarzających się problemów należą:

Niezgodność danych identyfikacyjnych ubezpieczonego: różnice w zapisie nazwisk, brak wpisanego drugiego imienia w jednym z programów lub błędnie zdefiniowany rodzaj dokumentu tożsamości (np. numer paszportu wpisany w pole dowodu osobistego) powodują odrzucenie importu przez Płatnika lub utworzenie zduplikowanej kartoteki ubezpieczonego.
Niewłaściwe kody tytułu ubezpieczenia w umowach cywilnoprawnych: przypisanie niepoprawnego kodu ubezpieczenia przy umowach zlecenie lub umowach o dzieło (np. nieuwzględnienie statusu studenta do 26. roku życia lub braku innego tytułu do ubezpieczeń) skutkuje naliczeniem nieprawidłowych składek, co generuje błędy krytyczne podczas weryfikacji dokumentów w Płatniku.
Ręczna edycja wygenerowanych plików KEDU: próby modyfikacji pliku KEDU/XML w edytorach tekstowych (np. Notatniku) w celu szybkiej poprawy błędów niszczą strukturę znaczników XML lub kodowanie znaków (UTF-8, ISO-8859-2, Windows-1250), uniemożliwiając odczytanie pliku przez mechanizmy walidujące Płatnika.
Brak aktualizacji komponentów i metryk: generowanie eksportu z nieaktualnej wersji Gratyfikanta GT do zaktualizowanego programu Płatnik (lub odwrotnie) wywołuje błędy niezgodności schematów dokumentów (błąd walidacji ze schematem XSD).
Niepoprawne zdefiniowanie kodów świadczeń chorobowych: pomylenie kodów świadczeń (np. wynagrodzenie za czas niezdolności do pracy finansowane przez pracodawcę – kod 331, z zasiłkiem chorobowym z ubezpieczenia chorobowego – kod 313) prowadzi do błędnego wypełnienia raportu ZUS RSA i odrzucenia deklaracji rozliczeniowej.
Rozbieżności w zaokrągleniach groszowych: różnice wynikające z odmiennego algorytmu sumowania składek (zaokrąglanie na poziomie pojedynczej pozycji płacowej vs zaokrąglanie od łącznej sumy podstaw wymiaru składek w Płatniku).
Błędy uprawnień do katalogu wymiany: brak uprawnień zapisu w folderze eksportu w środowisku Windows lub na udziale sieciowym powoduje generowanie komunikatów o braku dostępu i przerywanie procedury eksportu.

Kiedy problem nie leży po stronie eksportu danych

W trakcie diagnozy problemów z rozliczeniami ZUS zdarza się, że przyczyna usterki leży poza samym modułem eksportu Gratyfikanta GT. Właściwa identyfikacja źródła problemu pozwala uniknąć zbędnych modyfikacji w danych kadrowo-płacowych. Do typowych przyczyn zewnętrznych należą:

Uszkodzenie lub przepełnienie bazy danych Płatnika: w przypadku standardowej bazy plikowej Microsoft Access (.mdb) osiągnięcie rozmiaru zbliżonego do 2 GB (maksymalny fizyczny limit formatu Access) prowadzi do blokady zapisu, błędów indeksacji i awarii silnika Jet/ACE. Wymaga to przeprowadzenia procedury kompaktowania i naprawy bazy lub jej migracji na Microsoft SQL Server.
Problemy z certyfikatem kwalifikowanym i podpisem elektronicznym: brak możliwości wysłania zestawu dokumentów po poprawnym imporcie z Gratyfikanta GT często wynika z nieaktualnych sterowników karty kryptograficznej (oprogramowania czytnika kart lub tokena USB), wygasłego certyfikatu kwalifikowanego lub braku zainstalowanych certyfikatów pośrednich (np. certyfikatów Centrum Certyfikacji) w magazynie certyfikatów Windows.
Błędy pobierania metryki i komponentów ZUS: Płatnik blokuje weryfikację i wysyłkę dokumentów w przypadku problemów z połączeniem z serwerami ZUS, co bywa spowodowane blokadami na zaporze sieciowej (firewall), uszkodzonymi bibliotekami kryptograficznymi TLS w systemie Windows lub przerwami technicznymi po stronie Zakładu Ubezpieczeń Społecznych.
Uszkodzenie struktur bazy Gratyfikanta GT: błędy spójności tabel bazy Microsoft SQL Server wywołane nagłymi spadkami napięcia lub awariami dysków mogą uniemożliwiać poprawne przeliczanie list płac i generowanie plików KEDU, co wymaga naprawy bazy narzędziami administracyjnymi InsERT (Program Serwisowy).
Błędy bibliotek systemowych Windows: uszkodzenia komponentów takich jak Microsoft XML Core Services (MSXML) lub środowiska .NET Framework, które odpowiadają za parsowanie i generowanie dokumentów XML.

Procedura wdrożenia i weryfikacji na miejscu u klienta

Wszystkie prace konfiguracyjne i naprawcze realizowane są w modelu bezpośredniego dojazdu do siedziby klienta na obszarze Warszawy oraz w okolicznych powiatach (w promieniu do 40 km od stolicy, obejmującym powiaty: grodziski, legionowski, otwocki, piaseczyński, pruszkowski, warszawski zachodni oraz wołomiński). Wyjazd serwisanta bezpośrednio do biura klienta umożliwia przetestowanie pełnej ścieżki obiegu danych na rzeczywistej infrastrukturze komputerowej i sieciowej.

Standardowa procedura wdrożenia integracji obejmuje następujące kroki:

Kopia bezpieczeństwa: wykonanie pełnych kopii zapasowych baz danych systemu Gratyfikant GT (baza SQL Server) oraz programu Płatnik (plik mdb lub baza SQL) przed przystąpieniem do jakichkolwiek modyfikacji.
Weryfikacja środowiska systemowego: sprawdzenie wersji oprogramowania Gratyfikant GT, programu Płatnik, silnika bazy danych Microsoft SQL Server oraz aktualności metryk i słowników ZUS.
Audyt konfiguracji kadrowo-płacowej: przegląd definicji składników płacowych, kodów tytułu ubezpieczenia oraz schematów potrąceń pod kątem ich zgodności z wymaganiami programu Płatnik.
Konfiguracja parametrów eksportu i importu: ustawienie ścieżek wymiany plików KEDU, uprawnień użytkowników w systemie Windows oraz formatów plików wynikowych.
Testowy transfer danych: przeprowadzenie próbnego eksportu dokumentów zgłoszeniowych (ZUS ZUA/ZZA) oraz rozliczeniowych (ZUS DRA/RCA/RSA/RPA) z Gratyfikanta GT do programu Płatnik.
Weryfikacja i walidacja dokumentów: uruchomienie funkcji weryfikacji w programie Płatnik w celu sprawdzenia, czy wygenerowane dokumenty nie zawierają błędów krytycznych ani ostrzeżeń blokujących podpisanie i wysyłkę do ZUS.
Test podpisu elektronicznego i wysyłki: weryfikacja poprawności współpracy programu Płatnik z podpisem kwalifikowanym oraz test komunikacji z serwerami ZUS.

Z uwagi na przetwarzanie wrażliwych informacji dotyczących wynagrodzeń i danych osobowych pracowników, na życzenie klienta bezpłatnie podpisywana jest umowa o zachowaniu poufności (NDA) przed przystąpieniem do jakichkolwiek prac na systemach kadrowo-płacowych.

Dodatkowe pytania o integrację Gratyfikanta GT z Płatnikiem

Czy po aktualizacji Gratyfikanta GT integracja z Płatnikiem wymaga ponownej konfiguracji?

Z reguły standardowa aktualizacja Gratyfikanta GT w ramach linii InsERT GT zachowuje dotychczasowe ustawienia ścieżek eksportu i definicji składników. Jednakże w sytuacji, gdy aktualizacja wprowadza zmiany w schemacie formatu KEDU lub gdy Zakład Ubezpieczeń Społecznych wdraża nową metrykę programu Płatnik ze zmienionymi regułami walidacji, konieczna może być weryfikacja poprawności mapowania nowych pól w deklaracjach oraz aktualizacja bibliotek eksportujących.

W jaki sposób rozwiązać problem rozbieżności groszowych w składkach między Gratyfikantem GT a Płatnikiem?

Rozbieżności groszowe w kwotach składek ubezpieczeniowych wynikają najczęściej z odmiennych algorytmów zaokrągleń – Gratyfikant GT może wyliczać składki indywidualnie dla każdego składnika płacowego na liście płac, podczas gdy Płatnik sumuje podstawy wymiaru składek dla danego ubezpieczonego i zaokrągla dopiero końcową kwotę składki. Rozwiązaniem jest odpowiednia konfiguracja parametrów naliczania składek i zaokrągleń w Gratyfikancie GT, aby algorytm był w pełni tożsamy ze schematem obliczeniowym Płatnika.

Czy można przenieść bazę danych Płatnika na serwer z Gratyfikantem GT?

Tak, przeniesienie bazy danych programu Płatnik na ten sam serwer Microsoft SQL Server, na którym działa baza Gratyfikanta GT, jest zalecanym rozwiązaniem w środowiskach wielostanowiskowych. Pozwala to na centralizację kopii zapasowych, zwiększa bezpieczeństwo danych, eliminuje ograniczenie rozmiaru 2 GB bazy Access oraz przyspiesza proces importu i weryfikacji dużych zbiorów dokumentów rozliczeniowych.

Co zrobić, gdy Płatnik nie widzi pliku wyeksportowanego z Gratyfikanta GT?

Najczęstszą przyczyną jest brak odpowiednich uprawnień do odczytu folderu sieciowego przez użytkownika pracującego w programie Płatnik, zapisanie pliku z niestandardowym rozszerzeniem lub błędnie wskazana ścieżka w kreatorze importu. Należy zweryfikować uprawnienia NTFS i udostępniania w systemie Windows oraz upewnić się, że plik KEDU został prawidłowo i całkowicie zapisany przez moduł eksportu Gratyfikanta GT.

Czy integracja obejmuje również deklaracje korygujące za ubiegłe miesiące?

Tak, Gratyfikant GT umożliwia generowanie deklaracji korygujących (korekty ZUS DRA i imiennych raportów korygujących RCA/RSA). Integracja obejmuje konfigurację poprawnego generowania numerów deklaracji (zakres od 02 do 39 dla deklaracji korygujących w danym miesiącu rozliczeniowym) oraz ich właściwe wczytanie do utworzonego w Płatniku kompletu korygującego.

Jak postępować w przypadku umów cywilnoprawnych z zerowymi składkami ZUS?

W przypadku umów zlecenie zawieranych ze studentami lub uczniami do 26. roku życia, które nie podlegają obowiązkowi ubezpieczeń społecznych i zdrowotnego, konieczne jest właściwe ustawienie parametrów umowy w Gratyfikancie GT. Prawidłowa konfiguracja zapobiega generowaniu pustych lub błędnych raportów RCA/RZA dla tych osób, co eliminuje błędy walidacji podczas importu zestawu do programu Płatnik.

Prawidłowy obieg dokumentów rozliczeniowych i bezpieczeństwo danych

Sprawnie działająca integracja systemu Gratyfikant GT z programem Płatnik eliminuje potrzebę czasochłonnego i podatnego na błędy ręcznego wprowadzania danych o wynagrodzeniach i składkach ubezpieczeniowych. Prawidłowa konfiguracja środowiska wymiany danych, wdrożenie odpowiednich uprawnień sieciowych oraz regularna kontrola spójności kartotek zapewniają pełną zgodność ze standardami Zakładu Ubezpieczeń Społecznych i ciągłość terminowych rozliczeń kadrowo-płacowych w firmie.

22 378 48 09

Gratyfikant GT — integracja z programem Płatnik ZUS