Krok po kroku: publikowanie cen mieszkań i raportowanie danych do

Lead: Obowiązek codziennego raportowania cen mieszkań może brzmieć skomplikowanie, ale w praktyce sprowadza się do kilku powtarzalnych czynności. Deweloper musi przygotować aktualny cennik wszystkich lokali w formie pliku XML (lub innym formatem maszynowym) wraz z plikiem kontrolnym MD5, umieścić te pliki na swojej stronie internetowej, a następnie **zgłosić ich adresy URL do portalu Poniżej przedstawiamy praktyczny poradnik, jak wykonać te kroki -- od utworzenia pliku z danymi, poprzez jego publikację, aż po dopełnienie formalności zgłoszeniowych. Dzięki temu Twoja firma spełni wymagania ustawy o jawności cen mieszkań i uniknie ewentualnych kar za opóźnienia lub błędy w raportowaniu.

1. Przygotowanie danych -- tworzenie pliku XML z ofertą

Pierwszym krokiem jest zgromadzenie wszystkich wymaganych informacji o oferowanych lokalach i zapisanie ich w odpowiedniej strukturze. Zgodnie z wytycznymi Ministerstwa, plik powinien zawierać m.in.:

• Identyfikator lokalu/numer mieszkania (np. oznaczenie mieszkania w projekcie, klatce, piętrze).
• Powierzchnia lokalu w metrach kwadratowych (m²).
• Liczba pokoi.
• Piętro lub poziom, na którym znajduje się lokal.
• Status dostępności (np. dostępny, rezerwacja, sprzedany -- zgodnie z ustalonym słownikiem pojęć).
• Cena brutto lokalu (pełna cena za mieszkanie, z uwzględnieniem VAT, wyrażona w PLN).
• Cena brutto za 1 m² danego lokalu (w PLN).
• Koszty dodatkowe związane z zakupem -- czyli ceny wszystkich pomieszczeń przynależnych i dodatkowych produktów, jeśli są oferowane osobno. Obejmuje to np. cenę miejsca postojowego w garażu podziemnym, cenę komórki lokatorskiej, udział w gruncie lub inne opłaty, które nabywca musi ponieść.
• Historia zmian cen -- lista poprzednich cen danego lokalu wraz z datami ich obowiązywania. Ustawa wymaga, by odnotowywać zmiany od dat granicznych (11.07.2025 dla nowych inwestycji lub 11.09.2025 dla inwestycji będących wcześniej w sprzedaży), więc w pliku należy uwzględnić wszystkie aktualizacje cen od tego czasu.
• Data ostatniej aktualizacji danych dla danego lokalu.

Plik XML ma zhierarchizowaną strukturę -- najczęściej zaczyna się od elementu głównego (np. <offers> lub <oferty>), w którym zagnieżdżone są poszczególne rekordy <offer> opisujące każdy lokal. Każdy z wymienionych powyżej elementów staje się tagiem wewnątrz <offer>. Przykładowy uproszczony fragment takiego pliku XML może wyglądać następująco:

<offers>

• <offer>*

• <id>Budynek A / Mieszkanie 1</id>*

• <area_total>53.59</area_total>*

• <rooms>2</rooms>*

• <floor>1</floor>*

• <status>dostępny</status>*

• <price_brutto>682848</price_brutto>*

• <price_per_m2>12742.08</price_per_m2>*

• <additional_products>*

• <parking_space price="35000" />*

• <storage_unit price="15000" />*

• </additional_products>*

• <price_history>*

• <price_change date="2025-08-01" price_brutto="660000" />*

• <price_change date="2025-09-10" price_brutto="682848" />*

• </price_history>*

• <last_update>2025-09-11</last_update>*

• </offer>*

• <!-- ... kolejne oferty ... -->*

</offers>

Oczywiście rzeczywista struktura i nazwy pól powinny być zgodne z oficjalną specyfikacją (wzorcowym schematem) opublikowaną przez ministerstwo. Ważne jest zachowanie poprawnych jednostek (ceny w PLN, powierzchnie w m²) oraz formatów (np. data aktualizacji w formacie RRRR-MM-DD). Dane muszą być kompletne i aktualne, aby spełnić wymogi ustawowe -- przed wygenerowaniem pliku upewnij się, że Twój wewnętrzny system (CRM) zawiera najnowsze informacje o wszystkich mieszkaniach.

Uwaga: Niektóre systemy CRM deweloperskie oferują już funkcję eksportu danych do pliku XML zgodnego z ustawą. Jeżeli Twój CRM tego nie posiada, rozważ skorzystanie z zewnętrznych narzędzi lub napisanie skryptu, który pobierze dane z bazy i wygeneruje plik. Eksporta to przykład usługi SaaS, która może automatycznie wygenerować taki plik na podstawie danych z popularnych CRM, eliminując konieczność ręcznego przygotowywania XML-a.

2. Wygenerowanie pliku kontrolnego MD5

Gdy masz już gotowy plik XML zawierający cennik wszystkich lokali, kolejnym zadaniem jest wygenerowanie dla niego sumy kontrolnej MD5. Ministerstwo Cyfryzacji wymaga, by wraz z plikiem danych udostępniać plik z hashem MD5 -- ma on pozwolić systemowi automatycznie sprawdzać, czy pobrany plik XML nie jest uszkodzony lub niezmieniony od poprzedniej wersji.

Jak stworzyć plik MD5? W praktyce jest to bardzo proste: należy obliczyć 128-bitowy skrót MD5 z zawartości pliku XML i zapisać go w pliku tekstowym. Można to zrobić na kilka sposobów:

• Na systemach Linux/Unix/MacOS: używając polecenia md5sum. W terminalu należy przejść do katalogu z plikiem (np. inwestycja.xml) i wydać polecenie:

  md5sum inwestycja.xml > inwestycja.md5

  Spowoduje to obliczenie sumy i zapisanie jej do pliku inwestycja.md5. Zawartość pliku MD5 będzie wyglądać np. tak:
  a3f1b0f0b4b3c9db0e9f2a2a4b6d7c8e inwestycja.xml.
  Jest to ciąg hexadecymalny (32 znaki), a po nim nazwa pliku źródłowego.

• Na Windows: można skorzystać z programu PowerShell poleceniem Get-FileHash:

  Get-FileHash .\inwestycja.xml -Algorithm MD5 | Format-List

  Wynik należy skopiować do nowego pliku tekstowego o nazwie inwestycja.md5 (ew. można użyć skryptów lub narzędzi takich jak certutil).

• W programach graficznych lub edytorach: istnieje wiele darmowych narzędzi (np. HashCalc, QuickSFV) pozwalających wyklikać wygenerowanie sumy MD5 bez użycia konsoli.

Ważne, by plik .md5 zawierał dokładnie ten hash, którego oczekuje system -- zwykle format to: [hash] [dwa odstępy] [nazwa pliku]. Po wygenerowaniu sumy kontrolnej nie zmieniaj już pliku XML -- jeśli dokonasz jakiejkolwiek modyfikacji w danych, hash będzie niezgodny i portal wykryje to jako błąd integralności.

3. Publikacja plików na stronie internetowej

Posiadając dwa pliki -- inwestycja.xml i inwestycja.md5 (nazwy mogą być dowolne, tu przykładowe) -- należy je umieścić na serwerze WWW tak, aby były dostępne pod stałymi adresami URL. Najlepiej, jeśli będą to adresy związane bezpośrednio z daną inwestycją lub firmą. Przykładowo deweloper ABC Development dla inwestycji "Osiedle Zielone" może opublikować pliki pod adresami:

Kluczowe jest, aby adresy te pozostały niezmienne w czasie -- będą one raz zgłoszone do ministerstwa i system państwowy będzie ich codziennie używał do pobierania danych. Jeśli w przyszłości zmieni się struktura strony lub domena, należy wcześniej zaktualizować adres w systemie (co wiąże się z kolejnym zgłoszeniem). Dlatego warto przemyśleć stabilną lokalizację plików. Częstą praktyką jest stworzenie dedykowanego folderu (np. /oferty/ lub /dane/) gdzie będą trafiały pliki dla portalu danych.

Upewnij się, że pliki są dostępne publicznie (bez hasła, bez blokowania przez firewall) i serwer przesyła je poprawnie. Dobrze jest przetestować ich pobranie -- np. otwierając link do XML w przeglądarce lub pobierając plik przez narzędzie typu curl -- aby zweryfikować, że wszystko działa. Możesz również wykorzystać udostępnione przez Ministerstwo narzędzie do wizualizacji/validacji plików XML, aby upewnić się, że struktura danych jest zgodna z oczekiwaniami.

Najlepsza praktyka: Zautomatyzuj proces generowania i publikacji plików. Ręczne tworzenie XML i wgrywanie go codziennie na serwer byłoby uciążliwe i podatne na pomyłki. Większość deweloperów skonfigurowała więc skrypty lub zadania CRON, które np. każdej nocy generują nowe pliki i podmieniają je na serwerze. Jeśli korzystasz z profesjonalnego CRM dla deweloperów, sprawdź, czy oferuje on taką funkcję -- np. voxDeveloper CRM automatycznie generuje dwa linki (XML i MD5) i aktualizuje je codziennie. Podobnie, narzędzie Eksporta może zostać podłączone do Twojego CRM i publikować aktualne pliki bez Twojej ingerencji. Dzięki automatyzacji zyskasz pewność, że dane pojawią się codziennie, nawet w weekendy i święta, eliminując ryzyko przerwy w raportowaniu.

4. Zgłoszenie źródła danych do portalu

Gdy pliki są już dostępne online, należy wykonać ostatni krok -- poinformować Ministerstwo Cyfryzacji o źródle danych. Procedura zgłoszenia jest dość prosta i odbywa się poprzez wysłanie wiadomości e-mail. Zgodnie z instrukcją, należy wysłać mail na adres [email protected], podając następujące informacje:

• Pełna nazwa dewelopera oraz podstawowe dane identyfikacyjne firmy: NIP, KRS/REGON.
• Dane kontaktowe osoby odpowiedzialnej za udostępnianie danych -- imię, nazwisko, adres e-mail, numer telefonu. To będzie osoba do kontaktu w razie problemów.
• Dokładne adresy URL do pliku XML i pliku MD5. Upewnij się, że to te same adresy, pod którymi umieściłeś pliki, i że są one osiągalne.
• Informacja o częstotliwości aktualizacji danych -- zwykle wskazuje się, że pliki będą aktualizowane codziennie (co jest zgodne z ustawą). Można podać konkretną godzinę generowania, choć nie jest to wymagane -- ministerialny system i tak będzie próbował codziennie raz pobrać dane (prawdopodobnie w godzinach nocnych lub rannych).

W treści maila dobrze jest wyraźnie zaznaczyć, że zgłaszasz źródło danych zgodnie z ustawą deweloperską. Przykładowy mail mógłby wyglądać tak:

Temat: Zgłoszenie źródła danych -- [Nazwa Dewelopera]

Szanowni Państwo,
działając w imieniu [pełna nazwa firmy deweloperskiej wraz z formą prawną], zgłaszam źródło danych dotyczących cen ofertowych naszych inwestycji, zgodnie z art. 19b ustawy deweloperskiej.
Poniżej przesyłam wymagane informacje:
-- Nazwa dewelopera: [ABC Development Sp. z o.o., NIP..., KRS...]
-- Osoba do kontaktu: [Jan Nowak, [email protected], tel. 123-456-789] -- odpowiedzialny za publikację danych.
-- Adres URL pliku XML: [pełny URL do pliku XML]
-- Adres URL pliku MD5: [pełny URL do pliku MD5]
-- Częstotliwość aktualizacji: codziennie (dane aktualizowane każdego dnia zgodnie z wymogami ustawy).
Pliki są generowane automatycznie i zawierają aktualne, pełne informacje o cenach i zmianach cen oferowanych lokali. Proszę o dodanie powyższych adresów jako źródła danych w systemie Z poważaniem,
[Imię Nazwisko]
[Stanowisko, Firma]

Wysyłamy takiego maila **z adresu osoby zarejestrowanej jako edytor na -- pamiętaj, że wcześniej musisz posiadać konto w tym portalu i mieć uprawnienia do dodawania danych dla swojej firmy. Jeżeli nie masz jeszcze konta, zarejestruj się na (najlepiej służbowym mailem) i poproś w mailu o nadanie Twojemu kontu uprawnień edytora dla profilu Twojej firmy (można to połączyć w jednym zgłoszeniu).

Po wysłaniu zgłoszenia pozostaje czekać na weryfikację i dodanie źródła przez ministerstwo. Gdy profil dostawcy danych zostanie skonfigurowany, system państwowy zacznie codziennie automatycznie pobierać Twój plik XML i MD5 we wskazanych lokalizacjach. O tym, że wszystko działa, możesz przekonać się przeglądając portal -- po pierwszym imporcie powinien pojawić się tam Twój dataset z danymi (dostępny publicznie). W razie problemów lub braku importu, urząd może kontaktować się z podaną osobą odpowiedzialną.

5. Dalsze utrzymanie i aktualizacja danych

Po pomyślnym zgłoszeniu źródła, Twoim obowiązkiem jest utrzymywać dane w ciągłej aktualności. Ustawa wymaga codziennych aktualizacji -- nawet jeśli danego dnia nie było żadnej zmiany cen, powinieneś przynajmniej ponownie udostępnić plik z aktualną datą (lub inaczej zaznaczyć jego aktualność). W praktyce oznacza to, że każdego dnia plik XML powinien być świeży, najlepiej z datą aktualizacji równą bieżącej dacie. Brak aktualizacji przez kilka dni z rzędu może zostać odnotowany jako niedopełnienie obowiązku. Dlatego automatyzacja jest tak istotna -- ręczne pilnowanie 365 aktualizacji w roku byłoby trudne.

Warto także na bieżąco wprowadzać do systemu wszelkie zmiany -- np. gdy jakieś mieszkanie się sprzeda i zmieni status, albo gdy dodajecie nową pulę lokali do sprzedaży (kolejny etap inwestycji). Wszystkie te aktualności powinny znaleźć odzwierciedlenie w pliku najpóźniej następnego dnia. Historia cen musi być uzupełniana konsekwentnie -- jeśli np. 1 października wprowadzono nowy cennik z podwyższonymi cenami, to ta zmiana powinna trafić do historii każdego lokalu wraz z datą 01.10.2025.

Na koniec, pamiętaj o monitorowaniu całego procesu. Dobrą praktyką jest sprawdzanie logów na swoim serwerze -- czy serwery pobierają pliki codziennie (będzie to widoczne jako żądania do plików XML/MD5, zapewne z określonego adresu IP lub user-agenta). Jeśli integracja działa, możesz spać spokojnie, mając pewność że firma wywiązuje się z obowiązku. W przypadku wykrycia problemów (np. plik nie zaktualizował się któregoś dnia lub portal zgłasza błąd sumy kontrolnej), napraw je niezwłocznie.

Podsumowując, publikowanie cen mieszkań i raportowanie ich do sprowadza się do ustanowienia codziennego, zautomatyzowanego procesu eksportu danych. Po jednorazowym skonfigurowaniu wszystkiego (przygotowanie struktury danych, automatyzacja generowania plików, zgłoszenie do ministerstwa) -- dalsze działania dzieją się w tle. Deweloperzy, którzy czują się niepewnie w tych technicznych aspektach, mogą skorzystać z rozwiązań takich jak Eksporta -- które krok po kroku przeprowadzą przez integrację z portalem rządowym i przejmą na siebie codzienne raportowanie. Dzięki temu można mieć pewność pełnej zgodności z ustawą, minimalizując ryzyko błędu i oszczędzając czas zespołu.

Masz pytania odnośnie integracji z Potrzebujesz usprawnić raportowanie cen? Umów demo Eksporta -- pokażemy Ci, jak łatwo zautomatyzować te kroki i skupić się na sprzedaży mieszkań, zamiast na codziennej biurokracji.