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.
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
- 01Dlaczego warto przejść z ręcznego dodawania
- 02Co przygotować przed zgłoszeniem
- 03Co napisać w zgłoszeniu
- 04Kilka spółek = kilka zgłoszeń
- 05Co z zasobami dodanymi ręcznie
- 06Kolejność kroków
- 07Najczęstsze błędy przy przejściu
- 08Jak to wygląda we wtyczce DeweloperCeny
- 09Najczęstsze pytania
- 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
Przygotuj i sprawdź pliki
XML z sumą MD5 i dzienne pliki z cenami dla każdej spółki, wszystkie adresy po https, kody 200.
Sprawdź uprawnienia
Upewnij się, kto jest edytorem w profilu każdej spółki i z jakiego adresu wyślesz zgłoszenie.
Wyślij zgłoszenia
Osobny mail dla każdej spółki, z pytaniem o dotychczasowy zbiór.
Dodawaj pliki ręcznie do potwierdzenia
Do odpowiedzi administratora nic się nie zmienia – codzienny plik dodajesz jak dotąd.
Sprawdź pierwsze importy
Po potwierdzeniu wyszukaj spółkę na dane.gov.pl i zobacz, czy przy nowym zbiorze pojawiają się zasoby z kolejnych dni.
Uporządkuj stary zbiór
Zarchiwizuj go albo zostaw – tak, jak zalecił administrator.
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ą.
- 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
- 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
- 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
- Dane niezbędne do uruchomienia automatyzacji (import XML), dane.gov.pl, 24.09.2025
- Instrukcja zasilania XML dla deweloperów, wersja 1.0.6 (stan na 21.11.2025)
- Schemat XSD harvestera dane.gov.pl
- dane.gov.pl: udostępnianie danych dotyczących cen mieszkań – informacje dla deweloperów
- Dziennik Ustaw: rozporządzenie Ministra Cyfryzacji z 10 listopada 2026 r. w sprawie struktury danych (Dz.U. 2026 poz. 1489)