Portalen verbinden: instellingen per platform
Eén keer instellen per portaal en u bent klaar, voor 13 portalen is het een schakelaar omdraaien + URL kopiëren. Idealista en Fotocasa hebben inloggegevens nodig. Dit artikel beschrijft alle 15 + de Feed Manager.
Wanneer gebruikt u dit?
Section titled “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 15
Section titled “Overzicht van alle 15”| Portaal | Type | Markt | Extra config | Bijzonderheden |
|---|---|---|---|---|
| Kyero | XML-feed | ES, PT, FR | Prime Property Count | Taal-eis |
| ThinkSpain | XML-feed | ES | , | Taal-eis |
| Idealista | Directe API | ES, PT, IT | Klantcode | Domein + contact-ID vereist |
| Fotocasa | Directe API | ES | API-sleutel, email, phone | Contactgegevens voor leads |
| A Place in the Sun | XML-feed | Internationaal (UK) | , | Alleen en/fr; prijs 5k, 15M |
| Luxury Estate | XML-feed | Internationaal (luxe) | , | Valuta: USD, EUR, CNY, MXN, RUB |
| Green Acres | XML-feed | ES, PT, FR | , | Taal-eis |
| Idomia | XML-feed | ES, PT, FR | , | Kyero-compatibel |
| Spain Property Portal | XML-feed | ES, PT, FR | , | Kyero-compatibel |
| Resales Online | XML-feed | ES, PT, FR | , | Kyero-compatibel |
| ImmoVario | XML-feed | ES, PT, FR | , | Kyero-compatibel |
| Mimove | XML-feed | ES, PT, FR | , | Kyero-compatibel |
| Spain Houses | XML-feed | ES, PT, FR | , | Kyero-compatibel |
| James Edition | XML-feed | Internationaal (luxe) | , | Minimumprijs €490.000, info-dialoog bij selecteren |
| Own Company | XML-feed | Universeel | , | Uw bedrijfsnaam als label |
Deel 1: Portal Connections
Section titled “Deel 1: Portal Connections”Navigatie
Section titled “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
Section titled “Algemene flow per portaal”- Settings → Feed Export.
- Zoek het portaal.
- Schakelaar AAN. Voor feed-portalen wordt URL gegenereerd.
- Klik copy om URL te kopiëren → verstrek aan portaal-accountmanager indien gevraagd.
- Herhaal voor andere portalen.
Per portaal: config en eisen
Section titled “Per portaal: config en eisen”XML-feed, ES/PT/FR, Prime Property Count.
- Eerst taalcheck. Geen match met taallijst? Kyero-schakelaar uitgeschakeld + waarschuwing.
- Schakelaar AAN.
- Copy feed-URL → verstrek aan Kyero-accountmanager.
- 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.
Directe API, ES/PT/IT, klantcode.
- Vraag klantcode + contact-ID bij Idealista.
- Configureer websitedomein in Settings → Website.
- Klik edit-icoon op Idealista-kaart.
- Voer Idealista Customer Code in → Update.
- 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.
Directe API, ES, API-sleutel + email + phone.
- Vraag API-sleutel bij Fotocasa.
- Klik edit-icoon.
- Vul in:
- API Key (verplicht)
- Email (verplicht, geldig)
- Phone Number (verplicht, internationaal formaat)
- Update.
- 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.
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.
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.
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.
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
Section titled “Snelreferentie: verbindingstypen”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.
Auto-push naar Idealista of Fotocasa bij elke save.
| Portaal | Vereiste gegevens |
|---|---|
| Idealista | Klantcode + contact-ID |
| Fotocasa | API-sleutel + email + phone |
Gemeenschappelijke vereisten
Section titled “Gemeenschappelijke vereisten”- Status Active
- Display on Website aan
- Portaal toegewezen aan deze woning
- Websitedomein geconfigureerd
- Basisgegevens compleet: referentie, prijs, woningtype, adres, slaapkamers/badkamers, beschrijving, ≥1 foto
Deel 2: Feed Manager
Section titled “Deel 2: Feed Manager”Settings → Feed Manager. Tabel met bestaande feeds (Feed Name, Properties, Agencies, Last Update, Status).
Een feed aanmaken
Section titled “Een feed aanmaken”- Add feed-knop rechtsboven.
- Zijpaneel opent. Vul in:
- Name (3, 100 tekens, uniek)
- Description (optioneel, max 8.000 tekens)
- Status: Active / Offline
- Property Filters: uitklapbare panelen per criterium:
- Relation, Location, Property type, Bedrooms, Bathrooms, Price range, Tags
- Systeem slaat auto op als dynamisch filter
- Relations: voeg partnerkantoren toe. Elke krijgt unieke prive URL met token.
- Save.
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
Section titled “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
Section titled “Bewerken of verwijderen”- Edit: drie-punten-menu → Edit → wijzig → Save
- Delete: drie-punten-menu → Delete → bevestig (URL’s stoppen direct)
Veelgemaakte fouten
Section titled “Veelgemaakte fouten”Woning verschijnt niet in feed
Section titled “Woning verschijnt niet in feed”- Active + Display on Website aan?
- Portaal toegewezen?
- Alle verplichte velden ingevuld?
- Websitedomein geconfigureerd?
- Taal-eis voor portaal gerespecteerd?
- Idealista/Fotocasa: inloggegevens correct?
Feed Manager-feed toont 0 woningen
Section titled “Feed Manager-feed toont 0 woningen”- Filtercriteria matchen woningen?
- Display on Website én Display on Feed aan?
- Status in de in-aanmerking-komende lijst?
- Kyero-validatie geslaagd?