Raportowanie cen mieszkań do dane.gov.pl: jak to działa
- Harvester dane.gov.pl
Automat portalu, który regularnie odwiedza adres zapisany w zbiorze danych i pobiera aktualny plik. Nie czyta poczty dewelopera i nie loguje się nigdzie. Jeśli adres się zmieni, plik wymaga hasła albo wczorajszy adres zwraca błąd, zbiór przestaje się aktualizować, nawet gdy po Twojej stronie „przecież wysłaliśmy plik”.
Dlaczego to ma tak działać
Art. 19b ustawy deweloperskiej każe przekazywać dane raz na dobę, a przy tysiącach inwestycji w całym kraju nikt nie rozpakowuje maili z załącznikami. Dlatego portal działa w drugą stronę: nie czeka, aż deweloper coś wyśle, tylko sam zagląda pod adres, który wskazałeś. Z tego wynika cała reszta, czyli powód, dla którego adres musi być stały, plik ogólnodostępny, a eksport automatyczny.
Obowiązek publikacji cennika na stronie i prowadzenia historii (art. 19a) opisujemy w przewodniku o jawności cen mieszkań. Tutaj zajmujemy się drugą połową, czyli tym, co dzieje się między Twoją stroną a portalem.
Co leży pod adresem
Wtyczka wystawia pod stałymi adresami dwa pliki, które zgłaszasz do portalu, a razem z nimi codziennie nowy plik z cenami:
| Plik | Co zawiera | Kto go czyta |
|---|---|---|
| XML (dataset-latest.xml) | Metadane zbioru, jego identyfikator (ExtIdent), tytuł i opis, częstotliwość aktualizacji i listę dziennych plików CSV | Portal, przy każdym pobraniu |
| MD5 | Suma kontrolna XML, po której portal poznaje, że coś się zmieniło | Portal |
| CSV (jeden na dzień) | Lokale z cenami, statusami i dodatkami, w układzie 58 kolumn ze wzoru Ministerstwa | Portal, a Ty możesz otworzyć w arkuszu |
Zgłaszasz tylko XML i MD5, bo to one mają stały adres, na przykład:
https://twoja-domena.pl/wp-content/uploads/jawnosc-cen/datasets/dataset-latest.xml
https://twoja-domena.pl/wp-content/uploads/jawnosc-cen/datasets/dataset-latest.md5CSV-ów nie zgłaszasz osobno, bo wskazuje je XML. Każdy dzień ma własny plik, a stare zostają, więc portal nie widzi tylko „stanu na dziś”, ale cały ciąg zmian. To jest odpowiedź na pytanie, jak historia cen trafia do dane.gov.pl: nie w jednej kolumnie, tylko jako kolejne dni. Dlatego nie wolno kasować plików dziennych z katalogu wtyczki.
Co wtyczka robi sama, a co ty
Plik na dany dzień powstaje sam, po 00:05, przy pierwszej wizycie na stronie albo w panelu. Nie ustawiasz crona na hostingu ani nie konfigurujesz niczego w wp-config. Przed publikacją plik jest sprawdzany oficjalnym schematem dane.gov.pl i wzorem CSV Ministerstwa, a jeśli ma błędy, nie zastępuje ostatniej poprawnej wersji, więc portal w najgorszym razie dostaje wczorajszy plik. Gdy eksport się nie uda, wtyczka wysyła maila (najwyżej raz na dobę), a po dwóch dniach bez poprawnego pliku pokazuje czerwony komunikat w panelu.
Po Twojej stronie zostaje jednorazowe zgłoszenie i codzienne utrzymanie cen. Zgłoszenie to konto w dane.gov.pl i dwa maile na kontakt@dane.gov.pl. Pierwszy z prośbą o profil dostawcy, uprawnienia edytora i utworzenie zbioru, drugi z adresami plików. Całość z treściami maili jest w tekście jak zgłosić dane na dane.gov.pl.
Skąd biorą się lokale
Dwustu mieszkań nikt nie przepisuje po jednym. Wgrywasz cennik z Excela albo CSV, wtyczka rozpoznaje kolumny po nagłówkach (wymagany jest tylko numer lokalu) i pokazuje listę zmian, zanim cokolwiek zapisze: „A1: cena lokalu 897 770, zmienia się na 907 770”, „A3: nowy lokal”. Dopiero po kliknięciu zapisujesz. Import nigdy nie usuwa lokali, a puste komórki niczego nie kasują.
Od tego momentu źródłem prawdy jest panel. Obniżka lokalu aktualizuje tabelę na stronie, dopisuje wiersz do historii cen i trafia do następnego pliku. Arkusz zostaje kopią, a nie drugim cennikiem, o którego synchronizacji ktoś zapomni.
Do pliku dla portalu domyślnie idą lokale dostępne i zarezerwowane, a sprzedane nie. Nie wysyłają się też liczba pokoi, piętro, karty PDF, rzuty, mapa, dane nabywców ani nazwy użytkowników WordPressa.
Kontrola: co ci to daje poza spokojem
Historia eksportów trzyma datę, godzinę, status i rozmiar pliku, a zakładka „Dziennik zmian cen” w logach pokazuje każdą zmianę ceny, dodatków i statusu, z datą i nazwą użytkownika. To odpowiedź na pytanie „czy raportowaliście także 12 marca”, i to bez przeszukiwania skrzynki mailowej. Plik, który nie przeszedł walidacji, widać w panelu od razu, zanim portal zgłosi pusty zasób.
Jeśli zmieniasz domenę, adresy plików zmieniają się razem z nią i trzeba zgłosić nowe. Licencję wtyczki przenosimy na nową domenę na prośbę.
Ile to kosztuje
Abonamenty za samo raportowanie to, według publicznych cenników z 28 września 2026 r., od 169 do 412,50 zł netto miesięcznie, czyli od około 2 do 5 tysięcy złotych rocznie. Licencja wtyczki to 690 zł netto za rok przy jednej domenie i obejmuje publikację na stronie, historię i eksport. Instalacja przez nasz zespół jest za 150 zł netto. Strona inwestycji od zera, z rokiem licencji w cenie, to pakiet od 3 500 zł netto. Pełne zestawienie: ile kosztuje wtyczka do jawności cen.
Zanim uznasz, że dane.gov.pl jest ogarnięte
- XML i MD5 otwierają się w przeglądarce bez logowania i zaczynają się od https.
- Adresy w zbiorze są identyczne z adresami w panelu wtyczki.
- ExtIdent jest zablokowany i nie był zmieniany po zgłoszeniu.
- Walidacja w panelu pokazuje „OK”, a log eksportów ma wpisy z ostatnich dni.
- Cena na stronie i w pliku to ta sama kwota dla tego samego numeru lokalu.
- Tryb testowy jest wyłączony, a stare pliki dzienne nie zostały skasowane.
FAQ
Czy muszę mieć konto na dane.gov.pl, skoro mam wtyczkę?
Tak. Wtyczka wystawia pliki i odświeża je codziennie, ale profil dostawcy, uprawnienia edytora i zbiór powstają na Twoją prośbę po mailu do kontakt@dane.gov.pl. Bez tego portal nie wie, pod jaki adres iść.
Czy wystarczy wysyłać XML mailem?
Nie. Portal pobiera plik spod adresu zapisanego w zbiorze. Mail służy do zgłoszenia adresów, a nie do codziennej dostawy danych.
Czy zgłaszam też pliki CSV?
Nie. Zgłaszasz XML i jego MD5, a XML wskazuje portalowi dzienne pliki CSV.
Co jeśli zmienię domenę?
Adresy plików się zmienią, więc zgłoś nowe w portalu. Nie zmieniaj ExtIdent, bo to oznaczałoby nowy zbiór. Licencję przenosimy na nową domenę na prośbę.
Czy sam plik na FTP zamyka obowiązek?
Nie. Plik załatwia raportowanie do portalu (art. 19b), ale kupujący i kontrola otwierają stronę inwestycji, gdzie muszą być ceny i historia (art. 19a). Warianty dla Drupala i Joomli: jawność cen na Drupal i Joomla.
Co z nowym formatem danych od listopada 2026?
Od 11 listopada 2026 r. dane trzeba przekazywać w strukturze określonej rozporządzeniem ministra cyfryzacji, którego projekt był w konsultacjach pod koniec września. Eksport w licencji dostosowujemy do nowego wzoru, a adresy plików zostają te same.
Ile kosztuje automatyczne raportowanie?
Od 690 zł netto za rok, bez limitu lokali. Pakiety i liczba domen: cennik.
Raportowanie do dane.gov.pl
XML, CSV i MD5 pod stałym URL - harvester dane.gov.pl pobiera je sam.
Od 690 zł / rok