Eksport ofert na Nieruchomości-online.pl

System voxDeveloper CRM umożliwia udostępnienie ofert mieszkań inwestycji deweloperskiej na portalu Nieruchomości-online.pl. Oferta przekazywana jest w postaci pliku XML, z którego portal cyklicznie pobiera aktualne dane — bez ręcznego przepisywania ofert. Poniższy artykuł opisuje, co należy przygotować i uzupełnić po stronie klienta, aby oferta została poprawnie opublikowana.

💡 Informacja: Dedykowany link do pliku XML wraz z kluczem API dla wybranej inwestycji przygotowuje zespół wsparcia technicznego voxCRM. Rolą klienta jest uzupełnienie kompletnych danych inwestycji i lokali w systemie.

Spis treści

  1. Jak działa integracja?
  2. Co należy uzupełnić — dane inwestycji
  3. Co należy uzupełnić — dane lokali
  4. Ważne zasady portalu
  5. Kontakt

1. Jak działa integracja?

Dla wskazanej inwestycji przygotowywany jest dedykowany adres (link) do pliku XML zabezpieczony kluczem API. Plik XML po stronie voxCRM aktualizuje się co godzinę, natomiast portal Nieruchomości-online.pl pobiera z niego dane automatycznie raz dziennie, około godziny 6:00. Przesyłane są dane lokali wraz z opisami, zdjęciami, rzutami oraz materiałami 3D.

Aby lokal trafił na portal, jego dane muszą być kompletne. Lokale z brakującymi wymaganymi danymi zostają pominięte podczas eksportu — pozostałe oferty publikują się normalnie.

⚠ Zakres integracji: Eksport obejmuje oferty z rynku pierwotnego w kategoriach: mieszkania, domy oraz lokale. Integracja nie obsługuje działek oraz ofert z rynku wtórnego.

2. Co należy uzupełnić — dane inwestycji

Na poziomie inwestycji wymagane jest uzupełnienie danych wspólnych dla wszystkich jej ofert:

Dane Wymóg
Adres strony WWW inwestycji Wymagany, wraz z pełnym adresem rozpoczynającym się od http:// lub https://.
Lokalizacja — województwo, powiat, gmina, miasto Wymagana. Oprócz danych adresowych zalecane jest uzupełnienie ulicy wraz z numerem.
⚠ Uwaga: Braki w danych na poziomie inwestycji (np. brak adresu strony WWW lub niekompletna lokalizacja) powodują pominięcie wszystkich lokali danej inwestycji.

3. Co należy uzupełnić — dane lokali

Dla każdego lokalu, który ma zostać opublikowany, wymagane jest uzupełnienie:

Dane lokalu Wymóg
Numer / sygnatura lokalu (np. B16) Wymagany.
Powierzchnia (metraż) Wymagana.
Cena oraz cena za m² Obie wartości wymagane.
Piętro Wymagane.
Liczba pokoi Wymagana.
Materiały graficzne — rzuty / karta lokalu, zdjęcia, materiały 3D Zalecane. Rzut lub karta lokalu istotnie zwiększa atrakcyjność oferty.
Opis Wymagany, minimum 50 znaków.
💡 Najczęstsze braki: opis krótszy niż 50 znaków, brak ceny za m², nieuzupełnione piętro lub liczba pokoi. Warto sprawdzić te elementy przed pierwszą publikacją.

4. Ważne zasady portalu

  • Sprzedaż i rezerwacja. Format portalu przewiduje statusy lokalu (dostępne, zarezerwowane, sprzedane). Oferta ze statusem „Sprzedane" nie jest prezentowana w portalu.
  • Zasada zamrożenia przy awarii. Jeśli link do pliku XML przestanie działać (np. z powodu błędu adresu URL lub przekroczenia czasu odpowiedzi), system nie kasuje dotychczasowych ogłoszeń. Na portalu pozostaje zamrożony ostatni poprawny stan do momentu naprawy źródła.
  • Aktualizacja automatyczna. Plik XML odświeża się co godzinę, a portal pobiera go raz dziennie (około godziny 6:00) — zmiany danych w systemie pojawiają się na portalu przy najbliższym pobraniu pliku.
  • Potwierdzenie publikacji. Import oferty odbywa się po stronie portalu. Efekt publikacji weryfikuje się w panelu Nieruchomości-online.pl.

Kontakt

W razie pytań lub problemów prosimy o kontakt z działem wsparcia technicznego:

Oceń ten wpis:

Tagi

Podobne wpisy