Łączenie portali: ustawienia dla każdej platformy

Proszę skonfigurować każdy portal tylko raz i gotowe, dla 13 portali wystarczy włączyć przełącznik i skopiować URL. Idealista i Fotocasa wymagają danych logowania. W tym artykule opisano wszystkie 15 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 15 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
Idomia	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, okno informacyjne przy wyborze
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 wpiszą, są używane przez Fotocasa, gdy kupujący proszą o informacje. Proszę monitorować regularnie.

ThinkSpain

Feed XML, ES.

Proszę włączyć przełącznik → skopiować URL feeda → podać menedżerowi konta 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: ta sama lista co dla Kyero.

A Place in the Sun

Feed XML, skierowany na UK.

Proszę włączyć przełącznik → skopiować URL.

Wymagania: Kraj, region/prowincja, cena 5.000, 15.000.000, waluta EUR/GBP/USD, opis tylko en/fr, co najmniej 1 zdjęcie.

Luxury Estate

Feed XML, segment luksusowy.

Proszę włączyć przełącznik → 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 + Idomia + Spain PP + Resales + ImmoVario + Mimove + Spain Houses + Own Company

Wszystkie format kompatybilny z Kyero, ES/PT/FR, EUR/GBP/USD.

Proszę włączyć przełącznik → skopiować URL → podać menedżerowi konta portalu.

Wymagania identyczne 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.

---

Szybki przegląd: typy połączeń

Feed XML (12)

Portal odczytuje Państwa URL feeda okresowo. Kopiują Państwo i podają portalowi.

Synchronizacja: Oferta pojawia się w feedzie, gdy status = Active, Display on Website włączone, portal przypisany. Zmiany w ofertach widoczne przy następnym odczycie.

Bezpośrednie 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łączone
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. Add feed przycisk w prawym górnym rogu.
2. Otwiera się panel boczny. Proszę wypełnić:
   • Name (3, 100 znaków, unikalne)
   • Description (opcjonalne, 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 zapisuje automatycznie 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łączone

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

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://[państwa-serwer]/feedmanager/feedmanager/fetch-feed/[feed-id]?token=[unikalny-token]

Dla każdego biura partnerskiego unikalny token:

• Proszę udostępnić wielu biurom, każde ma własny URL
• Śledzenie: liczba żądań + ostatnie sprawdzenie dla każdego biura
• Usunięcie biura → ich URL natychmiast przestaje działać

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

Edycja lub usuwanie

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

---

Często popełniane błędy

Oferta nie pojawia się w feedzie

1. Czy status Active i Display on Website włączone?
2. Czy portal przypisany?
3. Czy wszystkie wymagane pola wypełnione?
4. Czy domena strony internetowej skonfigurowana?
5. Czy spełnione wymaganie językowe portalu?
6. Czy dla Idealista/Fotocasa dane logowania prawidłowe?

Feed Feed Managera wyświetla 0 ofert

1. Czy kryteria filtrów pasują do ofert?
2. Czy Display on Website i Display on Feed włączone?
3. Czy status znajduje się na liście kwalifikujących się?
4. Czy walidacja Kyero przebiegła pomyślnie?

---

Następny krok

Publikowanie ofert na portale Przypisywanie portali do oferty + Kyero Prime + walidacja.