Eksport danych z Płatnika w formacie XML pozwala automatycznie przekazywać informacje do zewnętrznego systemu kadrowo-płacowego bez ręcznego przepisywania.

Na czym polega ta usługa

Konfiguracja obejmuje ustawienie eksportu danych z Płatnika w odpowiednim formacie XML oraz sprawdzenie ich poprawnego importu do systemu docelowego.

Dla kogo ma sens

Usługa jest przydatna dla firm korzystających z osobnego systemu kadrowo-płacowego, które chcą zautomatyzować wymianę danych z Płatnikiem.

Ile to trwa

Konfiguracja eksportu danych 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.

Struktura formatu XML i standard KEDU w programie Płatnik

Program Płatnik, udostępniany przez Zakład Ubezpieczeń Społecznych, operuje na specyficznym standardzie dokumentów elektronicznych zwanym KEDU (Krajowy Elektroniczny Dokument Ubezpieczeniowy). Pliki generowane przez aplikację bazują na języku znaczników XML (rozszerzalnym języku formatowania danych, służącym do ustrukturyzowanej wymiany informacji między różnymi aplikacjami komputerowymi). Każdy plik XML tworzony w programie Płatnik musi spełniać rygorystyczne wymagania określone w schematach XSD (wzorcach definicji dokumentu XML, określających dozwolone elementy, atrybuty oraz typy danych).

W procesie eksportu z bazy Płatnika wyodrębniane są kluczowe zestawy informacji, w tym kartoteki płatnika składek, kartoteki ubezpieczonych (dane identyfikacyjne i ewidencyjne pracowników) oraz pełne komplety dokumentów rozliczeniowych i zgłoszeniowych. Wśród dokumentów zgłoszeniowych znajdują się formularze ZUS ZUA (zgłoszenie do ubezpieczeń społecznych i zdrowotnego), ZUS ZZA (zgłoszenie wyłącznie do ubezpieczenia zdrowotnego) oraz ZUS ZWUA (wyrejestrowanie z ubezpieczeń). Z kolei w obszarze rozliczeń eksportowane są deklaracje ZUS DRA (deklaracja rozliczeniowa płatnika), raporty imienne ZUS RCA (zestawienie należnych składek i wypłaconych świadczeń), ZUS RZA (raport o należnych składkach zdrowotnych) oraz ZUS RSA (raport o wypłaconych świadczeniach i przerwach w opłacaniu składek).

Poprawny eksport wymaga precyzyjnego dopasowania wersji schematu KEDU do wersji obsługiwanej przez zewnętrzny program kadrowo-płacowy. Zakład Ubezpieczeń Społecznych wraz z kolejnymi aktualizacjami programu Płatnik wprowadza nowe wersje struktur danych, co przy braku synchronizacji formatów w oprogramowaniu kadrowym prowadzi do błędów parsowania (procesu analizy składniowej pliku przez program docelowy) i odrzucenia całego pakietu dokumentów.

Współpraca Płatnika z popularnymi systemami kadrowo-płacowymi

Przekazywanie danych w formacie XML jest wykorzystywane do zasilania baz danych wiodących systemów kadrowo-płacowych funkcjonujących na polskim rynku. Nasi specjaliści konfigurują procedury eksportu i importu danych dla szerokiego spektrum aplikacji biznesowych, takich jak:

InsERT Gratyfikant GT oraz Gratyfikant nexo — systemy wymagające dopasowania kodowania znaków oraz poprawnego przyporządkowania kodów tytułów ubezpieczenia i schematów potrąceń składek ZUS.
Comarch ERP Optima (moduł Płace i Kadry) — środowisko przetwarzające pakiety KEDU i XML, w którym kluczowa jest zgodność identyfikatorów pracowników oraz okresów rozliczeniowych.
Symfonia Kadry i Płace oraz R2płatnik — aplikacje korzystające z rozbudowanych mechanizmów walidacji importowanych danych ubezpieczeniowych i historycznych podstaw wymiaru składek.
WAPRO ERP (WAPRO Gang) — oprogramowanie kadrowo-płacowe, w którym konfiguracja wymaga zdefiniowania odpowiednich filtrów importu kartotek oraz deklaracji rozliczeniowych.
enova365 (moduł Kadry Płace) — zintegrowany system ERP, w którym transfer danych XML pozwala na automatyczną synchronizację kartotek pracowniczych oraz weryfikację poprawności zgłoszeń.
RAKS SQL Kadry i Płace — system bazodanowy wymagający precyzyjnej struktury danych przy uzupełnianiu historii ubezpieczeniowej zatrudnionych osób.

W wielu przedsiębiorstwach zachodzi potrzeba odtworzenia historii zatrudnienia lub uzupełnienia bazy kadrowej po zmianie oprogramowania księgowego. Eksport danych z programu Płatnik w formacie XML pozwala na przeniesienie kompletnych kartotek ubezpieczonych bez konieczności manualnego wprowadzania setek rekordów, co eliminuje ryzyko pomyłek w numerach PESEL, NIP, datach urodzenia czy kodach oddziałów Narodowego Funduszu Zdrowia.

Najczęstsze warianty problemów przy eksporcie danych XML

Praktyka serwisowa wykazuje, że proces transferu danych między Płatnikiem a oprogramowaniem kadrowym może napotkać na zróżnicowane przeszkody techniczne i programowe. Do najczęściej występujących wariantów należą:

Niezgodność tabeli kodowej i kodowania znaków — pliki XML wygenerowane w programie Płatnik mogą korzystać z kodowania UTF-8 (uniwersalnego standardu kodowania znaków) lub Windows-1250 (strony kodowej dla języków środkowoeuropejskich). Niewłaściwa interpretacja strony kodowej przez moduł importu w systemie kadrowym powoduje zniekształcenie polskich znaków diakrytycznych (ą, ę, ś, ć, ż, ź, ł, ó, ń) lub całkowite zatrzymanie procesu odczytu pliku z komunikatem o błędzie nieprawidłowego znaku.
Rozbieżność wersji schematów dokumentów (niezgodność KEDU) — sytuacja, w której baza Płatnika zawiera dokumenty w nowszym formacie niż ten, który jest obsługiwany przez nieaktualizowaną wersję oprogramowania kadrowo-płacowego. System docelowy odrzuca plik z uwagi na nieznane węzły XML lub brakujące atrybuty wymagane w nowszej specyfikacji.
Niekompletne lub niespójne dane w kartotekach ubezpieczonych — obecność rekordów archiwalnych bez wypełnionego numeru PESEL (np. obcokrajowcy rozliczani wyłącznie paszportem), zdublowane wpisy pracowników lub brakujące kody tytułu ubezpieczenia (sześciocyfrowe kody ZUS, np. 01 10 00 dla pracowników etatowych). Błędy te blokują automatyczny import całego zbioru danych.
Problemy z podziałem na wielu płatników w jednej bazie — w biurach rachunkowych oraz grupach kapitałowych jedna baza Płatnika obsługuje wielu płatników składek. Nieprawidłowe wyeksportowanie paczki danych może skutkować wymieszaniem dokumentów różnych podmiotów gospodarczych lub próbą importu deklaracji do niewłaściwej firmy w systemie ERP.
Błędy uprawnień i blokady plików na poziomie systemu operacyjnego — brak uprawnień zapisu w folderze docelowym Windows NTFS lub blokowanie generowanych plików XML przez oprogramowanie antywirusowe bądź mechanizmy kontroli konta użytkownika (UAC).

Błędy popełniane podczas samodzielnych prób konfiguracji

Próby samodzielnego rozwiązywania problemów ze strukturą plików XML przez osoby bez odpowiedniego przygotowania informatycznego często prowadzą do pogłębienia usterki. Do najpoważniejszych błędów należą:

Ręczna modyfikacja plików XML w prostych edytorach tekstu — edycja pliku w programach typu Notatnik często powoduje uszkodzenie struktury znaczników (np. niezamknięte tagi XML) oraz niekontrolowaną zmianę nagłówka kodowania lub dodanie niewidocznego znacznika BOM (Byte Order Mark, sygnatury kolejności bajtów), który uniemożliwia przetworzenie pliku przez parser XML.
Brak wykonania kopii zapasowej przed procedurą importu — uruchomienie importu niesprawdzonego pliku XML do produkcyjnej bazy kadrowo-płacowej może skutkować nadpisaniem poprawnych danych pracowników, zdublowaniem kartotek lub uszkodzeniem powiązań relacyjnych w bazie SQL. Przywrócenie pierwotnego stanu bez aktualnej kopii bezpieczeństwa (backupu) bywa czasochłonne i kosztowne.
Ignorowanie raportów błędów i ostrzeżeń walidatora — pomijanie komunikatów generowanych przez wbudowany silnik weryfikacji danych i wymuszanie importu niekompletnych danych, co prowadzi do późniejszych niezgodności w deklaracjach podatkowych PIT oraz rocznych raportach ZUS IMIR.
Modyfikacje bezpośrednio w strukturze bazy danych programu Płatnik — próby ręcznego poprawiania tabel bazy MS Access (pliku z rozszerzeniem .mdb) lub bazy MS SQL Server za pomocą zewnętrznych zapytań, co narusza integralność referencyjną i może trwale uniemożliwić uruchomienie programu Płatnik.

Kiedy przyczyna problemu leży poza samym formatem XML

W trakcie diagnozy informatycznej nierzadko okazuje się, że niemożność wyeksportowania lub zaimportowania danych nie wynika z błędów w samym formacie XML, lecz z problemów środowiskowych i systemowych. Należą do nich:

Uszkodzenie bazy danych programu Płatnik — uszkodzenie indeksów lub struktury tabel w pliku bazy MS Access bądź w instancji serwera Microsoft SQL Server. Objawia się to zawieszaniem programu podczas generowania raportów lub komunikatami o błędach silnika bazy danych Jet/OLE DB. W takiej sytuacji konieczna jest naprawa i kompaktowanie bazy przed przystąpieniem do eksportu.
Nieaktualne komponenty i słowniki ZUS — brak pobranych aktualnych bibliotek programu, komponentów weryfikujących oraz danych słownikowych z serwerów ZUS. Program Płatnik może wówczas generować pliki niezgodne z bieżącymi wymogami prawnymi i technicznymi.
Ograniczenia konfiguracji modułów zewnętrznych w systemie ERP — brak aktywnej licencji na moduł integracji z Płatnikiem w programie kadrowym, niepoprawnie skonfigurowane ścieżki wymiany plików lub brak zainstalowanych sterowników dostępu do danych (np. Microsoft Access Database Engine).
Konflikty uprawnień sieciowych w środowiskach wielostanowiskowych — problemy z dostępem do zasobów współdzielonych w sieci lokalnej (SMB/CIFS), uniemożliwiające jednoczesny zapis i odczyt plików wymiany przez stanowisko kadrowe i stanowisko z programem Płatnik.

Procedura konfiguracji i wdrożenia eksportu realizowana przez serwisanta

Prace konfiguracyjne realizowane są bezpośrednio w siedzibie klienta przez doświadczonego serwisanta. Standardowy proces wdrożenia obejmuje następujące etapy:

Audyt środowiska i wykonanie kopii bezpieczeństwa — zabezpieczenie bazy danych programu Płatnik oraz bazy systemu kadrowo-płacowego na zewnętrznym nośniku lub dedykowanym zasobie backupowym.
Weryfikacja wersji oprogramowania i schematów wymiany — sprawdzenie zainstalowanych wersji aplikacji, poziomu aktualizacji metryk ZUS oraz zgodności schematów dokumentów XML/KEDU.
Konfiguracja parametrów eksportu w programie Płatnik — ustawienie odpowiednich filtrów danych, zakresów czasowych, definicji płatnika oraz docelowych ścieżek zapisu plików.
Konfiguracja profilu importu w systemie kadrowo-płacowym — zdefiniowanie reguł mapowania pól (przyporządkowania znaczników XML do odpowiednich kolumn w bazie danych kadr), ustawienie właściwego kodowania znaków oraz określenie zasad postępowania z duplikatami rekordów.
Wykonanie importu próbnego i weryfikacja integralności — przetworzenie testowej paczki danych na kopii roboczej bazy, szczegółowe sprawdzenie poprawności zaimportowanych kartotek, kwot składek społecznych, zdrowotnych oraz Funduszu Pracy i FGŚP (Funduszu Gwarantowanych Świadczeń Pracowniczych).
Uruchomienie procedury produkcyjnej i instruktaż — przeprowadzenie właściwego transferu danych oraz przekazanie personelowi działu kadr i płac wytycznych dotyczących bieżącej obsługi zautomatyzowanego procesu.

Bezpieczeństwo danych osobowych i poufność informacji kadrowych

Pliki XML generowane z programu Płatnik zawierają szczególne kategorie danych osobowych oraz szczegółowe informacje finansowe podlegające rygorystycznym przepisom o ochronie danych (RODO). Znajdują się w nich numery PESEL, adresy zamieszkania, dane o stanie zdrowia wynikające z kodów świadczeń rehabilitacyjnych i chorobowych, a także dokładne kwoty wynagrodzeń i podstaw naliczania składek.

Wszystkie prace konfiguracyjne i serwisowe przeprowadzane są z zachowaniem najwyższych standardów bezpieczeństwa IT. Na życzenie klienta podpisywana jest bezpłatna umowa o zachowaniu poufności (NDA — Non-Disclosure Agreement). Po zakończeniu procesu konfiguracji i weryfikacji wszelkie tymczasowe pliki XML utworzone w celach testowych są bezpowrotnie usuwane z dysków lokalnych, a docelowe foldery wymiany zabezpieczane są odpowiednimi uprawnieniami dostępu na poziomie kont użytkowników Windows.

Pytania i odpowiedzi dotyczące integracji danych Płatnika z systemami kadrowymi

Czy eksport danych w formacie XML pozwala przenieść kompletną historię ubezpieczenia pracownika?

Tak, poprawnie wyeksportowany zestaw dokumentów KEDU/XML zawiera pełną historię zgłoszeń oraz miesięcznych raportów rozliczeniowych zarejestrowanych w danej bazie Płatnika. Należy jednak pamiętać, że zakres zaimportowanych danych historycznych zależy od możliwości modułu importu w docelowym systemie kadrowo-płacowym, który może wymagać określonej kolejności przetwarzania dokumentów (od zgłoszeń ZUA/ZZA po chronologicznie ułożone raporty RCA/RSA).

Czy usługa obejmuje również konfigurację eksportu z systemu kadrowego do Płatnika?

Tak, nasi specjaliści konfigurują dwukierunkową wymianę danych. Najczęściej spotykanym modelem codziennej pracy jest generowanie miesięcznych deklaracji rozliczeniowych i dokumentów zgłoszeniowych w systemie kadrowo-płacowym, a następnie ich automatyczny import do programu Płatnik w celu weryfikacji i elektronicznej wysyłki do ZUS. Eksport w drugą stronę (z Płatnika do kadr) jest stosowany głównie przy wdrożeniach, migracjach danych oraz audytach rozliczeń.

Co zrobić, gdy system kadrowy zgłasza błąd naruszenia struktury pliku XML?

Komunikat o naruszeniu struktury wskazuje zazwyczaj na niezgodność wersji schematu XSD lub obecność nieobsługiwanego znaku w pliku wymiany. W takim przypadku nie należy podejmować prób ręcznej edycji pliku. Serwisant podczas wizyty diagnozuje źródło błędu za pomocą specjalistycznych walidatorów XML, koryguje parametry generatora lub aktualizuje profile importu w oprogramowaniu kadrowym.

Czy do prawidłowego działania wymiany danych wymagana jest instalacja serwera bazy danych Microsoft SQL Server?

Nie jest to bezwzględny wymóg, ponieważ program Płatnik obsługuje zarówno plikowe bazy danych Microsoft Access (format .mdb), jak i bazy oparte na silniku Microsoft SQL Server. Jednak w środowiskach, w których przetwarza się dane setek pracowników lub pracuje wielu użytkowników jednocześnie, migracja bazy Płatnika do środowiska MS SQL Server znacząco przyspiesza generowanie i przetwarzanie dużych plików XML oraz eliminuje błędy blokowania rekordów.

Jak szybko można uzyskać pomoc specjalisty w przypadku zablokowania rozliczeń z ZUS?

Zgłoszenia awarii i problemów integracyjnych realizowane są priorytetowo. Zapewniamy dojazd serwisanta na terenie Warszawy oraz okolicznych powiatów w promieniu do 40 km, dzięki czemu większość usterek i problemów konfiguracyjnych usuwamy sprawnie podczas pierwszej wizyty w biurze klienta.

Sprawna integracja Płatnika z systemem kadrowym w siedzibie Twojej firmy

Prawidłowe skonfigurowanie eksportu i importu danych w formacie XML między programem Płatnik a systemem kadrowo-płacowym eliminuje błędy manualnego wprowadzania danych, skraca czas przygotowywania comiesięcznych deklaracji i zapewnia pełną spójność dokumentacji przekazywanej do Zakładu Ubezpieczeń Społecznych. Nasi technicy wykonują pełną diagnostykę środowiska, konfigurację struktur wymiany oraz testy spójności danych bezpośrednio w siedzibie firmy na terenie Warszawy i okolicznych powiatów, zapewniając stabilne i bezpieczne funkcjonowanie działu kadr i płac.

22 378 48 09

Płatnik — eksport danych w formacie XML do systemu kadrowo-płacowego