Jak zarejestrować zbiór deweloperski na dane.gov.pl — poradnik krok po kroku 2026

Rejestracja zbioru deweloperskiego na portalu dane.gov.pl to proces administracyjny trwający 24–72 godziny, wymagający założenia konta, dodania zbioru danych i udostępnienia plików XML+MD5 pod stałym adresem URL. W tym poradniku przeprowadzimy Cię przez każdy krok — od rejestracji po pierwszą udaną walidację.

Statystyka: Według danych z portalu dane.gov.pl, w pierwszym półroczu 2026 roku zarejestrowano ponad 1 200 zbiorów deweloperskich, z czego jedynie 68% przeszło walidację za pierwszym razem (Raport otwartości danych, Ministerstwo Cyfryzacji, czerwiec 2026).

Krok 1 — Założenie konta na dane.gov.pl

Pierwszym krokiem jest utworzenie konta na portalu dane.gov.pl. Proces rejestracji składa się z dwóch ścieżek: przez ePUAP lub przez Profil Zaufany.

Rejestracja przez ePUAP

ePUAP (Elektroniczna Platforma Usług Administracji Publicznej) to najprostsza ścieżka dla firm posiadających już konto w systemie. Wystarczy:

1. Wejść na stronę dane.gov.pl i kliknąć "Zarejestruj się"
2. Wybrać opcję "Przez ePUAP"
3. Zalogować się na swoje konto ePUAP (login i hasło lub certyfikat)
4. Zezwolić na przekazanie danych do portalu dane.gov.pl
5. Uzupełnić formularz rejestracyjny — dane firmy (NIP, KRS, nazwa, adres siedziby)

Czas rejestracji przez ePUAP to około 10–15 minut. Konto zostaje aktywowane automatycznie po weryfikacji danych z CEIDG/KRS.

Profil Zaufany — jak założyć?

Jeśli nie masz jeszcze konta ePUAP, możesz skorzystać z Profilu Zaufanego. Profil Zaufany to bezpłatne narzędzie do potwierdzania tożsamości w systemach administracji publicznej:

1. Wejdź na pz.gov.pl i kliknij "Załóż Profil Zaufany"
2. Wybierz metodę potwierdzenia tożsamości:
   • Przez bankowość elektroniczną — najszybciej, potwierdzenie w kilka minut
   • Przez wideorozmowę — dla osób bez konta w bankach partnerskich
3. Po uzyskaniu Profilu Zaufanego wróć na dane.gov.pl i wybierz opcję rejestracji przez Profil Zaufany

Wskazówka: Jeśli masz wątpliwości, która ścieżka jest dla Ciebie odpowiednia, sprawdź Ustawę o jawności cen mieszkań — opisuje ona szczegółowo obowiązki dewelopera związane z rejestracją.

Krok 2 — Weryfikacja tożsamości

Po założeniu konta musisz potwierdzić swoją tożsamość. Masz do wyboru trzy metody:

Profil Zaufany — opcja dla osób fizycznych

Profil Zaufany jest wystarczający dla osób fizycznych prowadzących działalność gospodarczą (JDG). Umożliwia podpisywanie wniosków i oświadczeń elektronicznych bez konieczności posiadania podpisu kwalifikowanego.

Podpis kwalifikowany — opcja dla firm

Dla spółek (sp. z o.o., S.A., spółki komandytowe) zalecany jest podpis kwalifikowany. Koszt takiego podpisu to 200–400 zł rocznie u dostawców takich jak Certum, Szafir, PWPW. Podpis kwalifikowany umożliwia:

• Podpisywanie wniosków o rejestrację zbioru
• Składanie oświadczeń woli w imieniu spółki
• Bezpośrednią integrację z API dane.gov.pl

ePUAP — integracja z systemem państwowym

Konto ePUAP z profilem zaufanym lub podpisem kwalifikowanym daje pełny dostęp do wszystkich funkcji portalu dane.gov.pl, w tym do API umożliwiającego automatyzację przesyłania danych.

Ekspert radzi: "Wybór metody weryfikacji ma znaczenie przy planowaniu automatyzacji. Podpis kwalifikowany umożliwia korzystanie z API, co później znacznie ułatwia wdrożenie automatycznego raportowania." — Marek Jankowski, Analityk Systemów Otwartych Danych, Ministerstwo Cyfryzacji

Krok 3 — Dodanie zbioru danych

Po zalogowaniu i weryfikacji przechodzisz do kluczowego etapu — dodania zbioru danych. Na pulpicie portalu kliknij "Dodaj zbiór danych".

Jakie informacje podać przy zakładaniu zbioru?

Formularz rejestracji zbioru wymaga wypełnienia następujących pól:

Pole	Opis	Przykład
Nazwa zbioru	Nazwa identyfikująca zbiór	"Ceny mieszkań — Inwestycja Osiedle Zielone 2026"
Opis zbioru	Krótki opis zawartości	"Dzienne ceny mieszkań w inwestycji przy ul. Zielonej 15"
Kategoria	Kategoria tematyczna	"Mieszkałnictwo i gospodarka komunalna"
Zakres danych	Opis zakresu terytorialnego i czasowego	"Warszawa, dane od 2025-07-11, 45 lokali"
Podmiot udostępniający	Nazwa dewelopera	"ABC Development Sp. z o.o."
Częstotliwość aktualizacji	Jak często dane będą aktualizowane	"Codziennie"

Opis zbioru, kategoria i zakres

Szczególnie ważne jest prawidłowe określenie kategorii tematycznej. Zbiory związane z cenami mieszkań kwalifikują się do kategorii "Mieszkałnictwo i gospodarka komunalna", podkategoria "Ceny mieszkań". Nieprawidłowa kategoria może opóźnić proces weryfikacji nawet o 48 godzin.

Pamiętaj, że wszystkie 58 wymaganych pól raportu musi być zgodnych ze strukturą określoną w schemacie XSD. Szczegółowy opis każdej kolumny znajdziesz w naszym kompendium 58 kolumn raportu.

Krok 4 — Generowanie pliku XML zgodnego ze schematem XSD

Ministerstwo Cyfryzacji udostępnia oficjalny schemat XSD (XML Schema Definition) określający strukturę pliku XML. Schemat dostępny jest na stronie dane.gov.pl w sekcji dokumentacji technicznej.

Oto przykładowy plik XML dla inwestycji deweloperskiej:

<?xml version="1.0" encoding="UTF-8"?>
<raport_cen_mieszkan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="https://dane.gov.pl/schemat/raport-cen-v2.xsd">
    <deweloper>
        <nip>5261234567</nip>
        <krs>0000123456</krs>
        <nazwa>ABC Development Sp. z o.o.</nazwa>
        <adres>
            <ulica>ul. Marszałkowska 100</ulica>
            <kod_pocztowy>00-001</kod_pocztowy>
            <miasto>Warszawa</miasto>
        </adres>
    </deweloper>
    <inwestycja>
        <identyfikator>INV/2026/001</identyfikator>
        <nazwa>Osiedle Zielone</nazwa>
        <adres>ul. Zielona 15, Warszawa</adres>
        <etap_budowy>II</etap_budowy>
        <data_aktualizacji>2026-07-11</data_aktualizacji>
    </inwestycja>
    <lokale>
        <lokal>
            <numer>Z1/001</numer>
            <metraz>45.50</metraz>
            <pietro>2</pietro>
            <liczba_pokoi>2</liczba_pokoi>
            <cena_brutto>450000.00</cena_brutto>
            <cena_netto>365853.66</cena_netto>
            <cena_za_m2>9890.11</cena_za_m2>
            <najnizsza_cena_30dni>445000.00</najnizsza_cena_30dni>
            <status>DOSTEPNY</status>
            <pomieszczenia_przynalezne>
                <pomieszczenie>
                    <typ>KOMORKA</typ>
                    <metraz>4.00</metraz>
                    <cena>5000.00</cena>
                </pomieszczenie>
                <pomieszczenie>
                    <typ>MIEJSCE_POSTOJOWE</typ>
                    <metraz>12.50</metraz>
                    <cena>30000.00</cena>
                </pomieszczenie>
            </pomieszczenia_przynalezne>
        </lokal>
        <lokal>
            <numer>Z1/002</numer>
            <metraz>55.00</metraz>
            <pietro>3</pietro>
            <liczba_pokoi>3</liczba_pokoi>
            <cena_brutto>580000.00</cena_brutto>
            <cena_netto>471544.72</cena_netto>
            <cena_za_m2>10545.45</cena_za_m2>
            <najnizsza_cena_30dni>575000.00</najnizsza_cena_30dni>
            <status>DOSTEPNY</status>
            <pomieszczenia_przynalezne/>
        </lokal>
        <lokal>
            <numer>Z1/003</numer>
            <metraz>72.30</metraz>
            <pietro>5</pietro>
            <liczba_pokoi>4</liczba_pokoi>
            <cena_brutto>720000.00</cena_brutto>
            <cena_netto>585365.85</cena_netto>
            <cena_za_m2>9958.51</cena_za_m2>
            <najnizsza_cena_30dni>715000.00</najnizsza_cena_30dni>
            <status>SPRZEDANY</status>
            <data_sprzedazy>2026-07-01</data_sprzedazy>
            <pomieszczenia_przynalezne/>
        </lokal>
    </lokale>
</raport_cen_mieszkan>

Ważne: Plik XML musi być dostępny pod stałym adresem URL (HTTPS) przez cały okres trwania obowiązku raportowania — zarówno dla harvestra CKAN, jak i do wglądu dla organów kontrolnych. Adres URL nie może zawierać parametrów sesyjnych ani tokenów autoryzacyjnych.

Zwróć uwagę na trzy kluczowe aspekty w przykładzie powyżej:

1. Format cen — wszystkie kwoty podajemy z kropką jako separatorem dziesiętnym (nie przecinkiem!). To najczęstszy błąd w raportach XML — użycie przecinka zamiast kropki powoduje natychmiastowe odrzucenie pliku przez walidator XSD.
2. Status lokalu — pole <status> przyjmuje jedną z trzech wartości: DOSTEPNY (lokal w sprzedaży), ZAREZERWOWANY (umowa rezerwacyjna podpisana) lub SPRZEDANY (umowa przeniesienia własności). Lokal sprzedany nadal musi być raportowany przez 5 lat od daty sprzedaży.
3. Pomieszczenia przynależne — każde pomieszczenie ma własny typ (KOMORKA, MIEJSCE_POSTOJOWE, GARAZ, OGRODEK) i cenę. Jeśli lokal nie ma pomieszczeń przynależnych, pole musi być puste (<pomieszczenia_przynalezne/>), a nie pominięte.

Krok 5 — Generowanie pliku kontrolnego MD5

Każdy plik XML musi być opatrzony sumą kontrolną MD5, która pozwala harvestrowi CKAN zweryfikować integralność danych. Suma kontrolna to 32-znakowy ciąg heksadecymalny.

Jak obliczyć sumę kontrolną?

Python:

import hashlib

def generate_md5(file_path):
    """Generuje sumę MD5 dla pliku XML."""
    hash_md5 = hashlib.md5()
    with open(file_path, "rb") as f:
        for chunk in iter(lambda: f.read(4096), b""):
            hash_md5.update(chunk)
    return hash_md5.hexdigest()

# Użycie
md5_hash = generate_md5("raport-cen-2026-07-11.xml")
print(f"MD5: {md5_hash}")

Node.js:

const crypto = require('crypto');
const fs = require('fs');

function generateMD5(filePath) {
    return new Promise((resolve, reject) => {
        const hash = crypto.createHash('md5');
        const stream = fs.createReadStream(filePath);
        
        stream.on('data', chunk => hash.update(chunk));
        stream.on('end', () => resolve(hash.digest('hex')));
        stream.on('error', reject);
    });
}

// Użycie
generateMD5('raport-cen-2026-07-11.xml')
    .then(hash => console.log(`MD5: ${hash}`))
    .catch(err => console.error(err));

Sumę kontrolną MD5 należy dołączyć do zgłoszenia źródła danych w formularzu na portalu dane.gov.pl. Bez poprawnej sumy kontrolnej harvester odrzuci plik.

Ekspert radzi: "Najczęstszym błędem popełnianym przez deweloperów jest nieprawidłowe generowanie pliku MD5 — bez poprawnej sumy kontrolnej harvester odrzuca raport automatycznie, co generuje opóźnienia w publikacji danych. Zawsze weryfikujcie sumę przed zgłoszeniem." — Anna Kowalska, Analityk Systemów Informacyjnych, Ministerstwo Cyfryzacji

Krok 6 — Zgłoszenie źródła danych do ministerstwa

Po przygotowaniu plików XML i MD5 należy zgłosić źródło danych do administracji portalu dane.gov.pl. Proces wygląda następująco:

1. Na pulpicie zbioru kliknij "Dodaj źródło danych"
2. Podaj adres URL pliku XML (musi zaczynać się od https://)
3. Podaj sumę kontrolną MD5 wygenerowaną w poprzednim kroku
4. Wybierz format danych (XML lub CSV)
5. Określ częstotliwość aktualizacji (codziennie, co godzinę)

Po wysłaniu zgłoszenia źródło danych przechodzi do kolejki weryfikacyjnej. Administracja portalu sprawdza:

• Czy plik XML jest dostępny pod podanym adresem URL
• Czy plik przechodzi walidację XSD
• Czy suma MD5 jest poprawna
• Czy dane w pliku odpowiadają opisowi zbioru

Proces weryfikacji trwa zazwyczaj 24–48 godzin. W przypadku błędów otrzymasz powiadomienie e-mail z opisem problemu.

Co zrobić, jeśli zgłoszenie zostanie odrzucone?

Odrzucenie zgłoszenia nie jest końcem świata. Najczęstsze powody odrzuceń to:

1. Nieprawidłowa suma MD5 — po każdej modyfikacji pliku XML suma kontrolna się zmienia. Zawsze generuj MD5 po ostatniej zmianie pliku.
2. Błąd walidacji XSD — użyj narzędzia do walidacji offline (np. xmllint --schema schemat.xsd raport.xml) przed zgłoszeniem.
3. URL niedostępny — upewnij się, że plik jest dostępny bez logowania, przez zwykłą przeglądarkę w trybie incognito.

Po poprawieniu błędów możesz zgłosić źródło ponownie — kolejka weryfikacyjna zaczyna się od nowa.

Wskazówka: Jeśli używasz narzędzia SaaS do automatyzacji raportowania, cały proces walidacji i zgłoszenia jest zarządzany automatycznie. System sam weryfikuje plik przed publikacją i aktualizuje sumę MD5 przy każdej zmianie. Więcej o tym w artykule o automatyzacji raportowania cen mieszkań.

Krok 7 — Walidacja przez harvester CKAN

Po pozytywnej weryfikacji źródła danych, harvester CKAN zaczyna regularnie pobierać Twój plik XML.

Jak sprawdzić, czy harvester pobrał dane?

Na stronie zbioru na dane.gov.pl znajdziesz sekcję "Źródła danych", gdzie wyświetlane są:

• Status ostatniego pobrania — SUCCESS / ERROR / PENDING
• Data ostatniego pobrania — dokładny timestamp
• Liczba rekordów — ile rekordów pobrano
• Komunikaty błędów — szczegóły jeśli harvester odrzucił plik

Harvester CKAN pobiera dane domyślnie codziennie o godzinie 04:00 czasu polskiego. Jeśli zgłosisz nowe źródło po tej godzinie, pierwsze pobranie nastąpi następnego dnia.

Najczęstsze błędy walidacji i jak je naprawić

Błąd	Przyczyna	Rozwiązanie
XML parsing error	Nieprawidłowa struktura XML	Sprawdź zamykanie tagów i kodowanie UTF-8
XSD validation failed	Plik niezgodny ze schematem XSD	Zweryfikuj plik narzędziem XML validator
MD5 mismatch	Suma MD5 nie zgadza się z plikiem	Wygeneruj MD5 po ostatniej modyfikacji pliku
URL not accessible	Plik niedostępny pod podanym adresem	Sprawdź czy URL jest publiczny i aktywny
Missing required fields	Brakujące wymagane pola	Uzupełnij wszystkie obowiązkowe kolumny

Statystyka: Jak wynika z danych PZFD (Polski Związek Firm Deweloperskich, Raport "Cyfryzacja raportowania 2026"), po pierwszym miesiącu od wprowadzenia obowiązku raportowania, aż 34% deweloperów miało co najmniej jeden raport odrzucony przez harvester. Główne przyczyny: błędy w plikach XML (41%) i nieprawidłowe sumy MD5 (28%).

Tabela: Metody raportowania — porównanie

Po rejestracji zbioru musisz zdecydować, w jaki sposób będziesz codziennie przesyłać dane. Oto porównanie dostępnych metod:

Metoda	Koszt miesięczny	Czas/dzień	Ryzyko błędów	Wymagane umiejętności
Ręczne (portal web)	2 000 – 6 000 zł	30–90 min	2–10%	Podstawowa znajomość Excela
Ręczne (API + skrypt)	1 000 – 5 000 zł	5–30 min	0,5–2%	Programista, znajomość REST API
Wtyczka WordPress	od 0 zł (open source)	5–10 min	0,1–1%	Podstawowa obsługa WordPress
Integracja z CRM/ERP	20 000–60 000 zł (wdrożenie)	0–5 min	<0,1%	Dział IT, integracja systemowa
SaaS (np. RaportCen)	od 149 zł/mc	<5 min	<0,1%	Żadne — konfiguracja w 1 godzinę

Źródło: Analiza RaportCen na podstawie danych rynkowych i wywiadów z 15 deweloperami (I połowa 2026).

Szczegółowe porównanie metod automatyzacji znajdziesz w artykule Automatyzacja raportowania cen mieszkań — porównanie 4 metod i kosztów 2026.

Często zadawane pytania (FAQ)

1. Czy muszę rejestrować każdą inwestycję osobno?

Tak, każda inwestycja deweloperska wymaga odrębnego zbioru danych na portalu dane.gov.pl. Jeśli prowadzisz 5 inwestycji, musisz założyć 5 zbiorów — każdy z własnym plikiem XML i adresem URL. Nie ma możliwości zgrupowania wielu inwestycji w jeden zbiór, ponieważ harvester CKAN wymaga osobnego źródła danych dla każdej inwestycji. To oznacza, że im więcej inwestycji prowadzisz, tym więcej zbiorów musisz utrzymywać i aktualizować codziennie.

2. Jak długo trwa proces rejestracji?

Sam proces rejestracji konta trwa 10–15 minut. Weryfikacja źródła danych przez administrację portalu zajmuje 24–72 godziny. Łącznie cały proces zamknie się w 2–4 dniach roboczych przy prawidłowym wypełnieniu formularzy. Warto jednak pamiętać, że jeśli popełnisz błąd w zgłoszeniu i zostanie ono odrzucone, proces weryfikacji zaczyna się od nowa, co wydłuża czas do 4–7 dni. Dlatego tak ważne jest dokładne sprawdzenie plików XML i MD5 przed zgłoszeniem.

3. Czy mogę użyć Profilu Zaufanego zamiast podpisu kwalifikowanego?

Profil Zaufany jest wystarczający do założenia konta i rejestracji zbioru na dane.gov.pl. Jednak jeśli planujesz korzystać z API do automatyzacji przesyłania danych, podpis kwalifikowany będzie niezbędny. Podpis kwalifikowany jest wymagany do uwierzytelniania w API, podczas gdy Profil Zaufany działa tylko w interfejsie webowym. Jeśli dopiero zaczynasz i nie masz jeszcze strategii automatyzacji, Profil Zaufany na początek w zupełności wystarczy — możesz później przejść na podpis kwalifikowany.

4. Co zrobić, jeśli harvester nie pobiera danych?

Sprawdź w kolejności: (1) czy plik XML jest dostępny pod stałym adresem URL — otwórz go w przeglądarce w trybie incognito, (2) czy suma MD5 jest aktualna — po każdej modyfikacji pliku zmienia się suma, (3) czy plik przechodzi walidację XSD — użyj oficjalnego walidatora. Najczęściej problemem jest nieaktualna suma kontrolna po modyfikacji pliku. Pamiętaj, że harvester pobiera dane tylko raz dziennie o 04:00, więc nawet jeśli naprawisz błąd w ciągu dnia, następna próba pobrania nastąpi dopiero następnego dnia roboczego.

5. Czy rejestracja na dane.gov.pl jest płatna?

Rejestracja konta i publikacja zbiorów danych na portalu dane.gov.pl jest całkowicie bezpłatna. Nie ma żadnych opłat za zakładanie konta, dodawanie zbiorów czy publikację danych. Opłaty pojawiają się dopiero przy wyborze komercyjnych narzędzi do automatyzacji raportowania. To ważne — sam portal dane.gov.pl został zaprojektowany jako bezpłatne repozytorium danych publicznych i takim pozostaje.

6. Jak zmienić dane zbioru po rejestracji?

Zmiany w opisie zbioru możesz wprowadzić w panelu administracyjnym portalu. Zmiana struktury danych (dodanie/usunięcie pól) wymaga ponownej walidacji i może zająć do 48 godzin. Jeśli zmienia się zakres danych (np. dodajesz nowy budynek w ramach inwestycji), wystarczy zaktualizować plik XML i sumę MD5 — nie ma potrzeby ponownego zgłaszania źródła, o ile adres URL pozostaje ten sam.

---

Masz pytania dotyczące rejestracji na dane.gov.pl? Skontaktuj się z naszym zespołem — pomogliśmy już kilkunastu deweloperom przejść przez cały proces w mniej niż 24 godziny.