Polska firma IT z obrotem kadrowym ponad 1500 umów miesięcznie potrzebowała usprawnić proces, który co miesiąc obciążał zespół kadrowy. Dane trafiały do Google Sheets, a następnie były ręcznie przepisywane do systemów Rewizor nexo i Gratyfikant nexo. Dotyczyło to pracowników, umów, umów o dzieło, umów zlecenia i rachunków.
Problemem nie był wyłącznie czas. Ręczne wprowadzanie danych zwiększało ryzyko błędów w rozliczeniach, zwłaszcza przy umowach z przeniesieniem praw autorskich i bez przeniesienia praw autorskich. W takich przypadkach znaczenie mają koszty uzyskania przychodu i poprawne rozliczenie PIT.
Growth Insider zaprojektował PayrollBridge, czyli wewnętrzny proces integracyjny łączący Google Sheets, MS SQL Server oraz systemy z linii InsERT nexo. Po wdrożeniu pełne przetwarzanie pakietu trwa około 10 minut, a dodatkowa kontrola około 10 minut. W testach obejmujących ponad 10 000 umów nie wykryto błędów.
Krótko o projekcie
Projekt został zrealizowany dla polskiej firmy IT, której nazwa pozostaje poufna. Organizacja działa w obszarze IT i digital operations, a jej miesięczny obieg kadrowy przekracza 1500 umów. Skala procesu sprawiała, że ręczna obsługa pracowników, umów i rachunków zaczęła obciążać zespół oraz zwiększać ryzyko błędów operacyjnych.
Źródłem danych był Google Sheets. Dane z arkuszy trafiały następnie do systemów Rewizor nexo i Gratyfikant nexo, działających w środowisku MS SQL Server. Integracja została zaprojektowana jako proces batch ETL oraz integracja na poziomie bazy danych, ponieważ standardowy scenariusz API nie pokrywał potrzeb klienta.
Zakres automatyzacji objął tworzenie i aktualizację pracowników, przygotowanie umów, obsługę umów o dzieło i umów zlecenia, generowanie rachunków oraz kontrolę zgodności danych między źródłem a systemem docelowym.
Przed wdrożeniem proces zajmował około jednego tygodnia ręcznej pracy miesięcznie. Po wdrożeniu PayrollBridge pełne przetwarzanie danych trwa około 10 minut, a dodatkowa kontrola wyniku około 10 minut.
Rozwiązanie zostało przetestowane na ponad 10 000 umów z ostatnich 3 lat. W ramach przeprowadzonych testów nie wykryto błędów. Dodatkowa weryfikacja produkcyjna potwierdziła zgodność 41 z 41 sprawdzonych umów w kluczowych polach.
Problem: tydzień ręcznej pracy co miesiąc
Przed wdrożeniem integracji proces kadrowy był wykonywany ręcznie. Dane były eksportowane do Google Sheets, a następnie kadrowiec przenosił je do systemu kadrowo-płacowego i księgowego.
Każdy miesiąc oznaczał podobny zestaw czynności:
- utworzenie lub aktualizację pracowników,
- przygotowanie umów,
- utworzenie umów o dzieło,
- utworzenie umów zlecenia,
- wystawienie rachunków na podstawie umów,
- kontrolę poprawności danych.
Przy wolumenie 1000-1500 umów miesięcznie ten proces przestawał być zwykłą administracją. Stawał się operacyjnym ryzykiem.
Ręczna praca zajmowała około 40 godzin miesięcznie. Przy stawce 60 zł brutto za godzinę dawało to 2400 zł brutto miesięcznie samego kosztu pracy. To nadal tylko koszt bezpośredni. Nie obejmuje wartości poprawek, ponownych kontroli, opóźnień, ryzyka podatkowego i obciążenia osoby odpowiedzialnej za cały proces.
W przypadku kadr i płac błąd w jednej kolumnie może mieć konsekwencje dalej w procesie. Szczególnie ważna była różnica między umowami z przeniesieniem praw autorskich i bez przeniesienia praw autorskich. Przy przychodach z praw autorskich mogą mieć zastosowanie inne koszty uzyskania przychodu niż przy standardowych umowach cywilnoprawnych. Z kolei przy umowach zlecenia i umowach o dzieło istotne jest prawidłowe ustalenie podstawy rozliczenia PIT.
Dla właściciela firmy to nie jest techniczny detal. To kwestia kontroli nad procesem, przewidywalności i odpowiedzialności.
Dlaczego zwykła integracja nie wystarczyła
W wielu projektach integracyjnych naturalnym wyborem jest API. W tym przypadku gotowy interfejs nie obejmował potrzebnego scenariusza. Chodziło nie tylko o odczyt danych, ale o bezpieczne tworzenie i aktualizację powiązanych rekordów w systemach kadrowo-księgowych.
Dlatego integracja została wykonana na poziomie bazy danych przez MS SQL Server.
To podejście jest bardziej wymagające niż prosta wymiana plików. Systemy z linii InsERT nexo mają rozbudowaną strukturę danych. Rewizor nexo obsługuje obszar finansowo-księgowy, a Gratyfikant nexo wspiera kadry i płace. Dane pracownika, adres, umowa, rachunek, typ rozliczenia i parametry podatkowe są ze sobą powiązane.
Nie wystarczy więc “dopisać rekordu do tabeli”. Trzeba rozumieć kolejność operacji, zależności między danymi i skutki błędnego zapisu. Właśnie dlatego projekt wymagał podejścia ostrożnego, testowalnego i powtarzalnego.
Rozwiązanie: PayrollBridge jako integracja z systemem kadrowo-płacowym
Growth Insider przygotował PayrollBridge jako wewnętrzną warstwę integracyjną. To nie jest gotowy produkt SaaS. To proces zaprojektowany pod konkretny sposób pracy firmy i jej miesięczny cykl rozliczeniowy.
PayrollBridge łączy:
- Google Sheets jako źródło danych,
- MS SQL Server jako warstwę dostępu do danych,
- Rewizor nexo jako system finansowo-księgowy,
- Gratyfikant nexo jako system kadrowo-płacowy.
Integracja działa w modelu batch. Oznacza to, że przetwarza pakiet danych w kontrolowanym uruchomieniu. Taki model dobrze pasuje do comiesięcznej pracy kadrowej, gdzie ważna jest kompletność, kontrola i możliwość ponownego sprawdzenia wyniku.
Dla firmy najważniejsza zmiana była prosta: zespół przestał ręcznie przepisywać setki i tysiące pozycji. Operator może uruchomić proces, otrzymać wynik, sprawdzić tabelę kontrolną i porównać dane źródłowe z tym, co zostało utworzone w systemie docelowym.
To jest właściwa rola automatyzacji w kadrach i płacach. Nie chodzi o zastąpienie odpowiedzialności człowieka. Chodzi o usunięcie powtarzalnego, podatnego na błędy przepisywania danych.
Jak działa integracja
Proces został ułożony tak, aby dane przechodziły przez kolejne etapy kontroli.
- Dane są eksportowane z wewnętrznej bazy firmy IT do Google Sheets.
- Integracja sprawdza, czy istnieją wymagane arkusze.
- System weryfikuje nagłówki i strukturę danych.
- Dane są normalizowane do oczekiwanego formatu.
- Sprawdzane są obowiązkowe pola, PESEL, typ umowy, dane wypłat i informacja o przeniesieniu praw autorskich.
- System tworzy lub aktualizuje pracownika.
- Na podstawie pracownika i danych historycznych tworzona jest umowa.
- Tworzone są umowy o dzieło i umowy zlecenia.
- Na podstawie umowy tworzony jest rachunek.
- Zapisywane są techniczne logi.
- Dane trafiają do tabeli kontrolnej.
- Operator może porównać dane z Google Sheets z danymi w Rewizor nexo i Gratyfikant nexo.
- Proces można bezpiecznie uruchomić ponownie.
Ważnym elementem jest preflight validation, czyli kontrola przed właściwym zapisem danych. Dzięki niej można wykryć błędy w strukturze arkusza, brakujące pola lub niespójności, zanim system zacznie tworzyć dane w środowisku docelowym.
Drugim ważnym elementem jest tryb dry-run. Pozwala przeprowadzić próbne uruchomienie bez trwałego zapisu. To szczególnie przydatne przy procesach kadrowych, gdzie testowanie powinno poprzedzać każdy istotny etap wdrożenia.
Dlaczego idempotencja była krytyczna
W integracjach kadrowo-płacowych powtarzalność jest równie ważna jak szybkość. Proces może zostać uruchomiony drugi raz po poprawieniu arkusza, po zmianie danych lub po dodatkowej kontroli.
Bez odpowiedniego zabezpieczenia ponowne uruchomienie mogłoby utworzyć drugiego pracownika, drugą umowę lub drugi rachunek dla tej samej operacji. W praktyce oznaczałoby to bałagan w danych i konieczność ręcznego sprzątania systemu.
Dlatego w PayrollBridge zastosowano idempotencję. W prostych słowach: jeżeli dana operacja została już wykonana, system potrafi ją rozpoznać i nie tworzy duplikatu.
Pomaga w tym deterministyczny klucz importu. Jest to przewidywalny identyfikator operacji, dzięki któremu integracja wie, czy dana pozycja została już przetworzona. Do tego dochodzą kontrole duplikatów i przetwarzanie świadome źródła danych.
Dla przedsiębiorcy oznacza to większe bezpieczeństwo operacyjne. Zespół może pracować na realnym procesie, poprawiać dane i powtarzać przetwarzanie bez obawy, że każde uruchomienie zaśmieci system.
Jak ograniczono duplikaty i błędy w danych
PayrollBridge nie został zaprojektowany jako prosty importer. Jego zadaniem było również wykrywanie problemów, zanim trafią do systemu kadrowo-płacowego.
W projekcie wdrożono między innymi:
- kontrolę wymaganych arkuszy,
- kontrolę nagłówków,
- normalizację danych,
- walidację numeru PESEL,
- kontrolę typu umowy,
- walidację przedmiotu umowy,
- kontrolę danych wypłat,
- rozróżnienie umów z przeniesieniem praw autorskich i bez niego,
- zapobieganie duplikatom pracowników,
- zapobieganie duplikatom umów,
- zapobieganie duplikatom rachunków,
- tabelę kontrolną do porównania danych,
- techniczne logi w formacie JSON,
- raportowanie błędów,
- kontrole integralności danych,
- bezpieczne ponowne uruchomienia.
W testowym imporcie wykryto też konkretny problem z duplikatami adresów pracowników. W tej architekturze jeden pracownik powinien mieć jeden poprawny adres zamieszkania. Duplikaty mogły powodować błędy w dalszym procesie i blokować poprawne tworzenie umów.
Zespół dodał dodatkowe kontrole oraz logikę ochronną. Dzięki temu problem został rozwiązany przed przeniesieniem procesu do pracy produkcyjnej.
To ważna lekcja z projektu. W automatyzacji kadr i płac nie wystarczy sprawdzić, czy “coś się utworzyło”. Trzeba jeszcze wiedzieć, czy dane są spójne, możliwe do rozliczenia i gotowe do dalszej pracy.
Co było najtrudniejsze technicznie
Najtrudniejsza część projektu nie polegała na pobraniu danych z arkusza. Największym wyzwaniem była bezpieczna praca z rozbudowaną strukturą systemu kadrowo-księgowego.
Po pierwsze, baza danych miała wiele powiązanych elementów. Pracownik, adres, umowa, rachunek i dane podatkowe musiały zostać zapisane w poprawnej kolejności i z zachowaniem relacji.
Po drugie, proces dotyczył polskich realiów kadrowych i podatkowych. Biznes.gov.pl opisuje umowy cywilnoprawne jako obszar, w którym ważne są właściwe warunki umowy, obowiązki stron i koszty współpracy. W projekcie trzeba było uwzględnić różne typy umów, różne warianty kosztów uzyskania przychodu i wpływ tych danych na PIT.
Po trzecie, integracja musiała być odporna na ponowne uruchomienia. Proces miesięczny rzadko jest jednorazowym kliknięciem. Dane bywają poprawiane, uzupełniane i ponownie sprawdzane.
Po czwarte, potrzebna była szybka kontrola wyniku. Sama automatyzacja bez tabeli kontrolnej zostawiłaby zespół z pytaniem: czy wszystko naprawdę zostało utworzone poprawnie? Dlatego tabela porównawcza stała się częścią rozwiązania, a nie dodatkiem po wdrożeniu.
Rezultaty
Po wdrożeniu PayrollBridge pełne przetwarzanie pakietu danych zajmuje około 10 minut. Dodatkowa kontrola zajmuje kolejne około 10 minut. Wcześniej cały proces wymagał około jednego tygodnia pracy ręcznej miesięcznie.
Najważniejsze wyniki:
- obsługa wolumenu 1000-1500 umów miesięcznie,
- tworzenie porównywalnej liczby rachunków,
- automatyczne tworzenie i aktualizacja pracowników,
- automatyzacja umów o dzieło i umów zlecenia,
- ograniczenie ręcznego przepisywania danych,
- bezpieczne ponowne uruchamianie procesu,
- ochrona przed duplikatami,
- tabela kontrolna do szybkiej weryfikacji,
- testy na ponad 10 000 umów z ostatnich 3 lat,
- brak wykrytych błędów w ramach przeprowadzonych testów,
- production verification: 41 z 41 sprawdzonych umów zgodnych w kluczowych polach.
Nie traktujemy tego jako obietnicy braku błędów w każdej możliwej sytuacji. Poprawna konkluzja jest bardziej praktyczna: projekt pomógł znacząco ograniczyć ryzyko operacyjne i w ramach przeprowadzonego testowania nie wykryto błędów.
Ekonomia projektu
Przed automatyzacją proces zajmował około jednej roboczej tygodniówki miesięcznie.
Wyliczenie bezpośredniego kosztu pracy:
5 dni × 8 godzin = 40 godzin
40 godzin × 60 zł brutto = 2400 zł brutto miesięcznie
To tylko koszt samego ręcznego wykonywania operacji. Realny wpływ biznesowy jest szerszy, ponieważ ręczny proces generuje także:
- koszt ponownej kontroli,
- koszt poprawek,
- ryzyko błędów podatkowych,
- ryzyko opóźnień,
- przeciążenie kadrowca,
- zależność od jednej osoby,
- brak pełnej powtarzalności procesu.
Automatyzacja nie sprowadza się więc do oszczędności 40 godzin. Ważniejsza jest zmiana jakości pracy. Firma otrzymuje proces, który jest szybszy, powtarzalny, sprawdzalny i mniej zależny od ręcznego przepisywania danych.
Co przedsiębiorca może wynieść z tego case study
Pierwszy wniosek: automatyzację trzeba zaczynać od procesu, nie od kodu. Jeśli firma nie wie, skąd przychodzą dane, kto je poprawia, kiedy są gotowe i jak sprawdza się wynik, sama integracja nie rozwiąże problemu.
Drugi wniosek: integracja bez API jest możliwa, ale wymaga ostrożności. Praca na poziomie bazy danych może być uzasadniona, gdy API nie obsługuje danego scenariusza. Wymaga jednak testów, kontroli integralności, logów, dry-run i planu awaryjnego.
Trzeci wniosek: w kadrach i księgowości niezawodność jest ważniejsza niż szybkie wdrożenie. Lepiej dłużej dopracować walidację i zabezpieczenia, niż później ręcznie naprawiać dane produkcyjne.
Czwarty wniosek: idempotencja jest obowiązkowa przy powtarzalnych importach. Każdy proces, który może być uruchomiony ponownie, musi wiedzieć, co już zostało utworzone.
Piąty wniosek: tabela kontrolna powinna być częścią systemu. Nie można zostawiać weryfikacji wyłącznie w głowie operatora.
Szósty wniosek: polska specyfika kadrowa wymaga zrozumienia domeny. Umowa o dzieło, umowa zlecenia, rachunek, PIT i koszty uzyskania przychodu nie są tylko nazwami pól. To elementy realnego procesu rozliczeniowego.
Kiedy firma potrzebuje takiej integracji
Integracja z systemem kadrowo-płacowym ma sens, gdy firma:
- co miesiąc obsługuje setki lub tysiące umów,
- używa Google Sheets jako pośredniego źródła danych,
- ręcznie przenosi dane do Rewizor nexo lub Gratyfikant nexo,
- regularnie tworzy umowy o dzieło, umowy zlecenia i rachunki,
- ma ryzyko błędów przy danych wypłat,
- potrzebuje kontroli nad rozliczeniami PIT,
- zależy od jednej osoby w procesie kadrowym,
- chce szybciej zamykać miesięczny cykl rozliczeń,
- nie ma gotowego API dla potrzebnego scenariusza,
- potrzebuje tabeli kontrolnej między źródłem i systemem docelowym.
To szczególnie ważne dla firm IT, agencji, platform usługowych, zespołów operacyjnych i firm, które pracują z dużą liczbą wykonawców.
FAQ
Co to jest integracja z systemem kadrowo-płacowym?
To połączenie źródła danych z systemem kadrowym, płacowym lub księgowym. Taka integracja może automatycznie tworzyć pracowników, umowy, rachunki i dane kontrolne bez ręcznego przepisywania informacji.
Czy można zintegrować Google Sheets z Rewizor nexo i Gratyfikant nexo?
Tak. W tym projekcie Google Sheets był źródłem danych, a Rewizor nexo i Gratyfikant nexo były systemami docelowymi. Integracja działała przez MS SQL Server, ponieważ standardowy scenariusz API nie wystarczał do pełnej automatyzacji.
Dlaczego integracja przez bazę danych jest trudniejsza niż przez API?
API zwykle ukrywa część wewnętrznej złożoności systemu. Przy integracji przez bazę danych trzeba samodzielnie uwzględnić relacje, kolejność zapisów, obowiązkowe pola, historię danych i ograniczenia systemu.
Co oznacza idempotencja w integracji kadrowej?
Idempotencja oznacza, że ponowne uruchomienie procesu nie tworzy duplikatów. Jeśli pracownik, umowa lub rachunek zostały już utworzone, integracja powinna to rozpoznać.
Jak uniknąć duplikatów pracowników i umów?
Potrzebne są przewidywalne klucze importu, kontrole przed zapisem, analiza istniejących danych, rozróżnienie źródeł oraz tabela kontrolna. Ważne jest też testowanie ponownych uruchomień.
Czy można automatyzować umowy o dzieło i umowy zlecenia?
Tak, ale automatyzacja musi uwzględniać typ umowy, przedmiot umowy, dane wypłat, przeniesienie praw autorskich i skutki podatkowe. To nie jest tylko generowanie dokumentu.
Ile czasu może oszczędzić automatyzacja kadr i płac?
W tym case study proces skrócił się z około jednego tygodnia pracy miesięcznie do około 10 minut przetwarzania i około 10 minut kontroli. Rzeczywisty efekt zależy od skali i złożoności procesu.
Kiedy warto zamówić custom HR/payroll integration?
Gdy ręczny proces stał się wąskim gardłem, dane są przenoszone między systemami, błędy wpływają na rozliczenia, a gotowe konektory nie obejmują potrzebnego workflow.
Jeśli w Twojej firmie proces kadrowy, księgowy lub umowny nadal opiera się na Google Sheets, ręcznym przepisywaniu danych i wieloetapowej kontroli, możemy pomóc zaprojektować bezpieczną integrację.
Skontaktuj się z Growth Insider i opowiedz, gdzie zespół traci czas, kontrolę lub pewność danych. Zobaczymy, czy lepszym pierwszym krokiem będzie diagnoza procesu, proof of concept, integracja z systemem kadrowo-płacowym, automatyzacja raportowania czy uporządkowanie źródeł danych.
Zobacz też, jak pracujemy nad projektami i jak podchodzimy do biznes-systemów oraz automatyzacji. Możesz również wrócić na stronę główną Growth Insider, aby poznać szerszy zakres naszych usług.