Przejdź do treści

Eksport ofert na Nieruchomości-online.pl

System voxDeveloper CRM umożliwia udostępnienie ofert inwestycji deweloperskiej na portalu Nieruchomości-online.pl. Portal automatycznie pobiera dane ofertowe z voxCRM w postaci pliku XML autoryzowanego kluczem API, bez ręcznego przepisywania ofert. Poniższy artykuł opisuje, jak uruchomić integrację i co należy uzupełnić w systemie, aby oferty zostały poprawnie opublikowane.

Spis treści

  1. Jak działa integracja?
  2. Jak uruchomić integrację?
  3. Pola obowiązkowe w voxCRM
  4. Mapowanie typów nieruchomości
  5. Mapowanie statusów sprzedażowych
  6. Kontakt

1. Jak działa integracja?

Portal Nieruchomości-online.pl pobiera dane ofertowe z voxCRM z dedykowanego pliku XML, autoryzowanego kluczem API. Dane inwestycji są pobierane i aktualizowane codziennie około godziny 6:00. Zmiany wprowadzone w systemie pojawiają się na portalu przy najbliższym pobraniu pliku.

💡 Bezpieczeństwo danych (system Anti-Fail): jeśli link do pliku XML przestanie działać (np. awaria serwera, błąd adresu URL, przekroczenie czasu odpowiedzi), portal nie kasuje ogłoszeń. Na portalu pozostaje zamrożony ostatni poprawny stan ofert do momentu naprawy źródła i przywrócenia połączenia.

2. Jak uruchomić integrację?

  1. Przygotuj dedykowany link do pliku XML dla wybranej inwestycji wraz z powiązanym kluczem API. Link można wygenerować samodzielnie w Administracja > Linki do feedów XML/API (wymaga uprawnienia do zarządzania linkami feedów) albo poprosić o niego zespół wsparcia voxCRM.
  2. Jeśli inwestycja jest podzielona na etapy obsługiwane osobno, potrzebny jest osobny link dla każdego etapu.
  3. Link i klucz API prześlij na adres portalu: aktualizacja@nieruchomosci-online.pl.

3. Pola obowiązkowe w voxCRM

Aby w pełni wykorzystać integrację, uzupełnij dla każdego lokalu:

Dane lokalu Uwagi
Numer / sygnatura lokalu Unikalny identyfikator lokalu. W inwestycji wieloetapowej uzupełnij także budynek.
Powierzchnia Dokładny metraż.
Piętro  
Liczba pokoi  
Rzut lub karta lokalu  
Cena brutto oraz cena za m² Wymagane, patrz uwaga poniżej.
Data realizacji  
⚠ Brak ceny blokuje import: portal prezentuje wszystkie typy nieruchomości wyłącznie z ceną brutto. Lokal bez ceny w voxCRM (mieszkanie, dom czy lokal użytkowy) nie zostanie zaimportowany.
💡 Zalecenie: uzupełnij oferty o dodatkowe materiały graficzne: wysokiej jakości rzuty i wirtualne spacery 3D po lokalach. Budują zaufanie poszukujących i skracają czas ich reakcji na ofertę.

4. Mapowanie typów nieruchomości

Portal automatycznie przypisuje typ lokalu z voxCRM do swojej kategorii:

Typ w voxCRM Kategoria w Nieruchomości-online.pl
Mieszkanie, Apartament Mieszkanie
Dom Dom
Lokal komercyjny, Lokal biurowy, Condohotel Lokal użytkowy
⚠ Lokale inwestycyjne: wybór typu ma duże znaczenie dla zasięgu oferty. Portal nie wyświetla lokali komercyjnych w wynikach wyszukiwania mieszkań, nawet jeśli lokal ma charakter mieszkaniowy lub inwestycyjny. Jeśli taki lokal ma trafiać do osób szukających mieszkań, nadaj mu w voxCRM typ Apartament.

5. Mapowanie statusów sprzedażowych

Portal publikuje wyłącznie aktualne oferty ze statusem „dostępne” i „zarezerwowane”, zawsze z ceną:

Status w voxCRM Status na portalu Widoczność
Dostępne Dostępne widoczna
Rezerwacja ustna, Umowa rezerwacyjna Zarezerwowane widoczna
Sprzedane, Umowa przedwstępna, Umowa deweloperska, Akt notarialny, Odbiór, Wstrzymany Sprzedane / wstrzymane niewidoczna

Jeśli przy aktualizacji opublikowanej oferty zabraknie ceny, portal pokazuje ostatnią cenę sprzed aktualizacji.

Kontakt

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