Portalen verbinden: instellingen per platform

Eén keer instellen per portaal en u bent klaar, voor 14 portalen is het een schakelaar omdraaien + URL kopiëren. Idealista en Fotocasa hebben inloggegevens nodig. Dit artikel beschrijft alle 16 + de Feed Manager.

Klik om te vergroten

Het raster van portaalkaarten.

Admin-rol vereist

Portaalconfiguratie staat onder Settings. Admin-toegang + actief Tesoro-abonnement nodig.

Wanneer gebruikt u dit?

• Eerste setup van uw kantoor in Tesoro
• Een nieuw portaal toevoegen aan uw publicatiekanalen
• Idealista-klantcode invoeren om direct te kunnen pushen

Overzicht van alle 16

Portaal	Type	Markt	Extra config	Bijzonderheden
Kyero	XML-feed	ES, PT, FR	Prime Property Count	Taal-eis
thinkSPAIN	XML-feed	ES	Geen	Taal-eis
Idealista	Directe API	ES, PT, IT	Klantcode	Domein en contact-ID vereist
Fotocasa	Directe API	ES	API-sleutel, e-mail, telefoon	Contactgegevens voor leads
A Place in the Sun	XML-feed	Internationaal (UK)	Geen	Alleen en/fr; prijs 5k tot 15M
Luxury Estate	XML-feed	Internationaal (luxe)	Geen	Valuta: USD, EUR, CNY, MXN, RUB
Green Acres	XML-feed	ES, PT, FR	Geen	Taal-eis
Indomio	XML-feed	ES, PT, FR	Geen	Kyero-compatibel
Spain Property Portal	XML-feed	ES, PT, FR	Geen	Kyero-compatibel
Resales Online	XML-feed	ES, PT, FR	Geen	Kyero-compatibel
ImmoVario	XML-feed	ES, PT, FR	Geen	Kyero-compatibel
Mimove	XML-feed	ES, PT, FR	Geen	Kyero-compatibel
Spain Houses	XML-feed	ES, PT, FR	Geen	Kyero-compatibel
James Edition	XML-feed	Internationaal (luxe)	Geen	Minimumprijs €490.000
National Listing Service (NLS)	XML-feed	ES (Costa del Sol)	Geen	Kyero-compatibel
Own Company	XML-feed	Universeel	Geen	Uw bedrijfsnaam als label

---

Deel 1: Portal Connections

Navigatie

Settings → Feed Export in zijbalk → raster portaalkaarten. Per kaart:

• Portaallogo (of uw bedrijfsnaam voor Own Company)
• Aan/uit-schakelaar
• Copy-knop voor feed-URL (bij datafeed-portalen, na activatie)
• Edit-knop voor portalen met extra instellingen
• API-badge bij Idealista en Fotocasa

Algemene flow per portaal

1. Settings → Feed Export.
2. Zoek het portaal.
3. Schakelaar AAN. Voor feed-portalen wordt URL gegenereerd.
4. Klik copy om URL te kopiëren → verstrek aan portaal-accountmanager indien gevraagd.
5. Herhaal voor andere portalen.

Eén verbinding per portaal

Probeert u een tweede Kyero-verbinding? Foutmelding “This MLS key has already been taken.”

---

Per portaal: config en eisen

Kyero

XML-feed, ES/PT/FR, Prime Property Count.

1. Eerst taalcheck. Geen match met taallijst? Kyero-schakelaar uitgeschakeld + waarschuwing.
2. Schakelaar AAN.
3. Copy feed-URL → verstrek aan Kyero-accountmanager.
4. Prime Property Count instellen: edit-icoon → Set Property Count dropdown (1, 25) → Update.

Vereisten per woning: Referentie (max 255), prijs (max 8 cijfers), valuta (EUR/GBP/USD), transactietype, woningtype, stad, provincie, land (ES/PT/FR), slaapkamers + badkamers, beschrijving in ondersteunde taal, ≥1 foto, bedrijfs-email, websitedomein.

Talen: ca, da, de, en, es, fi, fr, it, nl, no, pt, ru, sv.

Idealista

Directe API, ES/PT/IT, klantcode.

1. Vraag klantcode + contact-ID bij Idealista.
2. Configureer websitedomein in Settings → Website.
3. Klik edit-icoon op Idealista-kaart.
4. Voer Idealista Customer Code in → Update.
5. Schakelaar AAN. Zonder klantcode: “Please add idealista customer code.”

Synchronisatie: Auto-push bij elke woning-save. Wijzigingen aan toegewezen woningen worden direct doorgezet, details, foto’s, video’s, beschrijvingen.

Vereisten: Klantcode + contact-ID (bedrijfsniveau), Idealista-equivalent woningtype, transactietype, prijs (1, 999.999.999), volledig adres, referentie (max 50), beschrijving (max 4.000) in ondersteunde taal, ≥1 foto met geldige URL, websitedomein.

Foutregistratie

Push naar Idealista mislukt? Tesoro logt fout op woningrecord en verwijdert MLS-toewijzing automatisch, voorkomt dat een woning “gepubliceerd” lijkt terwijl ze het niet is.

Fotocasa

Directe API, ES, API-sleutel + email + phone.

1. Vraag API-sleutel bij Fotocasa.
2. Klik edit-icoon.
3. Vul in:
   • API Key (verplicht)
   • Email (verplicht, geldig)
   • Phone Number (verplicht, internationaal formaat)
4. Update.
5. Schakelaar AAN.

Synchronisatie: Auto-push bij save. Foutregistratie idem aan Idealista.

Vereisten: Woningtype met Fotocasa-equivalent, subtype (auto-afgeleid), referentie, volledig adres, transactietype + prijs, woningkenmerken, contactgegevens type eigenaar/makelaar.

Fotocasa-leads

Email + phone die u hier invult worden door Fotocasa gebruikt wanneer kopers informatie opvragen. Monitor regelmatig.

ThinkSpain

XML-feed, ES.

Schakelaar AAN → feed-URL kopieren → verstrek aan ThinkSpain.

Vereisten: Bedrijfsnaam, referentie, prijs in EUR, transactietype, woningtype, provincie, ≥1 foto, websitedomein. Taal-eis: zelfde lijst als Kyero.

A Place in the Sun

XML-feed, UK-gericht.

Schakelaar AAN → URL kopieren.

Vereisten: Land, regio/provincie, prijs 5.000, 15.000.000, valuta EUR/GBP/USD, beschrijving alleen en/fr, ≥1 foto.

Luxury Estate

XML-feed, luxe.

Schakelaar AAN → URL kopieren.

Vereisten: Referentie, Luxury Estate-woningtype (Villa, Apartment, Castle, Mansion, …), prijs + transactietype, valuta USD/EUR/CNY/MXN/RUB (geen GBP), volledig adres, beschrijving, ≥1 foto, websitedomein.

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

Allemaal Kyero-compatibele formaat, ES/PT/FR, EUR/GBP/USD.

Schakelaar AAN → URL kopieren → verstrek aan portaal.

Vereisten identiek aan Kyero. Talen: ca, da, de, en, es, fi, fr, it, nl, no, pt, ru, sv.

Own Company = generieke feed met uw bedrijfsnaam als label. Voor uw website, partnerintegratie, of intern gebruik.

---

Snelreferentie: verbindingstypen

XML-feed (12)

Portaal leest uw feed-URL periodiek. U kopieert + verstrekt aan portaal.

Synchronisatie: woning verschijnt in feed als status = Active, Display on Website aan, portaal toegewezen. Wijzigingen aan woningen zichtbaar bij volgende uitlees.

Directe API (2)

Auto-push naar Idealista of Fotocasa bij elke save.

Portaal	Vereiste gegevens
Idealista	Klantcode + contact-ID
Fotocasa	API-sleutel + email + phone

---

Gemeenschappelijke vereisten

1. Status Active
2. Display on Website aan
3. Portaal toegewezen aan deze woning
4. Websitedomein geconfigureerd
5. Basisgegevens compleet: referentie, prijs, woningtype, adres, slaapkamers/badkamers, beschrijving, ≥1 foto

---

Deel 2: Feed Manager

Settings → Feed Manager. Tabel met bestaande feeds (Feed Name, Properties, Agencies, Last Update, Status).

Een feed aanmaken

1. Add feed-knop rechtsboven.
2. Zijpaneel opent. Vul in:
   • Name (3, 100 tekens, uniek)
   • Description (optioneel, max 8.000 tekens)
   • Status: Active / Offline
3. Property Filters: uitklapbare panelen per criterium:
   • Relation, Location, Property type, Bedrooms, Bathrooms, Price range, Tags
   • Systeem slaat auto op als dynamisch filter
4. Relations: voeg partnerkantoren toe. Elke krijgt unieke prive URL met token.
5. Save.

Display on Feed moet aan

Om in Feed Manager-feed te verschijnen: woning moet zowel Display on Website als Display on Feed aan hebben + in aanmerking komende status. Display on Feed staat default uit, expliciet aanzetten.

In aanmerking komende statussen voor Feed Manager: Pending Approval, Active, Sold, Rented, Under Offer, Off Market, Negotiating, Under Contract, Open House, Key Ready, Under Construction, Removed by Feed.

Feed-URL met token

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

Per partnerkantoor uniek token:

• Deel met meerdere kantoren, eigen URL per kantoor
• Tracking: aantal aanvragen + laatste raadpleging per kantoor
• Kantoor verwijderen → hun URL werkt direct niet meer

Feed-data wordt gevalideerd tegen Kyero-formaat vóór levering.

Bewerken of verwijderen

• Edit: drie-punten-menu → Edit → wijzig → Save
• Delete: drie-punten-menu → Delete → bevestig (URL’s stoppen direct)

---

Veelgemaakte fouten

Woning verschijnt niet in feed

1. Active + Display on Website aan?
2. Portaal toegewezen?
3. Alle verplichte velden ingevuld?
4. Websitedomein geconfigureerd?
5. Taal-eis voor portaal gerespecteerd?
6. Idealista/Fotocasa: inloggegevens correct?

Feed Manager-feed toont 0 woningen

1. Filtercriteria matchen woningen?
2. Display on Website én Display on Feed aan?
3. Status in de in-aanmerking-komende lijst?
4. Kyero-validatie geslaagd?

---

Volgende stap

Woningen publiceren naar portalenPortalen toewijzen per woning + Kyero Prime + validatie.