Question 1

Co to jest ustawa o jawności cen mieszkań?

Accepted Answer

Ustawa o jawności cen mieszkań to nowelizacja ustawy deweloperskiej z 21 maja 2025 r. (Dz.U. 2025 poz. 758), która weszła w życie 11 lipca 2025 r. Nakłada na deweloperów obowiązek publicznego udostępniania cen ofertowych lokali mieszkalnych na własnej stronie internetowej (art. 19a) oraz codziennego raportowania tych danych do ministra cyfryzacji na portal dane.gov.pl (art. 19b). Celem jest zwiększenie przejrzystości rynku pierwotnego i umożliwienie kupującym łatwego porównywania ofert.

Question 2

Kiedy weszła w życie ustawa o jawności cen?

Accepted Answer

Ustawa weszła w życie 11 lipca 2025 r. Od tego dnia obowiązuje wszystkie nowe inwestycje, których sprzedaż rozpoczęła się po tej dacie. Dla inwestycji, których sprzedaż rozpoczęła się przed 11 lipca 2025 r., przewidziano okres przejściowy do 11 września 2025 r. Po 11 września 2025 r. obowiązek publikacji cen obejmuje już wszystkich deweloperów, niezależnie od momentu rozpoczęcia sprzedaży.

Question 3

Kogo dokładnie dotyczy ustawa?

Accepted Answer

Ustawa dotyczy wszystkich deweloperów i przedsiębiorców oferujących lokale mieszkalne i domy jednorodzinne na rynku pierwotnym. Obejmuje zarówno duże grupy deweloperskie, jak i małych inwestorów. Nie dotyczy rynku wtórnego (sprzedaży między osobami prywatnymi) ani wynajmu długoterminowego. Ustawa dotyczy również przedsiębiorców, którzy nie są deweloperami w rozumieniu ustawy deweloperskiej, ale oferują sprzedaż lokali mieszkalnych.

Question 4

Jakie akty prawne regulują jawność cen?

Accepted Answer

Podstawą prawną jest ustawa z 21 maja 2025 r. o zmianie ustawy o ochronie praw nabywcy lokalu mieszkalnego lub domu jednorodzinnego oraz Deweloperskim Funduszu Gwarancyjnym (Dz.U. 2025 poz. 758). Nowelizacja ta dodała do ustawy deweloperskiej dwa kluczowe artykuły: art. 19a — obowiązek publikacji cen na własnej stronie internetowej, oraz art. 19b — obowiązek codziennego raportowania do dane.gov.pl.

Question 5

Czy ustawa dotyczy tylko nowych mieszkań?

Accepted Answer

Ustawa dotyczy wyłącznie nowych lokali mieszkalnych sprzedawanych bezpośrednio przez deweloperów w ramach pierwszej sprzedaży na rynku pierwotnym. Nie obejmuje rynku wtórnego, czyli transakcji między osobami prywatnymi. Jeśli deweloper sprzedaje lokal, który wcześniej był np. lokalem pokazowym, również podlega obowiązkowi raportowania.

Question 6

Czy ustawa dotyczy również lokali użytkowych?

Accepted Answer

Ustawa dotyczy wyłącznie lokali mieszkalnych i domów jednorodzinnych. Lokale użytkowe (biura, sklepy) nie podlegają obowiązkowi raportowania. Miejsca postojowe, komórki lokatorskie i inne pomieszczenia przynależne podlegają raportowaniu, jeśli są sprzedawane razem z lokalem mieszkalnym — ich cena musi być wtedy uwzględniona w cenie całkowitej.

Question 7

Jakie są główne obowiązki dewelopera?

Accepted Answer

Ustawa nakłada 4 główne obowiązki: 1) Prowadzenie własnej strony internetowej i publikowanie na niej cen mieszkań, historii zmian oraz części ogólnej prospektu informacyjnego, 2) Aktualizowanie cen na stronie przy każdej zmianie, 3) Podawanie adresu strony internetowej w każdej reklamie i ofercie sprzedaży, 4) Codzienne (raz na dobę) raportowanie danych o cenach do portalu dane.gov.pl — również w dni wolne i gdy ceny nie uległy zmianie.

Question 8

Co jeśli moja inwestycja jest jeszcze w budowie?

Accepted Answer

Obowiązek raportowania dotyczy wszystkich lokali oferowanych do sprzedaży, niezależnie od etapu budowy. Jeśli prowadzisz sprzedaż mieszkań w inwestycji będącej w budowie (sprzedaż 'z planu'), musisz raportować ceny tych lokali. Strona internetowa z cenami musi być aktywna od dnia rozpoczęcia sprzedaży, przed zawarciem pierwszej umowy rezerwacyjnej.

Question 9

Czy mogę zostać zwolniony z obowiązku raportowania?

Accepted Answer

Nie ma generalnych zwolnień dla deweloperów prowadzących sprzedaż mieszkań. Ustawa ma charakter powszechny. Jedynymi wyjątkami są sytuacje, gdy deweloper zakończył całkowicie działalność sprzedażową i nie oferuje już żadnych lokali, lub gdy inwestycja jest w całości przeznaczona na wynajem (nie na sprzedaż).

Question 10

Czy muszę raportować mieszkania już sprzedane?

Accepted Answer

Nie musisz raportować mieszkań, które zostały już sprzedane i dla których podpisano umowę deweloperską lub przeniesiono własność. Obowiązek dotyczy tylko lokali aktualnie dostępnych w ofercie. Jeśli jednak lokal wrócił do oferty (np. z powodu rezygnacji klienta), należy go ponownie raportować.

Question 11

Jakie dane muszę publikować na stronie internetowej?

Accepted Answer

Na stronie internetowej musisz publikować: cenę brutto za 1 m² powierzchni użytkowej każdego z oferowanych lokali, cenę całkowitą brutto każdego lokalu, cenę pomieszczeń przynależnych (garaży, komórek lokatorskich) jeśli nie są wliczone w cenę lokalu, pozacenowe świadczenia pieniężne wymagane od nabywcy, część ogólną prospektu informacyjnego, dane kontaktowe i adres siedziby, lokalizację inwestycji oraz historię zmian cen.

Question 12

Jak często muszę raportować dane do dane.gov.pl?

Accepted Answer

Dane należy raportować raz na dobę, codziennie — 365 dni w roku, również w soboty, niedziele i święta. Obowiązek obejmuje także dni, w których ceny nie uległy zmianie. Raportowanie ma charakter ciągły i nieprzerwany przez cały okres sprzedaży. W praktyce oznacza to konieczność wdrożenia zautomatyzowanego systemu, ponieważ ręczne raportowanie 365 dni w roku jest praktycznie niemożliwe.

Question 13

Co to jest art. 19a ustawy deweloperskiej?

Accepted Answer

Art. 19a to przepis wprowadzony nowelizacją, który zobowiązuje dewelopera do prowadzenia własnej strony internetowej i publikowania na niej określonych informacji. Strona może działać w domenie grupowej lub subdomenie, ale publikacja wyłącznie u pośrednika lub na portalu ogłoszeniowym nie spełnia wymogu. Strona musi być aktywna od dnia rozpoczęcia sprzedaży do dnia przeniesienia praw z ostatniej umowy.

Question 14

Co to jest art. 19b ustawy deweloperskiej?

Accepted Answer

Art. 19b nakazuje codzienne (raz na dobę) przekazywanie ministrowi cyfryzacji informacji o cenach ofertowych mieszkań. Dane są publikowane na portalu dane.gov.pl. Raportowanie obejmuje: cenę za 1 m², cenę całkowitą lokalu, cenę pomieszczeń przynależnych oraz informację o świadczeniach pieniężnych. Raport musi być wysyłany nawet jeśli ceny nie zmieniły się od poprzedniego dnia.

Question 15

Czy muszę podawać adres strony w reklamach?

Accepted Answer

Tak, adres strony internetowej, na której znajdują się wymagane ustawą informacje, musi być widoczny w każdej reklamie i ofercie sprzedaży — zarówno w internecie, jak i w materiałach drukowanych. To jeden z czterech kluczowych obowiązków wynikających z ustawy.

Question 16

Jak długo muszę przechowywać historię zmian cen?

Accepted Answer

Zgodnie z ustawą, historia zmian cen musi być dostępna przez cały okres sprzedaży. Dodatkowo, na potrzeby kontroli UOKiK zaleca się przechowywanie danych przez co najmniej 3 lata (okres przedawnienia roszczeń z tytułu naruszenia zbiorowych interesów konsumentów). Każda zmiana ceny powinna być oznaczona datą, a wcześniejsze ceny zachowane w archiwum.

Question 17

Czy mogę ukryć ceny za formularzem lub logowaniem?

Accepted Answer

Nie, to jest niezgodne z ustawą. Ceny muszą być publicznie dostępne dla każdego odwiedzającego stronę, bez konieczności rejestracji, logowania, podawania danych osobowych czy kontaktu z biurem sprzedaży. Celem ustawy jest właśnie pełna transparentność cenowa. Ukrywanie cen za formularzem może być uznane za praktykę naruszającą zbiorowe interesy konsumentów.

Question 18

Co jeśli cena w ofercie różni się od ceny w umowie?

Accepted Answer

Przepisy przewidują, że w przypadku rozbieżności między ceną na stronie internetowej a ceną w umowie, nabywca ma prawo żądać zawarcia umowy po cenie korzystniejszej (niższej). To istotne zabezpieczenie konsumentów. W praktyce oznacza, że musisz pilnować, aby ceny na stronie były zawsze aktualne.

Question 19

Czy muszę prowadzić stronę dla każdej inwestycji osobno?

Accepted Answer

Nie ma wymogu osobnej strony dla każdej inwestycji. Strona może być w domenie grupowej lub subdomenie, ważne aby jasno przypisać cenę i informacje do konkretnej inwestycji. Możesz mieć jedną stronę z zakładkami/wyszukiwarką dla wszystkich inwestycji.

Question 20

Jaki jest okres przejściowy dla starych inwestycji?

Accepted Answer

Dla inwestycji, których sprzedaż rozpoczęła się przed 11 lipca 2025 r., ustawodawca przewidział dwumiesięczny okres przejściowy do 11 września 2025 r. W tym czasie deweloperzy musieli dostosować swoje strony do nowych wymogów. Po 11 września 2025 r. obowiązek publikacji cen objął już wszystkich.

Question 21

Jakie kary grożą za nieprzestrzeganie ustawy?

Accepted Answer

Naruszenie obowiązków z ustawy o jawności cen jest traktowane jako praktyka naruszająca zbiorowe interesy konsumentów. Prezes UOKiK może nałożyć karę pieniężną w wysokości do 10% rocznego obrotu przedsiębiorcy. Dodatkowo, na osobę zarządzającą spółką (prezesa, członka zarządu) może zostać nałożona kara pieniężna do 2 000 000 zł.

Question 22

Kto kontroluje przestrzeganie ustawy?

Accepted Answer

Kontrole przeprowadza Prezes Urzędu Ochrony Konkurencji i Konsumentów (UOKiK). UOKiK może wszcząć postępowanie z urzędu lub na wniosek konsumentów. Kontrole mogą być zarówno planowe, jak i doraźne. UOKiK ma prawo żądać dostępu do wszystkich danych i dokumentacji związanej z raportowaniem cen.

Question 23

Jakie konkretnie naruszenia są najsurowiej karane?

Accepted Answer

Do najpoważniejszych naruszeń należą: brak publikacji cen na stronie internetowej, nieprowadzenie historii zmian cen, brak codziennego raportowania do dane.gov.pl, celowe zaniżanie lub zawyżanie cen w ofercie, uniemożliwianie dostępu do informacji o cenach, publikacja nieprawdziwych danych. Każde z tych naruszeń może skutkować karą do 10% obrotu.

Question 24

Czy UOKiK już prowadzi kontrole?

Accepted Answer

Tak, UOKiK zapowiedział i prowadzi kontrole w branży deweloperskiej. W pierwszej kolejności sprawdzane są strony internetowe deweloperów pod kątem dostępności i kompletności informacji o cenach. Kontrole obejmują również weryfikację, czy dane na stronach deweloperów są zgodne z danymi raportowanymi do dane.gov.pl.

Question 25

Czy mogę dostać karę za błędy w raportowaniu?

Accepted Answer

Tak, ale UOKiK zazwyczaj najpierw wzywa do usunięcia uchybień, a dopiero potem nakłada karę. Systemowe i powtarzające się błędy, celowe zaniżanie cen lub brak reakcji na wezwania UOKiK zwiększają ryzyko wysokiej kary. Ważne jest, aby prowadzić dokumentację i móc udowodnić, że błędy były natychmiast korygowane.

Question 26

Czy kara jest nakładana od razu, czy jest ostrzeżenie?

Accepted Answer

Zazwyczaj UOKiK najpierw wszczyna postępowanie wyjaśniające, a następnie wydaje decyzję nakazującą zaniechanie praktyk. Dopiero w przypadku braku dostosowania się lub rażących naruszeń nakładana jest kara finansowa. W praktyce urząd zwykle wzywa do usunięcia uchybień, dając czas na poprawę, ale w przypadku celowych działań kara może być nałożona od razu.

Question 27

Jakie są skutki wizerunkowe naruszenia?

Accepted Answer

UOKiK może nie tylko nałożyć karę finansową, ale również opublikować informację o naruszeniu na koszt dewelopera w mediach ogólnokrajowych. To oznacza poważne konsekwencje wizerunkowe — klienci stracą zaufanie do firmy, która nie przestrzega prawa. Negatywny PR może być bardziej kosztowny niż sama kara finansowa.

Question 28

Czy brak historii zmian cen podlega karze?

Accepted Answer

Tak, brak prowadzenia lub niekompletna historia zmian cen jest naruszeniem ustawy. UOKiK wymaga, aby każda zmiana ceny była udokumentowana datą, a wcześniejsze ceny zachowane w archiwum. Za brak historii zmian również grozi kara do 10% obrotu.

Question 29

Czy mogę uniknąć kary, jeśli szybko naprawię błąd?

Accepted Answer

Tak, dobrowolne usunięcie naruszenia i współpraca z UOKiK są okolicznościami łagodzącymi. Jeśli sam zgłosisz błąd i natychmiast go naprawisz, ryzyko kary jest znacząco mniejsze. Dlatego warto mieć system, który monitoruje poprawność danych i alertuje o problemach.

Question 30

Czy kara grozi również za brak rejestracji na dane.gov.pl?

Accepted Answer

Tak. Brak rejestracji profilu dostawcy na portalu dane.gov.pl i brak codziennego raportowania danych jest naruszeniem art. 19b i podlega tym samym sankcjom. Samo posiadanie strony z cenami nie wystarczy — raportowanie do dane.gov.pl to osobny, równie ważny obowiązek.

Question 31

Jakie dane muszę raportować dla każdego lokalu?

Accepted Answer

Dla każdego lokalu należy raportować: unikalny identyfikator lokalu, powierzchnię użytkową w m², liczbę pokoi, piętro/poziom, cenę brutto za 1 m² (z VAT), cenę całkowitą brutto (z VAT), cenę pomieszczeń przynależnych (garaż, komórka), status lokalu (dostępny/zarezerwowany/sprzedany), datę aktualizacji ceny. W przypadku raportowania w formacie CSV wymagane jest dokładnie 58 kolumn.

Question 32

W jakich formatach mogę raportować dane?

Accepted Answer

Portal dane.gov.pl akceptuje następujące formaty: XML — rekomendowany format strukturalny zgodny ze schematem XSD v1.13, CSV — z dokładnie 58 kolumnami, kodowaniem UTF-8 z BOM, separatorem przecinek i kropką jako separatorem dziesiętnym, JSON — dla integracji API. Plik XML manifestu jest wymagany do zarejestrowania zbioru na portalu.

Question 33

Co to jest schemat XSD i dlaczego jest ważny?

Accepted Answer

Schemat XSD (XML Schema Definition) to oficjalny wzorzec określający strukturę pliku XML. Ministerstwo Cyfryzacji udostępnia schemat otwarte_dane_latest.xsd (obecnie v1.13). Plik XML musi być zgodny z tym schematem — inaczej harvester (system pobierający dane) odrzuci plik i raportowanie nie zostanie uznane. Walidację można przeprowadzić narzędziem xmllint.

Question 34

Jakie są wymagania dotyczące pliku CSV?

Accepted Answer

Plik CSV musi spełniać następujące wymagania: dokładnie 58 kolumn (nie 57, nie 60), kodowanie UTF-8 z BOM (pierwsze 3 bajty: EF BB BF), separator pól: przecinek (,), separator dziesiętny: kropka (.), cena bez waluty ('zł' w polu numerycznym powoduje błąd walidacji). Excel domyślnie zapisuje z separatorem średnik — trzeba to zmienić.

Question 35

Jak sprawdzić, czy plik XML jest poprawny?

Accepted Answer

Przed publikacją należy zwalidować plik XML przeciwko oficjalnemu schematowi XSD. Komenda walidacji: xmllint --schema otwarte_dane_latest.xsd feed.xml --noout. Najczęstsze błędy to: niewłaściwy namespace (musi być urn:otwarte-dane:harvester:1.13), brak licenseId, format daty inny niż ISO (YYYY-MM-DD), zmienny extIdent zbioru między dniami.

Question 36

Co to jest plik kontrolny MD5?

Accepted Answer

Plik MD5 to suma kontrolna pliku z danymi (np. CSV), która pozwala harvesterowi zweryfikować, czy plik nie został uszkodzony podczas transferu. Plik MD5 powinien być udostępniony pod stałym adresem URL obok pliku z danymi. Harvester pobiera oba pliki, oblicza sumę MD5 z danych i porównuje z deklarowaną wartością.

Question 37

Czy mogę raportować dane ręcznie?

Accepted Answer

Teoretycznie istnieje możliwość ręcznego wprowadzania danych przez panel administracyjny dane.gov.pl, jednak w praktyce jest to bardzo niepraktyczne. Ręczne raportowanie wymaga codziennego logowania i aktualizacji danych przez 365 dni w roku, również w weekendy i święta. Dla inwestycji z dziesiątkami mieszkań to zadanie może zajmować kilka godzin dziennie. Automatyzacja jest zdecydowanie zalecana — wręcz niezbędna.

Question 38

Jak długo muszę przechowywać dane?

Accepted Answer

Ustawa wymaga przechowywania historii zmian cen przez cały okres sprzedaży. Zaleca się przechowywanie danych przez co najmniej 3 lata ze względu na okres przedawnienia dla kontroli UOKiK. System powinien archiwizować wszystkie zmiany z datami i autorami zmian. Na potrzeby audytu warto mieć możliwość wygenerowania pełnego raportu historycznego.

Question 39

Co jeśli popełnię błąd w raportowanych danych?

Accepted Answer

Jeśli zauważysz błąd, powinieneś jak najszybciej dokonać korekty. System automatycznie wygeneruje poprawny plik XML/CSV zaktualizowany o poprawione dane. Ważne jest, aby błędy były korygowane tego samego dnia. Warto prowadzić log zmian, aby w przypadku kontroli UOKiK móc wykazać, że błąd został niezwłocznie poprawiony.

Question 40

Co to znaczy, że extIdent zbioru musi być stały?

Accepted Answer

extIdent to unikalny identyfikator Twojego zbioru danych na portalu dane.gov.pl. Bardzo ważne: extIdent musi być TAKI SAM każdego dnia — nie może zmieniać się między dniami. Jeśli zmienisz extIdent, harvester potraktuje go jako NOWY zbiór, straci ciągłość danych i historię. Przykład poprawny: extIdent='ceny_ofertowe_jtm_001' — ten sam codziennie.

Question 41

Jakie są wymagania wobec strony internetowej?

Accepted Answer

Strona musi spełniać następujące wymagania: być własną stroną dewelopera (nie portal ogłoszeniowy, nie pośrednik), aktywna od dnia rozpoczęcia sprzedaży do przeniesienia praw z ostatniej umowy, publikować aktualne ceny brutto za m² i całkowite, publikować historię zmian cen, zawierać część ogólną prospektu informacyjnego, podawać dane kontaktowe i adres siedziby, być dostępna bez logowania i rejestracji.

Question 42

W jakiej formie prezentować ceny na stronie?

Accepted Answer

Ceny powinny być prezentowane w przejrzystej formie. Najlepiej w postaci tabeli z listą wszystkich dostępnych mieszkań z możliwością sortowania i filtrowania. Cena za m² i cena całkowita muszą być wyraźnie widoczne. Rekomenduje się również: interaktywny rzut kondygnacji z cenami, karty produktowe dla każdego mieszkania, historię zmian cen w formie rozwijanej sekcji lub wykresu.

Question 43

Czy muszę mieć osobną stronę dla każdej inwestycji?

Accepted Answer

Nie ma takiego wymogu. Możesz mieć jedną stronę grupową z podstronami lub filtrowaniem dla poszczególnych inwestycji. Ważne, aby dla każdej inwestycji dane były łatwo dostępne i jednoznacznie przypisane. Strona może być w domenie głównej firmy lub subdomenie (np. apartamenty.firma.pl).

Question 44

Jak często aktualizować ceny na stronie?

Accepted Answer

Ceny na stronie muszą być aktualizowane synchronicznie z danymi raportowanymi do dane.gov.pl. Każda zmiana ceny powinna być widoczna na stronie tego samego dnia. W praktyce oznacza to automatyczną synchronizację — ręczna aktualizacja byłaby bardzo ryzykowna, szczególnie przy większej liczbie mieszkań.

Question 45

Czy mogę używać WordPressa do publikacji cen?

Accepted Answer

Tak, WordPress świetnie się sprawdza. Nasz system oferuje dedykowaną integrację z WordPress, która automatycznie synchronizuje ceny. Możesz użyć gotowej wtyczki lub widgetu do wyświetlania tabeli cenowej. Ważne, aby strona była responsywna i spełniała wszystkie wymogi ustawy.

Question 46

Czy muszę pokazywać ceny w wynikach Google?

Accepted Answer

Nie jest to obowiązkowe, ale bardzo zalecane dla SEO. Możesz użyć strukturalnych danych Schema.org typu RealEstateListing, aby Google mógł wyświetlać ceny mieszkań bezpośrednio w wynikach wyszukiwania. To zwiększa widoczność i buduje zaufanie klientów. Pamiętaj jednak, że dane w Schema.org muszą być zgodne z tymi na stronie.

Question 47

Jak zapewnić responsywność cen na mobile?

Accepted Answer

Prezentacja cen musi być w pełni czytelna na smartfonach i tabletach. Rekomenduje się podejście mobile-first: tabele przekształcają się w karty na małych ekranach, ceny są widoczne bez przewijania w bok, filtrowanie jest wygodne na dotyk, czcionka jest czytelna na małych ekranach. Nasze widgety są domyślnie responsywne.

Question 48

Czy mogę użyć gotowego widgetu do wyświetlania cen?

Accepted Answer

Tak, możesz użyć zewnętrznych widgetów lub iframe'ów, pod warunkiem że dane są aktualne i zgodne z ustawą. Nasz system oferuje gotowe widgety w formie kodu HTML/JS do osadzenia. Widget automatycznie pobiera aktualne dane z naszego systemu i prezentuje je w atrakcyjnej formie. Widget można dostosować kolorystycznie do brandu.

Question 49

Co jeśli moja strona nie jest na WordPressie?

Accepted Answer

Nie ma problemu. Nasz system wspiera każdy rodzaj strony przez: REST API — pobieranie danych w formacie JSON, Widget JS — kod do umieszczenia na dowolnej stronie, Pliki statyczne — eksport HTML/CSV do wgrania na serwer. Możesz też użyć naszej gotowej podstrony z cenami na subdomenie.

Question 50

Jakie informacje muszą być na stronie oprócz cen?

Accepted Answer

Oprócz cen strona musi zawierać: część ogólną prospektu informacyjnego, adres siedziby dewelopera (dla osób fizycznych: adres głównego miejsca działalności), adres lokalu, w którym prowadzona jest sprzedaż, dane kontaktowe (telefon, email), lokalizację przedsięwzięcia deweloperskiego, historię zmian cen dla każdego lokalu.

Question 51

Jak zarejestrować się na portalu dane.gov.pl?

Accepted Answer

Rejestracja na portalu dane.gov.pl przebiega w kilku krokach: 1) Załóż konto na dane.gov.pl, 2) Utwórz profil dostawcy danych, 3) Dodaj zbiór danych (tytuł, opis, kategoria ECON, tagi), 4) Wybierz licencję — Open Government License v3.0 (ID 14), 5) Ustaw częstotliwość aktualizacji na 'daily', 6) Podaj URL do pliku XML manifestu, 7) Poczekaj na akceptację i pierwsze pobranie. Instrukcja krok po kroku dostępna jest na stronie cms.dane.gov.pl.

Question 52

Jak działa mechanizm pobierania danych (harvester)?

Accepted Answer

Harvester to system rządowy, który codziennie pobiera pliki z Twojego serwera. Działa to tak: Ty udostępniasz plik XML manifestu pod stałym adresem URL, harvester codziennie o ustalonej porze pobiera ten plik, weryfikuje zgodność ze schematem XSD, pobiera plik z danymi (CSV/XML), weryfikuje sumę kontrolną MD5, aktualizuje bazę danych na dane.gov.pl. Jeśli któryś krok się nie powiedzie, zbiór zostanie oznaczony jako nieaktualny.

Question 53

Jaka jest struktura pliku XML manifestu?

Accepted Answer

Plik XML manifestu ma następującą strukturę: namespace urn:otwarte-dane:harvester:1.13, elementy: extIdent (stały identyfikator zbioru), extTitle (nazwa zbioru), category (ECON dla ekonomii), frequency (daily), licenseId (14 dla OGL), resources z elementem resource zawierającym: extIdent, url (link do pliku z danymi), format (csv/xml), availability (active). Przykładowy manifest jest dostępny w dokumentacji na dane.gov.pl.

Question 54

Jakie są najczęstsze błędy przy raportowaniu?

Accepted Answer

Najczęstsze błędy to: 1) Niewłaściwy namespace XML — musi być urn:otwarte-dane:harvester:1.13, 2) Zmienny extIdent zbioru między dniami — harvester traktuje jako nowy zbiór i gubi historię, 3) Brak licenseId — wymagany od v1.13, 4) Zły format daty — wszystkie daty w formacie YYYY-MM-DD, 5) plik CSV bez BOM — polskie znaki jako krzaki, 6) Cena z walutą 'zł' w polu numerycznym — walidacja XSD failuje.

Question 55

Czy muszę raportować w weekendy i święta?

Accepted Answer

Tak, raportowanie musi odbywać się 365 dni w roku, również w soboty, niedziele i święta państwowe. Ustawa nie przewiduje dni wolnych od raportowania. W praktyce oznacza to konieczność w pełni zautomatyzowanego systemu, który generuje i udostępnia pliki bez ingerencji człowieka.

Question 56

Jakie informacje musi zawierać plik XML?

Accepted Answer

Plik XML musi zawierać: dane identyfikacyjne dewelopera (NIP, nazwa), adres inwestycji (województwo, powiat, gmina, miejscowość, ulica, numer), dane każdego lokalu (identyfikator, powierzchnia, liczba pokoi, piętro, cena za m² brutto, cena całkowita brutto, status, data aktualizacji). Struktura musi być zgodna ze schematem XSD opublikowanym przez Ministerstwo Cyfryzacji.

Question 57

Co się stanie, jeśli dane.gov.pl będzie niedostępny?

Accepted Answer

Jeśli portal dane.gov.pl jest chwilowo niedostępny, Twój system powinien automatycznie ponawiać próbę wysłania danych. Ważne jest, aby plik był dostępny pod stałym adresem URL przez cały czas — harvester sam ponowi próbę przy następnym cyklu. System automatycznie loguje wszystkie próby synchronizacji i informuje o błędach.

Question 58

Jak zweryfikować czy raportowanie działa poprawnie?

Accepted Answer

Poprawność raportowania można zweryfikować przez: sprawdzenie statusu zbioru w panelu dane.gov.pl (powinien być 'Aktualny'), walidację pliku XML narzędziem xmllint, sprawdzenie daty ostatniej aktualizacji na dane.gov.pl (powinna być z wczoraj), pobranie i weryfikację pliku przez curl z Twojego serwera, monitorowanie logów synchronizacji w systemie.

Question 59

Czy muszę raportować wszystkie inwestycje naraz?

Accepted Answer

Nie, każda inwestycja może być raportowana osobno, jako oddzielny zbiór na dane.gov.pl. Możesz też zgrupować wszystkie inwestycje w jeden zbiór. Ważne, aby każda inwestycja była jednoznacznie identyfikowana. Najlepiej utworzyć osobny plik danych (lub osobny zbiór) dla każdej inwestycji.

Question 60

Jaka jest różnica między XML manifestu a XML z danymi?

Accepted Answer

Plik XML manifestu to 'opakowanie' zawierające metadane zbioru — identyfikator, nazwę, kategorię, częstotliwość, licencję i link do pliku z danymi. To ten plik podajesz do dane.gov.pl. Plik z danymi (CSV lub XML) to właściwe dane o lokalach. Manifest wskazuje harvesterowi, gdzie szukać danych i jak je interpretować.

Question 61

Ile dokładnie kolumn ma plik CSV?

Accepted Answer

Plik CSV musi zawierać dokładnie 58 kolumn. Ani 57, ani 60 — dokładnie 58. Każda kolumna ma określoną nazwę, typ danych i pozycję. Przed pierwszym uruchomieniem pobierz oficjalny szablon z dane.gov.pl i upewnij się, że Twoje narzędzie eksportuje dokładnie 58 kolumn w odpowiedniej kolejności.

Question 62

Jakie kodowanie powinien mieć plik CSV?

Accepted Answer

Kodowanie musi być UTF-8 z BOM (Byte Order Mark). BOM to trzy pierwsze bajty pliku: EF BB BF. Bez BOM harvester może błędnie odczytać polskie znaki diakrytyzowane (ą, ć, ę, ł, ń, ó, ś, ź, ż) jako 'krzaki'. Excel domyślnie zapisuje CSV w kodowaniu Windows-1250 — to najczęstszy błąd polskich deweloperów.

Question 63

Jaki separator dziesiętny i pól w CSV?

Accepted Answer

Separator pól: przecinek (,). Separator dziesiętny: kropka (.). To ważne: w polskiej wersji Excela domyślnym separatorem dziesiętnym jest przecinek, a separatorem pól średnik. Musisz to zmienić w ustawieniach lub programowo. Przykład poprawnej ceny: 499000.60 (nie 499000,60 ani '499000,60 zł').

Question 64

Gdzie znaleźć oficjalny schemat XSD?

Accepted Answer

Oficjalny schemat XSD (otwarte_dane_latest.xsd) dostępny jest na stronie Ministerstwa Cyfryzacji pod adresem: https://www.dane.gov.pl/static/xml/otwarte_dane_latest.xsd. Obecnie obowiązuje wersja 1.13. Schemat definiuje strukturę pliku XML manifestu, wymagane elementy, typy danych i ograniczenia. Zawsze używaj najnowszej wersji schematu.

FAQ — Pytania i Odpowiedzi

Nadal masz pytania?

FAQ — Pytania i Odpowiedzi

Nadal masz pytania?