Integracja CRM: eksport ofert do nAgent.pl

Strona dla dostawców programów CRM dla biur nieruchomości i dla agentów, którzy chcą wysyłać oferty do nAgent.pl tak samo jak na portale ogłoszeniowe. Eksport do nAgent jest bezpłatny dla agentów i dla dostawców.

W skrócie

Agent nie musi wpisywać ofert drugi raz. Wystarczy, że CRM biura wyśle plik z ofertami na Twój adres odbioru albo poda nam link do pliku, który pobieramy co godzinę. Rozpoznajemy format nAgent XML, paczki ZIP wysyłane na portale, eksporty EstiCRM, Otodom, Gratka, Trovit, Kyero i Facebook oraz pliki CSV i Excel. Nie publikujemy numeru budynku ani lokalu.

Dla agenta bez CRM: oferty dodasz w panelu ręcznie albo z linku do ogłoszenia.

Format nAgent XML Oferty w panelu (demo)

CRM wysyła plik

Agent w panelu nAgent tworzy swój adres odbioru i wpisuje go w CRM. Program wysyła na ten adres cały plik ofert (POST albo PUT) po każdej zmianie lub co kilka godzin.

Albo my pobieramy plik

Jeśli CRM publikuje plik ofert pod stałym adresem (np. eksport na stronę biura), agent wkleja ten adres, a my pobieramy go co godzinę, co 6 godzin albo raz na dobę.

Pełna lista ofert

Każdy plik to wszystkie aktualne oferty agenta. Nowe dodajemy, zmienione aktualizujemy, a tych, których w pliku już nie ma, nie pokazujemy. Pusty plik niczego nie usuwa. Eksport różnicowy (tylko zmiany, jak na portale) też przyjmujemy: wtedy wycofujemy tylko oferty oznaczone do usunięcia.

Format nAgent XML (wersja 1)

Kodowanie UTF-8 (przyjmujemy też ISO-8859-2 i Windows-1250 z deklaracją w nagłówku). Element główny <nagent wersja="1">, w nim jedna <oferta> na ofertę. Kolejność pól dowolna, nieznane pola pomijamy. Pobierz przykładowy plik.

Pole	Wymagane	Opis
`id`	tak	Numer oferty w CRM. Po nim rozpoznajemy tę samą ofertę przy kolejnej wysyłce.
`status`	nie	aktywna, rezerwacja, sprzedana albo wycofana. Brak = aktywna.
`transakcja`	tak	sprzedaz albo wynajem.
`rodzaj`	tak	mieszkanie, dom, dzialka albo lokal.
`tytul`	nie	Tytuł ogłoszenia, do 140 znaków. Brak = tytuł z rodzaju, pokoi i metrażu.
`opis`	nie	Opis, do 8000 znaków. Zwykły tekst lub CDATA; znaczniki HTML usuwamy.
`cena`	tak	Cena w złotych, liczba całkowita. Przy wynajmie czynsz miesięczny.
`powierzchnia`	tak*	Metry kwadratowe, kropka lub przecinek dziesiętny. *Przy działce można pominąć.
`pokoje`	nie	Liczba pokoi.
`pietro`	nie	Piętro, 0 = parter.
`pieter`	nie	Liczba pięter w budynku.
`rok`	nie	Rok budowy.
`miasto`	tak	Nazwa miejscowości.
`dzielnica`	nie	Dzielnica lub osiedle.
`ulica`	nie	Sama nazwa ulicy. Numer budynku i lokalu usuwamy, nie publikujemy adresu.
`url`	nie	Link do oferty na stronie biura.
`zdjecia/zdjecie`	nie	Adresy zdjęć (https), do 30, pierwsze jest okładką. Kopiujemy je na nasz serwer.
`cechy/cecha`	nie	Udogodnienia, np. balkon, winda, garaż, ogródek.

Wysyłka na adres odbioru

Adres ma postać https://nagent.pl/api/oferty/odbior/TOKEN. Token to hasło kanału agenta, nie publikuj go.
Metoda POST lub PUT. Treść: sam plik (XML, CSV, JSON albo paczka ZIP z plikiem XML i zdjęciami, taka jak na portale) albo formularz multipart/form-data z jednym plikiem. Do 40 MB.
Odpowiedź JSON: { ok, total, added, updated, removed, skipped }. Kod 422 oznacza plik bez ofert, 404 nieznany token, 429 kolejną wysyłkę tego samego dnia z konta w planie Start (przyjmujemy raz na dobę; nagłówek Retry-After mówi, za ile sekund wysłać znowu).
Najwyżej 30 wysyłek na godzinę na jeden kanał. Wystarczy wysłać plik po zmianie ofert.

Inne formaty, które rozpoznajemy

Paczki eksportu na portale: Otodom Import (<otoDom>), Gratka (<dane><record>), oferty.net / domy.pl (<plik><lista_ofert>), zaadresowani.pl, a także EstiCRM XML. Zdjęcia mogą być w paczce ZIP (po nazwie pliku) albo jako adresy www.
JSON z API CRM (lista ofert z polami ceny, powierzchni i lokalizacji).
Trovit / Mitula XML (<trovit><ad>).
Kyero XML w wersji 3 (<root><property>).
Katalog Facebook home listings (<listings><listing>).
CSV z nagłówkami kolumn (średnik, przecinek lub tabulator) i arkusze Excel .xlsx.
Inny XML z ofertami: rozpoznajemy typowe nazwy pól (cena, powierzchnia, pokoje, miasto i inne). Jeśli coś nie przechodzi, napisz do nas, dopiszemy obsługę Twojego formatu.