Najczęstsze błędy CRU w module Dokumenty
Poniżej znajdziesz rozwiązania dwóch najczęstszych błędów związanych z publikacją do CRU z modułu Dokumenty. Przy weryfikacji klucza API oraz odrzucenie kontrahenta z dwoma podmiotami pod jednym REGON.
Spis treści
Dlaczego pojawia się błąd przy weryfikacji klucza API CRU?
Jeśli po dodaniu klucza API strony publikującej program zwraca błąd weryfikacji, w większości przypadków przyczyna leży po stronie sposobu skopiowania lub konfiguracji klucza w portalu CRU, a nie po stronie Publink. Sprawdź poniższe punkty po kolei.
CRU pokazuje pełny klucz API tylko raz — w oknie, które pojawia się bezpośrednio po jego wygenerowaniu. Kopiowanie klucza później (np. z listy lub historii kluczy) daje wartość skróconą, a nie pełny klucz — i to najczęstsza przyczyna błędu weryfikacji.
Jeśli weryfikacja klucza się nie powiedzie, sprawdź kolejno:
- Skąd skopiowałeś klucz? Wygeneruj nowy klucz w CRU, nie zamykaj okienka z pełnym kluczem, skopiuj go przyciskiem kopiowania (nie zaznaczeniem myszką), wklej w Publink i od razu kliknij „Weryfikuj klucz API".
- Jaki status ma klucz w CRU? W CRU: Moje Dane → Klucz API → historia kluczy. Klucz musi mieć status Aktywny — traci ważność po 6 miesiącach lub jest automatycznie blokowany po utracie roli Publikującego.
- Dla której jednostki działa klucz? Upewnij się, że masz rolę Publikującego w CRU dla tej samej jednostki, dla której wgrywasz klucz w Publink — a nie dla innej jednostki w ramach powiatu, i nie tylko rolę podglądu.
- Czy to na pewno środowisko produkcyjne? Sprawdź adres w pasku przeglądarki po zalogowaniu do CRU — jeśli widzisz
jsfp-cru-test.mf.gov.pllub cokolwiek ze słowem „test", to konto testowe Ministerstwa Finansów, a taki klucz nigdy nie zadziała na produkcji.
💡 Najważniejszy jest poprawny klucz + REGON podmiotu publikującego — sam wybór „strony publikującej" w module ma znaczenie drugorzędne, bo to system CRU waliduje przesłane dokumenty względem danych przypisanych do klucza API.
Dlaczego CRU odrzuca kontrahenta, gdy pod jednym REGON w GUS są dwa podmioty?
Jeśli CRU odrzuca kontrahenta mimo poprawnych danych, sprawdź, czy ten NIP/REGON nie jest współdzielony przez dwie zarejestrowane w GUS działalności (np. firmę i gospodarstwo rolne) — to ograniczenie systemu CRU, a nie błąd w Publink.
To ograniczenie leży po stronie systemu CRU Ministerstwa Finansów, nie po stronie Publink. Zgłosiliśmy sprawę do MF i czekamy na rozwiązanie — do tego czasu, niestety, nie mamy możliwości obejścia tego ograniczenia.
Jak to naprawić? Dodaj tę konkretną umowę ręcznie, bezpośrednio w przeglądarkowej wersji CRU (poza Publink) — tylko tam można wskazać właściwy z dwóch podmiotów. Umowa dodana w ten sposób nie pojawi się jeszcze automatycznie w Publink Dokumenty, ale możesz ją później pobrać do systemu przez zakładkę „Pobrane z CRU".