Błędy rejestracji DPP Registry – diagnoza i poprawki

Najpierw rozpoznaj etap błędu

Registry ma dwa odrębne procesy, które mogą zakończyć się niepowodzeniem:

1. enrolment i weryfikacja organizacji,
2. rejestracja i walidacja konkretnego DPP.

Błąd certyfikatu organizacji nie zostanie naprawiony zmianą danych produktu. Błąd UPI lub schematu DPP nie wymaga ponownego enrolmentu firmy. W logach zapisuj etap, correlation ID, czas, kanał zgłoszenia i niezmieniony komunikat źródłowy.

Błędy formularza organizacji

Zmiana danych organizacji po rozpoczęciu weryfikacji może wymagać wygenerowania nowej deklaracji.

Błędy deklaracji, QSeal i QES

Oficjalny przewodnik opisuje między innymi następujące przyczyny odrzucenia:

• brak pieczęci instytucjonalnej Komisji
• brak kontrasygnaty albo kontrpieczęci organizacji
• zmiana PDF po nadaniu pieczęci Komisji
• użycie innego pliku niż deklaracja pobrana z Registry
• niekwalifikowany podpis albo pieczęć
• profil podpisu niezgodny z wymaganym PAdES Baseline
• nieważny, odwołany albo niezaufany certyfikat
• brak zgodności danych certyfikatu z formularzem organizacji

Nie edytuj, nie drukuj ponownie do PDF i nie scalaj deklaracji. Jedyną oczekiwaną zmianą jest dodanie właściwego kwalifikowanego podpisu albo pieczęci do oryginalnego dokumentu.

Błędy pliku przed wysłaniem

Aktualny User Guide wskazuje następujące ograniczenia przepływu plikowego:

• format XML albo JSON
• maksymalnie 100 rejestracji w jednym zgłoszeniu
• maksymalny rozmiar pliku 1 GB
• nazwa pliku może zawierać litery, cyfry, kropkę, podkreślenie i łącznik
• spacje, ukośniki i sekwencje nawigacji katalogów są odrzucane

Jeżeli jeden DPP w zgłoszeniu zbiorczym zawiera błąd, cały plik jest odrzucany. Przed przesłaniem wykonuj lokalną walidację każdego rekordu oraz całej paczki.

Błędy walidacji DPP

HTTPS i przekierowania

Przewodnik wymaga adresu zaczynającego się od https://. Sam poprawny zapis nie wystarcza — Registry musi móc odczytać zasób. Typowe problemy to pętla przekierowań, przejście z HTTPS do HTTP, blokada automatycznych klientów, nieprawidłowy certyfikat TLS albo odpowiedź o nieobsługiwanym rozmiarze.

Przed wysłaniem sprawdź:

• odpowiedź bez logowania i bez sesji użytkownika
• ważny certyfikat TLS i pełny łańcuch certyfikatów
• brak przekierowania do mniej bezpiecznego protokołu
• stabilny status odpowiedzi i rozsądny czas ładowania
• zgodność treści pod UPI z wersją przekazywaną do Registry

Błąd danych czy błąd przejściowy?

Nie ponawiaj wszystkich zgłoszeń automatycznie.

• błędy schematu, duplikatu i nieprawidłowego UPI są deterministyczne — wymagają korekty danych
• chwilowa niedostępność walidacji lub usługi może uzasadniać ponowienie po sprawdzeniu wcześniejszego statusu
• timeout po wysłaniu nie dowodzi porażki — najpierw ustal wynik po correlation ID
• nie twórz nowego UPI tylko po to, aby ominąć błąd wcześniejszego zgłoszenia

Obecne ograniczenie dla baterii

Oficjalny User Guide w wersji 1.01 informuje, że skuteczna rejestracja DPP baterii nie jest jeszcze dostępna, ponieważ katalog semantyczny pozostaje w przygotowaniu. Komunikatu wynikającego z niedostępnego schematu nie należy interpretować jako dowodu, że dane firmy są błędne.

Przed eskalacją sprawdź bieżącą dokumentację właściwej grupy produktowej oraz środowisko, w którym wykonujesz operację.

Minimalny raport błędu dla zespołu

• środowisko: testowe albo produkcyjne
• organizacja i grupa produktu bez ujawniania danych wrażliwych
• kanał: formularz, plik albo API
• data, czas i correlation ID
• UPI lub jego bezpieczny identyfikator wewnętrzny
• status oraz pełny kod i komunikat błędu
• wersja schematu i wersja opublikowanego DPP
• liczba rekordów w paczce
• podjęte próby i ich wyniki

Tak przygotowany raport pozwala odróżnić błąd modelu danych od problemu po stronie Registry i zachowuje audytowalność operacji.