Powrót do artykułów
Poradniki techniczne
#dane.gov.pl#raportowanie#tutorial

Jak krok po kroku raportować ceny do dane.gov.pl

Kompletny przewodnik po procesie raportowania cen mieszkań do portalu dane.gov.pl. Dowiedz się, jak przygotować dane, wysłać raport i uniknąć błędów.

Jan Kowalski

Autor

01 listopada 2025

Data publikacji

8 min

Czas czytania

Jak krok po kroku raportować ceny do dane.gov.pl

Raportowanie cen mieszkań do portalu dane.gov.pl to obowiązek każdego dewelopera zgodnie z ustawą o jawności cen mieszkań. W tym przewodniku pokażemy Ci, jak zrobić to poprawnie i efektywnie.

Wymogi prawne

Zgodnie z ustawą z dnia 7 lipca 2023 r. o jawności cen mieszkań, deweloperzy są zobowiązani do:

  • Codziennego raportowania cen wszystkich oferowanych lokali
  • Utrzymywania historii zmian przez co najmniej 12 miesięcy
  • Dostarczania danych w określonym formacie XML

Krok 1: Przygotowanie danych

Struktura wymaganych pól

Każdy raport musi zawierać następujące informacje:

<lokal>
  <id_lokalu>UNIKALNY_ID</id_lokalu>
  <cena>NETTO</cena>
  <cena_m2>NETTO_M2</cena_m2>
  <powierzchnia>POWIERZCHNIA</powierzchnia>
  <liczba_pokoi>LICZBA_POKOI</liczba_pokoi>
  <pietro>PIETRO</pietro>
  <typ_budynku>TYP_BUDYNKU</typ_budynku>
  <data_aktualizacji>DATA</data_aktualizacji>
</lokal>

Pobieranie danych z systemów

Możesz pobrać dane z różnych źródeł:

  1. System CRM/ERP - eksport do CSV/XML
  2. WordPress - przez API lub wtyczki
  3. Pliki Excel - import i konwersja
  4. Ręczne wprowadzanie - dla małych projektów

Krok 2: Formatowanie danych

Konwersja do XML

Wymagany format XML dla dane.gov.pl:

<?xml version="1.0" encoding="UTF-8"?>
<raport_cen>
  <deweloper>
    <nip>1234567890</nip>
    <nazwa>Nazwa Firmy</nazwa>
  </deweloper>
  <lokalizacja>
    <wojewodztwo>Mazowieckie</wojewodztwo>
    <powiat>Warszawa</powiat>
    <gmina>Warszawa</gmina>
    <miejscowosc>Warszawa</miejscowosc>
    <ulica>ul. Przykładowa</ulica>
    <numer_budynku>1</numer_budynku>
  </lokalizacja>
  <lokale>
    <lokal>
      <!-- dane lokalu -->
    </lokal>
  </lokale>
</raport_cen>

Krok 3: Wysyłka raportu

Metoda 1: Portal dane.gov.pl

  1. Zaloguj się na swoje konto
  2. Wybierz sekcję "Raportowanie cen mieszkań"
  3. Prześlij plik XML
  4. Potwierdź wysyłkę

Metoda 2: API

const sendReport = async (xmlData) => {
  const response = await fetch('https://api.dane.gov.pl/pl/raporty/cen-mieszkan', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/xml',
      'Authorization': `Bearer ${API_TOKEN}`
    },
    body: xmlData
  });
  
  return response.json();
};

Krok 4: Weryfikacja i potwierdzenie

Po wysłaniu raportu:

  1. Sprawdź status w panelu dane.gov.pl
  2. Pobierz potwierdzenie otrzymania
  3. Zarchiwizuj kopię raportu
  4. Zaktualizuj historię zmian

Najczęstsze błędy i jak ich unikać

Błędy formatowania

  • ❌ Nieprawidłowe kodowanie znaków
  • ✅ Używaj UTF-8
  • ❌ Brakujące wymagane pola
  • ✅ Sprawdź wszystkie pola przed wysyłką
  • ❌ Nieprawidłowy format daty
  • ✅ Użyj formatu YYYY-MM-DD

Błędy logiczne

  • ❌ Cena netto zamiast brutto
  • ✅ Sprawdź wymagany typ ceny
  • ❌ Niezgodne dane z ofertą
  • ✅ Weryfikuj spójność danych

Automatyzacja procesu

Codzienne raportowanie

Aby zautomatyzować proces:

  1. Skonfiguruj harmonogram (cron job)
  2. Przygotuj skrypt generujący XML
  3. Implementuj logikę wysyłki
  4. Dodaj monitoring i alerty

Przykładowy skrypt

import requests
import xml.etree.ElementTree as ET
from datetime import datetime

def generate_daily_report():
    # Pobierz dane z bazy
    properties = get_properties_from_db()
    
    # Wygeneruj XML
    root = ET.Element("raport_cen")
    # ... budowanie XML
    
    # Wyślij raport
    response = requests.post(
        'https://api.dane.gov.pl/pl/raporty/cen-mieszkan',
        data=ET.tostring(root),
        headers={'Content-Type': 'application/xml'}
    )
    
    return response.status_code == 200

Podsumowanie

Raportowanie cen mieszkań to proces, który wymaga:

  • Dokładności w przygotowaniu danych
  • Regularności w codziennym raportowaniu
  • Dokumentacji historii zmian
  • Monitoringu statusu raportów

Z odpowiednimi narzędziami i automatyzacją możesz znacznie usprawnić ten proces i uniknąć kar za niewywiązywanie się z obowiązków.

Potrzebujesz pomocy?

Jeśli masz pytania dotyczące raportowania lub potrzebujesz profesjonalnego wsparcia w implementacji systemu, skontaktuj się z nami. Oferujemy:

  • ✅ Kompleksowe wdrożenie systemu
  • ✅ Automatyzację raportowania
  • ✅ Integrację z istniejącymi systemami
  • ✅ Pełne wsparcie techniczne 24/7

Zamów darmową konsultację

Potrzebujesz pomocy z raportowaniem?

Skontaktuj się z nami i dowiedz się, jak możemy zautomatyzować proces raportowania cen mieszkań.