Przejdź do treści

Z ręcznego wgrywania plików na import XML: jak przejść na automatyczne zasilanie dane.gov.pl

Codzienne ręczne dodawanie pliku z cenami w panelu dane.gov.pl działa, dopóki ktoś o nim pamięta – także w weekendy i święta. Pokazujemy, jak przejść na automatyczny import XML: co przygotować, co napisać w zgłoszeniu, jak to zrobić przy kilku spółkach i czego nie ruszać, zanim portal potwierdzi, że import działa.

Zaktualizowano
Stan prawny na
11 listopada 2026
Czytanie
7 min

W skrócie

  • Automatyczny import XML uruchamia administrator portalu na prośbę wysłaną na kontakt@dane.gov.pl – osobno dla każdego dostawcy danych, czyli dla każdej spółki.
  • W zgłoszeniu podajesz imię i nazwisko zgłaszającego, nazwę dostawcy zgodną z profilem, adresy pliku XML i sumy MD5, adresy e-mail edytorów i częstotliwość: codziennie.
  • Do potwierdzenia, że import działa, dodawaj pliki ręcznie jak dotąd – obowiązek „raz na dobę” nie robi przerwy na czas zmiany.
  • Ręcznie dodanych zbiorów nie usuwaj sam. Zapytaj administratora, co z nimi zrobić, gdy import ruszy – to historia danych, które już przekazałeś.
Spis treści 10 części
  1. 01Dlaczego warto przejść z ręcznego dodawania
  2. 02Co przygotować przed zgłoszeniem
  3. 03Co napisać w zgłoszeniu
  4. 04Kilka spółek = kilka zgłoszeń
  5. 05Co z zasobami dodanymi ręcznie
  6. 06Kolejność kroków
  7. 07Najczęstsze błędy przy przejściu
  8. 08Jak to wygląda we wtyczce DeweloperCeny
  9. 09Najczęstsze pytania
  10. 10Źródła i podstawa prawna

Żeby przejść z ręcznego dodawania plików na automatyczny import XML, wystawiasz na swoim serwerze plik XML z sumą MD5 i wysyłasz na kontakt@dane.gov.pl zgłoszenie źródła danych – osobno dla każdego dostawcy danych, czyli każdej spółki. Do potwierdzenia, że import działa, dodajesz pliki ręcznie jak dotąd, a o dotychczasowe zbiory pytasz administratora, zamiast usuwać je samemu. W zgłoszeniu podajesz: imię i nazwisko zgłaszającego, nazwę dostawcy zgodną z profilem, adresy pliku XML i sumy MD5, adresy e-mail edytorów i częstotliwość – codziennie.

Jak działa sama automatyzacja XML dla dane.gov.pl – pliki, które portal pobiera sam, codziennie i bez ręcznej pracy – opisujemy na osobnej stronie. Tu skupiamy się na przejściu: deweloper już raportuje, tylko ręcznie. Nie jesteś w tym sam: według naszego pomiaru z 29 października 2026 r. 765 dostawców danych prowadziło na portalu wyłącznie zbiory dodawane ręcznie – szczegóły w artykule ilu deweloperów raportuje ceny na dane.gov.pl.

Dlaczego warto przejść z ręcznego dodawania

Ręczne dodawanie zasobów w panelu dostawcy jest dozwolone, ale to codzienna czynność, także w weekendy i święta. Wystarczy urlop osoby, która to robi, żeby w danych na portalu pojawiła się dziura. Ministerstwo samo rekomenduje automatyczne zasilanie przez plik XML: portal raz dziennie pobiera plik ze spisem wszystkich dni i sam publikuje nowy zasób.

W październiku 2026 r. przygotowywaliśmy takie przejście u dewelopera z dwiema spółkami, które od miesięcy dodawały pliki ręcznie. Pytania, które wtedy padły – czy jeden mail wystarczy, co ze starymi zbiorami, kiedy przestać dodawać pliki ręcznie – są dokładnie tymi, na które odpowiadamy poniżej.

Co przygotować przed zgłoszeniem

  • Plik XML zgodny ze schematem portalu (przestrzeń nazw urn:otwarte-dane:harvester:1.13), z jednym zbiorem i zasobami z kolejnych dni. Szkielet pliku pokazujemy w instrukcji raportowania krok po kroku.
  • Adresy https w każdym zasobie – jeden adres z http wystarczy, żeby plik odpadł przy walidacji.
  • Sumę MD5 pod adresem pliku XML z dopisanym .md5.
  • Dzienne pliki z cenami dostępne dla portalu, odpowiadające kodem 200.
  • Stałe identyfikatory extIdent zbioru i zasobów – po zgłoszeniu ich nie zmieniasz.
  • Uprawnienia edytora w profilu dostawcy – przy ręcznym dodawaniu zwykle już je masz.

Zanim wyślesz zgłoszenie, sprawdź pliki trzema poleceniami z instrukcji: kod odpowiedzi XML, zgodność sumy MD5 i dostępność dzisiejszego pliku. Najczęstsze błędy i ich naprawę opisujemy w artykule błędy 403, 404, 500 i „https://.*” na dane.gov.pl.

Co napisać w zgłoszeniu

Dokument ministerstwa „Dane niezbędne do uruchomienia automatyzacji” wymienia, co musi być w wiadomości. Dodaj do tego numer NIP spółki i link do zbioru dodawanego dotąd ręcznie – administratorowi łatwiej będzie przypisać zgłoszenie do właściwego profilu.

Temat: Zgłoszenie automatycznego źródła danych (XML) – nazwa spółki, NIP 0000000000

Dzień dobry,
proszę o utworzenie źródła danych i włączenie automatycznego importu XML
dla dostawcy danych:

- nazwa dostawcy (jak w profilu): pełna nazwa spółki
- NIP: 0000000000
- zgłaszający: imię i nazwisko
- adresy e-mail edytorów: adres konta z uprawnieniami edytora
- adres pliku XML: https://…/raport.xml
- adres sumy MD5:  https://…/raport.xml.md5
- częstotliwość aktualizacji: codziennie
- dotychczasowy zbiór dodawany ręcznie: link do zbioru na dane.gov.pl

Do czasu potwierdzenia działania importu dodajemy pliki ręcznie.
Proszę o informację, co zrobić z dotychczasowym zbiorem po uruchomieniu importu.

Zgłoszenie najlepiej wysłać z adresu edytora albo z adresu firmowego, który jest w profilu. Ministerstwo nie podaje, ile trwa włączenie źródła – zgłoszenia są rozpatrywane według kolejności, a przy wdrożeniach, które prowadziliśmy, sprawy na portalu trwały od kilku dni do kilku tygodni.

Kilka spółek = kilka zgłoszeń

Każda spółka, która sprzedaje lokale, raportuje jako osobny dostawca danych. Przy przejściu na import XML oznacza to:

  • osobny plik XML dla każdej spółki, tylko z jej inwestycjami,
  • osobne zgłoszenie z nazwą tej spółki, jej NIP-em i adresem jej edytora,
  • dane tej spółki w plikach z cenami – firma, NIP i adres siedziby (od 11 listopada 2026 r. rozporządzenie o strukturze danych nie ma już pól na KRS ani REGON).

Co z zasobami dodanymi ręcznie

Import XML zarządza obiektami opisanymi w pliku – zbiorem i zasobami z ich identyfikatorami extIdent. Zbiór dodawany dotąd ręcznie nie pochodzi z tego pliku, więc sam się w niego nie zamieni. Po starcie importu na portalu mogą więc przez jakiś czas być dwa zbiory z cenami tej samej inwestycji: stary, ręczny, i nowy, automatyczny.

Ministerstwo nie opublikowało rekomendacji, co robić z takim zbiorem, dlatego:

  • nie usuwaj niczego sam – ręczne zasoby to historia danych, które już przekazałeś,
  • zapytaj w zgłoszeniu, czy po uruchomieniu importu stary zbiór zarchiwizować, czy zostawić bez zmian,
  • zrób to, co zaleci administrator – i dopiero po potwierdzeniu, że import działa.

Kolejność kroków

  1. Przygotuj i sprawdź pliki

    XML z sumą MD5 i dzienne pliki z cenami dla każdej spółki, wszystkie adresy po https, kody 200.

  2. Sprawdź uprawnienia

    Upewnij się, kto jest edytorem w profilu każdej spółki i z jakiego adresu wyślesz zgłoszenie.

  3. Wyślij zgłoszenia

    Osobny mail dla każdej spółki, z pytaniem o dotychczasowy zbiór.

  4. Dodawaj pliki ręcznie do potwierdzenia

    Do odpowiedzi administratora nic się nie zmienia – codzienny plik dodajesz jak dotąd.

  5. Sprawdź pierwsze importy

    Po potwierdzeniu wyszukaj spółkę na dane.gov.pl i zobacz, czy przy nowym zbiorze pojawiają się zasoby z kolejnych dni.

  6. Uporządkuj stary zbiór

    Zarchiwizuj go albo zostaw – tak, jak zalecił administrator.

  7. Zakończ ręczne dodawanie

    Dopiero teraz. Od tego dnia pilnujesz tylko, czy pliki są dostępne i czy portal je pobiera.

Najczęstsze błędy przy przejściu

  • Jedno zgłoszenie dla dwóch spółek – źródło trafia do jednego profilu, a druga spółka zostaje bez importu albo z cudzymi danymi.
  • Zgłoszony plik zbiorczy zamiast pliku inwestycji konkretnej spółki.
  • Przerwa w danych – ręczne dodawanie zatrzymane w dniu wysłania zgłoszenia, a import ruszył kilka dni później.
  • Adres z http w którymś zasobie albo w adresie samego pliku.
  • Zmieniony extIdent po zgłoszeniu – portal widzi nowy zbiór, a stary trafia do kosza.
  • Usunięte stare zasoby przed potwierdzeniem, że import działa.

Jak to wygląda we wtyczce DeweloperCeny

Wtyczka wystawia plik XML, sumę MD5 i codzienne pliki z cenami pod stałymi adresami https – także osobno dla każdej inwestycji. W panelu „dane.gov.pl” jest tabela, która pokazuje, która spółka zgłasza które adresy XML i MD5, i ostrzega przed zgłoszeniem pliku zbiorczego. Moduł zgodności codziennie sprawdza m.in., czy dzisiejszy plik z cenami jest dostępny dla portalu, i wysyła e-mail, gdy coś przestaje działać. Od 11 listopada 2026 r. wtyczka sama przełącza pliki na strukturę z rozporządzenia – adresy zgłoszone na portalu się nie zmieniają.

Więcej o tym, co jeszcze psuje raport, znajdziesz w artykule 50 problemów z jawnością cen mieszkań, a jeśli dopiero wybierasz narzędzie – w porównaniu 4 sposobów raportowania cen.

Najczęstsze pytania

Czy po zgłoszeniu importu XML mogę przestać dodawać pliki ręcznie?

Dopiero wtedy, gdy portal potwierdzi, że import działa, a na portalu pojawią się zasoby z kolejnych dni pobrane automatycznie. Do tego momentu dodawaj pliki ręcznie – obowiązek przekazywania danych raz na dobę trwa bez przerwy.

Ile trwa włączenie automatycznego importu?

Ministerstwo nie podaje terminu – zgłoszenia są rozpatrywane według kolejności. Pierwsze zasilenie następuje po włączeniu źródła przez administratora, a kolejne importy raz dziennie. Nie wysyłaj ponagleń jedno po drugim.

Co się stanie ze zbiorem, który dodawałem ręcznie?

Import XML tworzy zbiór z danych zapisanych w pliku, więc ręcznie dodany zbiór sam się w niego nie zamieni. Czy go zarchiwizować, czy zostawić, ustal z administratorem portalu – zapytaj o to w zgłoszeniu i niczego nie usuwaj przed odpowiedzią.

Mam dwie spółki. Wystarczy jeden mail?

Nie. Wyślij osobne zgłoszenie dla każdej spółki: z jej nazwą zgodną z profilem dostawcy, jej plikiem XML i sumą MD5 oraz adresem jej edytora. Jeden plik XML z inwestycjami dwóch spółek publikowałby ceny jednej pod nazwą drugiej.

Źródła i podstawa prawna

Stan prawny na 11 listopada 2026. Artykuł ma charakter informacyjny i nie jest poradą prawną.

  1. 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
  2. Ustawa z dnia 17 lipca 2026 r. o zmianie ustawy o ochronie praw nabywcy lokalu mieszkalnego lub domu jednorodzinnego oraz Deweloperskim Funduszu Gwarancyjnym Dz.U. 2026 poz. 1077
  3. Rozporządzenie Ministra Cyfryzacji z dnia 10 listopada 2026 r. w sprawie struktury danych zawartych w informacjach dotyczących sprzedaży lokali mieszkalnych i domów jednorodzinnych Dz.U. 2026 poz. 1489
  4. Dane niezbędne do uruchomienia automatyzacji (import XML), dane.gov.pl, 24.09.2025
  5. Instrukcja zasilania XML dla deweloperów, wersja 1.0.6 (stan na 21.11.2025)
  6. Schemat XSD harvestera dane.gov.pl
  7. dane.gov.pl: udostępnianie danych dotyczących cen mieszkań – informacje dla deweloperów
  8. Dziennik Ustaw: rozporządzenie Ministra Cyfryzacji z 10 listopada 2026 r. w sprawie struktury danych (Dz.U. 2026 poz. 1489)
Udostępnij LinkedIn Facebook E-mail

Newsletter

Newsletter dla deweloperów: przepisy, błędy, rozwiązania

Raz lub dwa razy w miesiącu: zmiany w przepisach o jawności cen, nowe problemy z dane.gov.pl i gotowe rozwiązania. Na start lista kontrolna PDF: 12 punktów do sprawdzenia przed kontrolą UOKiK.

  • Zmiany w ustawie i w wymaganiach dane.gov.pl, zanim wejdą w życie
  • Błędy, na których odpadają zgłoszenia deweloperów, i jak je naprawić
  • Bez spamu. Wypisujesz się jednym kliknięciem
Lista kontrolna zgodności z ustawą o jawności cen mieszkań (PDF)

Prezent na startLista kontrolna PDF: 12 punktów przed kontrolą UOKiK

Masz problem z jawnością cen we własnej inwestycji?

Opisz, co nie działa: strona, raport, zgłoszenie w dane.gov.pl. Odpowiemy w ciągu 24 godzin roboczych, jak to naprawić i czy wtyczka rozwiąże to u Ciebie.

Pola z * są wymagane
Śledź nas na Facebooku