System Ewidencja Umów JSFP został dostosowany do aktualnego zakresu dokumentacji CRU API 1.3.2.
Co zmieniło się od wersji 1.3.0?
Wersja 1.3.0 była istotnym etapem porządkowania integracji z CRU JSFP. Zmiany dotyczyły przede wszystkim ujednolicenia identyfikacji umów, rozszerzenia informacji zwracanych w odpowiedziach API, dodania opcjonalnego identyfikatora umowy nadawanego w systemie zewnętrznym oraz poprawy walidacji danych przesyłanych przez API.
Najważniejsze różnice względem 1.3.0 dotyczą obsługi wycofania informacji o umowie z publikacji, doprecyzowania zasad przekazywania danych osoby fizycznej spoza Polski oraz uzupełnienia struktury odpowiedzi endpointu /withdraw w zakresie obsługi błędów.
Nowy zakres API: wycofanie z publikacji informacji o umowie
Najważniejszą zmianą funkcjonalną po wersji 1.3.0 jest dodanie endpointu /withdraw, który umożliwia wycofanie z publikacji informacji o umowach.
To ważne rozróżnienie: nie chodzi o zwykłe „usunięcie umowy” z lokalnej ewidencji ani o techniczne skasowanie rekordu w systemie jednostki. Chodzi o obsługę procesu wycofania informacji opublikowanej w CRU JSFP, zgodnie z zakresem przewidzianym w dokumentacji API.
Z perspektywy jednostki oznacza to konieczność zapewnienia w systemie mechanizmu, który pozwala kontrolować nie tylko publikację i aktualizację danych, ale również sytuacje następcze — w tym przypadki, w których informacja o umowie nie powinna dalej pozostawać opublikowana w dotychczasowym zakresie.
System Ewidencja Umów JSFP wspiera ten nowy zakres API. Obejmuje to przygotowanie obsługi procesu wycofania z publikacji, przekazywanie właściwych identyfikatorów oraz interpretację odpowiedzi zwracanych przez API.
Doprecyzowanie danych osoby fizycznej spoza Polski
Aktualizacja dokumentacji objęła również doprecyzowanie zasad przekazywania danych osoby fizycznej spoza Polski.
To istotny obszar, ponieważ w danych kontrahentów i stron umów mogą występować przypadki, które nie mieszczą się w standardowym modelu identyfikacji właściwym dla podmiotów krajowych. W praktyce system obsługujący integrację z CRU JSFP musi rozróżniać typy stron umowy i odpowiednio walidować dane przed ich przekazaniem.
Dostosowanie systemu do wersji 1.3.2 oznacza uwzględnienie tych doprecyzowań w logice danych, walidacji oraz przygotowaniu struktur przekazywanych przez API. Dzięki temu ograniczane jest ryzyko błędów wynikających z nieprawidłowego uzupełnienia danych osoby fizycznej spoza Polski.
Precyzyjniejsza obsługa błędów endpointu /withdraw
Kolejna zmiana dotyczy struktury odpowiedzi endpointu /withdraw. W odpowiedzi dotyczącej błędów dodano pole agreementId w elementach tablicy errors.
To techniczna zmiana, ale ma praktyczne znaczenie. Jeżeli operacja wycofania z publikacji obejmuje więcej niż jedną umowę albo jeżeli API zwraca błąd dotyczący konkretnej pozycji, system powinien umożliwiać jednoznaczne ustalenie, której umowy dotyczy problem.
Obsługa agreementId w odpowiedziach błędów ułatwia diagnostykę, zmniejsza ryzyko niejednoznacznej interpretacji komunikatów oraz pozwala szybciej podjąć działania korygujące. Dla użytkownika biznesowego oznacza to bardziej czytelny proces obsługi błędów, a dla administratora lub osoby odpowiedzialnej za integrację — prostsze ustalenie przyczyny problemu.
Co to oznacza dla użytkowników systemu?
Dla użytkowników systemu Ewidencja Umów JSFP aktualizacja do zakresu CRU API 1.3.2 oznacza większą kompletność obsługi integracji z CRU JSFP.
System wspiera obecnie nie tylko publikację, aktualizację, wyszukiwanie i obsługę statusów, ale również nowy zakres związany z wycofaniem z publikacji informacji o umowach. Uwzględnia także zmiany dotyczące odpowiedzi API oraz doprecyzowania w zakresie danych osoby fizycznej spoza Polski.
Na bieżąco monitorujemy dokumentację Ministerstwa Finansów i wdrażamy niezbędne dostosowania, aby system pozostawał zgodny z aktualnymi wymaganiami technicznymi oraz wspierał stabilną obsługę procesów związanych z CRU JSFP.
Podsumowanie
Wersja 1.3.2 rozszerza zakres o obsługę wycofania z publikacji informacji o umowach, doprecyzowanie danych osoby fizycznej spoza Polski oraz precyzyjniejszą obsługę błędów endpointu /withdraw.
System Ewidencja Umów JSFP został dostosowany do tego zakresu i wspiera aktualne wymagania dokumentacji CRU API 1.3.2.
Źródła
- Ministerstwo Finansów — Dodatkowa opcja w API systemu CRU JSFP, komunikat z 24 czerwca 2026 r.
- Ministerstwo Finansów — Niezbędna modyfikacja dodatkowej opcji API do systemu CRU JSFP, komunikat z 26 czerwca 2026 r.
- CRU API — Dokumentacja integracyjna