Jak raportować ceny mieszkań do dane.gov.pl: instrukcja krok po kroku (2026)

Raportowanie cen mieszkań do dane.gov.pl polega na tym, że deweloper raz na dobę udostępnia na swoim serwerze plik z aktualnymi cenami, a portal sam go pobiera przez plik XML ze spisem wszystkich dotychczasowych dni. Żeby to uruchomić, trzeba przejść trzy etapy: założyć konto na dane.gov.pl, uzyskać od ministerstwa profil dostawcy danych i poprosić o utworzenie „źródła danych” z adresem pliku XML.

Instrukcja opiera się na materiałach Ministerstwa Cyfryzacji (stan na wrzesień 2026 r.) i na zgłoszeniach, które przeprowadzaliśmy dla deweloperów. Tam, gdzie oficjalne dokumenty milczą, piszemy wprost, że to nasza praktyka.

Jak działa raportowanie cen do dane.gov.pl

Art. 19b ustawy deweloperskiej każe przekazywać dane z cennika „raz na dobę ministrowi właściwemu do spraw informatyzacji”. Ministerstwo zbudowało do tego mechanizm automatycznego zasilania: deweloper nie wysyła plików, tylko wystawia je pod stałymi adresami, a portal pobiera je sam. Warto znać kilka pojęć, bo pojawiają się w korespondencji z ministerstwem:

Etap A: konto na dane.gov.pl

Na dane.gov.pl zakładasz zwykłe konto użytkownika. Ministerstwo oczekuje, że będzie to imienny adres e-mail w domenie firmy, np. anna.nowak@twoja-inwestycja.pl, a nie adres ogólny ani prywatny. Jeśli firma nie ma takiego adresu, można użyć innego, dopisując w zgłoszeniu potwierdzenie braku adresu w domenie służbowej i zapoznania się z § 10 pkt 3 i 4 regulaminu portalu.

Etap B: profil dostawcy i uprawnienia edytora

Po założeniu konta piszesz na kontakt@dane.gov.pl prośbę o utworzenie profilu dostawcy dla dewelopera i nadanie uprawnień edytora. Zgodnie z instrukcją ministerstwa w wiadomości podajesz:

• pełną nazwę dewelopera i jego adres,
• adres strony internetowej,
• ogólny adres e-mail i numer telefonu firmy (faks opcjonalnie),
• numer REGON,
• adres do doręczeń elektronicznych, jeśli firma go ma,
• imię i nazwisko edytora oraz jego imienny, służbowy adres e-mail (ten sam, na który założono konto).

Ministerstwo nie podaje, ile trwa rozpatrzenie zgłoszenia. U deweloperów, z którymi pracowaliśmy, trwało to od kilku dni do kilku tygodni. Ten czas warto wykorzystać na przygotowanie strony z cenami i pliku XML – żeby w dniu nadania uprawnień od razu wysłać zgłoszenie źródła danych.

Etap C: źródło danych – plik XML i suma MD5

To najważniejszy etap. Na swoim serwerze wystawiasz plik XML zgodny ze schematem portalu (przestrzeń nazw urn:otwarte-dane:harvester:1.13) oraz plik z sumą kontrolną MD5 tego XML-a. Uproszczony szkielet według szablonu ministerstwa v1.14:

<ns2:datasets xmlns:ns2="urn:otwarte-dane:harvester:1.13">
  <dataset status="published">
    <extIdent>stały identyfikator zbioru, do 36 znaków</extIdent>
    <title><polish>Ceny ofertowe mieszkań dewelopera …</polish><english>…</english></title>
    <description><polish>…</polish><english>…</english></description>
    <updateFrequency>daily</updateFrequency>
    <hasHighValueData>true</hasHighValueData>
    <categories><category>ECON</category></categories>
    <resources>
      <resource status="published">
        <extIdent>identyfikator zasobu, np. z datą _20260929</extIdent>
        <url>https://twoja-inwestycja.pl/…/Ceny-ofertowe-…-2026-09-29.csv</url>
        <title>…</title>
        <availability>local</availability>
        <dataDate>2026-09-29</dataDate>
      </resource>
      … zasoby z wszystkich wcześniejszych dni …
    </resources>
    <tags><tag lang="pl">ceny mieszkań</tag></tags>
  </dataset>
</ns2:datasets>

W prawdziwym pliku jest więcej pól (m.in. flagi hasDynamicData, hasResearchData, containsProtectedData), ale zasady, które najczęściej decydują o przyjęciu zgłoszenia, są cztery:

1. Adres każdego zasobu zaczyna się od https://. Schemat XSD portalu nie dopuszcza innych adresów – jeden adres z http:// wystarczy, żeby cały plik odpadł.
2. extIdent się nie zmienia. Instrukcja ministerstwa mówi, że po nadaniu identyfikatora nie należy go modyfikować. Nowy identyfikator to dla portalu nowy obiekt, a stary trafia do kosza.
3. Plik XML narasta. Obiekty, których identyfikatorów nie ma w pliku, portal usuwa. Dlatego XML zawiera zasoby z wszystkich dotychczasowych dni, a nie tylko dzisiejszy plik.
4. Suma MD5 leży obok XML-a. Instrukcja: adres pliku MD5 ma być taki sam jak pliku XML, ale z rozszerzeniem .md5. W praktyce walidator dopisuje .md5 do adresu XML (dane.xml → dane.xml.md5) i sprawdza, czy pod tym adresem jest suma.

Gdy plik jest gotowy, a masz już uprawnienia edytora, piszesz drugi raz na kontakt@dane.gov.pl z prośbą o utworzenie źródła danych. Według dokumentu ministerstwa podajesz: imię i nazwisko zgłaszającego, nazwę dostawcy zgodną z profilem, adres URL pliku XML i pliku MD5, adresy e-mail edytorów i częstotliwość aktualizacji – codziennie. Pierwsze zasilenie następuje po włączeniu źródła przez administratora, a kolejne importy – raz dziennie.

Co jest w pliku z cenami

Zasób to plik z cenami z jednego dnia. Ministerstwo rekomenduje, żeby każdy plik odpowiadał jednemu dniowi, i udostępnia wzorcowy zakres danych jako CSV i XLSX (stan na 22 lipca 2025 r.). Wzorcowy CSV ma 58 kolumn, separator średnik i kodowanie UTF-8. Kolumny układają się w grupy:

Jeden wiersz to jeden lokal lub dom. Pola, które nie dotyczą lokalu (np. brak komórki), dziś zwykle zostają puste. Projekt rozporządzenia ministra cyfryzacji, które ma obowiązywać od 11 listopada 2026 r., przewiduje w takich polach znak „X”, a do tego 57 pól (bez numeru faksu) i dokładne formaty: daty RRRR-MM-DD, kwoty z dwoma miejscami po przecinku, NIP i KRS jako 10 cyfr. Szczegóły są w artykule o nowej strukturze danych od 11 listopada 2026 r.

Wypełniony przykład w obu układach – do 10 listopada i od 11 listopada 2026 r. – pobierzesz z artykułu wzór pliku CSV dla dane.gov.pl, a to, co wpisać przy miejscach postojowych, komórkach i cenie łącznej, rozpisujemy w artykule o cenie łącznej i dodatkach w raporcie.

Codzienna praca: co musi się dziać każdego dnia

Ustawa mówi „raz na dobę”, a nie „po każdej zmianie ceny”. W opinii do projektu nowelizacji z 2026 r. Polski Związek Firm Deweloperskich proponował raportowanie tylko przy pierwszej publikacji i przy zmianie cen, ale ta propozycja nie weszła do ustawy. Dlatego codziennie powinno się dziać to samo:

1. Nowy plik z cenami

   Powstaje plik z bieżącym stanem cennika, z datą w nazwie, także jeśli ceny się nie zmieniły.

2. Nowy zasób w XML

   Do pliku XML dochodzi zasób wskazujący nowy plik (nowy extIdent z datą, adres https, dataDate z dzisiejszą datą). Wcześniejsze zasoby zostają.

3. Nowa suma MD5

   Po zmianie XML-a przelicza się jego sumę MD5 – inaczej portal uzna plik za niespójny.

4. Import przez portal

   Harvester dane.gov.pl pobiera XML, porównuje go z poprzednim i publikuje nowy zasób.

Najważniejsze, żeby dane w pliku były tymi samymi cenami, które są na stronie. Dwa niezależne cenniki – jeden na stronie, drugi w arkuszu do raportu – to najprostsza droga do rozbieżności. O terminach aktualizacji strony i raportu piszemy w tekście jak często aktualizować ceny mieszkań.

Jak sprawdzić, że portal pobiera Twoje dane

Po uruchomieniu źródła danych wyszukaj swoją firmę na dane.gov.pl i sprawdź, czy przy zbiorze pojawiają się kolejne zasoby z bieżącymi datami. Jeśli coś jest nie tak, trzy polecenia w terminalu pokażą, gdzie szukać przyczyny:

# 1. Czy XML odpowiada kodem 200 i ma typ XML?
curl -sI https://twoja-inwestycja.pl/sciezka/do/raportu.xml
HTTP/1.1 200 OK
Content-Type: application/xml

# 2. Czy suma MD5 zgadza się z plikiem XML?
curl -s https://twoja-inwestycja.pl/sciezka/do/raportu.xml | md5sum
curl -s https://twoja-inwestycja.pl/sciezka/do/raportu.xml.md5

# 3. Czy dzisiejszy plik z cenami jest dostępny dla portalu?
curl -s -o /dev/null -w "%{http_code}" https://twoja-inwestycja.pl/…/Ceny-ofertowe-…-2026-09-29.csv
200

Oba wyniki z punktu 2 muszą być identyczne. Każdy kod inny niż 200 w punktach 1 i 3 (403, 404, 500, przekierowanie) oznacza problem po stronie serwera – omawiamy je po kolei w artykule błędy 403, 404 i „https://.*” na dane.gov.pl.

Po zakończeniu sprzedaży i po dwóch latach raportowania

Obowiązki z ustawy trwają do przeniesienia praw z ostatniej umowy w inwestycji – nie kończą się z ostatnią rezerwacją ani z podpisaniem ostatniej umowy deweloperskiej. Do tego dnia ceny i ich historia zostają na stronie, a raport powstaje codziennie, także gdy w ofercie nie ma już wolnych lokali.

Ministerstwo wydało dwie rekomendacje, o których rzadko się pamięta:

• Koniec sprzedaży inwestycji – w opisie zbioru danych dopisz, że sprzedaż zakończyła się z konkretnym dniem. Jeśli źródło danych obejmuje tylko tę inwestycję, napisz na kontakt@dane.gov.pl o jego dezaktywację (adres pliku XML i nazwa dostawcy).
• Limit 1000 zasobów – w jednym pliku XML powinno być najwyżej 1000 zasobów. Przy codziennym pliku to około 2 lata i 9 miesięcy. Z wyprzedzeniem trzeba poprosić o nowe źródło danych, a nowy plik nie może dublować danych ze starego.

1. Sprawdź, czy obowiązek się skończył

   Liczy się przeniesienie praw z ostatniej umowy w inwestycji. Do tego dnia nic nie wyłączaj.

2. Dopisz zakończenie sprzedaży w opisie zbioru

   W opisie zbioru danych w pliku XML dodaj zdanie w rodzaju „Sprzedaż inwestycji … zakończyła się z dniem …”. Przy danych wgrywanych ręcznie zmieniasz opis w panelu portalu.

3. Poproś o dezaktywację źródła, jeśli obejmowało tylko tę inwestycję

   Napisz na kontakt@dane.gov.pl: że źródło trzeba dezaktywować, adres pliku XML i nazwę dostawcy dokładnie jak w profilu. Jeśli w tym samym XML są inne inwestycje w sprzedaży, źródło zostaje.

4. Poczekaj na potwierdzenie

   Administratorzy portalu informują dostawcę o dezaktywacji. Dopiero potem wyłączaj pliki raportu albo domenę inwestycji.

We wtyczce DeweloperCeny (od wersji 2.25) wpisujesz datę zakończenia sprzedaży przy inwestycji w panelu „dane.gov.pl”, a wtyczka sama dopisuje to zdanie do opisu zbioru w XML – codzienne pliki dalej powstają. Co zrobić z osobną domeną inwestycji po sprzedaży, opisujemy w artykule osobna domena dla inwestycji czy podstrona.

Ręcznie czy automatycznie?

Da się to wszystko robić ręcznie: codziennie eksportować cennik do CSV, wgrywać plik na serwer, dopisywać zasób w XML i przeliczać MD5. To jednak 365 czynności w roku, w każdy weekend i święto, a jedna pomyłka w adresie albo dacie wystarczy, żeby portal nie pobrał danych. Dlatego warto zautomatyzować raport – na własnym systemie albo wtyczką. Jeśli cennik prowadzisz w arkuszu, zobacz, jak przenieść cennik z Excela do raportu. Porównanie kosztów i ryzyka jest w artykule automatyzacja raportowania cen w WordPressie.