Integracja z CRU
W tej instrukcji pokażemy Ci, jak dokonać integracji ePublink Dokumenty z Centralnym Rejestrem Umów, aby automatycznie wysyłać umowy do systemu Ministerstwa Finansów
W tym artykule dowiesz się:
- Zanim zaczniesz — co trzeba przygotować po stronie CRU?
- Jak wygenerować klucz API w systemie CRU?
- Jak skonfigurowa integrację z CRU w ePublink?
- Jak wysłać umowę do CRU?
- Kto może wysyłać umowy — rola Publikującego
- Jak przygotować się do rozpoczęcia integracji 1 lipca
Zanim zaczniesz — co trzeba przygotować po stronie CRU
Żeby integracja z ePublink zadziałała, pracownik, który będzie wysyłać umowy, musi mieć założone konto i nadaną rolę Publikującego w systemie CRU Ministerstwa Finansów. Poniżej skrót tego, co musi się wydarzyć przed konfiguracją ePublink:
- Kierownik jednostki (wójt, burmistrz, dyrektor) składa wniosek o konto na jsfp.rejestrumow.gov.pl. Do złożenia wniosku potrzeba profilu zaufanego lub mObywatela, numeru REGON oraz dokumentu potwierdzającego pełnienie funkcji.
- Każdy pracownik, który będzie pracował w CRU zakłada własne konto i wnioskuje o przypisanie ról (jednocześnie może wnioskować o kilka ról):
– Administrator — zarządza kontami i uprawnieniami w jednostce;
– Wprowadzający — wpisuje dane umowy do systemu;
– Publikujący — zatwierdza wpis i wysyła go do rejestru. - Wniosek może zatwierdzić każdy pracownik z rolą "Administrator" .
💡 W ePublink każdy zalogowany pracownik jest domyślnie Wprowadzającym — bez dodatkowych wniosków w MF.
Klucz API (krok integracji poniżej) jest potrzebny wyłącznie osobom z rolą Publikującego.
💡 Ministerstwo rekomenduje składanie wniosków od 22 kwietnia 2026 r. Proces nadawania uprawnień może potrwać kilka dni — nie zostawiaj tego na ostatni tydzień przed 1 lipca.
Integrację z ePublink wykonuje wyłącznie pracownik z rolą Publikującego, bo tylko on może wygenerować klucz API w systemie CRU.
Jak wygenerować klucz API w systemie CRU?
- Zaloguj się do systemu CRU na jsfp.rejestrumow.gov.pl jako użytkownik z rolą Publikującego.
- Przejdź do zakładki Moje dane → Klucze API.

- Kliknij „Generuj klucz API", a następnie skopiuj wygenerowany kod — będzie potrzebny w kolejnym kroku.
👉 Nie wiesz jak się poruszać po panelu CRU? Skorzystaj z instrukcji wideo przygotowanej przez Ministerstwo Finansów.
💡 Pamiętaj: klucze API są nadawane indywidualnie, dlatego nie udostępniaj ich nikomu. Klucz identyfikuję osobę ktora publikuje umowę w CRU.
Jak skonfigurować integrację z CRU w ePublink?
-
Zaloguj się do platformy ePublink i przejdź do zakładki Integracje → CRU.
-
Wklej skopiowany klucz API w odpowiednim polu, uzupełnij REGON oraz wybierz "Jednostkę" i kliknij „Dodaj klucz API".

-
Skorzystaj z przycisku „Weryfikuj klucz API, aby sprawdzić, czy klucz jest aktywny i połączenie z CRU działa poprawnie.
.png?width=670&height=261&name=ver_api_publink%20(1).png)
💡 To jednorazowa konfiguracja dla każdego Publikującego. Po jej wykonaniu każda umowa może być przesłana do rejestru bezpośrednio z ePublink Dokumenty — bez wchodzenia na portal MF.
Co jeśli chcę publikować umowy jako Urząd i jako Gmina?
Możesz dodać klucz API dla obu podmiotów, ale pamiętaj o tym, żeby przy dodawaniu umowy wskazać poprawnie stronę publikującą.
Jak wysłać umowę do CRU?
-
W module ePublink Dokumenty przejdź do zakładki „CRU".
-
Przefiltruj widok "Do publikacji w CRU", aby wyświetlić wszystkie te umowy, które muszą zostać wysłane do CRU.
💡Obok umowy zobaczysz status do publikacji - oraz ilość dni pozostałych do publikacji

-
Kliknij checkbox wybranej umowy, a następnie wybierz „Publikuj do CRU". Umowa zmieni status na „Opublikowano".

💡 Dane umowy uzupełniane są automatycznie na podstawie tego, co jest już w ePublink. Nie musisz niczego przepisywać do portalu MF.
💡 Pamiętaj o terminie — każda umowa zawarta od 1 lipca 2026 r. musi trafić do CRU w ciągu 30 dni od jej podpisania. Warto wpisywać umowy na bieżąco, nie czekając na koniec miesiąca.
Kto może wysyłać umowy — role w CRU i ePublink
W systemie CRU obowiązują trzy role — i ważne jest, żeby rozumieć, jak mapują się na pracę w ePublink:
| Rola w CRU MF | Co robi | Jak to działa w ePublink |
| Administrator | Zarządza kontami i uprawnieniami jednostki w CRU | Kierownik jednostki lub jego reprezentant |
| Wprowadzający | Wpisuje dane umów do systemu | Każdy zalogowany pracownik ePublink — automatycznie, bez wniosków w MF |
| Publikujący | Wysyła umowy do rejestru CRU | Tylko pracownicy, którzy wkleili własny klucz API w ePublink |
Upewnij się, że "Publikujący" ma dostęp do wszystkich umów, które ma publikować. Jeśli "Publikujący" ma nadane uprawnienia wyłączenie na poziomie jednego wydziału, będzie mógł publikować umowy z tego wydziały. Aby publikować umowy z całego urzędu (JST), konto publikującego musi mieć uprawnienia nadane na poziomie całej organizacji, a nie tylko wybranego wydziału lub jednostki.
Podobnie jest w przypadku, gdy jednostka korzysta z różnych poziomów widoczności umów. Jeśli "Publikujący" nie będzie posiadał uprawnień, aby widzieć umowę, nie będzie mógł jej opublikować w CRU. "Publikujący" powinien posiadać uprawnienie do zarządzania dokumentami z ograniczonym dostępem oraz z wysokim ograniczeniem dostępu.
Jeśli chcesz wiedzieć, jak zarządzać uprawnieniami użytkowników w ePublink, przejdź do instrukcji dodania użytkownika.
💡 Konto w CRU zakłada się per REGON. Jeśli jesteś JST — pamiętaj, że Gmina i Urząd Gminy to dwa oddzielne podmioty z różnymi numerami REGON. Umowy zawiera Gmina jako osoba prawna, dlatego rekomendujemy złożenie wniosku dla Gminy, a nie dla Urzędu Gminy.
💡 Zdecydowanie rekomendujemy rozdzielenie ról Wprowadzającego i Publikującego — nawet jeśli w jednostce pracuje niewiele osób. Buduje to minimalną kontrolę wewnętrzną i zmniejsza ryzyko błędów przed wysyłką do rejestru publicznego.
Rozpoczęcie integracji z CRU 1 lipca 2026 r.
Poniżej zebraliśmy najważniejsze kwestie, o które często pytają użytkownicy i które warto wiedzieć przed startem integracji.
-
Klucze produkcyjne API do CRU – od kiedy są dostępne
Klucze produkcyjne API do CRU będzie można generować dopiero od 1 lipca. Wynika to z harmonogramu wdrożenia po stronie Ministerstwa Finansów.
Na początku marca MF umożliwiało generowanie klucza – istnieje więc możliwość, że w niektórych jednostkach takie klucze już powstały. Obecnie nie ma jednak pewności, czy będą one działały po uruchomieniu rejestru od 1 lipca. Ministerstwo doprecyzowuje tę kwestię; należy się liczyć z koniecznością wygenerowania nowych kluczy od dnia startu systemu. -
Tryb testowy CRU w ePublink po 1 lipca
Z dniem 1 lipca w module integracji z CRU zniknie domyślna możliwość testowania połączenia w trybie testowym. -
Informacje przed startem CRU
1 lipca planujemy wysłanie pakietu informacji do wskazanych osób w jednostkach – m.in. Skarbników, Sekretarzy oraz Kierowników (zgodnie z nadanymi uprawnieniami w ePublink). -
Jak podchodzić do tworzenia kluczy API – rekomendacje MF
Ministerstwo Finansów przedstawia kilka możliwych modeli pracy z kluczami API w CRU. Warto świadomie wybrać rozwiązanie, które najlepiej odpowiada strukturze jednostki:-
Model 1: Każdy pracownik ma własny klucz API
Każdy publikujący generuje swój indywidualny klucz API i publikuje umowy pod własnym kontem. Zapewnia on pełną rozliczalność czynności, ale wymaga zarządzania większą liczbą kluczy. -
Model 2: Jeden lub kilku pracowników ma klucz API dla całej jednostki (model rekomendowany)
Jeden lub kilku wyznaczonych pracowników posiada klucz API i publikuje umowy w imieniu jednostki. Jest to model rekomendowany przez Ministerstwo Finansów, a także rekomendowany przez Publink– zwłaszcza w wariancie, w którym klucze ma co najmniej dwóch pracowników.
Dzięki temu:-
łatwiej zapewnić ciągłość pracy (urlopy, choroby, nieobecności),
-
zarządzanie dostępami jest prostsze niż przy rozproszonym modelu indywidualnych kluczy dla wszystkich.
-
-
Model 3: Współdzielenie jednego klucza API przez wielu pracowników
Ten model polega na tym, że kilka osób korzysta z tego samego klucza API. Jest to rozwiązanie niezalecane. Utrudnia ono późniejsze wyjaśnianie, kto faktycznie dokonał publikacji oraz osłabia kontrolę wewnętrzną.
-
-
Widoczność danych o publikującym w rejestrze publicznym
Od 1 lipca rusza publiczny rejestr CRU. Warto podkreślić, że:-
w publicznie dostępnym rejestrze nie będzie widoczne imię i nazwisko osoby publikującej umowę,
-
informacje o tym, kto technicznie dokonał publikacji, będą przechowywane wyłącznie w niepublicznej części systemu CRU (dla celów administracyjnych i kontrolnych).
-
Dzięki znajomości powyższych zasad łatwiej zaplanować, kto w jednostce będzie generował klucze API, jak zorganizować proces publikacji umów oraz jak przygotować pracowników do pracy z CRU i ePublink Dokumenty.