ARiMR
API docs by Redocly

IRZplus REST API dla Producenta (PROD) (20260626)

Download OpenAPI specification:

Kontrakt integracyjny REST API systemu IRZplus dla producentów zwierząt i podmiotów z nimi zintegrowanych. Obejmuje wszystkie grupy zwierząt (koniowate, znakowane indywidualnie, świnie, drób), składanie dokumentów, dane zwierząt i zdarzeń, dane działalności oraz pobieranie złożonych dokumentów. Usługi pogrupowano tagami w formacie [grupa zwierząt - ]domena.

Model autoryzacji

Dostęp do API wymaga autoryzacji. Autoryzacja ma charakter globalny i obowiązuje wszystkie endpointy udostępniane w ramach niniejszego API; podlegają jej systemy integrujące się z IRZplus. Token autoryzacyjny przekazywany jest w nagłówku HTTP Authorization: Bearer <token>. Mechanizm autoryzacji jest zdefiniowany technicznie w specyfikacji (securitySchemes) i nie jest opisywany indywidualnie dla poszczególnych usług; szczegóły procesu uzyskania tokenu opisuje dokumentacja zewnętrzna. Brak autoryzacji lub brak wymaganych uprawnień skutkuje odrzuceniem żądania (odpowiednio HTTP 401 i HTTP 403).

Obsługa błędów

API stosuje standardowe kody odpowiedzi HTTP:

  • 200 — operacja zakończona sukcesem,
  • 400 — błąd walidacji danych wejściowych,
  • 401 — brak autoryzacji (brak lub nieważny token JWT),
  • 403 — brak uprawnień do wykonania operacji,
  • 500 — wewnętrzny błąd serwera (oraz pozostałe błędy techniczne z grupy 5xx).

Błędy biznesowe (np. negatywny wynik walidacji danych zgłoszenia czy brak dostępu do danych wskazanego producenta) są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat w treści odpowiedzi. Dla usług wyszukiwania brak wyników spełniających kryteria nie jest traktowany jako błąd — zwracana jest pusta lista z kodem HTTP 200.

Zasady wspólne

  • Daty — format ISO 8601 <RRRR-MM-DD> (np. 2026-05-15).
  • Kodowanie — UTF-8.
  • Słowniki — pola referencyjne odwołują się do słowników systemu IRZplus; wartość słownikowa jest reprezentowana jako obiekt KodOpisWartosciDto (kod + opis).

Dane referencyjne — TERYT

Pola lokalizacyjne (wojewodztwo, powiat, gmina, miejscowosc, ulica) w strukturach adresowych pochodzą z państwowego rejestru TERYT (Krajowy Rejestr Urzędowy Podziału Terytorialnego Kraju prowadzony przez Główny Urząd Statystyczny), a nie ze słowników IRZplus. Kategorie kodów:

  • TERC — województwa (2 cyfry), powiaty (2 cyfry), gminy (kod 2 cyfry + rodzaj gminy 1 cyfra),
  • SIMC — miejscowości (7 cyfr),
  • ULIC — ulice (5 cyfr).

Wartości mają strukturę hierarchiczną (województwo → powiat → gmina → miejscowość → ulica) i są udostępniane przez usługę danych terytorialnych IRZplus. Pole rodzajGminy zawiera typ wpisu TERC (gmina miejska, wiejska, miejsko-wiejska, miasto i obszar wiejski w gminie miejsko-wiejskiej).

Koniowate - dane zwierząt

Usługi udostępniania danych zwierząt koniowatych z aplikacji IRZplus przeznaczone dla posiadaczy i pracowników posiadaczy. Umożliwiają wyszukiwanie listy koniowatych spełniających kryteria oraz pobranie szczegółowych danych pojedynczego konia (po numerze UELN, identyfikatorze lub kodzie transpondera). Zakres: wyłącznie koniowate.

Pobranie listy koniowatych

Zwraca listę zwierząt koniowatych z aplikacji IRZplus spełniających podane kryteria wyszukiwania. Operacja przeznaczona dla posiadaczy oraz pracowników posiadaczy — umożliwia przeglądanie stanu rejestru w zakresie posiadanych zwierząt.

Obsługa błędów biznesowych: błędy walidacji kryteriów oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu (lista zwierząt jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer działalności, w której przebywa wyszukiwane zwierzę

gatunek
string
Example: gatunek=KON

Kod wartości słownikowej – Gatunek (SIA-SL02120)

niepowtarzalnyDozywotniNumer
string
Example: niepowtarzalnyDozywotniNumer=616000000000000

Numer identyfikacyjny rejestrowanego zwierzęcia

plec
string
Example: plec=PKXY

Kod wartości słownikowej – Kod płci zwierzęcia (SIA-SL02121)

numerSrodkaIdentyfikacji
string
Example: numerSrodkaIdentyfikacji=985000000000000

Numer/kod transpondera

nazwaKoniowatego
string
Example: nazwaKoniowatego=BURSZTYN

Imię/Nazwa koniowatego

masc
string
Example: masc=MK081

Kod wartości słownikowej – Kod masci zwierzęcia (SIA-SL02122)

stanDanychNaDzien
string <date>
Example: stanDanychNaDzien=2026-05-29

Stan danych na dzień

idKoniowatego
integer <int64>
Example: idKoniowatego=12345

ID koniowatego

dataModyfikacjiBiznesowejOd
string <date>
Example: dataModyfikacjiBiznesowejOd=2024-01-01

Data modyfikacji biznesowej od

dataModyfikacjiBiznesowejDo
string <date>
Example: dataModyfikacjiBiznesowejDo=2024-12-31

Data modyfikacji biznesowej do

tylkoWykastrowane
boolean
Example: tylkoWykastrowane=false

Tylko wykastrowane

tylkoZeZmianaTranspondera
boolean
Example: tylkoZeZmianaTranspondera=false

Tylko koniowate ze zmianą transpondera

tylkoZWaznaLicencja
boolean
Example: tylkoZWaznaLicencja=true

Tylko koniowate z ważną licencją

dataWylaczeniaZLancucha
string <date>
Example: dataWylaczeniaZLancucha=2024-06-01

Data wyłączenia z łańcucha

wylaczenieZLancuchaNaDate
boolean
Example: wylaczenieZLancuchaNaDate=false

Wyłączenie z łańcucha na datę

nrEPWlasciciela
string
Example: nrEPWlasciciela=000000000

Numer Ewidencji Producentów właściciela koniowatych

nrWlasciciela
string
Example: nrWlasciciela=0000000

Numer właściciela koniowatego (7 cyfr)

Responses

Response samples

Content type
application/json
{
  • "komunikat": "OK",
  • "listaZwierzeta": [
    ]
}

Pobranie danych pojedynczego konia

Zwraca podstawowe dane jednoznacznie zidentyfikowanego zwierzęcia koniowatego. Konia można wskazać po niepowtarzalnym dożywotnim numerze UELN, identyfikatorze koniowatego lub numerze kodu transpondera — należy podać co najmniej jeden z tych parametrów, a podane kryteria muszą jednoznacznie wskazywać jedno zwierzę. Operacja przeznaczona dla posiadaczy oraz pracowników posiadaczy.

Obsługa błędów biznesowych: brak parametru, brak zwierzęcia o podanym identyfikatorze lub niejednoznaczny wynik wyszukiwania są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
query Parameters
niepowtarzalnyDozywotniNumerUeln
string
Example: niepowtarzalnyDozywotniNumerUeln=616000000000000

Niepowtarzalny dożywotni numer UELN koniowatego

idKoniowatego
integer <int64>
Example: idKoniowatego=12345

Identyfikator koniowatego nadawany przed przydzieleniem numeru UELN

numerKodTranspondera
string
Example: numerKodTranspondera=985000000000000

Indywidualny numer/kod transpondera (chipa) koniowatego

Responses

Response samples

Content type
application/json
{
  • "komunikat": "OK",
  • "idKoniowatego": "12345",
  • "niepowtarzalnyDozywotniNumerUeln": "616000000000000",
  • "gatunek": {
    },
  • "dataUrodzenia": "2020-05-15",
  • "plec": {
    },
  • "rasa": {
    },
  • "masc": {
    },
  • "dataWyrejestrowania": "2026-05-15",
  • "masaCialaZwierzecia": 520.5,
  • "masaTuszy": 280,
  • "numerDzialalnosci": "000000000-001",
  • "numerKodTranspondera": "985000000000000",
  • "podaneLekiWylaczenieKoniowategoZLancuchaZywnosciowego": "NIE",
  • "imieNazwaKoniowatego": "BURSZTYN"
}

Koniowate - dokumenty

Usługi składania dokumentów (zgłoszeń) dla zwierząt koniowatych w aplikacji IRZplus przeznaczone dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy. Obejmują składanie poszczególnych typów dokumentów koniowatych (ZRKON, ZPKON, OZWKON, WWTKON, IWLZKON, WNZNKON, WDDIKON, ZPZUKON, ZURKON, ZUZKON) oraz pobieranie złożonych dokumentów. Zakres: wyłącznie dokumenty koniowatych.

Złożenie dokumentu ZUZKON (zgłoszenie unieszkodliwienia zwłok koniowatego)

Składa dokument ZUZKON — zgłoszenie unieszkodliwienia zwłok zwierzęcia koniowatego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZUZKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZURKON (zgłoszenie uboju koniowatego w rzeźni)

Składa dokument ZURKON — zgłoszenie uboju zwierzęcia koniowatego w rzeźni. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZURKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZRKON (zgłoszenie koniowatego do rejestru)

Składa dokument ZRKON — zgłoszenie zwierzęcia koniowatego do aplikacji IRZplus. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy. Zgłoszenie może zawierać załącznik z umową z właścicielem koniowatego. Dokument może zawierać maksymalnie jedną pozycję — przekroczenie limitu skutkuje błędem biznesowym.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
object (DyspozycjaZRKON)

Struktura danych: DyspozycjaZRKON.

umowaZWlascicielemKoniowatego
string <binary>

Responses

Request samples

Content type
application/json
{
  • "dyspozycja": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZPZUKON (zgłoszenie padnięcia/zabicia/uboju koniowatego)

Składa dokument ZPZUKON — zgłoszenie padnięcia, zabicia lub uboju zwierzęcia koniowatego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZPZUKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZPKON (zgłoszenie przemieszczenia koniowatego)

Składa dokument ZPKON — zgłoszenie przemieszczenia zwierzęcia koniowatego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy. Zgłoszenie rejestruje przybycie lub wybycie koniowatego z działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZPKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu WWTKON (informacja o zmianie środka identyfikacji)

Składa dokument WWTKON — informację o usunięciu, modyfikacji lub zastąpieniu środka identyfikacji koniowatego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (WniosekWWTKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu WNZNKON (wniosek o nadanie/zmianę nazwy koniowatego)

Składa dokument WNZNKON — wniosek o nadanie lub zmianę nazwy zwierzęcia koniowatego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (WniosekWNZNKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu WDDIKON (wniosek o duplikat/nowy dokument identyfikacyjny)

Składa dokument WDDIKON — wniosek o wydanie duplikatu, dokumentu zastępczego lub nowego unikalnego dożywotniego dokumentu identyfikacyjnego koniowatego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (WniosekWDDIKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu OZWKON (zgłoszenie zmiany właściciela koniowatego)

Składa dokument OZWKON — zgłoszenie zmiany właściciela zwierzęcia koniowatego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (OswiadczenieOZWKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu IWLZKON (wyłączenie z łańcucha żywnościowego)

Składa dokument IWLZKON — informację o wyłączeniu koniowatego z łańcucha żywnościowego. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieIWLZKONDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Pobranie złożonego dokumentu koniowatego

Zwraca szczegóły wcześniej złożonego dokumentu koniowatego na podstawie numeru producenta oraz numeru dokumentu. Operacja przeznaczona dla posiadaczy, właścicieli koniowatych oraz pracowników posiadaczy — umożliwia podgląd statusu i zawartości złożonego zgłoszenia/wniosku.

Obsługa błędów biznesowych: brak dokumentu o podanym numerze oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu odpowiedzi.

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer producenta, w kontekście którego odbywa się pobranie danych

numerDokumentu
string
Example: numerDokumentu=20260629/000000000

Numer dokumentu

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Dokument pobrany pomyślnie",
  • "numerDokumentu": "20260629/000000000",
  • "szczegoly": {
    },
  • "blad": [
    ]
}

Koniowate - zdarzenia

Usługi udostępniania danych o zdarzeniach zwierząt koniowatych z aplikacji IRZplus przeznaczone dla posiadaczy i pracowników posiadaczy. Umożliwiają wyszukiwanie i przeglądanie zdarzeń wraz ze szczegółami poszczególnych typów dokumentów (ZPKON, ZPZUKON, ZRKON, ZURKON, ZUZKON, ZAKON, ZZEIKON) oraz błędami walidacji. Dostęp ograniczony do działalności/producenta uprawnionego użytkownika.

Pobranie listy zdarzeń koniowatych

Zwraca listę zdarzeń zwierząt koniowatych z aplikacji IRZplus spełniających podane kryteria wyszukiwania (numer działalności lub numer producenta). Operacja przeznaczona dla posiadaczy oraz pracowników posiadaczy. Dostęp do danych jest weryfikowany: użytkownik musi posiadać uprawnienie do wskazanej działalności lub producenta; należy podać co najmniej jedno z tych kryteriów.

Obsługa błędów biznesowych: brak dostępu, brak kryteriów oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikatu (lista zdarzeń jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer działalności, której dotyczą wyszukiwane zdarzenia

niepowtarzalnyDozywotniNumerUeln
string
Example: niepowtarzalnyDozywotniNumerUeln=616000000000000

Niepowtarzalny dożywotni numer UELN koniowatego, którego mają dotyczyć zdarzenia

typZdarzenia
string
Example: typZdarzenia=ZRKONPR

Kod wartości słownikowej – Typ zdarzenia (SIA-SL02119)

stanZdarzenia
string
Example: stanZdarzenia=SZPA

Kod wartości słownikowej – Stan zdarzenia (SIA-SL02194)

dataZdarzeniaOd
string <date>
Example: dataZdarzeniaOd=2026-05-15

Data zdarzenia od

dataZdarzeniaDo
string <date>
Example: dataZdarzeniaDo=2026-05-29

Data zdarzenia do

Responses

Response samples

Content type
application/json
{
  • "komunikat": "OK",
  • "listaZdarzenie": [
    ]
}

Zwierzęta indywidualne - dokumenty

Usługi API produkcyjnego umożliwiające posiadaczom zwierząt (oraz pracownikom posiadacza) składanie dokumentów zgłoszeniowych dotyczących zwierząt znakowanych indywidualnie (m.in. przybycie, wybycie, ubój, padnięcie, zmiana danych, oznakowanie) oraz pobieranie złożonych dokumentów. Każdy typ zgłoszenia odpowiada konkretnemu dokumentowi w aplikacji IRZplus. Zakres: zwierzęta znakowane indywidualnie; nie obejmuje zwierząt znakowanych grupowo ani koniowatych.

Złożenie dokumentu ZZO (zgłoszenie zmiany oznakowania)

Rejestruje dokument zgłoszenia zmiany oznakowania zwierzęcia znakowanego indywidualnie (ZZO) — np. zmiany numeru identyfikacyjnego lub lokalizacji środka identyfikacji. Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZZODTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZW (zgłoszenie wwozu)

Dokument służy do rejestracji w aplikacji IRZplus zwierzęcia znakowanego indywidualnie, przywiezionego z zagranicy — z państwa UE albo z państwa niebędącego członkiem UE (ZW). Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZWDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZUZ (zgłoszenie unieszkodliwienia zwłok)

Dokument służy do zgłoszenia do aplikacji IRZplus unieszkodliwienia zwłok zwierzęcia znakowanego indywidualnie przez zakład przetwórczy lub spalarnię (ZUZ). W zgłoszeniu wskazuje się numer działalności zakładu przetwórczego lub spalarni, do której kierowane są zwłoki. Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Każde zwierzę stanowi odrębną pozycję dokumentu. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZUZDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZUR (zgłoszenie uboju w rzeźni)

Dokument służy do zgłoszenia do aplikacji IRZplus uboju w rzeźni zwierzęcia znakowanego indywidualnie (ZUR). Zgłoszenia dokonuje wyłącznie działalność o typie rzeźnia, w której nastąpił ubój. Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZURDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZTUKU (zgłoszenie typu użytkowego i kierunku użytkowania)

Dokument służy do zgłoszenia do aplikacji IRZplus typu użytkowego oraz kierunku użytkowania zwierzęcia znakowanego indywidualnie, a także daty określenia tych danych (ZTUKU). Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZTUKUDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZU (zgłoszenie urodzenia, dokument ZR)

Dokument służy do zgłoszenia do aplikacji IRZplus oznakowania urodzonego zwierzęcia znakowanego indywidualnie — nadania mu indywidualnego numeru identyfikacyjnego — i skutkuje utworzeniem dokumentu zgłoszenia urodzenia (ZR). Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZRDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZPZU (zgłoszenie padnięcia, zabicia, uboju)

Dokument służy do zgłoszenia do aplikacji IRZplus padnięcia, zabicia lub uboju w gospodarstwie (nie w rzeźni) zwierzęcia znakowanego indywidualnie (ZPZU). Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Należy pamiętać, że ubój w rzeźni zgłasza rzeźnia odrębnym dokumentem, a nie posiadacz zwierzęcia. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZPZUDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZP (zgłoszenie przemieszczenia)

Dokument służy do zgłoszenia do aplikacji IRZplus przemieszczenia zwierzęcia znakowanego indywidualnie (ZP). Obejmuje przybycie i wybycie zwierzęcia między działalnościami zarejestrowanymi w IRZ oraz przemieszczenie do lub z państwa UE bądź państwa niebędącego członkiem UE. Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy, który podlega regułom walidacji biznesowej i dalszemu przetwarzaniu w aplikacji IRZplus. Należy pamiętać, że przemieszczenie zwierzęcia do rzeźni zgłasza posiadacz tym dokumentem, natomiast sam ubój w rzeźni zgłasza rzeźnia odrębnym dokumentem uboju. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZPDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZAEI (zgłoszenie aplikacji elektronicznego identyfikatora)

Dokument służy do zgłoszenia do aplikacji IRZplus aplikacji (zaaplikowania) zwierzęciu znakowanemu indywidualnie elektronicznego środka identyfikacji wraz z datą jego aplikacji (ZAEI). Na podstawie zgłoszenia tworzony jest dokument zgłoszeniowy podlegający walidacji biznesowej i przetwarzaniu w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: błędy walidacji i inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a ich opis znajduje się w polach odpowiedzi (komunikat/lista błędów).

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZAEIDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Pobranie złożonego dokumentu zgłoszeniowego

Zwraca szczegóły wcześniej złożonego dokumentu zgłoszeniowego na podstawie numeru producenta oraz numeru dokumentu. Umożliwia posiadaczowi zwierząt (oraz jego pracownikowi) sprawdzenie zarejestrowanego zgłoszenia. Dostęp ograniczony do dokumentów powiązanych z danymi podmiotu wywołującego.

Obsługa błędów biznesowych: brak dokumentu o podanych parametrach oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat.

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer producenta, w kontekście którego odbywa się pobranie danych

numerDokumentu
string
Example: numerDokumentu=20260629/000000000

Numer dokumentu

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Dokument pobrany pomyślnie",
  • "numerDokumentu": "20260629/000000000",
  • "szczegoly": {
    },
  • "blad": [
    ]
}

Zwierzęta indywidualne - dane zwierząt

Usługi API produkcyjnego do pobierania danych zwierząt znakowanych indywidualnie z aplikacji IRZplus. Umożliwiają posiadaczom zwierząt oraz ich pracownikom wyszukiwanie listy zwierząt, pobranie szczegółowych danych pojedynczego zwierzęcia oraz historii jego przemieszczeń. Dostęp ograniczony kontrolą uprawnień po działalności i po posiadaczu. Zakres: wyłącznie zwierzęta znakowane indywidualnie.

Pobranie listy zwierząt indywidualnych

Zwraca listę zwierząt znakowanych indywidualnie spełniających podane kryteria wyszukiwania. Wymagane jest podanie numeru działalności lub numeru producenta — usługa zwraca dane wyłącznie dla podmiotów, do których wywołujący posiada dostęp (kontrola dostępu po działalności i po posiadaczu). Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: brak dostępu do danych, brak wymaganych kryteriów oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (lista zwierząt jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer producenta

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer działalności

gatunek
string
Example: gatunek=SW

Kod wartości słownikowej – Gatunek (SIA-SL02111)

numerIdentyfikacyjnyRejestrowanegoZwierzecia
string
Example: numerIdentyfikacyjnyRejestrowanegoZwierzecia=PL000000000000

Numer identyfikacyjny rejestrowanego zwierzęcia

plec
string
Example: plec=XX

Kod wartości słownikowej - Kod płci zwierzęcia (SIA-SL02131)

kodRasy
string
Example: kodRasy=RETU

Kod wartości słownikowej - Kod rasy zwierzęcia; słownik zależny od gatunku: bydło (SIA-SL02279), owce (SIA-SL02280), kozy (SIA-SL02281), jeleniowate (SIA-SL02166), wielbłądowate (SIA-SL02167)

typUzytkowy
string
Example: typUzytkowy=ML

Kod wartości słownikowej - Kod typu użytkowego (SIA-SL02135)

stanDanych
string <date>
Example: stanDanych=2026-05-15

Stan na dzień

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Brak dostępu do danych",
  • "listaZwierzeta": [
    ]
}

Pobranie danych pojedynczego zwierzęcia indywidualnego

Zwraca szczegółowe dane zwierzęcia znakowanego indywidualnie na podstawie jego numeru identyfikacyjnego. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: brak zwierzęcia o podanym identyfikatorze oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat.

Authorizations:
bearerAuth
query Parameters
numerIdentyfikacyjnyZwierzecia
string
Example: numerIdentyfikacyjnyZwierzecia=PL000000000000

Numer identyfikacyjny zwierzęcia

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Brak zwierzęcia o podanym identyfikatorze",
  • "numerIdentyfikacyjnyZwierzecia": "PL000000000000",
  • "gatunek": {
    },
  • "dataUrodzenia": "2026-05-15",
  • "plec": {
    },
  • "kodRasy": {
    },
  • "czyMatka": false,
  • "dataWyrejestrowania": "2026-05-15",
  • "masaCialaZwierzecia": 120.5,
  • "masaTuszy": 65.3,
  • "numerDzialalnosci": "000000000-001",
  • "sposobOznakowania": "ZK",
  • "informacjaOOswiadczeniuDDS": "TAK"
}

Pobranie historii przemieszczeń zwierzęcia indywidualnego

Zwraca historię przemieszczeń (przybyć i wybyć między działalnościami) zwierzęcia znakowanego indywidualnie na podstawie jego numeru identyfikacyjnego. Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: brak zwierzęcia o podanym identyfikatorze oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat.

Authorizations:
bearerAuth
query Parameters
numerIdentyfikacyjnyZwierzecia
string
Example: numerIdentyfikacyjnyZwierzecia=PL000000000000

Numer identyfikacyjny zwierzęcia

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Brak zwierzęcia o podanym identyfikatorze",
  • "numerIdentyfikacyjnyZwierzecia": "PL000000000000",
  • "gatunek": {
    },
  • "dataUrodzenia": "2026-05-15",
  • "wojewodztwo": {
    },
  • "powiat": {
    },
  • "plec": {
    },
  • "kodRasy": {
    },
  • "dataWyrejestrowania": "2026-05-15",
  • "masaCialaZwierzecia": 120.5,
  • "masaTuszy": 65.3,
  • "przemieszczenia": [
    ]
}

Zwierzęta indywidualne - zdarzenia

Usługi API produkcyjnego do pobierania zdarzeń (zgłoszeń) dotyczących zwierząt znakowanych indywidualnie zarejestrowanych w IRZplus. Pozwalają posiadaczom zwierząt oraz ich pracownikom przeglądać zdarzenia powiązane z ich działalnością lub numerem producenta (m.in. przybycie, wybycie, ubój, rejestracja, zmiana danych). Zakres: wyłącznie zwierzęta znakowane indywidualnie.

Pobranie listy zdarzeń zwierząt indywidualnych

Zwraca listę zdarzeń (zgłoszeń) dotyczących zwierząt znakowanych indywidualnie, spełniających podane kryteria wyszukiwania. Wymagane jest podanie numeru działalności lub numeru producenta — usługa zwraca dane wyłącznie dla podmiotów, do których wywołujący posiada dostęp (kontrola dostępu po działalności i po posiadaczu). Operacja przeznaczona dla posiadaczy zwierząt oraz ich pracowników.

Obsługa błędów biznesowych: brak dostępu do danych, brak wymaganych kryteriów oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (lista zdarzeń jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer producenta

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer działalności

numerIdentyfikacyjnyRejestrowanegoZwierzecia
string
Example: numerIdentyfikacyjnyRejestrowanegoZwierzecia=PL000000000000

Numer identyfikacyjny rejestrowanego zwierzęcia

gatunek
string
Example: gatunek=SW

Kod wartości słownikowej – Gatunek (SIA-SL02111)

typZdarzenia
string
Example: typZdarzenia=ZRPR

Kod wartości słownikowej - Typ zdarzenia (SIA-SL02136)

stanZdarzenia
string
Example: stanZdarzenia=SZPA

Kod wartości słownikowej - Stan zdarzenia (SIA-SL02194)

dataZdarzeniaOd
string <date>
Example: dataZdarzeniaOd=2026-05-15

Data zdarzenia od

dataZdarzeniaDo
string <date>
Example: dataZdarzeniaDo=2026-05-15

Data zdarzenia do

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Pobrano 1 zdarzeń",
  • "listaZdarzenie": [
    ]
}

Świnie - zdarzenia

Produkcyjne usługi udostępniające zdarzenia (zgłoszenia) zwierząt grupowych (świń) z aplikacji IRZplus. Pozwalają posiadaczom zwierząt oraz pracownikom posiadacza pobierać historię zdarzeń (oznakowanie, przemieszczenie, ubój, padnięcie, spis stanu stada i in.) wraz ze szczegółami danego typu zdarzenia oraz informacją o błędach walidacji. Zakres ograniczony do działalności dostępnych dla zalogowanego podmiotu.

Pobranie listy zdarzeń świń

Zwraca listę zdarzeń (zgłoszeń) zwierząt grupowych (świń) z aplikacji IRZplus spełniających podane kryteria wyszukiwania (m.in. numer producenta lub numer działalności). Dla każdego zdarzenia zwracane są szczegóły właściwe dla jego typu oraz lista ewentualnych błędów walidacji. Operacja przeznaczona dla posiadaczy zwierząt i pracowników posiadacza — zwracane są wyłącznie zdarzenia działalności, do których zalogowany podmiot ma dostęp. Wymagane jest podanie numeru producenta lub numeru działalności.

Obsługa błędów biznesowych: brak dostępu, brak kryteriów oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (lista zdarzeń jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR; ogranicza wynik do zdarzeń działalności tego posiadacza. Wymagany, jeśli nie podano numeru działalności.

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer działalności; ogranicza wynik do zdarzeń tej działalności. Wymagany, jeśli nie podano numeru producenta.

indywidualnyNumerIdentyfikacyjnyLochy
string
Example: indywidualnyNumerIdentyfikacyjnyLochy=PL000000000

Indywidualny numer identyfikacyjny lochy; ogranicza wynik do wskazanej lochy.

typZdarzenia
string
Example: typZdarzenia=ZOUSUR

Typ zdarzenia, do którego zawężany jest wynik (kod wartości słownikowej Typ zdarzenia, SIA-SL02269).

stanZdarzenia
string
Example: stanZdarzenia=SZPA

Stan zdarzenia, do którego zawężany jest wynik (kod wartości słownikowej Stan zdarzenia, SIA-SL02194).

dataZdarzeniaOd
string <date>
Example: dataZdarzeniaOd=2026-05-15

Początek zakresu daty zdarzenia (format RRRR-MM-DD).

dataZdarzeniaDo
string <date>
Example: dataZdarzeniaDo=2026-05-16

Koniec zakresu daty zdarzenia (format RRRR-MM-DD).

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Pobrano zdarzenia poprawnie",
  • "listaZdarzenie": [
    ]
}

Świnie - dokumenty

Produkcyjne usługi do składania dokumentów (zgłoszeń zdarzeń) dotyczących zwierząt grupowych (świń) oraz do pobierania złożonych dokumentów z aplikacji IRZplus. Obejmuje rejestrację zdarzeń takich jak oznakowanie, przybycie, ubój, padnięcie, przemieszczenie i spis stanu stada. Przeznaczone dla posiadaczy zwierząt i pracowników posiadacza działających w zakresie własnych działalności.

Złożenie dokumentu ZZPS

Składa zgłoszenie zamiaru przemieszczenia świń (ZZPS) w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy o planowanym przemieszczeniu zwierząt i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZZPSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZZDOL

Składa zgłoszenie zmiany dodatkowego oznakowania lochy (ZZDOL) w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy korygujący/aktualizujący dodatkowe oznakowanie lochy i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZZDOLDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZUZS

Składa zgłoszenie unieszkodliwienia zwłok świń (ZUZS) w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy o przekazaniu zwłok zwierząt do unieszkodliwienia i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZUZSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZURS

Składa zgłoszenie uboju świń w rzeźni (ZURS) w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy o uboju zwierząt przeprowadzonym w rzeźni i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZURSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZPZUS

Składa zgłoszenie padnięcia, zabicia lub uboju świń (ZPZUS) w działalności w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy o ubytku zwierząt i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZPZUSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZPS

Składa zgłoszenie przemieszczenia świń (ZPS) między działalnościami w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy o przemieszczeniu zwierząt (wybycie/przybycie) i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZPSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZPRS

Składa zgłoszenie przywozu świń (ZPRS) do działalności w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy o przywozie zwierząt spoza kraju i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZPRSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZOUS

Składa zgłoszenie oznakowania urodzonych świń (ZOUS) w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy o oznakowaniu zwierząt urodzonych w działalności i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZOUSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZDOL

Składa zgłoszenie dodatkowego oznakowania lochy (ZDOL) w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy dla wskazanej działalności i loch, a następnie uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZDOLDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu SSSS

Składa spis stanu stada świń (SSSS) w aplikacji IRZplus. Operacja rejestruje dokument zgłoszeniowy z liczebnością stada na dany dzień i uruchamia jego przetwarzanie biznesowe. Przeznaczona dla posiadaczy zwierząt i pracowników posiadacza w zakresie własnych działalności.

Obsługa błędów biznesowych: błędy walidacji zgłoszenia są zwracane z kodem HTTP 200, a ich opis znajduje się w polach komunikat/bledy odpowiedzi.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieSSSSDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Pobranie złożonego dokumentu

Zwraca szczegóły wcześniej złożonego dokumentu dla wskazanego numeru producenta i numeru dokumentu w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy zwierząt i pracowników posiadacza i zwraca wyłącznie dokumenty w zakresie dostępnym dla zalogowanego podmiotu.

Obsługa błędów biznesowych: błędy (np. brak dokumentu, brak dostępu) są zwracane z kodem HTTP 200, a ich opis znajduje się w polu komunikat odpowiedzi (szczegóły dokumentu są wówczas puste).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer producenta, w kontekście którego odbywa się pobranie danych

numerDokumentu
string
Example: numerDokumentu=20260629/000000000

Numer dokumentu

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Dokument pobrany pomyślnie",
  • "numerDokumentu": "20260629/000000000",
  • "szczegoly": {
    },
  • "blad": [
    ]
}

Świnie - dane zwierząt

Produkcyjne usługi udostępniające dane zwierząt grupowych (świń) z aplikacji IRZplus. Pozwalają posiadaczom zwierząt oraz ich pełnomocnikom pobierać dane świń, dane loch wraz z historią zmian oznakowania i rejestrem przebywania lochy, a także zgody na przemieszczenie. Zakres: wyłącznie zwierzęta grupowe (świnie) dla zalogowanego posiadacza/działalności.

Pobranie zgód na przemieszczenie

Zwraca listę zgód na przemieszczenie zwierząt grupowych (świń) z aplikacji IRZplus spełniających podane kryteria wyszukiwania. Operacja przeznaczona dla posiadaczy zwierząt i pracowników posiadacza; zwraca wyłącznie zgody w zakresie dostępnym dla zalogowanego podmiotu.

Obsługa błędów biznesowych: błędy walidacji kryteriów oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (lista zgód jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
doDzialalnosci
string
Example: doDzialalnosci=000000000-001

Numer działalności (siedziby stada lub rzeźni), do której planowane jest przemieszczenie świń.

posrednikDzialalnosc
string
Example: posrednikDzialalnosc=000000000-001

Numer działalności pośrednika w przemieszczeniu świń.

numerIdentyfikacyjnyZwierzecia
string
Example: numerIdentyfikacyjnyZwierzecia=PL000000000001

Numer identyfikacyjny świni; dla polskiego identyfikatora rozpoczyna się prefiksem 'PL'.

planowanaDataPrzemieszczeniaOd
string <date>
Example: planowanaDataPrzemieszczeniaOd=2026-05-15

Początek zakresu planowanej daty przemieszczenia (format RRRR-MM-DD).

planowanaDataPrzemieszczeniaDo
string <date>
Example: planowanaDataPrzemieszczeniaDo=2026-05-15

Koniec zakresu planowanej daty przemieszczenia (format RRRR-MM-DD).

rodzajZgody
string
Enum: "ZGODA_BEZ_BADANIA" "ZGODA_Z_BADANIEM" "BRAK_ZGODY"
Example: rodzajZgody=ZGODA_BEZ_BADANIA

Rodzaj zgody wydanej przez Powiatowego/Wyznaczonego Lekarza Weterynarii — zgoda z badaniem albo zgoda bez badania.

numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR; ogranicza wynik do zgód dotyczących działalności tego posiadacza.

numerDokumentuZgloszenia
string
Example: numerDokumentuZgloszenia=20260629/000000000

Numer dokumentu zgłoszenia zamiaru przemieszczenia świń, którego dotyczy zgoda.

zdzialalnosci
string
Example: zdzialalnosci=000000000-001

Numer działalności (siedziby stada lub rzeźni), z której planowane jest przemieszczenie świń.

Responses

Response samples

Content type
application/json
{
  • "komunikat": "OK",
  • "listaZgodNaPrzemieszczenieSwin": [
    ]
}

Pobranie danych świń i loch

Zwraca dane zwierząt grupowych (świń) z aplikacji IRZplus spełniających podane kryteria wyszukiwania (m.in. numer producenta, numer działalności, stan na dzień). Opcjonalnie — gdy zaznaczono odpowiednie flagi w żądaniu — dołącza dane loch wraz z historią zmian oznakowania oraz rejestrem przebywania lochy. Operacja przeznaczona dla posiadaczy zwierząt i pracowników posiadacza i zwraca wyłącznie dane w zakresie dostępnym dla zalogowanego podmiotu.

Obsługa błędów biznesowych: błędy walidacji kryteriów oraz inne błędy biznesowe są zwracane z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (listy danych są wówczas puste).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR; ogranicza wynik do zwierząt posiadacza prowadzącego działalności objęte tym numerem.

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer działalności typu siedziba stada; ogranicza wynik do zwierząt przebywających w tej działalności.

czyRejestrLoch
boolean
Example: czyRejestrLoch=true

Określa, czy w odpowiedzi dla danych loch ma zostać dołączony rejestr przebywania lochy w kolejnych działalnościach.

czyDaneLoch
boolean
Example: czyDaneLoch=true

Określa, czy w odpowiedzi mają zostać dołączone dane loch wraz z historią zmian oznakowania.

numerIdentyfikacyjnyLochy
string
Example: numerIdentyfikacyjnyLochy=PL000000000001

Indywidualny numer identyfikacyjny lochy; ogranicza wynik danych loch do wskazanej lochy.

stanDanychNaDzien
string <date>
Example: stanDanychNaDzien=2026-05-15

Dzień, na który prezentowany jest stan danych zwierząt w rejestrze (format RRRR-MM-DD).

Responses

Response samples

Content type
application/json
{
  • "komunikat": "OK",
  • "daneZwierzatZGatunkuSwinie": [
    ],
  • "daneLoch": [
    ]
}

Drób - dokumenty

Usługi umożliwiające posiadaczom składanie dokumentów (zgłoszeń) dotyczących drobiu — ZRD, ZZSSD, ZURD, ZUZD, ZPZD — oraz pobieranie złożonych dokumentów. Operacje obejmują walidację biznesową zgłoszeń i zwracają wynik przetwarzania. Zakres: dokumenty drobiowe.

Złożenie dokumentu ZZSSD

Składa zgłoszenie zmiany stanu stada drobiu / uboju w rzeźni (ZZSSD) w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy; zgłoszenie podlega regułom walidacji biznesowej, a odpowiedź zawiera wynik jego przetwarzania.

Obsługa błędów biznesowych: błędy walidacji oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200 wraz z opisem przyczyny w polach komunikatu/błędów wyniku operacji.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZZSSDDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZUZD

Składa zgłoszenie uboju partii drobiu w zakładzie (ZUZD) w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy; zgłoszenie podlega regułom walidacji biznesowej, a odpowiedź zawiera wynik jego przetwarzania.

Obsługa błędów biznesowych: błędy walidacji oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200 wraz z opisem przyczyny w polach komunikatu/błędów wyniku operacji.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZUZDDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZURD

Składa zgłoszenie uboju / rozchodu partii drobiu (ZURD) w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy; zgłoszenie podlega regułom walidacji biznesowej, a odpowiedź zawiera wynik jego przetwarzania.

Obsługa błędów biznesowych: błędy walidacji oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200 wraz z opisem przyczyny w polach komunikatu/błędów wyniku operacji.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZURDDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZRD

Składa zgłoszenie rejestracji partii drobiu (ZRD) w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy; zgłoszenie podlega regułom walidacji biznesowej, a odpowiedź zawiera wynik jego przetwarzania.

Obsługa błędów biznesowych: błędy walidacji oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200 wraz z opisem przyczyny w polach komunikatu/błędów wyniku operacji.

Authorizations:
bearerAuth
Request Body schema: application/json
required
komorkaOrganizacyjna
string

Komórka organizacyjna ARiMR, do której składany jest dokument

numerProducenta
required
string

Numer producenta, który składa dokument

required
object (ZgloszenieZRDDTO)

Treść zgłoszenia (dokumentu) zależna od typu dokumentu

Responses

Request samples

Content type
application/json
{
  • "komorkaOrganizacyjna": "3155",
  • "numerProducenta": "000000000",
  • "zgloszenie": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Złożenie dokumentu ZPZD

Składa zgłoszenie przekazania zwłok drobiu (ZPZD) — np. do zakładu przetwórczego lub spalarni — w aplikacji IRZplus. Operacja przeznaczona dla posiadaczy oraz portalu IRZplus; zgłoszenie składane jest jako multipart (dane zgłoszenia w części dyspozycja oraz opcjonalny dokumentHandlowy), podlega regułom walidacji biznesowej, a odpowiedź zawiera wynik jego przetwarzania.

Obsługa błędów biznesowych: błędy walidacji oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200 wraz z opisem przyczyny w polach komunikatu/błędów wyniku operacji.

Authorizations:
bearerAuth
Request Body schema: application/json
required
object (DyspozycjaZPZD)

Struktura danych: DyspozycjaZPZD.

dokumentHandlowy
string <binary>

Responses

Request samples

Content type
application/json
{
  • "dyspozycja": {
    }
}

Response samples

Content type
application/json
{
  • "komunikat": "DOKUMENT ZŁOŻONY POMYŚLNIE",
  • "bledy": [
    ],
  • "numerDokumentu": "20260629/000000000"
}

Pobranie złożonego dokumentu

Zwraca szczegóły złożonego dokumentu (zgłoszenia) drobiowego z aplikacji IRZplus na podstawie numeru producenta oraz numeru dokumentu. Operacja przeznaczona dla posiadaczy i umożliwia podgląd wcześniej złożonego dokumentu.

Obsługa błędów biznesowych: brak dokumentu lub inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat.

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer producenta, w kontekście którego odbywa się pobranie danych

numerDokumentu
string
Example: numerDokumentu=20260629/000000000

Numer dokumentu

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Dokument pobrany pomyślnie",
  • "numerDokumentu": "20260629/000000000",
  • "szczegoly": {
    },
  • "blad": [
    ]
}

Drób - dane zwierząt

Usługi udostępniające dane partii drobiu z aplikacji IRZplus posiadaczom oraz portalowi IRZplus. Pozwalają wyszukiwać partie drobiu wg zadanych kryteriów (numer działalności lub numer producenta) w zakresie danych, do których wywołujący ma uprawnienia. Zakres: wyłącznie drób; dostęp ograniczony kontrolą dostępu po działalności/producencie.

Pobranie listy partii drobiu

Zwraca listę partii drobiu z aplikacji IRZplus spełniających podane kryteria wyszukiwania. Wymagane jest podanie numeru działalności lub numeru producenta; odpowiedź obejmuje wyłącznie dane, do których wywołujący ma uprawnienia (kontrola dostępu po działalności i po producencie). Operacja przeznaczona dla posiadaczy.

Obsługa błędów biznesowych: brak uprawnień do wskazanych danych, brak kryteriów oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (lista partii drobiu jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR, którego dane mają zostać wyszukane.

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer identyfikacyjny zarejestrowanej działalności (zakładu drobiu).

gatunek
string
Example: gatunek=KURY

Kod wartości słownikowej – Gatunek drobiu (SIA-SL02125).

numerPartiiDrobiu
string
Example: numerPartiiDrobiu=PL000000000/KURY/2026/00001

Indywidualny numer identyfikacyjny partii drobiu w aplikacji IRZplus.

stanDanychNaDzien
string <date>
Example: stanDanychNaDzien=2026-05-15

Dzień, na który ma zostać odtworzony stan danych partii drobiu. Przy braku wartości przyjmowana jest data bieżąca.

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Brak dostępu do danych",
  • "listaDrob": [
    ]
}

Drób - zdarzenia

Usługi udostępniające zdarzenia drobiowe z aplikacji IRZplus posiadaczom oraz portalowi IRZplus. Pozwalają wyszukiwać zdarzenia (m.in. ZAD, ZRD, ZURD, ZUZD, ZZSSD) wg zadanych kryteriów (numer działalności lub numer producenta) wraz z ich szczegółami oraz informacją o błędach walidacji. Zakres ograniczony kontrolą dostępu po działalności/producencie.

Pobranie listy zdarzeń drobiowych

Zwraca listę zdarzeń drobiowych z aplikacji IRZplus spełniających podane kryteria wyszukiwania, wraz ze szczegółami właściwymi dla typu zdarzenia (ZAD, ZRD, ZURD, ZUZD, ZZSSD) oraz listą błędów walidacji wynikających z przetwarzania. Wymagane jest podanie numeru działalności lub numeru producenta; odpowiedź obejmuje wyłącznie dane, do których wywołujący ma uprawnienia (kontrola dostępu po działalności i po producencie). Operacja przeznaczona dla posiadaczy.

Obsługa błędów biznesowych: brak uprawnień do wskazanych danych, brak kryteriów oraz inne błędy biznesowe są zwracane w odpowiedzi z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (lista zdarzeń jest wówczas pusta).

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR, którego zdarzenia mają zostać wyszukane.

numerDzialalnosci
string
Example: numerDzialalnosci=000000000-001

Numer identyfikacyjny zarejestrowanej działalności (zakładu drobiu).

numerPartiiDrobiu
string
Example: numerPartiiDrobiu=PL000000000/2026/001

Indywidualny numer identyfikacyjny partii drobiu w aplikacji IRZplus.

gatunek
string
Example: gatunek=KURY

Kod wartości słownikowej – Gatunek drobiu (SIA-SL02125).

typZdarzenia
string
Example: typZdarzenia=ZRDPR

Kod wartości słownikowej – Typ zdarzenia drobiu (SIA-SL02126).

stanZdarzenia
string
Example: stanZdarzenia=SZPA

Kod wartości słownikowej – Stan zdarzenia (SIA-SL02194), tj. status zdarzenia w systemie (m.in. Pasujące, Niepasujące, Do przetworzenia, Anulowane).

dataZdarzeniaOd
string <date>
Example: dataZdarzeniaOd=2026-05-15

Początek zakresu dat zdarzenia, dla którego wyszukiwane są zdarzenia.

dataZdarzeniaDo
string <date>
Example: dataZdarzeniaDo=2026-05-15

Koniec zakresu dat zdarzenia, dla którego wyszukiwane są zdarzenia.

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Brak dostępu do danych",
  • "listaZdarzenie": [
    ]
}

Dokumenty

Produkcyjne usługi udostępniania dokumentów z aplikacji IRZplus. Pozwalają posiadaczowi zwierząt oraz upoważnionym pracownikom posiadacza pobrać listę dokumentów złożonych w kontekście wskazanego numeru producenta, z możliwością zawężenia po typie, statusie i zakresie dat. Dostęp do danych ograniczony jest do producentów, do których uwierzytelniony podmiot posiada uprawnienia.

Pobranie listy dokumentów producenta

Zwraca listę dokumentów z aplikacji IRZplus złożonych w kontekście numeru producenta przekazanego w żądaniu. Wynik można zawęzić podając numer dokumentu, stan dokumentu, typy dokumentów oraz zakres dat złożenia. Operacja przeznaczona jest dla posiadacza zwierząt oraz pracowników posiadacza i poprzedzona jest weryfikacją uprawnień zalogowanego podmiotu do wskazanego producenta.

Obsługa błędów biznesowych: brak dostępu do danych producenta oraz pozostałe błędy biznesowe zwracane są z kodem HTTP 200; lista dokumentów jest wówczas pusta, a opis przyczyny znajduje się w polu komunikat.

Authorizations:
bearerAuth
query Parameters
numerProducenta
string
Example: numerProducenta=000000000

Numer identyfikacyjny producenta nadany w ewidencji producentów ARiMR, w kontekście którego pobierana jest lista dokumentów.

numerDokumentu
string
Example: numerDokumentu=20260629/000000000

Numer dokumentu, do którego zawężane jest wyszukiwanie listy dokumentów.

statusDokumentu
string
Example: statusDokumentu=1

Kod wartości słownikowej określającej stan obsługi dokumentu, po którym zawężane jest wyszukiwanie (SIA-SL02198).

typyDokumentow
Array of strings
Example: typyDokumentow=ZRKON&typyDokumentow=ZD

Lista kodów wartości słownikowych określających typy dokumentów, po których zawężane jest wyszukiwanie (SIA-SL02153).

dataOd
string <date>
Example: dataOd=2026-05-15

Początek zakresu dat złożenia dokumentu, od którego zawężane jest wyszukiwanie.

dataDo
string <date>
Example: dataDo=2026-05-15

Koniec zakresu dat złożenia dokumentu, do którego zawężane jest wyszukiwanie.

Responses

Response samples

Content type
application/json
{
  • "komunikat": "Brak dostępu do danych",
  • "dokumenty": [
    ]
}

Działalności (producent)

Usługi produkcyjne udostępniane producentom (posiadaczom zwierząt) do wyszukiwania ich działalności zarejestrowanych w systemie IRZplus. Wyniki ograniczone są zakresem dostępu uwierzytelnionego użytkownika — zwracane są wyłącznie działalności, do których ma on uprawnienia. Zakres: dane działalności widoczne dla producenta.

Wyszukanie działalności producenta

Zwraca listę działalności spełniających przekazane kryteria wyszukiwania (numer działalności, numer producenta, rodzaj, stan oraz typ działalności). Wymagane jest podanie numeru działalności lub numeru producenta. Wyniki są filtrowane do zakresu dostępu uwierzytelnionego użytkownika — pracownik posiadacza otrzymuje wyłącznie działalności, do których jest uprawniony.

Obsługa błędów biznesowych: brak dostępu do danych, brak wymaganych kryteriów oraz wygaśnięcie hasła zwracane są z kodem HTTP 200, a opis przyczyny znajduje się w polu komunikat (lista działalności jest wówczas pusta).

Authorizations:
bearerAuth
Request Body schema: application/json
required
numerProducenta
string

Numer identyfikacyjny producenta (posiadacza zwierząt) nadany w ewidencji producentów ARiMR.

numerDzialalnosci
string

Numer identyfikacyjny zarejestrowanej działalności producenta (np. siedziby stada, rzeźni, zakładu drobiu, zakładu przetwórczego lub spalarni).

rodzajDzialalnosci
string

Rodzaj działalności (podzakładu) określający szczegółowy profil prowadzonej działalności w ramach danego typu zakładu. Kod wartości słownikowej (SIA-SL02201).

typDzialalnosci
string

Typ działalności (rodzaj zakładu): siedziba stada, rzeźnia, zakład drobiu, zakład przetwórczy lub spalarnia. Kod wartości słownikowej (SIA-SL02159).

stanDzialalnosci
string

Stan działalności w aplikacji IRZplus (m.in. zarejestrowana, aktywna, nieaktywna, wyrejestrowana). Kod wartości słownikowej (SIA-SL02180).

Responses

Request samples

Content type
application/json
{
  • "numerProducenta": "000000000",
  • "numerDzialalnosci": "000000000-001",
  • "rodzajDzialalnosci": "SST01",
  • "typDzialalnosci": "SST",
  • "stanDzialalnosci": "SDZR"
}

Response samples

Content type
application/json
{
  • "dzialalnosc": [
    ],
  • "komunikat": "Brak dostępu do danych"
}