Instrukcja obsługi
Kompletny przewodnik po panelu deweloperdane.pl - od logowania, przez zarządzanie lokalami i cenami, aż po automatyczne raportowanie do dane.gov.pl.
1. Logowanie do panelu
1. Otwórz przeglądarkę i wejdź na adres: https://deweloperdane.pl/admin
2. Wpisz swój adres e-mail i hasło (otrzymane przy rejestracji lub ustawione po zakupie).
3. Kliknij "Zaloguj sie".
Po pomyślnej autoryzacji system przekierowuje do Pulpitu (strony startowej panelu).
2. Pierwsze kroki (Onboarding)
Przy pierwszym logowaniu Pulpit wyswietla karty onboardingowe z lista kroków do wykonania. Do momentu ich ukończenia niektóre zakładki (Eksport, Kreator Widgetu) są zablokowane.
Uzupełnij dane firmy
Zakładka Ustawienia - NIP, forma prawna, REGON, adres siedziby, dane kontaktowe. Dane te trafiają do raportu XML/CSV.
Dodaj inwestycję
Zakładka Inwestycje - nazwa osiedla/budynku, adres fizyczny, dane biura sprzedaży.
Dodaj pierwszy lokal
Zakładka Lokale - numer, typ, cena brutto, cena za m². Po dodaniu pierwszego lokalu odblokujesz pełną funkcjonalność.
3. Menu boczne - co gdzie znajdziesz
| Zakładka | Opis |
|---|---|
| Pulpit | Statystyki, stan synchronizacji z dane.gov.pl, zadania onboardingowe |
| Inwestycje | Kartoteka projektów budowlanych - dodawanie i edycja inwestycji |
| Lokale | Baza lokali z edycją cen, statusów, historią zmian i eksportem |
| Eksport i Integracja | Linki XML/CSV, klucz API, reczna publikacja zmian |
| Historia raportów | Archiwum wygenerowanych raportów CSV/XML z podziałem na daty |
| Kreator Widgetu | Generator kodu tabeli cenowej do osadzenia na Twojej stronie WWW |
| WordPress | Instrukcja instalacji wtyczki WP i integracja z widgetem |
| Kopia zapasowa | Historyczne backupy CSV i JSON - mozliwosc pobrania |
| Subskrypcja i oplaty | Status pakietu, daty ważnosci, historia opłat |
| Wsparcie | Formularz kontaktowy do zespołu deweloperdane.pl |
| Ustawienia | Dane firmy, NIP, hasło, profil dostawcy dane.gov.pl |
4. Inwestycje
Inwestycja to projekt budowlany (np. osiedle, budynek wielorodzinny), do którego przypisujesz lokale.
Dodawanie inwestycji:
1. Menu - Inwestycje - kliknij "Dodaj inwestycje".
2. Wypełnij: nazwa projektu, adres fizyczny, dane biura sprzedaży (adres, telefon, e-mail, godziny).
3. Zapisz. Inwestycja pojawia sie na liscie i możesz do niej przypisywac lokale.
5. Zarządzanie lokalami
Dodawanie nowego lokalu
1. Menu - Lokale - rozwiń sekcję "Dodaj lokal do raportowania".
2. Wybierz inwestycje, wpisz numer lokalu, wybierz rodzaj, status, cene brutto i cene za m².
3. Kliknij "Dodaj ten lokal".
Edycja lokalu
1. Na liscie lokali znajdz wybrany lokal i kliknij "Edycja i szczegóły".
2. Zmień potrzebne pola (cena, status, powierzchnia, dane dodatkowe).
3. Kliknij "Zapisz zmiany lokalu".
Widoki listy
Nad lista lokali znajdziesz przycisk zmiany widoku: Lista (szczegółowy, z rowkami) lub Siatka (kompaktowe karty). Mozesz też filtrowac lokale po inwestycji lub statusie.
6. Procedura aktualizacji cen
Metoda 1: Formularz edycji (zalecana)
1. Lokale - "Edycja i szczegóły" - zmień pole "Obecna Cena (Brutto)" i "Cena za m²".
2. Opcjonalnie ustaw "Date wejscia w zycie" (domyslnie: dzisiaj).
3. Zapisz. System automatycznie doda wpis do historii cen.
Metoda 2: Zaplanowanie przyszlej zmiany
1. W edycji lokalu przejdz do sekcji "Planowanie zmiany ceny".
2. Ustaw przyszłą datę i nową cenę - kliknij "Zaplanuj zmiane ceny".
3. System automatycznie zastosuje zmiane w wyznaczonym dniu (cron nocny).
7. Statusy lokali - cykl zycia
| Status | W raporcie? | Znaczenie |
|---|---|---|
| Dostepny | Tak | Lokal w ofercie sprzedazy |
| Zarezerwowany | Tak | Umowa rezerwacyjna (klient moze sie wycofac) |
| Sprzedany | Tak | Umowa deweloperska (do aktu notarialnego moze sie cofnac) |
| Przeniesienie własnosci | Nie | Akt notarialny - lokal znika z raportu |
| Wycofany | Nie | Lokal zdjety z oferty |
Wazne: Status "Sprzedany" (umowa deweloperska) nie zwalnia z raportowania. Dopiero po podpisaniu aktu notarialnego (Przeniesienie własnosci) lokal znika z raportu CSV/XML. Publicznie status "Przeniesienie własnosci" wyswietla sie jako "Sprzedany".
8. Eksport i Integracja - publikacja zmian
Zmiany cen i statusów nie sa natychmiast publiczne - są oznaczane jako "oczekujące na publikacje".
Publikacja automatyczna: System publikuje wszystkie zmiany codziennie o 00:05 w nocy. Nie musisz nic robic.
Publikacja reczna: Jesli chcesz natychmiastowej aktualizacji:
1. Menu - Eksport i Integracja.
2. Zobaczysz: "Nieopublikowane zmiany: X lokali".
3. Opcjonalnie: "Pokaz róznice przed publikacja" - podglad co sie zmieni.
4. Kliknij "Opublikuj zmiany" - nowy CSV/XML jest natychmiast dostepny.
W tej samej zakładce znajdziesz takze:
- - Linki publiczne CSV i XML - adresy URL do przesłania do dane.gov.pl
- - Klucz API - do integracji z zewnetrznymi systemami
- - Plik MD5 - suma kontrolna aktualnego raportu
Cykl raportowania:
Zmieniasz cene/status w panelu
->
Lokal oznaczony jako "oczekuje na publikacje"
->
Klikasz "Opublikuj" lub czekasz na nocny cron (00:05)
->
System generuje nowy CSV + XML + MD5
->
Portal dane.gov.pl pobiera XML i aktualizuje dane (do 24h)
9. Historia raportów
Zakładka Historia raportów przechowuje archiwum wszystkich wygenerowanych przez system plików CSV/XML.
- - Kazdy rekord zawiera date wygenerowania, liczbe lokali w raporcie i linki do pobrania
- - Mozesz porownac historyczne wersje raportu i sprawdzic co sie zmieniało
- - Dane sa przechowywane przez 5 lat
10. Kreator Widgetu (tabela cenowa na strone)
Zakładka Kreator Widgetu pozwala wygenerowac gotowy kod HTML do osadzenia tabeli cenowej lokali bezposrednio na Twojej stronie internetowej.
Dostepny dla: uzytkowników z pakietem zawierającym modul "Wyswietlanie cennika".
Jak skonfigurowac widget:
1. Wybierz inwestycje do wyswietlenia
2. Skonfiguruj wyglad - kolory, kolumny, jezyk
3. Skopiuj gotowy kod i wklej na swojej stronie lub w panelu WordPress
11. WordPress - wtyczka i integracja
Zakładka WordPress zawiera gotową wtyczke (.zip) do pobrania oraz instrukcje instalacji krok po kroku.
Instalacja wtyczki:
1. W panelu WordPress wejdz w Wtyczki - Dodaj nową - Wyslij wtyczke
2. Wgraj plik .zip pobrany z panelu deweloperdane.pl
3. Aktywuj wtyczke
4. W ustawieniach wtyczki wpisz swoje ID Dewelopera (znajdziesz je w zakładce Eksport i Integracja)
12. Kopia zapasowa
Zakładka Kopia zapasowa przechowuje automatyczne backupy całego konta.
- - Backupy tworzone są automatycznie codziennie o 23:59
- - Kazdy backup zawiera pełny zestaw danych: lokale, inwestycje, ceny, historia
- - Format JSON i CSV do pobrania w dowolnym momencie
- - Przechowywane przez 5 lat
13. Harmonogram automatyczny
| Godzina | Co sie dzieje |
|---|---|
| 23:59 | Kopia zapasowa CSV + pełny backup JSON konta |
| 00:05 | Publikacja swiezych plikow CSV/XML/MD5 ze wszystkimi zmianami |
| 00:10 | Wdrazanie zaplanowanych zmian cen (jesli data mniejsza lub rowna dzisiaj) |
| 03:00 | Czyszczenie starych logow systemowych |
| 09:00 (pon.) | Wysyłanie tygodniowych raportow e-mail do deweloperow |
Nawet jesli zapomnisz kliknac "Opublikuj zmiany", Twoje zmiany zostana opublikowane automatycznie nastepnej nocy o 00:05.
14. Subskrypcja i oplaty
Zakładka Subskrypcja i oplaty pokazuje aktualny stan konta:
- - Wybrany pakiet (Roczny lub Kwartalny) i daty waznosci
- - Aktywne moduly (Wyswietlanie cennika, Indywidualne wsparcie)
- - Limit inwestycji dostepny w ramach pakietu
- - Historia platnosci i faktur
Przy blizacym sie koncu subskrypcji system wyswietla ostrzezenie na Pulpicie i e-mailem.
15. Pola rozszerzone CSV (format 57-kolumnowy MRiT)
W formularzu edycji lokalu znajdziesz 4 opcjonalne, zwijane sekcje wymagane przez Ministerstwo Rozwoju:
- Czesc nieruchomosci (garaze, udzialy)
- Pomieszczenia przynaletne (piwnice, komorki lokatorskie)
- Prawa niezbedne do korzystania (drogi wewnetrzne, miejsca postojowe)
- Inne swiadczenia pieniezne (oplaty przyłączeniowe, inne koszty)
Sekcja pusta: Checkbox "Brak danych" jest zaznaczony automatycznie, sekcja zwinięta. W CSV pojawi sie znak X.
Sekcja z danymi: Odznacz checkbox, rozwiń sekcję, wypełnij pola. Dane trafią do raportu.
Nie musisz wypelniać tych sekcji jesli nie dotycza Twojej inwestycji.
16. Wsparcie techniczne
Zakładka Wsparcie w panelu deweloper umozliwia wyslanie wiadomosci bezposrednio do naszego zespolu bez koniecznosci opuszczania panelu.
Standardowo odpowiadamy w ciagu 1 dnia roboczego. Klienci z pakietem Indywidualne wsparcie korzystają z priorytetowej obsługi.
Formularz w panelu
Panel - Wsparcie
17. Najczestsze pytania
Kiedy najlepiej dokonywac zmian cen?
W dniu wejscia zmiany w zycie, do godziny 23:59. O tej porze system zamraza baze i generuje dobowa kopie.
Czy musze codziennie sie logowac?
Nie. Loguj sie tylko gdy masz faktyczne zmiany (nowa cena, rezerwacja, sprzedaz). Bez zmian system serwuje dotychczasowe dane.
Co jesli klient zrezygnuje z rezerwacji?
Zmien status z powrotem na Dostepny. Lokal wroci do raportu przy najblizszej publikacji.
Jak skorygowac blad w cenie?
Otworz edycje lokalu, wpisz poprawna cene i zapisz. Bledna wartosc zostanie zachowana w historii jako skorygowana.
Czy moge cofnac Przeniesienie własnosci?
Tak - zmien status z powrotem na Sprzedany lub Dostepny. Lokal wroci do raportu.
Kiedy dane.gov.pl zobaczy moje zmiany?
Po publikacji pliki sa natychmiast gotowe. Rzadowy harvester pobiera je zazwyczaj w ciagu 24 godzin.
Jak dodac lokal do drugiej inwestycji?
W formularzu dodawania lokalu wybierz z listy inwestycje do której ma nalezec. Kazdy lokal nalezy do jednej inwestycji.
Co oznacza blokada zakładek po zalogowaniu?
Jesli zakładki sa zablokowane, sprawdz Pulpit - pojawia sie tam lista kroków onboardingowych do wykonania (dane firmy, inwestycja, pierwszy lokal).
© 2026 deweloperdane.pl - Wszelkie prawa zastrzezone