Spis treści
W skrócie
Feed XML to plik z listą ofert biura zapisany w formacie, który portal potrafi odczytać maszynowo. CRM generuje go z bazy ofert i udostępnia pod stałym adresem albo wysyła na serwer portalu. Portal pobiera plik cyklicznie, porównuje z tym, co ma w indeksie, i dodaje, aktualizuje lub zdejmuje ogłoszenia. Agent nie przepisuje niczego ręcznie.
Kiedy agent dodaje ofertę w CRM-ie i po kwadransie widzi ją na portalu, po drodze zadziałał mechanizm, o którym rzadko się mówi: feed XML. To on decyduje, czy zmiana ceny dotrze do portalu dziś, czy dopiero po telefonie do supportu. Ten tekst wyjaśnia, czym ten plik jest, jak portale go czytają i dlaczego jeden błąd w polu potrafi wyrzucić ofertę z wyników wyszukiwania.
Plik, który czyta maszyna, nie człowiek
XML to format tekstowy opisany przez konsorcjum W3C: dane zamknięte w znacznikach, które nazywają każde pole. W ofercie nieruchomości wygląda to tak, że cena, metraż, liczba pokoi, adres i lista zdjęć mają osobne znaczniki, a cała oferta jest jednym blokiem w większej liście. Portal nie czyta opisu, tylko szuka konkretnych znaczników i sprawdza, czy wartości mieszczą się w jego słowniku.
Z punktu widzenia biura feed to po prostu aktualny wyciąg z bazy ofert w formacie, którego oczekuje dany portal. CRM buduje go z tych samych danych, które agent wpisał raz przy dodawaniu oferty.
Jak portal pobiera feed
Są dwa modele, czasem oba w jednym portalu:
- Portal sam pobiera plik spod stałego adresu, który podało biuro. Robi to według własnego harmonogramu, zwykle kilka razy na dobę.
- CRM wysyła plik na serwer portalu (najczęściej przez FTP) po każdej zmianie albo w ustalonych odstępach, a portal przetwarza to, co dostał.
Po pobraniu portal porównuje listę z tym, co ma w indeksie. Oferta, której nie było, zostaje dodana. Oferta z innymi danymi jest aktualizowana. Oferta, której w feedzie już nie ma, jest zdejmowana. To ostatnie jest ważne: wycofanie oferty w CRM-ie skutkuje zniknięciem ogłoszenia bez logowania do panelu portalu.
Dlaczego jeden błąd potrafi zepsuć więcej niż jedną ofertę
Portale walidują pliki różnie. Część sprawdza każdą ofertę osobno i odrzuca tylko tę, w której brakuje wymaganego pola albo wartość jest spoza słownika. Część traktuje cały plik jako jedną paczkę: jeśli struktura jest naruszona, na przykład przez niezamknięty znacznik, nie aktualizuje niczego i zostawia stare dane.
W praktyce najczęstsze przyczyny odrzuceń to:
| Przyczyna | Skutek na portalu | Jak zapobiegać w CRM-ie |
|---|---|---|
| Brak wymaganego pola (np. powierzchnia) | oferta pominięta | walidacja formularza przed publikacją |
| Wartość spoza słownika (np. własny typ budynku) | oferta pominięta albo pole puste | mapowanie słowników per portal |
| Zdjęcie pod adresem, który nie odpowiada | oferta bez zdjęć albo odrzucona | stałe adresy zdjęć z własnego magazynu |
| Uszkodzona struktura pliku | cały plik odrzucony | generowanie z kodu, nigdy ręczna edycja |
Stąd prosta zasada: sprawdzanie pól powinno odbywać się w CRM-ie, zanim plik powstanie. Portal zgłasza błąd dopiero po fakcie, często bez czytelnego opisu.
Jeden portal, jedna specyfikacja
Nie istnieje wspólny format dla polskich portali. Każdy publikuje własną specyfikację: inne nazwy znaczników, inne słowniki (rynek pierwotny czy wtórny, stan mieszkania, rodzaj ogrzewania), inne limity liczby zdjęć. Dlatego CRM, który obsługuje kilka portali, utrzymuje kilka tłumaczeń tej samej bazy. Agent wpisuje dane raz, a system dobiera nazwy pól i wartości pod każdy portal.
Otodom działa inaczej niż reszta: zamiast pliku udostępnia interfejs programistyczny (API), przez który CRM wysyła i aktualizuje oferty na bieżąco. W Estalo Otodom jest podłączony właśnie przez API, a Morizon, Gratka, Domy.pl i Nieruchomości-online przez pliki XML w formatach tych portali. Do tego dochodzi Portal Estalo, na którym oferta pojawia się bez osobnego eksportu.
Jak sprawdzić feed przed wysyłką
Trzy rzeczy, które warto obejrzeć, zanim oferta pójdzie na portale:
- Czy wszystkie pola wymagane przez dany portal są wypełnione. Dobry CRM pokazuje listę braków przy ofercie, zamiast zostawiać to do odkrycia po odrzuceniu.
- Czy zdjęcia mają stałe adresy i rozsądny rozmiar. Portale pobierają je osobno, pod adresami z feedu.
- Czy status publikacji przy ofercie zmienia się po eksporcie. Jeśli CRM nie pokazuje statusu per portal, agent dowiaduje się o problemie od klienta.
Co z tego wynika dla biura
Feed XML jest niewidoczny, dopóki działa. Warto jednak wiedzieć, że stoi za nim kilka decyzji CRM-a: skąd biorą się dane, jak są sprawdzane, jak często trafiają do portalu i czy agent widzi wynik. Jeśli któraś z tych rzeczy wymaga ręcznej pracy, koszt pojawia się przy każdej zmianie ceny.
Więcej o samym procesie publikacji z jednego formularza jest w tekście o eksporcie ofert do kilku portali naraz, a lista portali obsługiwanych przez Estalo na stronie funkcji.
Najczęstsze pytania
Jak często portal pobiera feed XML?
Każdy portal ma własny harmonogram; typowo jest to od kilku razy dziennie do raz na dobę, a przy integracji przez wysyłkę na serwer portalu zmiana trafia do kolejki od razu po zapisie. Dokładny cykl podaje dokumentacja techniczna danego portalu, nie CRM.
Co się dzieje, gdy jedno pole w feedzie jest błędne?
Zależy od walidacji portalu: część portali odrzuca tylko jedną ofertę z błędnym polem, część uznaje cały plik za niepoprawny i nie aktualizuje niczego. Dlatego CRM powinien sprawdzać pola przed wygenerowaniem pliku, a nie dopiero po odrzuceniu.
Czy każdy portal wymaga innego formatu feedu?
W praktyce tak. Portale publikują własne specyfikacje: inne nazwy pól, inne słowniki wartości (rynek pierwotny, typ budynku, stan), inne wymagania dla zdjęć. Jedna baza ofert w CRM-ie jest tłumaczona na kilka formatów, po jednym na portal.
Czy feed XML aktualizuje się automatycznie po zmianie oferty?
Tak, jeśli CRM generuje plik z bieżącej bazy. Po zmianie ceny albo zdjęć kolejne pobranie przez portal dostaje już nową wersję. Ręczne generowanie i wgrywanie pliku to relikt, który wprowadza opóźnienia i pomyłki.
Źródła
Wojciech Płonka
Design & Product, Estalo
Zobacz też
Masz podobne biuro?
Estalo prowadzi klientów, oferty i eksport do portali z jednego miejsca. 14 dni pełnego dostępu bez karty.

