Wzór pliku CSV dla dane.gov.pl: przykład raportu cen mieszkań do pobrania (2025 i od 11.11.2026)

Wzór pliku z cenami mieszkań dla dane.gov.pl to tabela CSV, w której każdy wiersz opisuje jeden lokal albo dom, a kolumny idą w kolejności z wzorca ministerstwa. Do 10 listopada 2026 r. stosuje się wzorcowy zakres danych z 22 lipca 2025 r. (58 kolumn), a od 11 listopada 2026 r. strukturę z rozporządzenia ministra cyfryzacji (57 pól). Poniżej oba przykłady do pobrania, wypełnione dla trzech lokali, opis tego, co trafia do których kolumn, i lista błędów, przez które plik wygląda dobrze w Excelu, a w portalu już nie.

Przykładowe pliki do pobrania

Oficjalny wzorzec ministerstwa ma poprawne nagłówki, ale w przykładowych wierszach zamiast danych stoi słowo „tekst”. Nasze pliki mają te same nagłówki i trzy lokale wypełnione tak, jak robi to raport z prawdziwej inwestycji:

• Wzór od 11 listopada 2026 r. – 57 pól ze struktury w projekcie rozporządzenia (CSV, UTF-8, separator „;”),
• Wzór do 10 listopada 2026 r. – 58 kolumn wzorcowego zakresu danych z 2025 r. (CSV, UTF-8, separator „;”).

Dane w przykładach są fikcyjne: NIP 1234567890 ma błędną cyfrę kontrolną, a adresy e-mail i strony są w domenie example.com, zarezerwowanej do przykładów. Oryginalny wzorzec pobierzesz z materiałów dla deweloperów na dane.gov.pl.

Który wzór obowiązuje i kiedy

Skąd ta zmiana i co jeszcze reguluje rozporządzenie, opisujemy w artykule o nowej strukturze danych od 11 listopada 2026 r. Tu skupiamy się na samym pliku.

Jak wygląda wypełniony wiersz

Pierwsze 34 pola (w strukturze od 11 listopada) są takie same w każdym wierszu danej inwestycji: dane firmy, adres siedziby, adres biura sprzedaży i lokalizacja inwestycji. Dopiero od pola E1 zaczyna się konkretny lokal. Fragment pierwszego wiersza z naszego przykładu:

Trzy lokale, trzy sytuacje

Przykład pokazuje trzy najczęstsze układy oferty. Każdy kolejny wiersz różni się tylko polami od E1 w górę:

1. Mieszkanie A/1.05 z obowiązkowym miejscem postojowym i komórką do wyboru. Miejsce MP-12 (35 000 zł) trzeba kupić razem z mieszkaniem, więc trafia do grupy F i do ceny łącznej E7 (655 000 + 35 000 = 690 000 zł). Komórka KL-5 (12 000 zł) jest opcjonalna: ma cenę w grupie G, ale nie wchodzi do ceny łącznej.
2. Mieszkanie A/2.07 bez dodatków. Cena łączna byłaby równa cenie lokalu, więc pola E7, E8 i grupy F–I mają „X”.
3. Dom D-3 z udziałem w drodze wewnętrznej i zwrotem kosztów przyłączy. Udział w drodze (15 000 zł) to prawo niezbędne do korzystania z domu – grupa H. Zwrot kosztów przyłączy (6 000 zł) to inne świadczenie pieniężne – grupa I. Oba wchodzą do ceny łącznej: 1 054 650 + 15 000 + 6 000 = 1 075 650 zł.

Kiedy dodatek wchodzi do ceny łącznej, a kiedy nie, i co zrobić z kilkoma komórkami przy jednym mieszkaniu – rozpisujemy w artykule cena łączna, miejsce postojowe i komórka w raporcie.

Ten sam lokal w dwóch formatach

Zakres danych się nie zmienia. Zmienia się zapis. Ten sam lokal w pliku sprzed 11 listopada i po nim:

Lokal mieszkalny;A/1.05;12500,00;2026-10-01 00:00:00;655000,00;…

lokal mieszkalny;A/1.05;12500,00;2026-10-01;655000,00;…

A tak wyglądają zapisy, które od 11 listopada będą niezgodne ze strukturą:

NIP: 123-456-78-90          1234567890
Telefon: +48 501 234 567    +48501234567
Data: 01.10.2026            2026-10-01
Cena: 655 000 zł            655000,00
Pole bez wartości: (puste)  X

Najczęstsze błędy w pliku z cenami

Od 25 września 2025 r. portal nie pokazuje deweloperom wyników walidacji plików z cenami. Sprawdza plik XML, a plik CSV opublikuje nawet z błędami. Dlatego warto znać typowe pułapki:

• Kodowanie inne niż UTF-8. Plik zapisany w Excelu jako zwykły CSV ma kodowanie Windows-1250 – na portalu „Łódź” zamienia się w krzaczki.
• Średnik w treści pola. Opis w stylu „parking; komórka” przesuwa wszystkie dalsze kolumny o jedną. Średnik w treści zamień na przecinek albo całe pole ujmij w cudzysłów.
• Zmieniony albo skrócony nagłówek. Nazwy kolumn mają być takie jak we wzorcu. Ze skrótów typu „Cena m2” nie wynika, które to pole.
• Kolumny w innej kolejności. Struktura od 11 listopada wymaga kolejności z tabeli w załączniku, a dodatkowych kolumn nie przewiduje.
• Data wygenerowania pliku zamiast daty ceny. Pola z datą mówią, od kiedy obowiązuje cena. Jeśli codziennie wpisujesz dzisiejszą datę, historia cen w danych publicznych traci sens.
• Kwoty jako tekst. „655 000 zł” czy „655.000,00” to dla programu tekst, a nie liczba.
• Puste komórki. Od 11 listopada w polach bez zastosowania ma stać „X”.
• Dane innej spółki. Przy kilku spółkach celowych łatwo skopiować NIP lub KRS z innej inwestycji – opisujemy to w artykule o raportowaniu inwestycji kilku spółek.

Sam plik CSV to nie wszystko

Portal nie przyjmuje pliku wgranego ręcznie. Każdy dzienny plik z cenami musi być opisany w pliku XML na Twoim serwerze, a obok XML-a ma leżeć suma kontrolna MD5. Dane.gov.pl raz na dobę pobiera XML i wskazane w nim pliki. Cały proces opisujemy w przewodniku jak raportować ceny mieszkań do dane.gov.pl, a błędy walidacji XML-a – w artykule o błędach 403, 404 i 500.

Jak sprawdzić swój plik w pięciu krokach

1. Pobierz plik, który naprawdę pobiera portal

   Otwórz swój plik XML, znajdź najnowszy zasób i pobierz plik spod adresu z pola url. Sprawdzaj ten plik, a nie wersję roboczą z dysku.

2. Otwórz go w edytorze tekstu

   Notatnik albo inny edytor pokaże kodowanie, separatory i puste pola dokładnie tak, jak widzi je portal. Excel część błędów ukrywa.

3. Policz kolumny w nagłówku

   58 do 10 listopada 2026 r., 57 od 11 listopada. Każdy wiersz musi mieć tyle samo pól co nagłówek.

4. Sprawdź daty, kwoty i numery

   Daty jako RRRR-MM-DD, kwoty z dwoma miejscami po przecinku, NIP i KRS bez spacji, telefon bez spacji.

5. Porównaj trzy lokale z cennikiem na stronie

   Cena, cena za m², dodatki i daty muszą być takie same jak na stronie. Rozbieżność to dwa różne cenniki.

Jeśli raport tworzy wtyczka DeweloperCeny, plik ma dokładnie układ z tego artykułu: od wersji 2.25 kolumny wzorca z 2025 r., a 11 listopada 2026 r. wtyczka sama przełączy się na strukturę z rozporządzenia, bez zmiany adresów XML i MD5 zgłoszonych na portalu. Prowadzisz cennik w Excelu? Zobacz, jak przenieść cennik z Excela do raportu bez przepisywania lokali.