← Wiedza

Integracja z IRZplus — wszystkie możliwości Lecznicy Terenowej

Lecznica Terenowa łączy się z systemem ARiMR w dwóch kierunkach: pobiera aktualne stado z IRZplus i wysyła zgłoszenia IRZ do ARiMR w imieniu hodowcy. Ten artykuł opisuje obie ścieżki od konfiguracji po codzienne użytkowanie.

Dwie niezależne możliwości
  • Synchronizacja stada — pobranie aktualnej listy zwierząt z IRZplus do programu. Działa przez plik CSV (bez konfiguracji) albo przez API (jeden klik po skonfigurowaniu konta pracownika).
  • Automatyczne zgłoszenia IRZ — wysyłka ZP, ZR, ZUR, ZTUKU i ZZO do ARiMR bez logowania się do portalu. Wymaga konta pracownika w IRZplus.

Konfiguracja konta pracownika jest wspólna dla obu funkcji — jednorazowa na każdego hodowcę.

Synchronizacja stada z IRZplus

Droga 1 — plik CSV (bez konfiguracji)

Nie wymaga żadnej konfiguracji po stronie programu — działa od razu dla każdego hodowcy.

  1. Pobierz plik CSV z IRZplus. Hodowca loguje się do systemu IRZplus (irz.arimr.gov.pl) i eksportuje listę zwierząt. Możesz to zrobić też w jego imieniu, jeśli masz dostęp do jego konta.
  2. Wgraj plik do programu. W Lecznicy Terenowej wejdź do Importy stada i wybierz hodowcę. Program rozpoznaje go po numerze siedziby stada z pliku CSV.
  3. Przejrzyj i zatwierdź zmiany. Program porównuje plik ze stanem stada w bazie i pokazuje nowe zwierzęta, ubytki i zmiany danych. Zatwierdzasz tylko to, co chcesz przyjąć. Import można cofnąć — program ostrzeże, jeśli dla danego zwierzęcia są już wpisy w książce leczenia.

Droga 2 — API IRZplus (jedno kliknięcie)

Po jednorazowej konfiguracji konta pracownika synchronizację stada uruchamiasz jednym kliknięciem bez wychodzenia z programu i bez logowania się do portalu IRZplus. Wyniki trafiają do standardowego porównania — identycznego jak przy imporcie CSV.

Na stronie hodowcy w panelu IRZplus kliknij Synchronizuj stado IRZplus. Program pobierze listę zwierząt z ARiMR i przekieruje Cię do widoku różnic.

Automatyczne zgłoszenia IRZ

Po skonfigurowaniu konta pracownika każde zdarzenie, które wpisujesz dla hodowcy, automatycznie trafia do kolejki zgłoszeń IRZ. Program sam dobiera typ dokumentu:

Zdarzenie w programie Typ dokumentu IRZ
Przybycie zwierzęcia ZP — Zgłoszenie Przybycia
Ubytek — sprzedaż lub przemieszczenie ZR — Zgłoszenie Ubytku
Ubytek — śmierć lub padnięcie na fermie ZUR — Zgłoszenie Ubytku Rzeczywistego
Ubój ZTUKU — Zgłoszenie Tuszki
Zmiana kolczyka (oznakowania) ZZO — Zgłoszenie Zmiany Oznakowania

Zdarzenia weterynaryjne (badania, zabiegi, leczenie) nie tworzą zgłoszeń IRZ.

Zgłoszenia trafiają do kolejki — nie są wysyłane automatycznie, dopóki nie klikniesz wysyłki. To celowe: masz chwilę, żeby sprawdzić dane przed przekazaniem do ARiMR. W panelu zgłoszeń IRZ dla danego hodowcy zobaczysz trzy zakładki:

  • Oczekujące — gotowe do wysłania. Wyślij każde osobno albo wszystkie jednym kliknięciem.
  • Błędy — coś poszło nie tak; widoczny komunikat z API ARiMR. Wyślij ponownie po poprawieniu przyczyny.
  • Wysłane — przekazane do ARiMR z numerem dokumentu zwrotnego. Ostatnie 20.

Cofanie błędnych zgłoszeń

Zdarzenie wpisane przez pomyłkę możesz obsłużyć w zależności od tego, czy zgłoszenie było już wysłane do ARiMR:

Zgłoszenie oczekujące (nie wysłane)

Kliknij Anuluj IRZ przy zdarzeniu w zakładce Oczekujące. Wpis w książce leczenia zostaje, z kolei zgłoszenie IRZ zostaje usunięte z kolejki. Możesz je potem wysłać ponownie lub pozostawić bez zgłoszenia.

Zgłoszenie wysłane (trafiło do ARiMR)

W zakładce Wysłane kliknij Cofnij zgłoszenie IRZ. Program wyśle do ARiMR żądanie usunięcia dokumentu przez API IRZplus, a zdarzenie wróci do stanu bez zgłoszenia IRZ. Możesz wówczas wysłać je ponownie z poprawionymi danymi lub anulować.

Przycisk jest widoczny wyłącznie dla zdarzeń z numerem dokumentu zwrotnego z ARiMR i tylko gdy konto pracownika jest skonfigurowane. Bez tego nie ma technicznej możliwości cofnięcia dokumentu przez API — hodowca musi wtedy usunąć go ręcznie w portalu irz.arimr.gov.pl.

Konfiguracja — konto pracownika IRZplus

Zarówno automatyczne zgłoszenia, jak i synchronizacja stada przez API wymagają jednorazowego skonfigurowania konta pracownika. Robimy to raz na każdego hodowcę:

  1. Hodowca zakłada konto pracownika dla Twojej lecznicy w portalu IRZplus: Moje konto → Pracownicy → Dodaj pracownika. Podaje imię, nazwisko i e-mail pracownika, a następnie przekazuje Ci dane logowania do tego konta.
  2. W programie otwórz stronę hodowcy i kliknij Połącz z IRZplus w panelu IRZplus (widoczny dla kierowników lecznicy i lekarzy).
  3. Wpisz login i hasło konta pracownika w polach Login do IRZplus (konto pracownika) i Hasło, a następnie kliknij Zweryfikuj i zapisz. Program sprawdzi połączenie od razu — zobaczysz potwierdzenie albo komunikat o błędzie.

Dane logowania są przechowywane w formie zaszyfrowanej i służą wyłącznie do komunikacji z IRZplus dla tego hodowcy. Hodowca może w dowolnej chwili usunąć konto pracownika w swoim portalu IRZplus — od tej chwili wysyłka ze strony lecznicy przestaje działać.

Kto ma dostęp do panelu IRZplus?

Panel IRZplus na stronie hodowcy jest widoczny dla lekarzy weterynarii i kierowników lecznicy. Poniżej co może każda rola:

Czynność Kierownik Lekarz weterynarii
Podgląd zgłoszeń IRZ tak tak
Wysyłanie zgłoszeń, cofanie tak tak
Konfiguracja konta pracownika tak tak
Synchronizacja stada przez API tak tak
Uwaga

Integracja z IRZplus działa dla bydła, owiec, kóz, świń i koniowatych — gatunków rejestrowanych w systemie ARiMR. Automatyczne zgłoszenia zależą od poprawnego zakwalifikowania gatunku w programie. Przy wątpliwościach co do schematu API ARiMR (np. przy zmianach specyfikacji IRZplus) skontaktuj się z nami — zaktualizujemy integrację niezwłocznie.

Najczęstsze pytania

Czym różni się synchronizacja CSV od synchronizacji przez API IRZplus?

Przy CSV hodowca ręcznie pobiera plik z portalu i wgrywa do programu — nie wymaga konfiguracji, ale co kilka tygodni trzeba to robić ręcznie. Przy API program łączy się z IRZplus bezpośrednio — wystarczy jedno kliknięcie. Obie metody dają ten sam wynik: aktualną listę zwierząt z porównaniem zmian.

Czy zgłoszenia są wysyłane do ARiMR od razu po wpisaniu zdarzenia?

Nie. Zdarzenie trafia do kolejki oczekujących zgłoszeń. Wysyłasz je ręcznie — albo każde osobno, albo wszystkie jednym kliknięciem. To celowe: masz chwilę na weryfikację przed przekazaniem do ARiMR.

Co się dzieje, gdy zgłoszenie IRZ zostało wysłane przez pomyłkę?

W zakładce Wysłane kliknij Cofnij zgłoszenie IRZ. Program wyśle do ARiMR żądanie usunięcia dokumentu przez API, a zdarzenie wróci do stanu bez zgłoszenia. Możesz je ponownie wysłać z poprawionymi danymi lub na stałe anulować.

Czy konto pracownika daje dostęp do innych danych hodowcy w IRZplus?

Nie. Konto pracownika daje wyłącznie dostęp do rejestracji zdarzeń i pobierania listy stada dla tego konkretnego hodowcy. Hodowca może je w każdej chwili usunąć ze swojego konta IRZplus, co natychmiast blokuje wysyłkę ze strony lecznicy.

Powiązane artykuły

IRZplus 2026 i WNI — co zmieniła ustawa o zdrowiu zwierząt

Nowy WNI dla hodowców, termin 18 czerwca, wyłącznie cyfrowa rejestracja od 2026 r.

Import stada z IRZplus w 2 minuty

Jak pobrać plik CSV z IRZplus i wgrać do Lecznicy Terenowej — krok po kroku.

e-KLZ — elektroniczna książka leczenia zwierząt

Dane ze stada z IRZplus trafiają prosto do książki leczenia.

Chcesz skonfigurować integrację z IRZplus?

Napisz do nas — pomożemy skonfigurować konto pracownika i przetestować pierwszą wysyłkę.

[email protected]