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:
- Aplikacja pobiera GET /jrwa raz dziennie (cache lokalny)
- Przy zakładaniu sprawy sprawdza klasę w cache
- 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:
- Pobiera GET /jrwa z EZD RP
- Porównuje z lokalnymi tabelami w systemie X
- Aktualizuje różnice (dodaje nowe klasy, dezaktywuje usunięte)
Częste pułapki
JRWA to nie zwykły słownik
Klasa JRWA ma swoje atrybuty: kod, opis, retencja archiwalna (lata), kategorię (A/B). Podczas synchronizacji nie pomijaj tych pól.Reguły synchronizacji JRWA
- Cache lokalny w aplikacji (nie pobieraj JRWA przy każdym wywołaniu)
- Wersjonowanie — śledzić, którą wersją JRWA dysponuje aplikacja
- Soft-delete — nigdy nie usuwaj klas bez sprawdzenia, czy żadna sprawa z nich nie korzysta
- Logowanie zmian — kto i kiedy modyfikował JRWA
- Walidacja kodów — niektóre formaty JRWA są surowo strukturalne (np. 0123, 0123-1)
Konsultacja zarządzania JRWA przez API
Pomożemy zaprojektować bezpieczną synchronizację JRWA między systemami.
Umów konsultację