API integracyjne EZD RP pozwala na wykonywanie następujących działań związanych z zadaniami:
- hurtową zmianę właściciela,
- dekretację,
- wystawienie zadania Do akceptacji lub podpisu.
W każdym z wymienionych przypadków konieczne jest uzyskanie wartości idStanowisko. Można ją odnaleźć za pomocą metody
POST /ezdrp/integrator/v2/struktura/uzytkownik/_search
lub kolejno przy użyciu metod:
GET /ezdrp/integrator/v2/struktura
GET /ezdrp/integrator/v2/struktura/{idKomorkaOrganizacyjna}/stanowiska
Hurtowa zmiana właściciela
Hurtową zmianę właściciela wykonujemy za pomocą metody:
PUT /stanowiska/{idStanowisko}/obiegi
Za pomocą powyższej metody można przekazać hurtowo wyłącznie te typy obiegów, które mogą zostać przekazane z poziomu GUI EZD RP.
Przykład: w EZD RP znajdują się dwa obiegi typu Dokument w module Do obsłużenia.
Chcemy przekazać je hurtowo na inne stanowisko.
W celu uzyskania wartości idObieg korzystamy z metody:
GET /ezdrp/integrator/v2/obiegi
Następnie przekazujemy je hurtowo na nowe stanowisko za pomocą metody:
PUT /stanowiska/{idStanowisko}/obiegi
Przykład:
PUT /stanowiska/db0eb1fbf3bb407791d23f8c468e852e/obiegi
{
"listaIdObieg": [
"2b278d9dfc894c7bb896bab4a28b34e1", "e008a12b99bb4acaa2292f439cd3937b"
],
"uwagi": "Przekazanie testowe"
}
Widok na stanowisku, które zostało wskazane jako nowe:
Dekretacja
Dekretację wykonujemy za pomocą metody:
PATCH /ezdrp/integrator/v2/obiegi/{idObieg}/zadanie/{idZadania}
Parametry idObieg oraz idZadania uzyskujemy w taki sam sposób jak w przypadku przekazania hurtowego.
Możemy wykonać dekretację, mając informacje o obiegu, jak w przykładzie poniżej:
{
"idZadanie": "07c2c15f628e40b7add05effd1db59a7",
"idObieg": "a95b094f32984623b695bd0b6dd38a18",
"dataOtrzymania": "2026-07-20 13:37",
"statusOpis": "Niepodjęte",
"status": 1,
"typZadania": 1,
"tytulDokumentu": "Dokument testowy.pdf"
}
Przykład:
PATCH /ezdrp/integrator/v2/obiegi/a95b094f32984623b695bd0b6dd38a18/zadanie/07c2c15f628e40b7add05effd1db59a7
{
"terminZalatwienia": "2026-11-22",
"idStanowisko": "db0eb1fbf3bb407791d23f8c468e852e"
}
Widok u odbiorcy zadania:
Zadanie Do akceptacji lub podpisu
Zadanie Do akceptacji lub podpisu tworzymy za pomocą metody:
POST /ezdrp/integrator/v2/obiegi/{idObieg}/zadanie
Dokument przekazywany w tym typie zadania musi mieć uzupełnione metadane:
Listę dokumentów w obiegu pobieramy za pomocą metody:
GET /ezdrp/integrator/v2/obiegi/{idObieg}/dokumenty
Przykładowa odpowiedź:
{
"idDokumentPrzestrzeni": "1d987b647fcd4275a7f31522fdf4d31b",
"idDokument": "9504580daaea40e2a69554bf14097d4b",
"idDokumentWersja": "0787ccbb791f47638159c6c5fdc051f9",
"nazwa": "Dokument testowy.pdf",
"dataModyfikacji": "2026-07-20T13:48:06.491144",
"dataUtworzenia": "2026-07-20T13:48:06.491144",
"idPrzestrzenRobocza": "8c29d0e7491245f19bdbaea746342d36",
"liczbaZalacznikow": 0,
"czyPodpisany": false,
"czyZaakceptowany": false,
"czyMetadane": true,
"czyWSkladzieChronologicznym": false,
"etykieta": "",
"czyWystawionoZadanie": false,
"czyWystawionoZadanieUdostepnienia": false,
"czyWystawionoZadanieUdostepnieniaDoRealizacji": false,
"czyDokumentWplywu": false,
"czyTylkoDoOdczytu": false,
"czyZaakceptowanyWklad": false,
"rozszerzenie": ".pdf",
"czyTylkoDoOdczytuDlaNowoTworzonychZadan": false,
"idStanowiskoAutor": "42ad53c712ff49aca1151ba21f3dd84a",
"idStanowiskoWlasciciel": "42ad53c712ff49aca1151ba21f3dd84a",
"typDokumentu": 0,
"typOdwzorowania": 0,
"isFileSignatureValid": true,
"idDokumentPrzestrzeniOryginal": "",
"dokumentWirtualny": false,
"czyKopia": false,
"czyIstniejeNowszaWersjaDokumentu": false,
"doPoprawy": false,
"zalaczniki": []
}
Przykład zadania do akceptacji (typZadania = 1):
POST /ezdrp/integrator/v2/obiegi/0eac9a92b44742b3973376e3658e072c/zadanie
{
"idStanowisko": "db0eb1fbf3bb407791d23f8c468e852e",
"uwagi": "akceptacja",
"terminZalatwienia": "2026-07-30",
"typZadania": 1,
"listaDokumentow": [
{
"idDokumentPrzestrzeni": "1d987b647fcd4275a7f31522fdf4d31b",
}
]
}
W przypadku zadania do podpisu wartość parametru typZadania jest równa 2. Dodatkowo należy dodać parametr kluczProfiluPodpisu. Musi być on zgodny z typem podpisywanego pliku.
Lista dostępnych wartości:
- Default lub wartość pusta → Podpis domyślny (PAdES).
- Zewnetrzny → Podpis zewnętrzny (XAdES).
- Otaczajacy → Podpis wewnętrzny otaczający (XAdES).
- Otoczony → Podpis otoczony (XAdES/XML).
Dodatkowo walidowane jest, czy stanowisko wskazane jako odbiorca zadania ma nadane w EZD RP uprawnienie Dokumenty.Podpisywanie na poziomie Stanowisko.
Widok u odbiorcy zadania:
