Nowa ustawa o jawności cen - przekazywanie historii cen na stronę WWW

Zmodyfikowano dnia czw, 12 Cze o 10:38 RANO

W systemie mamy przygotowany endpoint do przekazywania historii zmian cen nieruchomości na podstawie dostępnego w systemie Raportu historii zmian cen lokali.

Link do przykładowego endpointu historii zmian cen lokali:

https://demo1.voxdeveloper.com/webservice/realestate-price-history/api_key/ab33c2fb8240c8c7ca015d924713b5d234b7778e/investment_id/21

Przykładowa struktura endpointu historii zmian cen lokali dla inwestycji:

<xml>
  <realestate>
    <id>1</id>
    <investment_id>1</investment_id>
    <investment_name>Testowa Inwestycja</investment_name>
    <investment_stage/>
    <building>A</building>
    <name>A - M1</name>
    <local_number>M1</local_number>
    <type_id>1</type_id>
    <type>Mieszkanie</type>
    <price>490000.00</price>                //aktualna cena
    <price_net>453703.70</price_net>        //aktualna cena
    <pricemkw>10888.89</pricemkw>           //aktualna cena
    <pricemkw_net>10082.31</pricemkw_net>   //aktualna cena
    <price_history>
      <price_change>
        <date_modified>2025-05-26 17:00:00</date_modified>
        <before>
          <price>500000.00</price>                //cena przed zmianą
          <price_net>462962.96</price_net>        //cena przed zmianą
          <pricemkw>11111.11</pricemkw>           //cena przed zmianą
          <pricemkw_net>10288.06</pricemkw_net>   //cena przed zmianą
        </before>
        <after>
          <price>490000.00</price>                //cena po zmianie
          <price_net>453703.70</price_net>        //cena po zmianie
          <pricemkw>10888.89</pricemkw>           //cena po zmianie
          <pricemkw_net>10082.31</pricemkw_net>   //cena po zmianie
        </after>
      </price_change>
      <price_change>
        ...
      </price_change>
    </price_history>
  </realestate>
  <realestate>
    <id>2</id>
    <investment_id>1</investment_id>
    <investment_name>Testowa Inwestycja</investment_name>
    <investment_stage/>
    <building>B</building>
    <name>B - M2</name>
    <local_number>M2</local_number>
    <type_id>1</type_id>
    <type>Mieszkanie</type>
    <price>590000.00</price>                //aktualna cena
    <price_net>546296.30</price_net>        //aktualna cena
    <pricemkw>13111.11</pricemkw>           //aktualna cena
    <pricemkw_net>12139.92</pricemkw_net>   //aktualna cena
    <price_history>
      <price_change>
        ...
      </price_change>
      <price_change>
        ...
      </price_change>
    </price_history>
  </realestate>
</xml>

Opis pól w XML:

Nazwa pola w XML	Opis
<id/>	Identyfikator lokalu
<investment_id/>	Identyfikator inwestycji
<investment_name/>	Nazwa inwestycji
<investment_stage/>	Identyfikator etapu inwestycji
<building/>	Numer budynku lokalu
<name/>	Nazwa lokalu (numer budynku - numer lokalu)
<local_number/>	Numer lokalu
<type_id/>	Identyfikator typu lokalu
<type/>	Nazwa typu lokalu
<price_history/>	Blok historii zmian cen
<price_change/>	Blok zmiany ceny
<date_modified/>	Data modyfikacji ceny
<before/>	Blok ceny przed zmianą
<after/>	Blok ceny po zmianie
<price/>	Cena katalogowa brutto
<price_net/>	Cena katalogowa netto
<pricemkw/>	Cena katalogowa za m2 brutto
<pricemkw_net/>	Cena katalogowa za m2 netto

Alternatywnie do istniejących endpointów możemy dodać pole <price_change_history>, w który przekazywany będzie link do zmian ceny danego lokalu.

Link do przykładowego endpointa zawierającego nagłówek <price_change_history>:

https://demo1.voxdeveloper.com/webservice/realestatestatuslist/api_key/ab33c2fb8240c8c7ca015d924713b5d234b7778e/investment_id/21

Oraz przykładowy endpoint dla historii zmiany cen pojedynczego lokalu:

https://demo1.voxdeveloper.com/webservice/realestate-price-history/api_key/ab33c2fb8240c8c7ca015d924713b5d234b7778e/realestate_id/2288

Przykładowa struktura endpointu dla historii zmian cen pojedynczego lokalu:

<xml>
  <realestate>
    <id>1</id>
    <investment_id>1</investment_id>
    <investment_name>Testowa Inwestycja</investment_name>
    <investment_stage/>
    <building>A</building>
    <name>A - M1</name>
    <local_number>M1</local_number>
    <type_id>1</type_id>
    <type>Mieszkanie</type>
    <price>490000.00</price>                //aktualna cena
    <price_net>453703.70</price_net>        //aktualna cena
    <pricemkw>10888.89</pricemkw>           //aktualna cena
    <pricemkw_net>10082.31</pricemkw_net>   //aktualna cena
    <price_history>
      <price_change>
        <date_modified>2025-05-26 17:00:00</date_modified>
        <before>
          <price>500000.00</price>
          <price_net>462962.96</price_net>
          <pricemkw>11111.11</pricemkw>
          <pricemkw_net>10288.06</pricemkw_net>
        </before>
        <after>
          <price>490000.00</price>
          <price_net>453703.70</price_net>
          <pricemkw>10888.89</pricemkw>
          <pricemkw_net>10082.31</pricemkw_net>
        </after>
      </price_change>
      <price_change>
        <date_modified>2025-04-12 13:54:33</date_modified>
        <before>
          <price>510000.00</price>
          <price_net>472222.22</price_net>
          <pricemkw>11333.33</pricemkw>
          <pricemkw_net>10493.82</pricemkw_net>
        </before>
        <after>
          <price>500000.00</price>
          <price_net>462962.96</price_net>
          <pricemkw>11111.11</pricemkw>
          <pricemkw_net>10288.06</pricemkw_net>
        </after>
      </price_change>
    </price_history>
  </realestate>
</xml>

Więcej informacji o przekazywanych danych w artykule: W jaki sposób podłączyć stronę WWW do voxCRM