Konfiguracja portali: ustawienia dla każdej platformy

Proszę skonfigurować każdy portal tylko raz i gotowe. Dla 14 portali wystarczy włączyć przełącznik i skopiować URL. Idealista i Fotocasa wymagają danych logowania. W tym artykule opisano wszystkie 16 portali oraz Feed Manager.

Kliknij, aby powiększyć

Siatka kart portali.

Wymagana rola administratora

Konfiguracja portali znajduje się w sekcji Settings. Wymagany dostęp administratora i aktywna subskrypcja Tesoro CRM.

Kiedy należy z tego skorzystać?

• Pierwsza konfiguracja biura w Tesoro
• Dodanie nowego portalu do kanałów publikacji
• Wprowadzenie kodu klienta Idealista w celu bezpośredniego przesyłania ofert

Przegląd wszystkich 16 portali

Portal	Rodzaj połączenia	Rynek	Dodatkowa konfiguracja	Szczególne wymagania
Kyero	Feed XML	ES, PT, FR	Prime Property Count	Wymaganie językowe
ThinkSpain	Feed XML	ES		Wymaganie językowe
Idealista	Bezpośrednie API	ES, PT, IT	Kod klienta	Wymagana domena + identyfikator kontaktowy
Fotocasa	Bezpośrednie API	ES	Klucz API, e-mail, telefon	Dane kontaktowe dla leadów
A Place in the Sun	Feed XML	Międzynarodowy (UK)		Tylko angielski/francuski; cena 5 000, 15 000 000
Luxury Estate	Feed XML	Międzynarodowy (segment luksusowy)		Waluty: USD, EUR, CNY, MXN, RUB
Green Acres	Feed XML	ES, PT, FR		Wymaganie językowe
Indomio	Feed XML	ES, PT, FR		Format kompatybilny z Kyero
Spain Property Portal	Feed XML	ES, PT, FR		Format kompatybilny z Kyero
Resales Online	Feed XML	ES, PT, FR		Format kompatybilny z Kyero
ImmoVario	Feed XML	ES, PT, FR		Format kompatybilny z Kyero
Mimove	Feed XML	ES, PT, FR		Format kompatybilny z Kyero
Spain Houses	Feed XML	ES, PT, FR		Format kompatybilny z Kyero
James Edition	Feed XML	Międzynarodowy (segment luksusowy)		Minimalna cena €490.000
National Listing Service (NLS)	Feed XML	ES (Costa del Sol)		Format kompatybilny z Kyero
Own Company	Feed XML	Uniwersalny		Wyświetla nazwę Państwa firmy jako etykietę

---

Część 1: Portal Connections

Nawigacja

Settings → Feed Export w panelu bocznym → siatka kart portali. Na każdej karcie:

• Logo portalu (lub nazwa Państwa firmy dla Own Company)
• Przełącznik włącz/wyłącz
• Przycisk Copy do kopiowania URL feeda (dla portali z feedem danych, po aktywacji)
• Przycisk Edit dla portali z dodatkowymi ustawieniami
• Plakietka API przy Idealista i Fotocasa

Ogólna procedura dla każdego portalu

1. Proszę przejść do Settings → Feed Export.
2. Proszę znaleźć portal.
3. Proszę włączyć przełącznik. Dla portali feedowych generowany jest URL.
4. Proszę kliknąć copy, aby skopiować URL → podać menedżerowi konta portalu, jeśli jest wymagany.
5. Proszę powtórzyć dla innych portali.

Jedno połączenie na portal

Próba dodania drugiego połączenia Kyero? Komunikat błędu: “This MLS key has already been taken.”

---

Instrukcje i wymagania dla poszczególnych portali

Kyero

Feed XML, ES/PT/FR, Prime Property Count.

1. Proszę najpierw sprawdzić język. Brak zgodności z listą języków? Przełącznik Kyero wyłączony + ostrzeżenie.
2. Proszę włączyć przełącznik.
3. Proszę skopiować URL feeda → podać menedżerowi konta Kyero.
4. Proszę ustawić Prime Property Count: kliknąć ikonę edycji → menu rozwijane Set Property Count (1, 25) → Update.

Wymagania dla nieruchomości: Numer referencyjny (maks. 255), cena (maks. 8 cyfr), waluta (EUR/GBP/USD), typ transakcji, typ nieruchomości, miasto, prowincja, kraj (ES/PT/FR), liczba sypialni i łazienek, opis w obsługiwanym języku, co najmniej 1 zdjęcie, adres e-mail firmy, domena strony internetowej.

Obsługiwane języki: ca, da, de, en, es, fi, fr, it, nl, no, pt, ru, sv.

Idealista

Bezpośrednie API, ES/PT/IT, kod klienta.

1. Proszę uzyskać kod klienta i identyfikator kontaktowy od Idealista.
2. Proszę skonfigurować domenę strony internetowej w Settings → Website.
3. Proszę kliknąć ikonę edycji na karcie Idealista.
4. Proszę wprowadzić Idealista Customer Code → Update.
5. Proszę włączyć przełącznik. Bez kodu klienta: “Please add idealista customer code.”

Synchronizacja: Automatyczne wysyłanie przy każdym zapisie oferty. Zmiany w przypisanych ofertach są natychmiast przesyłane, szczegóły, zdjęcia, filmy, opisy.

Wymagania: Kod klienta + identyfikator kontaktowy (na poziomie firmy), typ nieruchomości odpowiadający Idealista, typ transakcji, cena (1, 999.999.999), pełny adres, numer referencyjny (maks. 50), opis (maks. 4.000) w obsługiwanym języku, co najmniej 1 zdjęcie z prawidłowym URL, domena strony internetowej.

Rejestracja błędów

Jeśli wysyłanie do Idealista nie powiedzie się, Tesoro rejestruje błąd na rekordzie oferty i automatycznie usuwa przypisanie MLS, zapobiega to sytuacji, w której oferta wydaje się „opublikowana“, a tak nie jest.

Fotocasa

Bezpośrednie API, ES, klucz API + e-mail + telefon.

1. Proszę uzyskać klucz API od Fotocasa.
2. Proszę kliknąć ikonę edycji.
3. Proszę wypełnić:
   • API Key (wymagane)
   • Email (wymagane, prawidłowy)
   • Phone Number (wymagane, format międzynarodowy)
4. Update.
5. Proszę włączyć przełącznik.

Synchronizacja: Automatyczne wysyłanie przy zapisie. Rejestracja błędów taka sama jak w Idealista.

Wymagania: Typ nieruchomości odpowiadający Fotocasa, podtyp (automatycznie wyprowadzany), numer referencyjny, pełny adres, typ transakcji + cena, cechy nieruchomości, dane kontaktowe typu właściciel/agent.

Lead-y z Fotocasa

E-mail i telefon, które Państwo tutaj wprowadzą, są używane przez Fotocasa, gdy kupujący proszą o informacje. Proszę regularnie monitorować.

ThinkSpain

Feed XML, ES.

Przełącznik włącz → skopiować URL feeda → podać do ThinkSpain.

Wymagania: Nazwa firmy, numer referencyjny, cena w EUR, typ transakcji, typ nieruchomości, prowincja, co najmniej 1 zdjęcie, domena strony internetowej. Wymaganie językowe: taka sama lista jak w Kyero.

A Place in the Sun

Feed XML, skierowany na rynek UK.

Przełącznik włącz → skopiować URL.

Wymagania: Kraj, region/prowincja, cena 5 000 do 15 000 000, waluta EUR/GBP/USD, opis tylko en/fr, co najmniej 1 zdjęcie.

Luxury Estate

Feed XML, segment luksusowy.

Przełącznik włącz → skopiować URL.

Wymagania: Numer referencyjny, typ nieruchomości Luxury Estate (Villa, Apartment, Castle, Mansion, …), cena + typ transakcji, waluta USD/EUR/CNY/MXN/RUB (bez GBP), pełny adres, opis, co najmniej 1 zdjęcie, domena strony internetowej.

Green Acres + Indomio + Spain PP + Resales + ImmoVario + Mimove + Spain Houses + NLS + Own Company

Wszystkie w formacie kompatybilnym z Kyero, ES/PT/FR, EUR/GBP/USD.

Przełącznik włącz → skopiować URL → podać do portalu.

Wymagania takie same jak dla Kyero. Języki: ca, da, de, en, es, fi, fr, it, nl, no, pt, ru, sv.

Own Company = ogólny feed z nazwą Państwa firmy jako etykietą. Dla Państwa strony internetowej, integracji partnerskiej lub użytku wewnętrznego.

---

Szybka referencja: typy połączeń

XML-feed (12)

Portal odczytuje Państwa URL feeda okresowo. Państwo kopiują i podają do portalu.

Synchronizacja: oferta pojawia się w feedzie, jeśli status = Active, Display on Website włączone, portal przypisany. Zmiany w ofertach są widoczne przy następnym odczycie.

Directe API (2)

Automatyczne wysyłanie do Idealista lub Fotocasa przy każdym zapisie.

Portal	Wymagane dane
Idealista	Kod klienta + identyfikator kontaktowy
Fotocasa	Klucz API + e-mail + telefon

---

Wspólne wymagania

1. Status Active
2. Display on Website włączony
3. Portal przypisany do tej oferty
4. Domena strony internetowej skonfigurowana
5. Podstawowe dane kompletne: numer referencyjny, cena, typ nieruchomości, adres, liczba sypialni/łazienek, opis, co najmniej 1 zdjęcie

---

Część 2: Feed Manager

Settings → Feed Manager. Tabela z istniejącymi feedami (Feed Name, Properties, Agencies, Last Update, Status).

Tworzenie feeda

1. Przycisk Add feed w prawym górnym rogu.
2. Otwiera się panel boczny. Proszę wypełnić:
   • Name (3–100 znaków, unikalny)
   • Description (opcjonalnie, maks. 8 000 znaków)
   • Status: Active / Offline
3. Property Filters: rozwijane panele według kryterium:
   • Relation, Location, Property type, Bedrooms, Bathrooms, Price range, Tags
   • System automatycznie zapisuje jako filtr dynamiczny
4. Relations: proszę dodać biura partnerskie. Każde otrzymuje unikalny prywatny URL z tokenem.
5. Save.

Display on Feed musi być włączony

Aby pojawić się w feedzie Feed Managera: oferta musi mieć włączone zarówno Display on Website, jak i Display on Feed + odpowiedni status. Display on Feed jest domyślnie wyłączony, należy go jawnie włączyć.

Kwalifikujące się statusy dla Feed Managera: Pending Approval, Active, Sold, Rented, Under Offer, Off Market, Negotiating, Under Contract, Open House, Key Ready, Under Construction, Removed by Feed.

Feed URL z tokenem

https://[uw-server]/feedmanager/feedmanager/fetch-feed/[feed-id]?token=[uniek-token]

Token unikalny dla każdego biura partnerskiego:

• Można udostępnić wielu biurom, każde ma własny URL
• Śledzenie: liczba zapytań + ostatnie sprawdzenie na biuro
• Usunięcie biura → ich URL przestaje działać natychmiast

Dane feeda są walidowane względem formatu Kyero przed dostarczeniem.

Edytowanie lub usuwanie

• Edit: menu z trzema kropkami → Edit → zmiana → Save
• Delete: menu z trzema kropkami → Delete → potwierdź (URL przestają działać natychmiast)

---

Często popełniane błędy

Oferta nie pojawia się w feedzie

1. Active + Display on Website włączony?
2. Portal przypisany?
3. Wszystkie wymagane pola wypełnione?
4. Domena strony internetowej skonfigurowana?
5. Wymaganie językowe portalu spełnione?
6. Idealista/Fotocasa: dane logowania poprawne?

Feed Feed Managera pokazuje 0 ofert

1. Kryteria filtra pasują do ofert?
2. Display on Website i Display on Feed włączone?
3. Status na liście kwalifikujących się?
4. Walidacja Kyero zakończona sukcesem?

---

Następny krok

Publikowanie ofert na portalePrzypisywanie portali do ofert + Kyero Prime + walidacja.