Integracje i API

Nie zastępujemy wszystkiego. Wymieniamy się z tym, co macie.

Program płacowy zostaje, system gabinetowy zostaje, Wasze automatyzacje zostają. HRmoniq prowadzi wszystko pomiędzy — ludzi, umowy, grafiki, godziny, zadania, rozliczenia — i wymienia się z resztą danymi w obie strony. Poniżej pełna lista, łącznie z tym, czego nie robimy.

Płace: wymiana w obie strony Webhooki, n8n, API per moduł Eksport danych zawsze

Najczęstsze pytanie

Jak płynie wymiana z programem płacowym

Naliczenia i PIT-y robi Wasz program. My wysyłamy gotowe wejścia i odbieramy paski — od pierwszego miesiąca, bez ręcznego klejenia.

Odbicia i grafik godziny z faktów
Składniki nadgodziny, dodatki, potrącenia
Eksport do płac plik lub API, w układzie Waszego programu
Naliczenie u Was enova365, Optima, inny
Paski wracają do portalu pracownika

Kadry nie przepisują godzin, pracownik widzi pasek w telefonie

Z czym się wymieniamy

Sześć obszarów, jedna zasada: dane raz, na miejscu

Etap 1

Płace i księgowość

Wymiana dwukierunkowa, nie odcięcie.

enova365, Comarch Optima — składniki, godziny, potrącenia na wyjściu
Paski wypłat z powrotem do portalu pracownika
Faktury i korekty do KSeF przez adapter; noty księgowe poza KSeF
Plik przelewów do bankowości firmowej (zaliczki, wypłaty)

Etap 2

Urzędy i rejestry

Tam, gdzie da się złożyć maszynowo — składamy.

Automat urzędowy (boty, bo portale nie mają API): praca.gov.pl i portale spraw pobytowych
Autoryzacja mObywatel / profil zaufany — skan QR, kod SMS
Dane firmy z GUS przy rejestracji
Publiczne rejestry placówek i NFZ zasilają wyszukiwarkę

Etap 3

Komunikacja

Kanał wybiera odbiorca, historia zostaje na profilu.

SMS i e-mail systemowy ze statusem doręczenia
Telegram i Viber (boty), WhatsApp Business API
Powiadomienia push w aplikacjach
Odpowiedzi wracają webhookiem do profilu osoby

Etap 4

Podpis i dokumenty

Własna infrastruktura SMS; kwalifikowany od Q1 2027.

Podpis kodem SMS z własnej infrastruktury — umowy cywilnoprawne, aneksy, zgody
Podpis kwalifikowany (np. mSzafir): planowany na Q1 2027 — do tego czasu umowa o pracę idzie z systemu na papier
Kod QR na każdym dokumencie do publicznej weryfikacji
Skan z QR wraca do teczki sam

Etap 5

Automatyzacje i API

Wasz workflow albo nasz.

Webhooki i triggery na zdarzeniach systemu
n8n, Node-RED i inne narzędzia — bez wyrzucania tego, co działa
API REST per moduł dla klientów i partnerów
Edytor procesów bez programisty

Etap 6

Sprzęt i urządzenia

Terminale własnej produkcji i to, co już stoi na obiekcie.

Terminale RCP i zadaniowe — karta, kod, pokrętło, offline
Czujniki i urządzenia po MQTT (temperatury, wejścia)
Tablet dyżurki w przeglądarce, bez instalacji
Aplikacje iOS i Android z jednym logowaniem

Wasze dane są Wasze

Wejście z naszą pomocą, wyjście w każdej chwili

Import bierzemy z tego, co macie — arkusz, eksport, skan. Eksport dostajecie zawsze, także po zakończeniu umowy: w formacie archiwum z manifestem i sumami kontrolnymi, z protokołem usunięcia, jeśli tego chcecie. Bez szantażu danymi.

Import z arkuszy, eksportów innych systemów i skanów — pomagamy przygotować dane do wczytania
Eksport danych w każdej chwili, także po zakończeniu umowy — w formacie archiwum, z manifestem
Logowanie firmowe (SSO) i sesje unieważniane centralnie
Relacje między firmami z sześcioma poziomami dostępu zamiast maili z załącznikami
Dziennik każdej zmiany rekordu: kto, co, kiedy, z jakiej wartości na jaką

Granice

Co zostaje u Was, a co jest u nas

Granice budują wiarygodność. Mówimy je głośno, zanim zapyta o nie Wasz IT.

	Zostaje u Was	HRmoniq
Naliczenia wynagrodzeń i PIT	Wasz program płacowy	wysyłamy składniki, odbieramy paski
Dokumentacja medyczna pacjentów, NFZ, P1	Wasz system gabinetowy	nie dziś — mówimy to na stronie
Podpis kwalifikowany (mSzafir i podobne)	zewnętrzny dostawca	planowany na Q1 2027 — dziś umowę o pracę drukujesz z systemu
Księga HACCP, analiza zagrożeń	Wasz technolog / audytor	pomiary, dowody, eskalacje, rejestry
Automatyzacje w n8n / Node-RED	Wasze narzędzie	trigger i webhook z naszej strony
Wszystko pomiędzy: ludzie, umowy, grafiki, godziny, zadania, rozliczenia	—	to jest HRmoniq

Dla partnerów i IT

Trzy drogi do integracji

Partnerzy: biura rachunkowe i dostawcy płac

Prowadzicie płace dla naszych klientów? Dostajecie gotowe wejścia w układzie Waszego programu i odsyłacie paski. Napiszcie — ustawimy wymianę raz, dla wszystkich wspólnych klientów.

Integracja własna przez API

Dokumentację API i klucze udostępniamy klientom i partnerom po podpisaniu umowy — z osobnym dostępem per moduł i dziennikiem wywołań.

Bezpieczeństwo wymiany

Każda integracja przechodzi przez te same uprawnienia per rola i moduł, co użytkownik. Dane w UE, szyfrowanie w transmisji i w spoczynku.

Pytania IT

O integracjach

Mamy nietypowy program płacowy. Czy da się go podłączyć?

Wymiana z płacami to plik lub API w układzie, którego program oczekuje. Dla enova365 i Optimy mamy gotowe układy; dla innych ustawiamy je przy wdrożeniu — składniki, godziny i potrącenia są u nas danymi, więc format wyjścia to konfiguracja, nie projekt.

Czy udostępniacie publiczną dokumentację API?

Dokumentację i klucze dostają klienci i partnerzy po podpisaniu umowy, nie jest publiczna. API jest podzielone per moduł, każde wywołanie ma dziennik, a uprawnienia są takie same jak dla użytkownika z daną rolą.

Jak działają webhooki przy awarii po naszej stronie i jakie są limity API?

Webhook, który nie dostał potwierdzenia, jest ponawiany z narastającym odstępem, a nieudane dostarczenia widać w dzienniku z możliwością ręcznego powtórzenia. Limity zapytań są per klucz i per moduł, podane w dokumentacji przy wydaniu klucza; dziennik wywołań eksportujecie razem z resztą dziennika audytu.

Kto ma rację, gdy stawkę zmieni ktoś w programie płacowym i ktoś u nas?

Źródłem prawdy dla godzin, składników i potrąceń jest HRmoniq, dla naliczenia i podatków — program płacowy. Wymiana idzie w jedną stronę per rodzaj danych, więc konflikt nie powstaje; gdy program płacowy przyjmie inną wartość, rozjazd widać w raporcie zgodności przed zamknięciem miesiąca.

Mamy własne terminale RCP innej firmy. Wyrzucać?

Nie musicie. Odbicia z obcych czytników przyjmujemy plikiem albo przez API do tej samej ewidencji; własne terminale HRmoniq dokładacie tam, gdzie potrzebujecie zadań przy urządzeniu, pracy offline albo terminala per agencja.