Data aktu lub dokumentu opisuje moment związany z transakcją, data publikacji mówi, kiedy źródło udostępniło wersję danych, a data pobrania wskazuje, kiedy serwis tę wersję sprawdził lub zaimportował. Nie wolno używać tych dat zamiennie. Najważniejsza dla porównania cen w czasie jest data dokumentu, a pozostałe dwie służą ocenie świeżości i pochodzenia danych.
Dlaczego trzy daty są potrzebne
Użytkownik chce wiedzieć, kiedy sprzedano nieruchomość oraz czy baza jest aktualna. Jedna data nie odpowiada na oba pytania. Transakcja mogła zostać zawarta w marcu, opublikowana w lipcu i pobrana przez aplikację w sierpniu. Jeżeli pokażemy tylko sierpień, odbiorca może błędnie uznać cenę za sierpniową.
W RCN znajduje się data sporządzenia dokumentu. GUGiK i jednostki publikują dane przez usługi oraz pliki, które mogą mieć własne wersje i terminy aktualizacji. Ilemetr może zapisywać czas pobrania lub przetworzenia. Każda data opisuje inny etap łańcucha.
Słownik dat
| Data | Co oznacza | Jak ją podpisać | Do czego używać |
|---|---|---|---|
| Dokumentu lub aktu | Moment dokumentu będącego podstawą wpisu | „Data dokumentu transakcji” | Porównanie cen i wieku sprzedaży |
| Publikacji lub wersji źródła | Moment udostępnienia zbioru, jeśli znany | „Źródło opublikowane/zaktualizowane” | Ocena opóźnienia źródła |
| Pobrania | Moment pobrania danych przez serwis | „Dane pobrano” | Audyt i powtarzalność |
| Przetworzenia | Moment importu albo obliczenia | „Raport obliczono” | Odtworzenie wersji wyniku |
| Ostatniego sprawdzenia | Moment zapytania o nowsze dane | „Źródło sprawdzono” | Operacyjna informacja o monitoringu |
Data publikacji nie zawsze jest dostępna na poziomie pojedynczego rekordu. W takim przypadku nie należy jej wymyślać na podstawie daty pliku bez wyraźnego opisu. Można przechować datę pobrania i wersję lub sumę kontrolną źródła, aby później odtworzyć analizę.
Najczęstszy błąd: „najnowsze dane”
Hasło „najnowsze dane z września” jest niejasne. Może znaczyć, że plik pobrano we wrześniu, chociaż najnowszy akt pochodzi z czerwca. Lepszy komunikat brzmi: „źródło sprawdzono 16 września 2026 r.; najnowszy dokument w tej próbce ma datę 24 czerwca 2026 r.”. Użytkownik rozumie wtedy zarówno działanie serwisu, jak i wiek obserwacji.
Szerzej o ocenie luki mówi artykuł jak aktualne są dane RCN. Ogólny zakres rejestru opisuje Rejestr Cen Nieruchomości: co zawiera.
Przykład osi czasu — wyłącznie ilustracyjny
- 12 marca: sporządzono akt sprzedaży mieszkania za ilustracyjne 650 000 zł.
- 20 maja: rekord został ujęty w wersji danych udostępnionej przez źródło.
- 21 maja: serwis pobrał plik.
- 22 maja: przebudowano indeks wyszukiwania.
- 30 czerwca: użytkownik wygenerował raport.
Cena 650 000 zł pozostaje ceną transakcji z marca. Nie jest ceną majową ani czerwcową. Raport powstał w czerwcu na podstawie stanu bazy pobranego w maju. Jeżeli przeliczamy cenę do nowszego okresu za pomocą indeksu, wynik musi być osobnym scenariuszem i nie może zastąpić źródłowej ceny.
Jak projektować raport i API
Raport dla człowieka powinien pokazać datę dokumentu przy każdej transakcji, datę aktualności źródła w sekcji metodologii i datę wygenerowania raportu. API powinno stosować jednoznaczne nazwy pól, dokumentować strefy czasowe i nie używać ogólnego pola „date” dla kilku znaczeń.
Przy zapisanym raporcie warto przechować identyfikatory rekordów, wersję metody, datę obliczenia i stan dodatkowego szeregu rynkowego. Pozwala to wyjaśnić, dlaczego raport wygenerowany miesiąc później zawiera inne porównania. Tę zasadę rozwija planowany artykuł powtarzalna wycena: dane, założenia i wersja obliczeń.
Checklista języka
- „sprzedano” wiąż z datą dokumentu, nie importu;
- „pobrano” wiąż z działaniem systemu;
- „opublikowano” stosuj tylko, gdy znasz podstawę tej daty;
- „sprawdzono” nie oznacza, że znaleziono nowsze rekordy;
- „zaktualizowano codziennie” doprecyzuj jako częstotliwość procesu;
- przy korekcie czasowej zachowaj oryginalną cenę i datę.
Przy doborze starszych sprzedaży użyj metod z poradnika jak stare transakcje można wykorzystać przy wycenie. Tak opisany łańcuch zwiększa zaufanie, ponieważ odbiorca widzi zarówno fakt, jak i historię jego przetwarzania.
Dlaczego nazwy pól mają znaczenie
W interfejsie „data transakcji” może być zrozumiałym skrótem, ale dokumentacja powinna podać, że podstawą jest data dokumentu z RCN. W eksporcie lepiej używać pełnych nazw niż anonimowych kolumn „data1” i „updated”. Spójne nazewnictwo pomaga także integracjom CRM i analizom wykonywanym po czasie. Gdy źródło nie publikuje daty na danym poziomie, wartość powinna pozostać pusta zamiast dziedziczyć datę całego pliku bez wyjaśnienia.
Źródła i metodologia
Pole daty dokumentu i zakres informacji transakcyjnych zweryfikowano w oficjalnym wykazie danych RCN GUGiK. Sposób prowadzenia rejestru opisuje strona RCN w Geoportalu. Rozdzielenie dat publikacji, pobrania, przetworzenia i sprawdzenia jest praktyką audytową ilemetr.pl. Oś czasu i cena są ilustracyjne.
Stan źródeł: 16 września 2026 r.