System Ewidencja Umów JSFP został dostosowany do aktualnej dokumentacji integracyjnej CRU API 1.3.0, opublikowanej przez Ministerstwo Finansów.
Ministerstwo Finansów opublikowało informację o zmianach w API integracyjnym systemu CRU JSFP. Zmiany zostały opisane w dokumentacji integracyjnej CRU API w wersji 1.3.0 i dotyczą przede wszystkim identyfikacji umów, obsługi identyfikatorów, odpowiedzi API, statusów przetwarzania oraz walidacji danych.
Dostosowaliśmy nasz system do aktualnej wersji dokumentacji, aby wspierać jednostki sektora finansów publicznych w stabilnej obsłudze integracji z Centralnym Rejestrem Umów JSFP.
Najkrótsza informacja
System Ewidencja Umów JSFP został dostosowany do CRU API 1.3.0.
Aktualizacja obejmuje w szczególności:
- obsługę zmian w identyfikacji umów,
- uwzględnienie identyfikatorów UUID,
- możliwość obsługi identyfikatora umowy nadawanego w systemie lokalnym,
- dostosowanie do zmian w strukturach odpowiedzi API,
- obsługę statusów przetwarzania danych,
- dostosowanie walidacji danych przesyłanych przez API,
- przygotowanie procesu publikacji i aktualizacji umów zgodnie z aktualną dokumentacją integracyjną.
Dla użytkowników oznacza to większą przewidywalność integracji, mniejsze ryzyko błędów technicznych oraz lepszą kontrolę statusów danych przekazywanych do CRU JSFP.
Co zmieniło się w CRU API?
Zgodnie z komunikatem Ministerstwa Finansów zmiany w API integracyjnym CRU JSFP dotyczą kilku kluczowych obszarów.
Najważniejsze z nich to:
- ujednolicenie identyfikacji umów,
- rozszerzenie informacji zwracanych w odpowiedziach API,
- dodanie opcjonalnego identyfikatora umowy nadawanego w systemie integrowanym z CRU JSFP,
- poprawa walidacji danych przesyłanych przez API,
- wykorzystanie identyfikatora UUID,
- możliwość sprawdzania statusów przetwarzania danych przekazanych przez API,
- ujednolicenie sposobu przekazywania danych stron umowy, z uwzględnieniem bazy REGON dla stron zarejestrowanych na terytorium RP.
To ważne zmiany, ponieważ integracja z CRU JSFP nie polega wyłącznie na technicznym wysłaniu danych. System lokalny musi poprawnie identyfikować umowę, przekazać dane w wymaganej strukturze, obsłużyć odpowiedź systemu centralnego i umożliwić monitorowanie statusu publikacji albo aktualizacji.
Dlaczego zgodność z aktualną wersją API jest ważna?
W przypadku integracji z systemem centralnym nie wystarczy jednorazowe przygotowanie mechanizmu wysyłki danych. API może się zmieniać, a system lokalny powinien nadążać za aktualną dokumentacją.
Brak zgodności z aktualną wersją API może powodować między innymi:
- błędy walidacji danych,
- odrzucenie przesyłanych informacji,
- problemy z identyfikacją umów,
- trudności z aktualizacją wcześniej przekazanych danych,
- brak możliwości prawidłowego monitorowania statusów,
- konieczność ręcznych korekt,
- opóźnienia w procesie publikacji lub aktualizacji informacji o umowach.
Dlatego zgodność z CRU API 1.3.0 ma znaczenie nie tylko techniczne, ale również organizacyjne. Stabilna integracja ogranicza ryzyko pracy ręcznej, błędów i rozjazdu między lokalną ewidencją umów a systemem centralnym.
Co oznacza to dla jednostki sektora finansów publicznych?
Dla jednostki najważniejszy jest efekt operacyjny.
Dostosowanie systemu do aktualnej wersji CRU API oznacza, że lokalna ewidencja umów może lepiej wspierać proces:
- przygotowania danych do publikacji,
- walidacji wymaganych informacji,
- przekazania danych do CRU JSFP,
- obsługi odpowiedzi systemu centralnego,
- sprawdzania statusów przetwarzania,
- aktualizacji danych po zmianach umowy,
- ograniczenia ręcznych korekt,
- monitorowania błędów integracyjnych.
Dzięki temu osoby odpowiedzialne za rejestr umów, publikację informacji i kontrolę procesu mogą pracować na danych przygotowanych w lokalnym systemie, zamiast każdorazowo przepisywać informacje ręcznie do systemu centralnego.
UUID i identyfikator lokalny umowy
Jedną z istotnych zmian jest ujednolicenie identyfikacji umów oraz wykorzystanie identyfikatora UUID. Ma to znaczenie przy jednoznacznym powiązaniu danych lokalnych z informacjami przetwarzanymi i publikowanymi w CRU JSFP.
Równocześnie dokumentacja przewiduje możliwość przekazywania opcjonalnego identyfikatora umowy nadanego w systemie zintegrowanym z CRU JSFP.
Dla jednostki jest to praktycznie ważne, ponieważ lokalny system może posiadać własny identyfikator umowy, niezależny od numeru umowy widocznego na dokumencie albo identyfikatora nadanego przez system centralny.
Dobrze zaprojektowana integracja powinna umożliwiać powiązanie:
- numeru umowy,
- identyfikatora lokalnego,
- identyfikatora technicznego,
- identyfikatora UUID,
- statusu publikacji,
- historii aktualizacji.
Takie podejście ułatwia obsługę korekt, aneksów, aktualizacji i wyjaśnianie ewentualnych różnic między systemem lokalnym a CRU JSFP.
Status przetwarzania danych
Zmiany w API obejmują również obsługę statusów przetwarzania informacji przekazanych przez API.
To szczególnie istotne, ponieważ samo wysłanie danych nie oznacza jeszcze, że proces zakończył się poprawnie. System lokalny powinien umożliwiać sprawdzenie, czy dane zostały przyjęte, przetworzone, opublikowane, odrzucone albo wymagają poprawy.
W praktyce jednostka powinna widzieć co najmniej:
- które umowy są gotowe do publikacji,
- które zostały przekazane do CRU JSFP,
- które oczekują na przetworzenie,
- które zostały przetworzone poprawnie,
- które wymagają poprawy,
- przy których wystąpił błąd,
- które wymagają ponowienia operacji,
- które zostały zaktualizowane po zmianie danych.
Obsługa statusów jest ważna dla codziennej pracy zespołu, ale również dla raportowania i kontroli terminów.
Walidacja danych przed publikacją
Poprawa walidacji danych przesyłanych przez API oznacza, że jednostka powinna szczególnie dbać o jakość danych przygotowywanych w lokalnym rejestrze.
System lokalny powinien pomagać sprawdzić między innymi:
- kompletność wymaganych pól,
- poprawność danych stron umowy,
- zgodność identyfikatorów,
- wartość umowy,
- status umowy,
- dane potrzebne do aktualizacji,
- informacje o ograniczeniach jawności,
- strukturę danych przekazywanych do API.
Im lepsza walidacja po stronie lokalnej, tym mniejsze ryzyko odrzucenia danych przez system centralny i konieczności ręcznej poprawy.
Integracja wymaga utrzymania, nie jednorazowego wdrożenia
Zmiana CRU API pokazuje, że integracja z systemem centralnym wymaga bieżącego utrzymania.
Jednostka korzystająca z integracji powinna mieć pewność, że system lokalny:
- monitoruje aktualną dokumentację API,
- dostosowuje struktury danych do zmian,
- obsługuje nowe albo zmienione odpowiedzi API,
- aktualizuje walidacje,
- pozwala śledzić statusy przetwarzania,
- zachowuje historię wysyłek i błędów,
- umożliwia bezpieczne aktualizacje informacji o umowach.
Integracja z CRU JSFP nie powinna być traktowana jako jednorazowy moduł techniczny. To element procesu, który musi być utrzymywany zgodnie z aktualnymi wymaganiami Ministerstwa Finansów.
Co zyskuje jednostka?
Dostosowanie systemu do CRU API 1.3.0 pomaga ograniczyć ryzyka związane z publikacją i aktualizacją informacji o umowach.
Najważniejsze korzyści to:
- większa stabilność integracji,
- lepsza obsługa identyfikatorów umów,
- możliwość powiązania danych lokalnych z danymi w CRU JSFP,
- lepsze monitorowanie statusów,
- ograniczenie ręcznych korekt,
- mniejsze ryzyko błędów walidacji,
- sprawniejsza aktualizacja informacji po zmianach umowy,
- lepsza kontrola procesu publikacji,
- większa rozliczalność działań użytkowników.
Dla jednostki oznacza to mniej improwizacji i więcej kontroli nad procesem przekazywania danych do systemu centralnego.
Podsumowanie
System Ewidencja Umów JSFP został dostosowany do aktualnej dokumentacji integracyjnej CRU API 1.3.0.
Zmiany w API dotyczą między innymi identyfikacji umów, obsługi UUID, opcjonalnego identyfikatora lokalnego, struktury odpowiedzi, statusów przetwarzania oraz walidacji danych.
Dostosowanie systemu do aktualnej wersji API ma znaczenie praktyczne: pomaga utrzymać stabilność integracji, poprawność przekazywanych danych, obsługę statusów i sprawną aktualizację informacji o umowach.
Dla jednostek sektora finansów publicznych oznacza to lepsze przygotowanie do pracy z CRU JSFP, szczególnie wtedy, gdy lokalny rejestr umów ma być zintegrowany z systemem centralnym.
Źródła
Materiał został przygotowany na podstawie aktualnie dostępnych informacji publicznych dotyczących zmian w API integracyjnym systemu CRU JSFP oraz dokumentacji Ministerstwa Finansów.
Najważniejsze źródła:
- Ministerstwo Finansów — komunikat „Zmiana API systemu CRU JSFP” z 17 czerwca 2026 r.
- Ministerstwo Finansów — komunikat „Planowane zmiany w API systemu CRU JSFP” z 11 czerwca 2026 r.
- Ministerstwo Finansów — dokumentacja integracyjna CRU API, wersja 1.3.0.
https://jsfp-cru-test.mf.gov.pl/api-gw/docs/int/api.html - Ministerstwo Finansów — specyfikacja OpenAPI CRU API.
https://jsfp-cru-test.mf.gov.pl/api-gw/docs/openapi
Uwaga: artykuł ma charakter informacyjny i produktowy. Przed podjęciem decyzji integracyjnych jednostka powinna każdorazowo zweryfikować aktualną dokumentację CRU API, komunikaty Ministerstwa Finansów oraz wymagania własnego środowiska technicznego i organizacyjnego.