Jak zautomatyzować raportowanie cen do dane.gov.pl?

Codzienne raportowanie cen mieszkań do dane.gov.pl automatyzujemy, gdy program sam tworzy pliki z bieżącej oferty, a dane.gov.pl je pobiera. Możemy użyć własnego skryptu albo PanelDlaDewelopera.pl. W obu przypadkach musimy mieć profil dostawcy, zgłosić pliki do sprawdzenia i upewnić się, że cenniki z kolejnych dni trafiają do dane.gov.pl.

Codzienne raportowanie cen: odpowiedź w 60 sekund

• Wybieramy jedno źródło cen. Z niego program pobiera zatwierdzoną ofertę.
• Wybieramy własny skrypt albo Panel. Własny program wymaga stałej opieki informatyka.
• Zakładamy profil dostawcy. Jeżeli już raportujemy, najpierw sprawdzamy obecny profil i zbiór.
• Tworzymy pliki pod stałymi adresami. Cennik i pliki potrzebne do jego pobrania muszą być zgodne z wymogami.
• Składamy wniosek o automatyczne zasilanie. Podajemy dane dostawcy, adresy plików i częstotliwość „codziennie”.
• Czekamy na sprawdzenie i podłączenie. Sam wysłany mail nie włącza automatu.
• Sprawdzamy, czy wszystko działa. Kontrola obejmuje daty, pełną ofertę i ceny widoczne w dane.gov.pl.

Dlaczego automatyzacja raportowania cen wymaga sprawdzenia całej oferty?

Załóżmy, że we wtorek dodajemy do sprzedaży drugi etap inwestycji: 12 mieszkań. W ofercie mamy teraz 40 lokali, ale program nadal pobiera tylko pierwszy etap. Codzienny plik powstaje bez błędu, choć zawiera zaledwie 28 mieszkań.

Dlatego przed startem sprawdzamy, czy pełna oferta trafia do dane.gov.pl. Sam komunikat „zadanie wykonane” nie pokaże nam braku drugiego etapu.

Art. 19b ust. 1 ustawy deweloperskiej wymaga, by dane trafiały do dane.gov.pl raz na dobę, także w dni bez zmiany cen. Osobno art. 19a ust. 2 nakazuje zmieniać informacje na stronie z dniem zmiany ceny. Czyli nową cenę pokazujemy na stronie tego samego dnia, a dane do dane.gov.pl przekazujemy codziennie. Podstawa prawna: ustawa deweloperska, Dz.U. 2026 poz. 880.

Zakres obowiązków, terminy i skutki naruszeń opisujemy w przewodniku po przepisach o jawności cen. Tutaj przechodzimy przez kroki potrzebne do startu automatu.

Jak zautomatyzować raportowanie cen do dane.gov.pl krok po kroku?

Krok 1. Wybieramy źródło cen i sprawdzamy całą ofertę

Zaczynamy od wyboru miejsca, w którym trzymamy zatwierdzone ceny. Może to być arkusz albo program do obsługi oferty.

Przed startem sprawdzamy liczbę lokali i ich oznaczenia. Każdy lokal musi należeć do właściwej firmy i inwestycji. W przykładzie z drugim etapem mamy 40 mieszkań, więc od razu pytamy, skąd w pliku tylko 28 pozycji.

Jedno źródło cen może też zasilać tabelę mieszkań na stronie. Sposób pracy biura sprzedaży i zasady zmiany ceny opisujemy w poradniku o utrzymaniu tej samej oferty w biurze, na stronie i w raportowaniu.

Krok 2. Wybieramy własny skrypt albo Panel

Własny skrypt to program, który informatyk tworzy dla naszej firmy. Ma pobierać ofertę, tworzyć wymagane pliki i udostępniać je każdego dnia.

Przed startem prac musi być jasne, kto będzie usuwać błędy i zmieniać program, gdy zmienią się wymogi. Ustalamy też, kto przejmie te zadania w razie urlopu lub choroby.

PanelDlaDewelopera.pl tworzy pliki na podstawie oferty prowadzonej w aplikacji. Jego automatyczne raportowanie cen do dane.gov.pl zaczyna działać po sprawdzeniu plików i prawidłowym podłączeniu.

Gdy planujemy połączyć Panel z innym programem, możemy uwzględnić API. To sposób, w jaki dwa programy wymieniają informacje, np. cenę mieszkania, bez przepisywania.

API w każdym planie, w cenie; uruchamiamy je w najbliższych dniach. Połączenie z naszym programem tworzy informatyk i może wycenić tę pracę osobno.

Przy wyborze między codzienną pracą ręczną a automatem pomoże nam porównanie ręcznego raportowania, automatyzacji i kosztów obsługi.

Krok 3. Sprawdzamy profil dostawcy i wcześniejsze cenniki

Profil dostawcy wskazuje firmę, od której pochodzą dane. Zbiór danych grupuje pliki tej firmy, a zasób to jedna pozycja w zbiorze, na przykład cennik z danego dnia.

Przy pierwszym podłączeniu korzystamy z urzędowej instrukcji założenia profilu dostawcy i nadania uprawnień edytora. Praktyczny opis znajdziemy też w poradniku jak założyć profil dostawcy w dane.gov.pl.

Jeżeli już raportujemy, notujemy adres naszego zbioru. Z informatykiem lub dostawcą narzędzia ustalamy, jak zachować wcześniejsze cenniki i kiedy zakończyć dotychczasowy sposób raportowania.

Jeśli korzystamy z Panelu: dodajemy dane firmy, inwestycji i lokali. Panel uzupełnia tymi danymi treść pierwszego maila do kontakt@dane.gov.pl.

Mail sprawdzamy i wysyłamy z własnej skrzynki. Po odpowiedzi tworzymy profil i nadajemy dostęp zgodnie z otrzymanymi wskazówkami.

Krok 4. Tworzymy pliki potrzebne do pobierania cen

XML to plik, który wskazuje dane.gov.pl, gdzie znajduje się cennik i jak go opisać. MD5 to krótki kod liczony z treści XML. Pozwala wykryć różnicę między wersjami pliku.

Dla własnego skryptu ustalamy sześć wymogów:

1. Osobny cennik dla każdego dnia. Może to być arkusz albo CSV, czyli prosty plik tabeli, który otworzymy też w Excelu. Każdy dzienny plik ma stały adres, który wpisujemy w polu url w XML.
2. XML zgodny ze schematem XSD. XSD to wzór budowy pliku, z którym program porównuje nasz XML. Każdy zbiór i cennik z danego dnia ma stałe oznaczenie, którego nie może użyć inny zbiór lub cennik.
3. Właściwy opis cennika. updateFrequency ustawiamy na daily, czyli codziennie, a dataDate na datę publikacji cennika. Dla danych deweloperów availability ma wartość local, czyli dane.gov.pl pobiera plik i udostępnia jego kopię.
4. MD5 z gotowego XML. Wynik ma mieć małe litery. Oba pliki są w tym samym miejscu i mają taką samą nazwę, ale inne końcówki, na przykład oferta.xml i oferta.md5.
5. Dostęp do plików. Serwer, czyli komputer, z którego pobieramy XML, ma oznaczać typ pliku jako text/xml albo application/xml w polu Content-Type. Pliki muszą być dostępne przez standardowe porty, czyli punkty połączenia: 80 dla HTTP lub 443 dla HTTPS.
6. Codzienne tworzenie kompletu. Program tworzy kolejny cennik, zmienia XML i ponownie liczy MD5. Zachowuje przy tym wcześniejsze cenniki z tego źródła.

Wymogi opisują przewodnik automatycznego zasilania oraz instrukcja XML dla deweloperów, wersja 1.0.6. Zależności między plikami wyjaśniamy również w poradniku XML, CSV i MD5 do dane.gov.pl.

Od 11 listopada 2026 r. zmienia się ustawowy wymóg dotyczący struktury danych. Dane trzeba będzie przekazywać w dokumencie elektronicznym zgodnym ze strukturą z rozporządzenia. To znaczy, że plik będzie musiał mieć wskazany w nim układ danych.

Wzorcowe dokumenty mają trafić do dane.gov.pl. Wynika to z nowelizacji, Dz.U. 2026 poz. 1077.

Na 26 października 2026 r. rozporządzenia z nową strukturą danych jeszcze nie ma w Dzienniku Ustaw. Ministerstwo Cyfryzacji opublikowało projekt rozporządzenia WPL MC 52.

W planie prac mamy więc zadanie: sprawdzić ogłoszone wymogi i dostosować do nich pliki. Dotychczasowa instrukcja techniczna nie zastępuje przyszłego rozporządzenia.

Raportowanie z oferty prowadzonej w Panelu

Panel przygotowuje pliki potrzebne do automatycznej wysyłki cen i prowadzi przez podłączenie. Po jego zakończeniu aktualizujemy ofertę w aplikacji i kontrolujemy kolejne publikacje.

Chcę poznać automatyczne raportowanie

Krok 5. Składamy wniosek i kończymy podłączenie

Gdy profil jest gotowy, a pliki dostępne, wysyłamy na kontakt@dane.gov.pl wniosek o automatyczne zasilanie. Podajemy:

• imię i nazwisko osoby zgłaszającej;
• nazwę dostawcy zgodną z profilem;
• adresy e-mail osób z uprawnieniami edytora;
• adres pliku XML i adres pliku MD5;
• częstotliwość aktualizacji: „codziennie”.

Zakres zgłoszenia opisują urzędowe informacje dla deweloperów. Ten krok dotyczy zarówno własnego skryptu, jak i gotowego narzędzia.

W Panelu wracamy po drugi gotowy mail z dwoma linkami. Sprawdzamy go i wysyłamy jako odpowiedź w tym samym wątku.

Następnie dane.gov.pl sprawdza pliki. To walidacja, czyli sprawdzenie ich poprawności. Jeśli są uwagi, usuwamy błędy i odpisujemy.

Automatyczne raportowanie zaczyna działać dopiero po pozytywnym sprawdzeniu i podłączeniu źródła. Panel tworzy treść maila, ale to my go wysyłamy i czytamy odpowiedź.

Krok 6. Ustawiamy codzienną pracę i obsługę błędów

Własny skrypt ma działać codziennie, także w weekendy i święta. Wpisanie „codziennie” w polu „Częstotliwość aktualizacji” opisuje rytm dodawania cenników, ale samo nie włącza programu.

Dla własnego skryptu zalecamy:

• zapis czasu pracy skryptu i wyniku zadania;
• sygnał o błędzie do opiekuna;
• ponowną próbę po chwilowej awarii, bez dodania drugiej kopii tego samego cennika;
• krótką instrukcję dla osoby, która przejmie pracę opiekuna.

Automatyczna wysyłka w Panelu polega na codziennym tworzeniu plików, które dane.gov.pl pobiera ze sprawdzonych adresów. Dlatego osobno sprawdzamy tworzenie plików i ich pobranie.

W obu wariantach ustalamy, do kogo zgłaszamy problem i kto sprawdza wynik naprawy. Przerwę w dostępie do pliku testujemy na kopii u informatyka, poza adresem zgłoszonym do dane.gov.pl.

Krok 7. Sprawdzamy, czy wszystko działa

Wchodzimy do właściwego zbioru w dane.gov.pl i pobieramy cennik. Sprawdzamy nazwę firmy, inwestycję, datę, liczbę lokali i wybrane ceny. Dane w cenniku muszą zgadzać się z zatwierdzoną ofertą.

W naszym przykładzie sprawdzamy wszystkie 40 mieszkań, w tym 12 z nowego etapu. Dopiero wtedy wiemy, że program pobiera pełny zakres oferty.

W Panelu możemy sprawdzić status raportowania, historię publikacji i czas ostatniego pobrania oraz przejść do publicznego zbioru. Dzięki temu łatwiej ustalić, na którym etapie powstał problem.

Po pierwszym pliku sprawdzamy następny dzień. Gdy faktycznie zmieni się cena, sprawdzamy też, czy nowa kwota trafiła do właściwego pliku.

Notujemy wynik testu oraz to, kto będzie dalej sprawdzał dane. Automat przejmuje stałe zadania, a zespół nadal dba o poprawność oferty.

Wdrożenie raportowania cen: co uzgodnić dla skryptu i Panelu?

W obu wariantach oferta musi być poprawna. Ktoś z zespołu musi też reagować na brak cennika lub błąd w danych.

Najczęstsze błędy w automatycznym raportowaniu cen mieszkań

1. Program pomija część oferty.
   Po dodaniu inwestycji lub etapu sprawdzamy liczbę lokali w źródle i raporcie. Plik bez błędów w budowie też może mieć luki w danych.
2. Zadanie uruchamia się tylko po zmianie ceny.
   Włączamy codzienny harmonogram. Sprawdzamy również dzień bez zmian.
3. XML i MD5 dotyczą różnych wersji.
   Po każdej zmianie XML trzeba ponownie obliczyć MD5. Oba pliki muszą stanowić zgodną parę.
4. Nowe narzędzie tworzy drugi zbiór bez planu przejścia.
   Przed podłączeniem notujemy adres naszego zbioru i ustalamy, jak zachować wcześniejsze cenniki. Nie usuwamy ich tylko po to, by uprościć start.
5. Z dane.gov.pl znikają wcześniejsze zasoby pominięte w XML.
   XML musi nadal wskazywać wcześniejsze cenniki z danego źródła. Zmianę ich stałych oznaczeń ustalamy z osobą, która wdraża program, zgodnie z zasadami aktualizacji i usuwania danych.
6. Pod adresem pliku pojawia się strona logowania albo komunikat błędu.
   Bez logowania sprawdzamy, czy pod adresem można pobrać właściwy plik. Przy własnym skrypcie informatyk sprawdza też dostęp z zewnątrz.
7. Kontrola kończy się na utworzeniu pliku.
   Sprawdzamy również pobranie i treść cennika w dane.gov.pl. Pomocniczo możemy wykonać darmowy audyt raportowania cen.
8. Po wdrożeniu nikt nie przejmuje obsługi błędów.
   Ustalamy, kto zajmuje się błędami, kto go zastąpi i jak zgłaszamy problemy. Obie osoby muszą znać te zasady przed pierwszą awarią.

FAQ

Czy Excel może pozostać źródłem danych dla automatu?

Tak, jeśli program pobiera z niego pełną, bieżącą ofertę i tworzy pliki zgodne z wymogami. Obecne wskazówki dane.gov.pl dla deweloperów dopuszczają między innymi XLSX, czyli format arkusza Excel. Od 11 listopada 2026 r. ustawa wymaga dokumentu o wskazanym układzie danych. Sposób eksportu trzeba więc sprawdzić po ogłoszeniu rozporządzenia, którego na 26 października jeszcze nie ma.

Co przekazać informatykowi przed pracą nad własnym skryptem?

Podajemy źródło cen, pełną listę lokali i adres naszego zbioru, jeśli już raportujemy. Do tego dodajemy wymogi dla plików z kroku 4. Ustalamy też, kto zajmie się błędami i zmianami wymagań. Dzięki temu zakres prac obejmuje zarówno start, jak i dalszą obsługę programu.

Kiedy zakończyć dotychczasowy sposób raportowania?

Termin przejścia ustalamy z osobą, która podłącza nowe narzędzie. W planie podajemy ostatni cennik ze starej metody i pierwszy z nowej, aby uniknąć luki i drugiej kopii tych samych danych. Gotowy plik lub wysłany wniosek nie wystarcza, by zakończyć dotychczasową obsługę.

Czy brak nowego pliku w publicznym widoku oznacza awarię?

Nie zawsze. Cennik może być widoczny najpierw w panelu, w którym zarządzamy danymi, a dopiero później na publicznej stronie. Sprawdzamy oba miejsca zgodnie z urzędowymi wyjaśnieniami dotyczącymi opóźnień.

Jak przetestować obsługę awarii własnego skryptu?

Zlecamy informatykowi próbę przerwy w dostępie do kopii pliku. Test odbywa się poza adresem zgłoszonym do dane.gov.pl, więc nie przerywamy pobierania prawdziwych cenników. Sprawdzamy, czy skrypt zapisuje błąd, zgłasza go opiekunowi i ponawia próbę bez dodania drugiej kopii cennika. Są to wymagania dla naszego skryptu, opisane w kroku 6.

Czy do testu musimy zmieniać cenę mieszkania w prawdziwej ofercie?

Nie. Na start sprawdzamy, czy automat przenosi zatwierdzoną ofertę bez zmian i obejmuje wszystkie lokale. Gdy w ofercie faktycznie zmieni się cena, sprawdzamy, czy nowa kwota trafiła do właściwego pliku. Samo sprawdzenie plików przy podłączeniu nie potwierdza poprawności każdej ceny. Ogólne pytania o codzienny obowiązek, profil dostawcy, API, kontrolę raportów i koszty omawiamy w odpowiedziach na pytania o raportowanie cen.

Automatyczne raportowanie cen: od czego zacząć?

Zacznijmy od pełnej oferty i adresu obecnego zbioru w dane.gov.pl. Następnie wybierzmy narzędzie, stwórzmy pliki, zakończmy podłączenie i sprawdźmy cenniki z kolejnych dni.

W PanelDlaDewelopera.pl możemy prowadzić ofertę, na której opiera się raportowanie. Te same dane mogą zasilać tabelę mieszkań na stronie, dzięki czemu klient po przejściu z reklamy widzi bieżącą ofertę przed rozmową z biurem.

Wypróbuj przez 7 dni bezpłatnie, bez zobowiązań

Chcę zacząć 7 dni za darmo