API EZD RP pozwala systemom zewnętrznym uzyskiwać dostęp do zasobów EZD RP oraz korzystać z jego modułów i funkcji. W tej instrukcji przedstawione są metody API wykorzystywane do realizacji konkretnego celu biznesowego – dodania uczestnika do sprawy . Opisana jest także zalecana kolejność wywoływania metod.
Aby dodać uczestnika do sprawy, musi on być wcześniej zarejestrowany w systemie EZD RP. Proces ten został opisany w artykule Dodawanie adresata – przykład użycia metod API EZD RP.
Jeśli posiadamy następujące dane:
- idAdresWersja – identyfikator wersji adresata,
- rodzaj uczestnika (pobrany ze słownika),
- idSprawa – identyfikator sprawy,
możemy skorzystać z metody:
POST /ezdrp/integrator/v2/sprawy/{idSprawa}/uczestnicy
Jeśli nie mamy wartości idAdresWersja, możemy wyszukać adresata za pomocą metody:
POST /ezdrp/integrator/v2/adresaci/_search
W naszym przykładzie uzyskana wartość idAdresWersja to 9d43f0e884ea4cc2ac419a53643f7d42.
Jeśli nie znamy rodzaju uczestnika, możemy pobrać listę możliwych wartości ze słownika:
GET /ezdrp/integrator/v2/slowniki/{kluczSlownika}
Dla uczestnika sprawy kluczem słownika będzie: EZDRP.RPW.RodzajNadawcy.
Z odpowiedzi wybieramy interesującą nas wartość, np.:
"idSlownikWykaz": "EZDRP.RPW.RodzajNadawcy.4", "nazwa": "Reprezentant", "klucz": "Reprezentant"
Jeśli nie mamy identyfikatora sprawy (idSprawa), możemy go wyszukać na podstawie znaku sprawy:
POST /ezdrp/integrator/v2/sprawy/_search
Przykład zapytania:
{
"znakSprawy": "SSPASI.000.3.2025",
}
W odpowiedzi interesuje nas wartość idSprawa. W naszym przypadku to: ba7308c651324f83ac179184ba5dec5a.
Mając wszystkie wymagane dane, możemy wywołać metodę dodania uczestnika:
POST /ezdrp/integrator/v2/sprawy/ba7308c651324f83ac179184ba5dec5a/uczestnicy
Przykład treści żądania:
{
"idAdresWersja": "9d43f0e884ea4cc2ac419a53643f7d42",
"rodzajStrony": "EZDRP.RPW.RodzajNadawcy.4",
"sposobKomunikacji": 1,
"uwagi": "Dodatkowe uwagi"
}
Wartość sposobKomunikacji:
- 1 – komunikacja papierowa
- 2 – komunikacja elektroniczna
Odpowiedź:
{
"idUczestnik": "f941fb7ab0974f3d9450dc9a4e533f4f"
}
Widok w systemie prezentuje dodanego uczestnika przypisanego do wybranej sprawy:
