Poradnik

Wzór CSV: ceny mieszkań do dane.gov.pl

Aktualizacja: 16.07.2026 · Operator Oferty

Walidator dane.gov.pl przyjmuje plik w układzie ustawowym — co do znaku. Ten artykuł opisuje, co musi zawierać wiersz lokalu i skąd wziąć bezpieczny szablon.

Do czego służy ten plik

CSV to rdzeń raportu dobowego: tabela, w której każdy lokal Twojej inwestycji ma osobny wiersz. Z tego pliku administracja — a od wiosny 2027 r. planowo także rządowy Portal DOM — odczytuje ceny ofertowe. Razem z CSV publikujesz XML metadanych (schemat harvester 1.13) i sumy kontrolne MD5.

Co musi znaleźć się w wierszu lokalu

Układ kolumn wynika z art. 19a–19b ustawy deweloperskiej. Co do zasady wiersz lokalu opisuje:

• identyfikację lokalu — dane pozwalające jednoznacznie wskazać lokal w inwestycji,
• ceny — cenę m² i cenę całkowitą lokalu,
• przynależności — miejsca postojowe, komórki lokatorskie i inne elementy nabywane z lokalem,
• świadczenia dodatkowe — pozycje płatne obok ceny lokalu,
• daty — dzięki którym da się odtworzyć, od kiedy obowiązuje cena.

Świadomie nie publikujemy tu własnej listy nazw kolumn: walidator wymaga układu ustawowego co do znaku, a przepisany „z pamięci” nagłówek to typowa przyczyna odrzutu. Pracuj na szablonie zgodnym z aktualnym schematem.

Zasady techniczne, które oszczędzają odrzutów

• Jedno źródło danych. Plik generuj z cennika, z którego korzysta też strona inwestycji — nie z równoległego arkusza.
• Sumy MD5 na końcu. Wyliczaj z finalnych plików; każda późniejsza poprawka wymaga przeliczenia.
• Spójne kodowanie i separatory. Eksport z arkusza kalkulacyjnego potrafi po cichu zmienić jedno i drugie.
• Kompletność wierszy. Lokal wycofany ze sprzedaży to zmiana statusu, nie zniknięcie wiersza bez śladu.

Diagnozę konkretnych komunikatów walidatora zebraliśmy w artykule Błędy walidacji dane.gov.pl.

Więcej o całym procesie raportowania: Raport i zgodność oraz instrukcja Jak zgłosić ceny mieszkań na dane.gov.pl.