JRWA przez API EZD RP — synchronizacja

JRWA (Jednolity Rzeczowy Wykaz Akt) to klasyfikacja spraw obowiązująca w jednostce. Dostęp przez API pozwala synchronizować JRWA z innym systemem, czytać dostępne klasy do walidacji, a nawet modyfikować strukturę z aplikacji zewnętrznej.

Co API JRWA umożliwia

• GET /jrwa — pobranie pełnej struktury JRWA (klasy, opisy, retencja)
• GET /jrwa/{kod} — szczegóły jednej klasy
• POST /jrwa (jeśli dostępne) — dodanie nowej klasy (uprawnienie administratora)
• PUT /jrwa/{kod} — modyfikacja istniejącej klasy
• DELETE /jrwa/{kod} — usunięcie (jeśli żadna sprawa nie korzysta)

Typowe scenariusze

Scenariusz 1: walidacja klasy w aplikacji zewnętrznej

System rekrutacji studentów chce automatycznie zakładać sprawy w EZD RP. Przed wysłaniem POST /sprawy waliduje, czy klasa JRWA istnieje:

1. Aplikacja pobiera GET /jrwa raz dziennie (cache lokalny)
2. Przy zakładaniu sprawy sprawdza klasę w cache
3. Jeśli klasa istnieje → POST /sprawy. Jeśli nie → komunikat błędu dla użytkownika

Scenariusz 2: synchronizacja JRWA między systemami

Jednostka prowadzi JRWA centralnie w EZD RP. Inne systemy (FK, kadry, system rekrutacji) muszą znać klasy. Co tydzień skrypt:

1. Pobiera GET /jrwa z EZD RP
2. Porównuje z lokalnymi tabelami w systemie X
3. Aktualizuje różnice (dodaje nowe klasy, dezaktywuje usunięte)

Częste pułapki