Jak przygotować feed cen mieszkań do dane.gov.pl krok po kroku
Przygotowanie poprawnego feedu cen do dane.gov.pl wygląda groźnie tylko na papierze. W praktyce to kilka uporządkowanych kroków: jedno źródło danych, czyste mapowanie pól, właściwy format i walidacja przed wysyłką. Poniżej rozkładamy proces na czynniki pierwsze.
W skrócie
- Zacznij od jednego, wiarygodnego źródła danych o lokalach.
- Zmapuj pola raz — kolejność i nazwy kolumn muszą się zgadzać.
- Wybierz format (CSV lub XML) i trzymaj się stałej struktury.
- Zwaliduj plik przed wysyłką i zaplanuj codzienną aktualizację.
Krok 1: zacznij od jednego źródła danych
Najczęstszy błąd to rozproszone dane — część cen w arkuszu, część w CRM, część na stronie. Zanim cokolwiek wyślesz, ustal jedno miejsce, które jest „prawdą” o cenach i lokalach. Jeśli prowadzisz stronę na WordPressie, naturalnym źródłem są wpisy o lokalach wraz z ich polami.
Dzięki temu feed buduje się zawsze z tych samych danych, a Ty nie musisz ręcznie godzić rozjazdów między systemami.
Krok 2: zmapuj wymagane pola
Zbiór ma stałą strukturę, więc każde wymagane pole z formatu trzeba powiązać z odpowiednim polem w Twoich danych. To jednorazowa konfiguracja, która potem działa automatycznie.
- Identyfikator i powierzchnia lokalu
- Cena za metr kwadratowy i cena całego lokalu
- Lokalizacja inwestycji i dane dewelopera
- Data obowiązywania ceny oraz odnośnik do prospektu
Krok 3: wybierz format
Dane udostępnia się w formacie otwartym i maszynowo czytelnym — najczęściej CSV lub XML. CSV jest prostszy i lżejszy, XML bywa wygodniejszy przy bardziej złożonych strukturach. Niezależnie od wyboru, kluczowe jest zachowanie stałej kolejności i nazw kolumn.
Używaj UTF-8 i właściwego separatora. Polskie znaki w złym kodowaniu to częsta przyczyna problemów z odczytem pliku.
Krok 4: zwaliduj plik przed wysyłką
Zanim plik trafi do portalu, sprawdź, czy nie brakuje wymaganych kolumn, czy ceny są liczbami, a statusy lokali mają dozwolone wartości. Walidacja na tym etapie oszczędza nerwów później — odrzucony zbiór to stracony dzień zgodności.
Krok 5: zaplanuj codzienną wysyłkę
Obowiązek jest codzienny, więc ręczne wgrywanie pliku szybko staje się ciężarem. Zaplanuj generowanie i wysyłkę o stałej porze — najlepiej w nocy, gdy nie ma ruchu. Wtyczka taka jak Jawny Developer robi to automatycznie i pilnuje historii zmian.
Najczęstsze pytania
Czy lepszy jest CSV czy XML?
Oba formaty są akceptowane. CSV jest prostszy i wystarcza w większości przypadków; XML bywa wygodniejszy przy bardziej rozbudowanych danych. Najważniejsza jest zgodność ze stałą strukturą.
Jak często muszę aktualizować feed?
Codziennie — zbiór ma odzwierciedlać aktualny stan cen. Dlatego warto zautomatyzować generowanie i wysyłkę zamiast robić to ręcznie.
Co jeśli dodam nowy lokal w trakcie sprzedaży?
Nowy lokal powinien pojawić się w kolejnym wygenerowanym feedzie. Przy automatycznej konfiguracji dzieje się to bez Twojego udziału.
Czy mogę przetestować feed przed publikacją?
Tak. Wygeneruj plik z nagłówkami do podglądu i zwaliduj go lokalnie, zanim trafi do dane.gov.pl.
Zgodność z dane.gov.pl bez przepisywania CRM
Skonfigurujemy codzienny feed cen mieszkań po Twojej stronie — od A do Z.