Płatnik – naprawa błędów synchronizacji danych

Automatyczny import danych z programu kadrowo-płacowego do Płatnika za pomocą plików KEDU jest podstawą efektywnej i bezbłędnej pracy w większości firm. Niestety, synchronizacja ta bywa źródłem problemów: niezgodności formatów, błędów walidacji KEDU, niespójności w kodach tytułów ubezpieczenia czy rozbieżności w danych osobowych ubezpieczonych. Systematyczne podejście do diagnostyki i naprawy tych błędów pozwala przywrócić niezawodną automatyzację przepływu danych między systemami.

Najczęstsze przyczyny błędów synchronizacji

Błędy podczas importu pliku KEDU z programu kadrowego najczęściej wynikają z:

• Niezgodności wersji formatu KEDU – program kadrowy może eksportować plik w starszej wersji formatu niż ta, którą obsługuje zainstalowana wersja Płatnika.
• Błędnych kodów tytułów ubezpieczenia – po zmianach prawnych kody mogą być nieaktualne w programie kadrowym, co powoduje błąd walidacji w Płatniku.
• Rozbieżności w danych identyfikacyjnych – różne pisownie imion, błędy w PESEL lub NIP, literówki w nazwisku mogą spowodować, że Płatnik nie odnajdzie ubezpieczonego w bazie.
• Uszkodzenia pliku KEDU – błędy kodowania znaków (np. polska litera zapisana w złym kodowaniu), nieprawidłowe zakończenie pliku lub zagnieżdżenie tagów XML.
• Niezgodności okresów ubezpieczenia – brak dokumentu ZUA dla osoby, której dane próbuje zaimportować RCA.

Diagnostyka błędu importu KEDU

Po nieudanym imporcie Płatnik wyświetla komunikat błędu, który zazwyczaj wskazuje numer wiersza lub identyfikator dokumentu powodującego problem. Aby skutecznie zdiagnozować błąd:

1. Zapisz dokładny komunikat błędu (zrzut ekranu lub przepisanie treści).
2. Otwórz plik KEDU w edytorze tekstowym (Notatnik lub Notepad++) – pliki KEDU są formatem tekstowym lub XML.
3. Przejdź do wskazanego numeru wiersza i zidentyfikuj problematyczny wpis.
4. Sprawdź, czy podany kod tytułu ubezpieczenia istnieje w aktualnej liście kodów ZUS.
5. Zweryfikuj dane identyfikacyjne ubezpieczonego (PESEL, NIP, imię, nazwisko) pod kątem literówek.

Naprawa pliku KEDU

Drobne błędy w pliku KEDU można naprawić ręcznie w edytorze tekstowym:

• Popraw błędny kod tytułu ubezpieczenia na aktualny.
• Napraw błędy w PESEL lub NIP (dodaj brakującą cyfrę, popraw przestawione cyfry).
• Napraw kodowanie znaków – jeśli polskie litery są zaburzone, otwórz plik z kodowaniem Windows-1250 lub UTF-8 i zapisz w poprawnym.

Po modyfikacji zapisz plik pod nową nazwą (np. import_korygowany.txt) i ponów import.

Aktualizacja konfiguracji w programie kadrowym

Jeśli błędy wynikają z nieaktualnych ustawień w programie kadrowym, zaktualizuj:

• Słownik kodów tytułów ubezpieczenia – pobierz aktualną listę ze strony ZUS i uzupełnij w programie kadrowym.
• Ustawienia eksportu KEDU – sprawdź, czy program kadrowy eksportuje w formacie zgodnym z aktualną specyfikacją ZUS.
• Dane identyfikacyjne pracowników – porównaj dane w programie kadrowym z danymi w Płatniku i ujednolicaj rozbieżności.

Weryfikacja po poprawnym imporcie

Po udanym imporcie pliku KEDU zawsze sprawdź:

• Czy liczba zaimportowanych dokumentów imiennych zgadza się z oczekiwaną liczbą pracowników.
• Czy sumy podstaw składek w zaimportowanych RCA odpowiadają sumom z listy płac.
• Czy nie brakuje żadnego pracownika na liście – porównaj z listą z programu kadrowego.
• Czy DRA wygenerowana po imporcie zawiera poprawne sumy zbiorcze.

Automatyzacja i monitorowanie synchronizacji

Jeśli synchronizacja odbywa się regularnie (co miesiąc), warto stworzyć checklistę kroków kontrolnych po każdym imporcie. W środowiskach z wieloma pracownikami (powyżej 50 osób) zalecane jest wdrożenie procedury porównania sum z listy płac z danymi zaimportowanymi do Płatnika przed każdą wysyłką do ZUS.

Nasz serwis diagnozuje i naprawia błędy synchronizacji danych między programami kadrowymi a Płatnikiem, integruje nowe wersje formatów KEDU i konfiguruje bezbłędny przepływ danych. Skontaktuj się z nami, jeśli import z Twojego programu kadrowego przestał działać poprawnie.