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.
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
- 01Dlaczego ręczny eksport z CRM przestaje wystarczać
- 02Najpierw zdecyduj, gdzie żyje cena lokalu
- 03Cztery sposoby połączenia CRM lub ERP z raportem dla dane.gov.pl
- 04Co musi się zgadzać między CRM a raportem
- 05Typowe błędy przy łączeniu systemu sprzedaży z raportem
- 06Pytania do dostawcy CRM albo ERP przed połączeniem
- 07Jak to łączymy w DeweloperCeny
- 08Najczęstsze pytania
- 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.
| Dane | Gdzie się zmieniają | Kto je czyta |
|---|---|---|
| Status lokalu (wolny, rezerwacja, sprzedany) | CRM – tam pracują handlowcy | cennik na stronie, makieta, raport |
| Cena za m² i cena lokalu | CRM albo cennik na stronie – tylko jedno z nich | strona, raport, ERP |
| Historia cen i najniższa cena z 30 dni | tam, gdzie zapisuje się zmiana ceny z datą | strona, raport |
| Dane dewelopera, adresy, współrzędne inwestycji | cennik i raport (zmieniają się rzadko) | raport |
| Umowy, harmonogramy, wpłaty | CRM i ERP | nie 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ób | Jak działa | Kto pilnuje struktury raportu | Kiedy wybrać |
|---|---|---|---|
| 1. CRM zmienia cennik przez API | Zmiana statusu albo ceny w CRM od razu idzie do cennika na stronie, który zapisuje historię i przebudowuje raport | cennik na stronie | sprzedaż pracuje w CRM, a CRM ma automatyzacje albo webhooki |
| 2. Cennik jest źródłem, CRM czyta | Ceny zmienia się w panelu cennika, a CRM dostaje zdarzenie o zmianie albo czyta dane z API | cennik na stronie | ceny zatwierdza jedna osoba, CRM służy do kontaktów i rezerwacji |
| 3. Eksport z CRM i import pliku | Przy każdej zmianie cennika eksport do CSV i import w panelu z mapowaniem kolumn | cennik; termin pilnuje człowiek | rzadkie zmiany cen, CRM bez API, okres przejściowy |
| 4. Własny moduł raportu w ERP | System sam składa plik 48 pól, plik XML dla portalu i sumę MD5 pod stałym adresem | dostawca systemu | duż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 raportu | Wymaganie | Co ustawić w CRM lub ERP |
|---|---|---|
| Identyfikator lokalu (E2) | unikalny i stały przez cały proces oferowania | numer 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 |
| Status | raport zawiera ofertę; we wtyczce DeweloperCeny lokal sprzedany wypada z raportu, zarezerwowany zostaje | sprzedaż 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 lokalu | komó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 lokalu | opłaty pobierane poza ceną lokalu zapisane z wartością i datą |
| Adresy XML i MD5 | zgłoszone w portalu raz, pobierane codziennie | zmiana 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
- Czy system wysyła zdarzenie (webhook) przy zmianie statusu i ceny lokalu? W jakim formacie i z jakimi polami?
- Czy potrafi wywołać zewnętrzne API z własnym nagłówkiem, np. kluczem dostępu, bez programowania po naszej stronie?
- Czy ma pole na numer lokalu zgodny z cennikiem i prospektem, a nie tylko wewnętrzny identyfikator rekordu?
- Czy zapisuje datę i godzinę każdej zmiany ceny, czy tylko bieżącą cenę?
- Czy pomieszczenia przynależne i miejsca postojowe są osobnymi pozycjami z ceną i oznaczeniem?
- Co dzieje się, gdy wysyłka danych się nie uda – czy system ponawia próbę i czy ktoś dostaje informację?
- Kto i za ile dostosuje integrację, gdy struktura raportu znów się zmieni?
- 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ą.
- 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
- 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
- Dziennik Ustaw: rozporządzenie Ministra Cyfryzacji z 10 listopada 2026 r. w sprawie struktury danych (Dz.U. 2026 poz. 1489)
- ISAP: ustawa deweloperska, tekst jednolity Dz.U. 2026 poz. 880 (art. 19a, art. 19b)