Błędy walidacji dane.gov.pl — przyczyny i rozwiązania
Aktualizacja: 16.07.2026 · Operator Oferty
Osiem najczęstszych powodów odrzucenia raportu cen, w formacie: problem → przyczyna → rozwiązanie. Od niezgodnej sumy MD5 po rozjazd raportu ze stroną.
Zanim zaczniesz diagnozę
Raport dobowy składa się z trzech elementów: CSV w układzie art. 19a–19b, XML metadanych (schemat harvester 1.13) i sum kontrolnych MD5. Walidator odrzuca całość, gdy dowolny element jest niespójny — dlatego diagnozę zawsze zaczynaj od pytania, który z trzech elementów zawiódł. Dokładne komunikaty walidatora różnią się zależnie od przypadku; tam, gdzie ich treść ma znaczenie, zostawiamy oznaczone miejsca do uzupełnienia.
BŁĄD 01 Suma MD5 się nie zgadza
PrzyczynaPlik został zmieniony po wyliczeniu sumy kontrolnej — najczęściej przez ręczną poprawkę w arkuszu albo ponowny zapis, który zmienił zawartość binarną. Zdarza się też wyliczenie sumy z innej wersji pliku niż wysłana.
RozwiązanieWylicz sumę MD5 z finalnej wersji pliku, po ostatnim zapisie, i publikuj oba elementy razem. W procesie automatycznym sumy liczy generator — zawsze na końcu.
BŁĄD 02 Polskie znaki zamieniają się w krzaki
PrzyczynaPlik zapisany w innym kodowaniu znaków niż oczekiwane. Eksport z arkusza kalkulacyjnego potrafi po cichu użyć kodowania systemowego zamiast UTF-8.
RozwiązanieUstaw kodowanie jawnie przy eksporcie i nie edytuj pliku „na szybko” w innym programie. Po zmianie narzędzia — sprawdź plik testowo przed publikacją.
BŁĄD 03 Walidator nie rozpoznaje kolumn
PrzyczynaNiewłaściwy separator pól — arkusze potrafią eksportować średnik albo przecinek w zależności od ustawień regionalnych, a bywa też mieszanie separatorów w jednym pliku.
RozwiązanieUstal separator zgodny z wymaganiami schematu i zablokuj go w procesie eksportu. Komunikat walidatora: [KOMUNIKAT — dostarczy zamawiający].
BŁĄD 04 Układ kolumn niezgodny z ustawą
PrzyczynaNagłówki lub kolejność kolumn odbiegają od układu wynikającego z art. 19a–19b — np. plik powstał z własnego szablonu „z pamięci”.
RozwiązaniePracuj na szablonie zgodnym z aktualnym schematem i nie zmieniaj nagłówków. Wzór struktury: Wzór CSV: ceny mieszkań.
BŁĄD 05 Metadane XML odrzucone
PrzyczynaPlik XML metadanych niezgodny ze schematem harvester 1.13 — brakujące pola, złe wartości albo stary szablon metadanych.
RozwiązanieGeneruj XML automatycznie z tych samych danych co CSV i aktualizuj szablon przy każdej zmianie schematu. Komunikat walidatora: [KOMUNIKAT — dostarczy zamawiający].
BŁĄD 06 Brak raportu w dobie
PrzyczynaPublikacja oparta na czynności ręcznej: urlop, weekend, awaria komputera — i doba mija bez raportu.
RozwiązanieZautomatyzuj publikację o stałej porze i dodaj kontrolę wykonania z alertem. Raport publikuje się raz na dobę — bez wyjątków na dni wolne.
BŁĄD 07 Błędny format liczb lub dat
PrzyczynaCeny z odstępami, symbolem waluty albo przecinkiem/kropką niezgodnie ze schematem; daty w formacie lokalnym zamiast wymaganego.
RozwiązanieFormatuj liczby i daty na etapie generowania pliku, nie w arkuszu. Po każdej zmianie ustawień regionalnych sprawdź plik testowo.
BŁĄD 08 Raport przechodzi, ale ceny różnią się od strony
PrzyczynaTo nie błąd walidatora, a najdroższy z rozjazdów: raport i strona inwestycji są zasilane z osobnych źródeł. Cena niższa opublikowana na stronie wiąże dewelopera.
RozwiązanieWyznacz jedno źródło cen dla strony, historii i raportu oraz włącz monitoring porównujący kanały. Tak działa Operator Oferty.
Co dalej
Jednorazowa naprawa pliku nie chroni przed kolejnym odrzutem — a jesienią 2026 r. schemat zmieni się dla wszystkich (szczegóły: jednolity format danych 2026). Trwałe rozwiązanie to generator, który składa i waliduje pliki automatycznie: Raport i zgodność.