Jak opublikować ceny mieszkań w dane.gov.pl – instrukcja dla dewelopera

Udostępnienie cen mieszkań w portalu dane.gov.pl to dla dewelopera jednorazowa konfiguracja i codzienna automatyczna aktualizacja. Poniżej opisujemy proces krok po kroku, na podstawie materiałów przygotowanych przez administratora portalu.

Krok 1. Profil dostawcy i konto edytora

Deweloper zakłada w portalu dane.gov.pl profil dostawcy danych, a osoba odpowiedzialna za publikację rejestruje konto i uzyskuje uprawnienia edytora. Portal udostępnia w tym celu instrukcję w formacie PDF w bazie wiedzy, w dziale „Przydatne materiały”.

Krok 2. Przygotowanie zbioru danych

Dane o cenach przygotowuje się według wzorcowego zakresu danych opublikowanego przez portal (plik XLSX lub CSV w kodowaniu UTF-8). Każdy wiersz opisuje jeden lokal mieszkalny lub dom jednorodzinny, a kolumny obejmują m.in. dane dewelopera, lokalizację inwestycji, ceny za m², ceny całkowite, daty obowiązywania cen oraz ceny części przynależnych.

Krok 3. Plik XML i suma kontrolna MD5

Do automatycznego pobierania danych portal wykorzystuje mechanizm harvestera. Deweloper przygotowuje plik XML, którego struktura jest zgodna ze schematem XSD dostępnym w portalu (otwarte_dane_latest.xsd), oraz plik z sumą kontrolną MD5. Plik XML wskazuje adresy zasobów – codziennych plików z cenami.

Ważne zasady techniczne:

• pliki muszą być dostępne pod stałymi adresami URL, najlepiej w protokole HTTPS,
• suma MD5 musi odpowiadać aktualnej zawartości pliku XML,
• identyfikatory zasobów w pliku XML muszą być unikalne.

Krok 4. Zgłoszenie do administratora portalu

Deweloper kontaktuje się z administratorem portalu ([email protected]), przekazując m.in. dane osoby z uprawnieniami edytora, adres URL pliku XML i pliku MD5 oraz częstotliwość aktualizacji. Po konfiguracji harvester regularnie pobiera dane bez udziału dewelopera.

Krok 5. Codzienna aktualizacja

Od tego momentu wystarczy, aby pliki pod stałymi adresami były aktualizowane każdego dnia. Najwygodniej zapewnić to automatycznie – tak, aby zmiana ceny na stronie dewelopera trafiała do portalu bez ręcznego przygotowywania plików.

Automatyzacja w WordPress

Moduł Jawne ceny dla WordPress wykonuje kroki 2, 3 i 5 automatycznie: tworzy codzienny plik CSV w układzie wzorcowym, plik XML zgodny ze schematem XSD oraz plik MD5 pod stałymi adresami. Ekran „Status zgodności” pokazuje, czy wszystkie wymagania są spełnione, a dziennik eksportów i powiadomienia e-mail informują o ewentualnych problemach.

Od 11 listopada 2026 r. format danych staje się obowiązkowy – więcej w artykule Jednolity format danych o cenach mieszkań od 11 listopada 2026 r.

Źródła

• dane.gov.pl – Udostępnianie danych dotyczących cen mieszkań, informacje dla deweloperów