Integracja systemu EZD RP z Centralnym Rejestrem Umów JSFP (CRU) umożliwia automatyczne przekazywanie danych o umowach do systemu Ministerstwa Finansów. Komunikacja odbywa się z wykorzystaniem API, z autoryzacją poprzez klucz X-API-KEY przypisany do numeru REGON jednostki.
Wymagane uprawnienia
Uprawnienia potrzebne do dodania klucza API to Rejestry.Cru.Publikacja.
Uprawnienia powinny być dodane na poziomie Instytucja.
Udostępnione API pozwala m.in. na:
- publikację i aktualizację umów,
- pobieranie szczegółów umów,
- wyszukiwanie informacji o umowach w rejestrze.
Wdrożenie integracji powinno przebiegać w dwóch etapach:
- konfiguracja i testy w środowisku testowym,
- uruchomienie integracji w środowisku produkcyjnym.
Środowisko testowe CRU
Środowisko testowe CRU zostało udostępnione przez Ministerstwo Finansów w celu:
- weryfikacji poprawności integracji systemów zewnętrznych (np. EZD RP),
- testowania mechanizmów publikacji i aktualizacji umów,
- sprawdzenia działania komunikacji API przed wdrożeniem produkcyjnym
Uzyskanie dostępu do środowiska testowego
Dostęp do środowiska testowego nie jest automatyczny – należy złożyć wniosek mailowy.
Wniosek powinien zawierać:
- numer REGON jednostki,
- nazwę systemu integrowanego (np. EZD RP),
- orientacyjną liczbę użytkowników systemu.
Wniosek należy wysłać na adres:
- wsparcie.cru.jsfp@mf.gov.pl (dla JSFP),
- pomoc.cru@mf.gov.pl (dla integratorów zewnętrznych).
Szczegółowe informacje dotyczące wysłania wniosku oraz wygenerowania klucza API są dostępne w artykułach Środowisko testowe i Materiały szkoleniowe.
Konfiguracja w EZD RP
- Na początku należy przejść do modułu Administracja → Ustawienia → CRU.
- Następnie trzeba wprowadzić numer REGON jednostki i wybrać środowisko zgodne z właściwym środowiskiem: Testowe lub Produkcyjne
- Na koniec wprowadza się uzyskany klucz API (X-API-KEY).
Połączenie EZD RP z CRU odbywa się za pomocą klucza API połączonego z konkretnym numerem REGON. Do testów klucze API generuje się na stronie CRU, w zakładce Moje dane → Klucze API. Filmik pokazujący generowanie klucza po stronie systemu CRU dostępny jest tu.Klucz API generowany jest tylko raz i należy go skopiować i zapisać.Użytkownik dodaje skopiowany wcześniej klucz API do swoich ustawień użytkownika w systemie EZD RP w sekcji CRU.
