Przejdź do treści

Raport dane.gov.pl z CRM lub ERP dewelopera – jak połączyć bez ręcznego eksportu

Handlowcy rezerwują lokale w CRM, księgowość pracuje w ERP, a plik dla dane.gov.pl ktoś co rano składa z eksportu. Od 11 listopada 2026 r. raport ma 48 pól, daty z godziną i osobne wiersze na pomieszczenia przynależne – ręczne kopiowanie przestaje się bronić. Pokazujemy cztery sposoby połączenia systemu sprzedaży z raportem i cennikiem na stronie.

Opublikowano
Stan prawny na
13 listopada 2026
Czytanie
13 min

W skrócie

  • Raport dla dane.gov.pl nie musi powstawać z ręcznego eksportu z CRM albo ERP. Najpierw ustal jedno miejsce, w którym zmienia się cena i status lokalu – wszystkie inne systemy tylko je czytają.
  • Najprostszy układ: CRM zmienia status i cenę w cenniku na stronie przez API, a cennik zapisuje historię cen z datą i sam przebudowuje raport w strukturze 48 pól z rozporządzenia z 10 listopada 2026 r.
  • Między systemem sprzedaży a raportem muszą się zgadzać: stały identyfikator lokalu, cena z datą i godziną zmiany, status (sprzedane wypadają z raportu) i pomieszczenia przynależne z własną ceną w osobnych wierszach.
  • Przed połączeniem zapytaj dostawcę CRM albo ERP, czy wysyła zdarzenia przy zmianie ceny, czy może wywołać zewnętrzne API z kluczem i czy zapisuje datę zmiany, a nie tylko bieżącą cenę.
Spis treści 9 części
  1. 01Dlaczego ręczny eksport z CRM przestaje wystarczać
  2. 02Najpierw zdecyduj, gdzie żyje cena lokalu
  3. 03Cztery sposoby połączenia CRM lub ERP z raportem dla dane.gov.pl
  4. 04Co musi się zgadzać między CRM a raportem
  5. 05Typowe błędy przy łączeniu systemu sprzedaży z raportem
  6. 06Pytania do dostawcy CRM albo ERP przed połączeniem
  7. 07Jak to łączymy w DeweloperCeny
  8. 08Najczęstsze pytania
  9. 09Źródła i podstawa prawna

Jeśli cennik i statusy lokali prowadzisz w CRM albo ERP, raport dla dane.gov.pl nie musi powstawać z ręcznego eksportu. Wystarczy ustalić jedno miejsce, w którym zmienia się cena i status lokalu, i połączyć z nim resztę: CRM zmienia cenę w cenniku na stronie przez API, a cennik zapisuje historię i codziennie wystawia plik w strukturze 48 pól z rozporządzenia z 10 listopada 2026 r. (Dz.U. 2026 poz. 1489), pod stałymi adresami XML i MD5. Poniżej porównujemy cztery sposoby połączenia, pokazujemy, co musi się zgadzać między systemem sprzedaży a raportem, i dajemy listę pytań do dostawcy CRM albo ERP.

Ten tekst jest o raporcie i cenach. Jak zapytania ze strony trafiają do CRM, opisujemy w artykule zapytania o mieszkania – integracja strony z CRM, a czym CRM różni się od ERP u dewelopera – w porównaniu CRM a ERP w firmie deweloperskiej.

Dlaczego ręczny eksport z CRM przestaje wystarczać

Często wygląda to tak: handlowcy zmieniają statusy w CRM, zarząd zatwierdza nowy cennik w arkuszu, a ktoś co rano eksportuje lokale, układa kolumny, zapisuje plik i wgrywa go na serwer. Przy kilkunastu lokalach i rzadkich zmianach da się tak żyć. Od 11 listopada 2026 r. ten plik ma jednak strukturę 48 pól w ośmiu grupach i kilka wymagań, które ręczny eksport łatwo psuje:

  • Daty z godziną. Cena za m² i cena lokalu mają datę i czas, od których obowiązują, w formacie RRRR-MM-DD GG:MM:SS. Jeśli eksport z CRM podaje tylko bieżącą cenę, datę jej zmiany trzeba odtwarzać osobno.
  • Stały identyfikator lokalu. Rozporządzenie wymaga oznaczenia, które zachowuje tę samą wartość przez cały proces oferowania. Najprościej, gdy jest nim numer lokalu z cennika, a nie wewnętrzny numer rekordu z CRM.
  • Pomieszczenia przynależne osobno. Komórka czy piwnica z ceną spoza ceny lokalu ma własny rodzaj, identyfikator, cenę i datę, a we wzorcowym dokumencie Ministerstwa Cyfryzacji z 11 listopada 2026 r. – osobny wiersz.
  • Współrzędne inwestycji. Długość i szerokość geograficzna punktu inwestycji, z dokładnością do sześciu miejsc po przecinku. To dane inwestycji, a nie lokalu, więc w eksporcie lokali z CRM ich nie będzie.

Do tego dochodzi strona: cena przy lokalu musi się zmienić z dniem zmiany, wcześniejsze ceny zostają w historii, a przy obniżce trzeba pokazać najniższą cenę z 30 dni. Ręczny eksport oznacza trzy kopie tych samych cen – w CRM, na stronie i w pliku – i prędzej czy później jedna z nich się rozjedzie. Skutki opisujemy w artykule dwie ceny tego samego mieszkania na stronie, a pełną listę pól – w przewodniku struktura danych od 11 listopada 2026 r.

Najpierw zdecyduj, gdzie żyje cena lokalu

Każde połączenie systemów zaczyna się od jednej decyzji: w którym miejscu wolno zmienić cenę i status lokalu. Wszystkie pozostałe miejsca tylko te dane czytają. Jeśli cenę da się edytować w dwóch systemach, każdy z nich prędzej czy później będzie miał własną wersję prawdy.

DaneGdzie się zmieniająKto je czyta
Status lokalu (wolny, rezerwacja, sprzedany)CRM – tam pracują handlowcycennik na stronie, makieta, raport
Cena za m² i cena lokaluCRM albo cennik na stronie – tylko jedno z nichstrona, raport, ERP
Historia cen i najniższa cena z 30 dnitam, gdzie zapisuje się zmiana ceny z datąstrona, raport
Dane dewelopera, adresy, współrzędne inwestycjicennik i raport (zmieniają się rzadko)raport
Umowy, harmonogramy, wpłatyCRM i ERPnie trafiają do raportu

Status prawie zawsze zmienia się w CRM, bo to tam handlowiec rezerwuje lokal. Z ceną bywa różnie: w jednych firmach cennik zatwierdza zarząd i wprowadza jedna osoba, w innych ceny zmieniają się w CRM razem z rabatami. Od tego wyboru zależy, który z czterech sposobów połączenia pasuje.

Cztery sposoby połączenia CRM lub ERP z raportem dla dane.gov.pl

SposóbJak działaKto pilnuje struktury raportuKiedy wybrać
1. CRM zmienia cennik przez APIZmiana statusu albo ceny w CRM od razu idzie do cennika na stronie, który zapisuje historię i przebudowuje raportcennik na stroniesprzedaż pracuje w CRM, a CRM ma automatyzacje albo webhooki
2. Cennik jest źródłem, CRM czytaCeny zmienia się w panelu cennika, a CRM dostaje zdarzenie o zmianie albo czyta dane z APIcennik na stronieceny zatwierdza jedna osoba, CRM służy do kontaktów i rezerwacji
3. Eksport z CRM i import plikuPrzy każdej zmianie cennika eksport do CSV i import w panelu z mapowaniem kolumncennik; termin pilnuje człowiekrzadkie zmiany cen, CRM bez API, okres przejściowy
4. Własny moduł raportu w ERPSystem sam składa plik 48 pól, plik XML dla portalu i sumę MD5 pod stałym adresemdostawca systemuduży ERP z działem IT; strona i tak potrzebuje cen z historią

1. CRM zmienia cennik przez API zapisu

To układ, w którym handlowiec nie zagląda do panelu strony. We wtyczce DeweloperCeny od wersji 2.23 działa API zapisu – domyślnie wyłączone, włącza się je w panelu Deweloper – Oferty → CRM i integracje. CRM wysyła zapytanie POST na adres lokalu: po jego identyfikatorze we wtyczce albo po numerze lokalu w danej inwestycji. Może zmienić trzy rzeczy – status (wolny, zarezerwowany, sprzedany), cenę brutto i cenę za m² – i dopisać, skąd przyszła zmiana.

POST /wp-json/deweloper-oferty/v1/inwestycje/3/lokale
X-DeweloperCeny-Klucz: klucz z panelu
Content-Type: application/json

{ "numer": "A/1.05", "status": "zarezerwowany", "zrodlo": "CRM" }

Autoryzacja to klucz z panelu w nagłówku albo hasło aplikacji konta administratora WordPressa. Zmiana idzie tą samą drogą co edycja w panelu: nowa cena trafia do historii z datą, cena za m² liczy się z nowej ceny, jeśli CRM jej nie poda, a pliki raportu przebudowują się po zapisie. Każda zmiana z API trafia do dziennika w panelu – kto, kiedy, co było i co jest.

Uczciwie o granicach: API zmienia status i ceny lokali, które już są w cenniku. Nie zakłada nowych lokali i nie zmienia metrażu ani cen komórek czy miejsc postojowych – te dane wprowadza się w panelu albo importem. Lokal, którego numer nie pasuje do cennika, API odrzuci, zamiast założyć duplikat.

2. Cennik jako źródło, CRM czyta zmiany

Jeśli cennik zatwierdza zarząd i wprowadza go jedna osoba, prościej odwrócić kierunek. Wtyczka przy każdej zmianie statusu albo ceny lokalu – z panelu, importu albo API – wysyła zdarzenie w formacie JSON na adres podany w panelu: do Make, Zapiera, n8n albo własnego serwera CRM. Zdarzenie zawiera dane lokalu i poprzednie wartości, jest podpisane HMAC-SHA256, a gdy odbiorca nie odpowiada, wysyłka jest ponawiana po 1, 5, 15 i 60 minutach.

Drugą drogą jest publiczne API odczytu: lista lokali inwestycji z ceną brutto, ceną za m², ceną łączną, najniższą ceną z 30 dni przy obniżce, datą ostatniej zmiany ceny i pełną historią. Z tych samych danych może korzystać ERP albo raport dla zarządu. Lokale sprzedane są w API widoczne ze statusem, a ceny ukryte w ustawieniach inwestycji wracają jako puste.

3. Eksport z CRM albo ERP i import pliku

Gdy CRM nie ma API ani webhooków, zostaje plik. Importer wtyczki czyta CSV z separatorem średnik, przecinek albo tabulator, w kodowaniu UTF-8 albo Windows-1250, i przyjmuje tabelę wklejoną prosto z Excela. Kolumny przypisuje się do pól cennika, a przed zapisem można zrobić próbę na sucho. Istniejące lokale dopasowują się po numerze, a pola spoza mapowania zostają bez zmian. Jeden import to do 2000 wierszy; osobny tryb wczytuje historię cen z datą wsteczną.

To nadal praca ręczna: ktoś musi zrobić eksport i import w dniu zmiany ceny. Cyklicznego importu z pliku pod adresem URL ani poleceń WP-CLI wtyczka nie ma – taką funkcję można zamówić. Jeśli Twój cennik to dziś arkusz, zobacz, jak przejść z cennika w Excelu na raport bez codziennego eksportu.

4. Własny moduł raportu w ERP

Duże ERP potrafią składać pliki dla urzędów, więc kusi, żeby raport generował system finansowy. Moduł musi jednak spełnić całą specyfikację: 48 pól w ustalonej kolejności, daty z godziną, kwoty bez separatorów tysięcy, znak „X” w pustych polach (jak we wzorcowym dokumencie ministerstwa), dzienny plik CSV, plik XML dla portalu z listą zasobów i sumę MD5 pod stałym adresem https, który odpowiada kodem 200. Każda zmiana przepisów to zlecenie dla dostawcy: projekt rozporządzenia miał 57 pól, a ostateczny tekst z 48 polami ogłoszono 10 listopada 2026 r., dzień przed wejściem w życie. A strona i tak potrzebuje cen przy lokalach, historii i najniższej ceny z 30 dni, więc ERP musiałby zasilać także ją. Jak wygląda poprawny plik, pokazujemy we wzorze pliku CSV dla dane.gov.pl.

Co musi się zgadzać między CRM a raportem

Niezależnie od sposobu połączenia te elementy muszą mieć jedną wartość we wszystkich systemach. Z naszych wdrożeń wynika, że najwięcej pracy wymaga pierwszy wiersz tabeli.

Element raportuWymaganieCo ustawić w CRM lub ERP
Identyfikator lokalu (E2)unikalny i stały przez cały proces oferowanianumer lokalu taki sam jak w cenniku, prospekcie i raporcie; bez zmiany numeracji w trakcie sprzedaży
Cena i data (E3–E6)cena za m² i cena lokalu z datą i czasem, od których obowiązujązmiana ceny jako nowa wartość z datą, a nie nadpisanie starej
Statusraport zawiera ofertę; we wtyczce DeweloperCeny lokal sprzedany wypada z raportu, zarezerwowany zostajesprzedaż w CRM zmienia status w cenniku tego samego dnia
Pomieszczenia przynależne (F1–F5)rodzaj, identyfikator, cena i data, gdy cena nie jest w cenie lokalu, oraz identyfikator lokalukomórka czy piwnica jako osobna pozycja z oznaczeniem (np. K7) i własną ceną
Prawa niezbędne i inne świadczenia (G, H)opis, wartość, data i identyfikator lokaluopłaty pobierane poza ceną lokalu zapisane z wartością i datą
Adresy XML i MD5zgłoszone w portalu raz, pobierane codzienniezmiana systemu nie może zmienić adresu zgłoszonego na dane.gov.pl

Więcej o komórkach i miejscach postojowych w raporcie piszemy w artykule cena łączna, miejsce postojowe i komórka w raporcie.

Typowe błędy przy łączeniu systemu sprzedaży z raportem

  • Dwie bazy cen. Cennik edytowany i w CRM, i w panelu strony. Po kilku tygodniach nikt nie wie, która cena jest aktualna.
  • Kopiowanie raz w tygodniu. Cena obowiązuje od dnia zmiany, więc plik z piątku ze zmianą z poniedziałku pokazuje stan, którego już nie ma.
  • Różne numery tego samego lokalu. W CRM „M12”, w cenniku „A/1.12”, w prospekcie „12”. API po numerze nie znajdzie lokalu, a import założy nowy. Numerację ujednolica się przed połączeniem, nie po nim.
  • Daty bez godziny i strefy czasowe. CRM w chmurze bywa ustawiony na czas UTC. Przy ręcznym przenoszeniu zmiana wprowadzona tuż przed północą potrafi trafić do pliku z datą następnego dnia. We wtyczce data i godzina zmiany zapisują się w czasie ustawionym w WordPressie.
  • Poprawka błędu zapisana jak nowa cena. Literówka w cenie poprawiona przez CRM staje się w historii „zmianą ceny”. Jak odróżnić korektę od zmiany, opisujemy w artykule korekta cennika: metraż, data ceny i historia.
  • Rezerwacja tylko w CRM. Handlowiec rezerwuje lokal, a na stronie lokal dalej jest wolny – kolejni kupujący pytają o mieszkanie, którego nie da się kupić.
  • Kilka spółek w jednym systemie. ERP prowadzi kilka spółek celowych, a raport każdej z nich ma osobne zgłoszenie i własne dane dewelopera. Zobacz kilka spółek celowych a raport dla dane.gov.pl.

Pytania do dostawcy CRM albo ERP przed połączeniem

  1. Czy system wysyła zdarzenie (webhook) przy zmianie statusu i ceny lokalu? W jakim formacie i z jakimi polami?
  2. Czy potrafi wywołać zewnętrzne API z własnym nagłówkiem, np. kluczem dostępu, bez programowania po naszej stronie?
  3. Czy ma pole na numer lokalu zgodny z cennikiem i prospektem, a nie tylko wewnętrzny identyfikator rekordu?
  4. Czy zapisuje datę i godzinę każdej zmiany ceny, czy tylko bieżącą cenę?
  5. Czy pomieszczenia przynależne i miejsca postojowe są osobnymi pozycjami z ceną i oznaczeniem?
  6. Co dzieje się, gdy wysyłka danych się nie uda – czy system ponawia próbę i czy ktoś dostaje informację?
  7. Kto i za ile dostosuje integrację, gdy struktura raportu znów się zmieni?
  8. Czy w systemie widać, kto i kiedy zmienił cenę lub status lokalu?

Jeśli na pierwsze dwa pytania odpowiedź brzmi „tak”, połączenie przez API zwykle da się ustawić bez pisania osobnej aplikacji – wystarczy narzędzie do automatyzacji albo scenariusz po stronie CRM.

Jak to łączymy w DeweloperCeny

Wtyczka DeweloperCeny prowadzi cennik na stronie z historią cen i najniższą ceną z 30 dni, wystawia raport dla dane.gov.pl w strukturze z rozporządzenia i łączy się z systemem sprzedaży w obie strony: przyjmuje zmiany statusu i ceny przez API zapisu i wysyła zdarzenia o zmianach do CRM. Gdy strona ma własny projekt kart lokali, ceny wczytują się do niej z publicznego API – tak działa strona inwestycji w Elementorze z cenami z API. Jeśli strona nie stoi na WordPressie, zobacz, jak dodać jawność cen do strony na kreatorze albo własnym CMS, a opis adresów i pól API jest na stronie API dla agencji i programistów.

Nie masz jeszcze CRM albo abonament za każdego handlowca przestał się opłacać? Budujemy CRM dla deweloperów połączony z cennikiem i raportem dla dane.gov.pl – na własność, od 28 000 zł zależnie od zakresu. Rezerwacja w takim systemie od razu zmienia status w cenniku na stronie i w raporcie, bez eksportów. Potrzebujesz importu cennika z pliku pod adresem URL albo innego połączenia, którego wtyczka dziś nie ma? Napisz – wycenimy je po ustaleniu, skąd i jak często mają płynąć dane.

Najczęstsze pytania

Czy raport dla dane.gov.pl można generować prosto z CRM albo ERP?

Można, jeśli system codziennie wystawia plik w strukturze 48 pól z rozporządzenia z 10 listopada 2026 r. (Dz.U. 2026 poz. 1489) pod stałym adresem https, razem z plikiem XML dla portalu i sumą MD5, i będzie aktualizowany przy każdej zmianie przepisów. Częściej prostsze jest połączenie: CRM zmienia status i cenę w cenniku na stronie przez API, a raport tworzy cennik, który i tak musi prowadzić historię cen.

Jak CRM może zmienić cenę lokalu we wtyczce DeweloperCeny?

Przez API zapisu, dostępne od wersji 2.23 i domyślnie wyłączone. CRM wysyła zapytanie POST na adres lokalu – po jego identyfikatorze we wtyczce albo po numerze lokalu w inwestycji – z polami status, cena brutto albo cena za m². Autoryzacja to klucz z panelu w nagłówku X-DeweloperCeny-Klucz albo hasło aplikacji administratora. Zmiana ceny trafia do historii z datą, a raport przebudowuje się sam.

Skąd CRM ma wiedzieć o zmianie ceny wprowadzonej w panelu cennika?

Wtyczka DeweloperCeny wysyła zdarzenie przy każdej zmianie statusu albo ceny lokalu – z panelu, importu albo API – jako JSON na adres z panelu, np. do Make, Zapiera, n8n albo własnego serwera CRM. Treść jest podpisana HMAC-SHA256, a nieudana wysyłka jest ponawiana po 1, 5, 15 i 60 minutach. Dane można też czytać z publicznego API w formacie JSON.

Czy wtyczka sama pobiera cennik z CRM, np. z pliku pod adresem URL?

Nie. Wtyczka nie ma cyklicznego importu z adresu URL ani poleceń WP-CLI. Cennik wczytuje się z pliku CSV albo wklejonej tabeli z Excela w panelu (do 2000 wierszy na raz, z próbą na sucho) albo zmienia przez API zapisu wywoływane z CRM. Import z adresu URL można zamówić jako funkcję dodatkową.

Co musi się zgadzać między CRM a raportem dla dane.gov.pl?

Identyfikator lokalu – ten sam w CRM, cenniku na stronie i raporcie, niezmienny przez całą sprzedaż. Cena za m² i cena lokalu z datą i godziną, od której obowiązują. Status – lokal sprzedany nie powinien zostać w ofercie. Pomieszczenia przynależne z własną ceną, identyfikatorem i przypisaniem do lokalu.

Źródła i podstawa prawna

Stan prawny na 13 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. 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
  3. Dziennik Ustaw: rozporządzenie Ministra Cyfryzacji z 10 listopada 2026 r. w sprawie struktury danych (Dz.U. 2026 poz. 1489)
  4. ISAP: ustawa deweloperska, tekst jednolity Dz.U. 2026 poz. 880 (art. 19a, art. 19b)
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