W ramach stałego rozwoju rozwiązania dostosowaliśmy nasz system do aktualnej specyfikacji CRU API udostępnionej przez Ministerstwo Finansów. Na dzień 22 czerwca 2026 r. dokumentacja OpenAPI wskazuje wersję API 1.3.0, opisaną w standardzie OpenAPI 3.1.0.
To istotna zmiana dla jednostek sektora finansów publicznych, ponieważ zgodność systemu wewnętrznego z aktualną dokumentacją API wpływa bezpośrednio na stabilność integracji, poprawność przekazywanych danych oraz ciągłość procesów związanych z publikacją informacji o umowach w Centralnym Rejestrze Umów JSFP.
Od strony technicznej aktualizacja oznacza, że system obsługuje aktualną specyfikację komunikacji z API CRU. Obejmuje to w szczególności autoryzację z wykorzystaniem X-API-KEY, publikację i aktualizację umów, pobieranie szczegółów umów, wyszukiwanie streszczeń, a także weryfikację statusów przetwarzania danych przekazanych przez API.
Uwzględniliśmy również zmiany wprowadzone w najnowszej wersji dokumentacji, w tym ujednolicenie identyfikacji umów, obsługę identyfikatorów UUID, możliwość przekazywania opcjonalnego identyfikatora umowy nadawanego w systemie zewnętrznym oraz rozszerzone informacje zwracane w odpowiedziach API. Równolegle dostosowaliśmy walidację danych, strukturę żądań i odpowiedzi oraz obsługę parametrów filtrowania, sortowania i stronicowania.
W praktyce oznacza to mniejsze ryzyko błędów integracyjnych, odrzuceń danych oraz konieczności wykonywania ręcznych korekt. System może sprawniej wspierać jednostkę w przygotowaniu, przekazywaniu i monitorowaniu informacji o umowach publikowanych w CRU JSFP.
Dla użytkowników biznesowych najważniejszy jest efekt operacyjny. Aktualna integracja zwiększa przewidywalność działania systemu, ułatwia obsługę procesu publikacji umów oraz pozwala szybciej reagować na statusy zwracane przez API. Dzięki temu zespoły odpowiedzialne za ewidencję, kontrolę i publikację umów mogą pracować w bardziej uporządkowany sposób, z mniejszym ryzykiem pomyłek i opóźnień.
Ta aktualizacja potwierdza nasze podejście do utrzymania i rozwoju systemu. Na bieżąco monitorujemy dokumentację CRU API oraz wdrażamy niezbędne dostosowania, aby system pozostawał zgodny z aktualnymi wymaganiami technicznymi i wspierał stabilną pracę jednostek sektora finansów publicznych.
Źródła
- Ministerstwo Finansów - Dokumentacja integracyjna CRU API
- Ministerstwo Finansów - Specyfikacja OpenAPI CRU API
- Ministerstwo Finansów - komunikat o zmianie API systemu CRU JSFP z 17 czerwca 2026 r.