Strona na Wix, Webflow albo własnym CMS: jak spełnić jawność cen bez przenoszenia strony
Strona dewelopera stoi na kreatorze albo na systemie od agencji i dobrze wygląda – tylko nie umie prowadzić historii cen, liczyć najniższej ceny z 30 dni ani wystawiać codziennego pliku dla dane.gov.pl. Nie trzeba jej przenosić. Pokazujemy trzy sposoby, jak dołożyć jawność cen do istniejącej strony, i jak działa wariant, w którym ceny wczytują się do jej obecnego wyglądu.
W skrócie
- Strony nie trzeba przenosić: cennik z historią cen i raport dla dane.gov.pl może prowadzić osobna instalacja WordPress z wtyczką, np. na podstronie albo subdomenie, a obecna strona linkuje do cennika albo pobiera ceny przez API.
- API wtyczki DeweloperCeny jest tylko do odczytu, zwraca JSON bez klucza i zawiera lokale, ceny, statusy, historię zmian i najniższą cenę z 30 dni przed obniżką.
- Raport dla dane.gov.pl powstaje w instalacji z wtyczką, więc to jej adresy XML i MD5 zgłasza się w portalu i one nie mogą się zmieniać.
- Strona na Joomli może mieć tę samą wtyczkę w wersji dla Joomli, a dla Drupala przygotowujemy moduł na zamówienie.
Spis treści 7 części
Strony na kreatorze albo własnym systemie nie trzeba przenosić, żeby spełnić ustawę o jawności cen. Cennik z historią zmian, najniższą ceną z 30 dni i codziennym raportem dla dane.gov.pl może prowadzić osobna instalacja WordPress z wtyczką – na podstronie albo subdomenie – a obecna strona albo linkuje do cennika, albo pobiera z niego ceny przez API i pokazuje je w swoim wyglądzie. Wybór zależy od tego, czy kreator pozwala wstawić własny kod i ile pracy chcesz włożyć w wygląd. Poniżej trzy sposoby i szczegóły wariantu z API.
Prowadzisz stronę dewelopera jako agencja albo masz własny zespół? Dokumentacja tras, pól i przykładów jest na stronie API dla agencji, a samą wtyczkę do jawności cen mieszkań zobaczysz w demo.
Dlaczego sam kreator stron nie wystarczy
Tabelę z cenami da się postawić w każdym kreatorze. Ustawa wymaga jednak więcej niż tabeli:
- Cena przy każdym oferowanym lokalu, aktualizowana z dniem zmiany, z historią od rozpoczęcia sprzedaży (art. 19a ust. 1 i 2 ustawy deweloperskiej). Ręcznie edytowana tabela nadpisuje starą cenę i nie zostawia śladu.
- Najniższa cena z 30 dni przed obniżką przy każdej promocji (art. 4 ustawy o informowaniu o cenach) – liczona z historii.
- Raz na dobę te same dane dla dane.gov.pl (art. 19b): plik CSV i XML z sumą kontrolną MD5 pod stałym adresem https, który portal pobiera sam.
Typowy kreator nie zapisuje historii zmian w tabeli, nie liczy najniższej ceny z 30 dni i nie wystawia plików dla portalu. Ręczne prowadzenie tego obok strony to codzienna praca i ryzyko, że strona i raport pokażą co innego.
Trzy sposoby bez przenoszenia strony
| Sposób | Jak działa | Kiedy wybrać |
|---|---|---|
| 1. Cennik na podstronie albo subdomenie | WordPress z wtyczką pod adresem typu ceny.twojafirma.pl prowadzi cennik, karty lokali i raport. Obecna strona linkuje do niego z menu, z pierwszego ekranu i z kart inwestycji. Wygląd cennika dopasowuje się do strony. | Najszybszy start, gdy kreator nie pozwala na własny kod albo nie chcesz zmieniać strony |
| 2. Ceny w obecnym wyglądzie przez API | WordPress z wtyczką działa w tle (np. na subdomenie) i prowadzi cennik oraz raport. Strona pobiera przez API lokale, ceny, statusy, historię i najniższą cenę z 30 dni i wstawia je we własne karty i tabele. | Gdy strona ma dopracowany wygląd, a kreator pozwala wstawić własny kod HTML i JavaScript |
| 3. Wtyczka w CMS strony | Strona na Joomli korzysta z wersji wtyczki dla Joomli, na Drupalu – z modułu na zamówienie, a strona na WordPressie (także z Elementorem czy Avadą) – ze zwykłej wtyczki. | Gdy strona stoi na Joomli, Drupalu albo WordPressie |
Dla stron na Joomli przygotowaliśmy wtyczkę dla Joomli, a dla Drupala moduł na zamówienie. Przy podziale na kilka adresów warto przeczytać, jak wybrać między osobną domeną a podstroną.
Jak działa wariant z API
Wtyczka DeweloperCeny udostępnia publiczne API tylko do odczytu. Odpowiedzi są w JSON, bez logowania i bez klucza – to te same dane, które i tak są na stronie z cenami. Sześć tras pokrywa listę lokali, kartę lokalu i historię:
| Trasa | Co zwraca |
|---|---|
inwestycje | Lista inwestycji z adresem, liczbą lokali i licznikami statusów |
inwestycje/{id} | Jedna inwestycja: adres, deweloper, prospekt, termin ukończenia |
inwestycje/{id}/lokale | Lokale inwestycji z filtrem statusu, sortowaniem i stronicowaniem |
lokale/{id} | Karta lokalu: ceny, dodatki, opis, grafiki, historia cen i najniższa cena z 30 dni |
lokale/{id}/podobne | Inne lokale tej inwestycji, najpierw dostępne |
lokale/{id}/historia | Historia zmian ceny: kwoty przed i po zmianie z datą |
Każda trasa ma prefiks /wp-json/deweloper-oferty/v1/ na adresie instalacji z wtyczką. Fragment kodu na stronie wczytuje dane i wstawia je w karty, na przykład:
fetch('https://ceny.twojafirma.pl/wp-json/deweloper-oferty/v1/inwestycje/1/lokale')
.then(function (odp) { return odp.json(); })
.then(function (dane) { /* wstaw cenę, cenę za m², status i najniższą cenę z 30 dni do swoich kart */ });
Kilka rzeczy, które warto wiedzieć przed projektem:
- Najniższa cena z 30 dni jest w danych (pole
najnizsza_30_dni) i przy obniżce musi być widoczna obok ceny – zaplanuj na nią miejsce w karcie od początku. - Ukryte ceny są ukryte też w API. Jeśli deweloper chowa ceny sprzedanych lokali, API zwraca puste pole i flagę
ceny_ukryte, więc strona nie pokaże więcej niż cennik. - Lokal ma stały identyfikator, który nie zmienia się przy edycji ani ponownym imporcie cennika – przydaje się do powiązań i ukrytego pola w formularzu zapytania.
- Dostęp z innej domeny. Domyślnie API odpowiada każdej stronie, która o nie zapyta. Deweloper może w ustawieniach wpisać listę domen, które mogą wczytywać cennik przez przeglądarkę.
- Zapis to osobna sprawa. Zmiana ceny albo statusu z CRM wymaga klucza API zapisu, który jest domyślnie wyłączony, a każda zmiana trafia do historii cen.
Z praktyki wdrożeń
Strona inwestycji zbudowana w Elementorze miała własny, dopracowany wygląd kart lokali – z rzutami, galerią i kartami do pobrania. Zamiast zastępować je tabelą, dopisaliśmy do strony skrypt, który pobiera z API wtyczki ceny, statusy, metraże, historię ceny i najniższą cenę z 30 dni i podmienia je w istniejących kartach. Wygląd strony się nie zmienił, a cennik, historia i raport dla dane.gov.pl działają z jednego panelu. Opis tego wdrożenia znajdziesz w realizacji ceny z API na stronie zbudowanej w Elementorze.
Ten sam sposób sprawdza się przy stronach zbudowanych w innych kreatorach dla WordPressa, np. w Avadzie, i przy stronach poza WordPressem, o ile pozwalają wstawić własny kod.
Co z raportem dla dane.gov.pl
Raport powstaje w instalacji z wtyczką, nie w kreatorze. To jej adresy pliku XML i sumy kontrolnej MD5 zgłasza się w portalu dane.gov.pl i to one muszą być stałe i dostępne po https – przy kolejnych zmianach wyglądu strony nie wolno ich ruszać. Licencję wtyczki wystawiamy na adres instalacji, w której działa wtyczka.
Jak przebiega zgłoszenie krok po kroku, opisujemy w przewodniku jak raportować ceny mieszkań do dane.gov.pl, a jeśli pliki trafiały dotąd do portalu ręcznie – w artykule z ręcznego wgrywania na import XML. Gdy cennik żyje w systemie sprzedaży, opisujemy osobno raport dla dane.gov.pl, gdy cennik jest w CRM albo ERP.
Najczęstsze pytania
Czy strona na Wix albo Webflow może spełniać ustawę o jawności cen?
Może, jeśli cennik z historią zmian, najniższą ceną z 30 dni i codziennym raportem dla dane.gov.pl prowadzi narzędzie, które to potrafi. Najprościej postawić je obok: na subdomenie albo podstronie z WordPressem i wtyczką, do której linkuje obecna strona albo z której pobiera ceny przez API.
Czy cennik może być na subdomenie, np. ceny.firma.pl?
Tak. Subdomena firmy jest częścią strony dewelopera, a ważne jest, żeby kupujący łatwo trafiał na cennik ze strony inwestycji i żeby reklamy podawały adres strony z cenami (art. 19a ust. 3 ustawy deweloperskiej). Ten sam adres instalacji zgłasza się na dane.gov.pl jako źródło raportu.
Czy API wtyczki DeweloperCeny wymaga klucza?
Odczyt nie wymaga klucza: lokale, ceny, statusy, historia cen i najniższa cena z 30 dni są dostępne publicznie w JSON, bo i tak są na stronie. Klucz jest potrzebny tylko do zapisu – API zapisu dla CRM jest domyślnie wyłączone.
Czy obca strona może pobierać ceny z API przez przeglądarkę?
Tak, domyślnie API odpowiada każdej domenie, bo to dane publiczne. Jeśli deweloper chce, wpisuje w ustawieniach listę domen, które mogą wczytywać cennik przez przeglądarkę – wtedy inne strony go nie wczytają.
Źródła i podstawa prawna
Stan prawny na 29 października 2026. Artykuł ma charakter informacyjny i nie jest poradą prawną.
- Ustawa z dnia 20 maja 2021 r. o ochronie praw nabywcy lokalu mieszkalnego lub domu jednorodzinnego oraz Deweloperskim Funduszu Gwarancyjnym (tekst jednolity) Dz.U. 2026 poz. 880
- Ustawa z dnia 9 maja 2014 r. o informowaniu o cenach towarów i usług (tekst jednolity) Dz.U. 2023 poz. 168
- ISAP: ustawa deweloperska, tekst jednolity Dz.U. 2026 poz. 880 (art. 19a, art. 19b)
- dane.gov.pl: udostępnianie danych dotyczących cen mieszkań – informacje dla deweloperów