XML Feed Export

De pagina Feed Export in Tesoro CRM is het centrale beheerpunt voor al uw portaalverbindingen. Hier schakelt u vastgoedportalen in of uit, configureert u portaalspecifieke instellingen en kopieert u de feed-URL’s die portalen gebruiken om uw woningaanbod op te halen.

U vindt Feed Export onder Settings > Feed Export.

Wat is een XML Feed Export?

Een XML Feed Export is een geautomatiseerd proces waarbij Tesoro CRM uw woninggegevens omzet naar een gestructureerd XML-bestand. Externe vastgoedportalen lezen dit bestand via een URL om uw aanbiedingen op hun website te tonen.

Het proces werkt als volgt:

U schakelt een portaal in bij Feed Export.
Tesoro genereert automatisch een unieke feed-URL voor dat portaal.
U verstrekt deze URL aan het portaal (bij uw accountregistratie aldaar).
Het portaal leest de URL op regelmatige intervallen en synchroniseert uw aanbiedingen.

Elke keer dat het portaal de feed-URL opvraagt, ontvangt het de meest actuele gegevens van alle woningen die aan dat portaal zijn toegewezen.

Ondersteunde portalen

Tesoro CRM ondersteunt 14 portaalintegraties. Elk portaal kan individueel worden in- of uitgeschakeld.

Portaal	Verbindingstype	Extra configuratie vereist
Kyero	Datafeed (URL)	Ja — Prime Property Count
Idealista	Directe verbinding (API)	Ja — Klantcode
Fotocasa	Directe verbinding (API)	Ja — API-sleutel, e-mail, telefoonnummer
ThinkSpain	Datafeed (URL)	Nee
A Place in the Sun	Datafeed (URL)	Nee
Luxury Estate	Datafeed (URL)	Nee
Green Acres	Datafeed (URL)	Nee
Idomia	Datafeed (URL)	Nee
Spain Property Portal	Datafeed (URL)	Nee
Resales Online	Datafeed (URL)	Nee
ImmoVario	Datafeed (URL)	Nee
Mimove	Datafeed (URL)	Nee
Spain Houses	Datafeed (URL)	Nee
Your Own Company	Datafeed (URL)	Nee

Het portaal Your Own Company is een bijzonder geval: het genereert een datafeed met uw eigen bedrijfsnaam en logo. Dit is nuttig om aanbiedingen naar uw eigen website of een aangepaste integratie te voeden.

De Feed Export-pagina

Indeling

De pagina toont een raster van portaalkaarten, een voor elk ondersteund portaal. Elke kaart bevat:

Het portaallogo (of uw bedrijfsnaam/logo voor Your Own Company)
Een schakelaar om het portaal te activeren of deactiveren
Een copy-knop om de feed-URL te kopieren (alleen zichtbaar bij actieve datafeed-portalen)
Een edit-knop voor portalen met extra instellingen (Kyero, Idealista, Fotocasa)
Een API-badge bij portalen met een directe verbinding (Idealista, Fotocasa)

Een portaal inschakelen

Ga naar Feed Export
Section titled “Ga naar Feed Export”

Navigeer naar Settings > Feed Export vanuit de hoofdzijbalk.
Zoek het portaal
Section titled “Zoek het portaal”

Blader door het raster van portaalkaarten totdat u het gewenste portaal vindt.
Activeer de schakelaar
Section titled “Activeer de schakelaar”

Zet de schakelaar op het portaal op AAN. Het portaal is nu actief.
- Bij datafeed-portalen wordt automatisch een feed-URL gegenereerd. Klik op de copy-knop op de kaart om de URL te kopieren.
- Bij Idealista of Fotocasa moet u eerst de portaalspecifieke instellingen invullen (zie hieronder).
Verstrek de feed-URL aan het portaal
Section titled “Verstrek de feed-URL aan het portaal”

Voor datafeed-portalen kopieert u de gegenereerde URL en verstrekt u deze aan het portaal bij uw accountregistratie. Het portaal gebruikt deze URL om uw aanbiedingen periodiek op te halen.

Portaalspecifieke configuratie

Drie portalen vereisen aanvullende instellingen voordat ze volledig functioneren.

Kyero heeft een extra instelling: de Prime Property Count. Hiermee bepaalt u hoeveel woningen tegelijk als “Prime” (uitgelicht) op Kyero kunnen worden gemarkeerd.

Klik op het bewerkpictogram op de Kyero-portaalkaart.
Er opent een zijpaneel met de dropdown Set Property Count.
Selecteer een getal tussen 1 en 25.
Klik op Update om op te slaan.

Overige portalen

De overige 11 portalen (ThinkSpain, A Place in the Sun, Luxury Estate, Green Acres, Idomia, Spain Property Portal, Resales Online, ImmoVario, Mimove, Spain Houses en Your Own Company) vereisen geen extra configuratie. Schakel ze in en kopieer de feed-URL.

Hoe de XML-feed werkt

Datafeed-portalen

Wanneer een portaal is ingeschakeld, genereert Tesoro een unieke feed-URL. Deze URL levert een XML-bestand met alle woningen die aan het portaal zijn toegewezen en aan de volgende voorwaarden voldoen:

De woningstatus is Active (voor de meeste portalen ook Reserved, Sold of Under Offer)
Display on Website is ingeschakeld op de woning
Het portaal is toegewezen aan de woning via de MLS-lijst

Het portaal leest de feed-URL volgens zijn eigen schema (doorgaans elke paar uur). Wijzigingen aan woningen worden automatisch weergegeven bij de volgende keer dat het portaal de feed ophaalt.

Directe verbinding-portalen (Idealista en Fotocasa)

Bij Idealista en Fotocasa werkt het anders: Tesoro detecteert welke velden zijn gewijzigd wanneer u een woning opslaat en pusht alleen de relevante updates automatisch naar het portaal. Wijzigingen verschijnen doorgaans binnen minuten op het portaal.

Veldmapping per portaal

Elke portaalfeed bevat een gestandaardiseerde set woninggegevens. De XML-feed wordt per portaal opgebouwd op basis van de vereisten van dat portaal. Hieronder vindt u een overzicht van de belangrijkste velden die in de feed worden opgenomen.

Standaardvelden (alle portalen)

Veld in Tesoro	Beschrijving
Referentienummer	Unieke identificatie van de woning
Prijs	Vraagprijs van de woning
Transactietype	Koop of huur
Woningtype	Appartement, villa, finca, etc.
Stad (Town)	Gemeente of stad
Provincie (State)	Regio of provincie
Slaapkamers	Aantal slaapkamers
Badkamers	Aantal badkamers
Bebouwde oppervlakte	Woonoppervlakte in vierkante meter
Perceelgrootte	Kavelgrootte in vierkante meter
Beschrijvingen	Woningbeschrijvingen in een of meer talen
Foto’s	Alle afbeeldingen die aan de woning zijn gekoppeld
Video-URL	Optionele videolink
Virtuele rondleiding-URL	Optionele link naar virtuele rondleiding
Energielabel	Energieprestatiecertificaat (A t/m G, X of In Process)
Kenmerken	Voorzieningen en faciliteiten
Locatiecoordinaten	Breedtegraad en lengtegraad

Portaalspecifieke velden

Portaal	Aanvullende velden
Kyero	Prime-markering, woning-URL (op basis van websitedomein), land (Spanje, Portugal of Frankrijk)
Idealista	Klantcode, gedetailleerde veldmapping voor Idealista-categorisering
Fotocasa	API-sleutel, contact-e-mail, telefoonnummer
Your Own Company	Bedrijfsnaam en bedrijfslogo

Validatie van woninggegevens

Voordat een woning in de XML-feed wordt opgenomen, voert Tesoro een validatiecontrole uit. Woningen die niet aan de vereisten voldoen, worden automatisch uitgesloten. De validatie vindt plaats op het moment dat u een portaal toewijst aan een woning.

Algemene validatievereisten

Veld	Vereiste
Referentienummer	Verplicht, maximaal 255 tekens
Prijs	Verplicht, maximaal 8 cijfers
Transactietype	Verplicht (koop of huur)
Woningtype	Verplicht
Stad	Verplicht
Provincie	Verplicht
Slaapkamers	Verplicht, geheel getal
Badkamers	Verplicht, geheel getal
Beschrijving	Verplicht, in minstens een taal die het portaal ondersteunt
Foto’s	Minimaal 1 afbeelding
Bedrijfs-e-mail	Verplicht in Company Settings

Kyero-specifieke validatie

Kyero hanteert aanvullende regels:

Land moet Spanje, Portugal of Frankrijk zijn
Beschrijvingstaal moet overeenkomen met een van de 13 ondersteunde talen en tevens als websitetaal zijn geconfigureerd
Woning-URL wordt gegenereerd op basis van uw websitedomein en mag niet langer zijn dan 255 tekens
Kenmerknamen mogen maximaal 35 tekens bevatten
Video-URL en Virtuele Rondleiding-URL mogen elk maximaal 255 tekens bevatten
Energielabelwaarden moeten A, B, C, D, E, F, G, X of In Process zijn
Bebouwde oppervlakte en Perceelgrootte moeten numerieke waarden zijn
Bedrijfsvaluta moet EUR, GBP of USD zijn

Formaat van validatiefouten

Wanneer validatie mislukt, volgt de foutmelding dit patroon:

“[Portaalnaam] validation failed for property [Referentie]: [lijst van problemen]”

Elk probleem wordt in duidelijke taal beschreven, bijvoorbeeld:

“Price is required”
“Town is required”
“Description language is invalid for kyero”
“Minimum 1 image is required for Kyero”

Feeds monitoren

Feed-URL controleren

Na het inschakelen van een datafeed-portaal kunt u de feed-URL kopieren via de copy-knop op de portaalkaart. Open de URL in uw browser om de ruwe XML-output te bekijken. Dit is nuttig om te verifiereren dat:

De feed correct wordt gegenereerd
De verwachte woningen in de feed staan
De woninggegevens volledig zijn

Synchronisatiestatus

Voor datafeed-portalen geldt dat het portaal zelf bepaalt hoe vaak de feed wordt opgehaald. Dit is doorgaans elke paar uur, maar varieert per portaal. Tesoro heeft hier geen directe invloed op.

Voor Idealista en Fotocasa worden updates direct gepusht bij het opslaan van woningwijzigingen. Als u vermoedt dat een update niet is doorgekomen, controleer dan of u de woning daadwerkelijk heeft opgeslagen na het aanbrengen van wijzigingen.

Probleemoplossing

Woning verschijnt niet in de feed

Controleer de volgende punten in volgorde:

Is het portaal ingeschakeld in Settings > Feed Export?
Is het portaal toegewezen aan de specifieke woning (controleer de kaart “Posted To” op het woningrecord)?
Is de woningstatus Active, Reserved, Sold of Under Offer?
Is Display on Website ingeschakeld op de woning?
Doorstaat de woning de validatie voor dat portaal? Verwijder het portaal en voeg het opnieuw toe om eventuele validatiefouten te zien.
Voor datafeed-portalen: wacht op de volgende verversingscyclus van het portaal.

Idealista of Fotocasa worden niet bijgewerkt

Controleer of het portaal actief is in Settings en of de inloggegevens correct zijn opgeslagen.
Verifieer dat de woning aan het portaal is toegewezen.
Zorg ervoor dat u de woning heeft opgeslagen na het aanbrengen van wijzigingen — de push vindt alleen plaats bij opslaan.
Controleer of de gewijzigde velden relevant zijn voor het portaal. Niet elke veldwijziging activeert een push.

Kyero of ThinkSpain kan niet worden ingeschakeld

Deze portalen vereisen minstens een websitetaal uit de volgende lijst: Catalaans (ca), Deens (da), Duits (de), Engels (en), Spaans (es), Fins (fi), Frans (fr), Italiaans (it), Nederlands (nl), Noors (no), Portugees (pt), Russisch (ru) of Zweeds (sv).

Ga naar Settings > Website > Language en voeg een ondersteunde taal toe.

Feed-URL levert een leeg resultaat

Als de feed-URL geen woningen bevat, controleer dan:

Of er woningen aan het portaal zijn toegewezen.
Of die woningen de status Active hebben en Display on Website ingeschakeld.
Of de woningen de validatie voor dat portaal doorstaan.

Vereisten voordat u begint

Voordat u portalen kunt inschakelen en feeds kunt genereren, moet u het volgende geregeld hebben:

Actieve woningen. Alleen woningen met de status Active, Reserved, Sold of Under Offer kunnen naar portalen worden gepubliceerd. De woning moet ook Display on Website ingeschakeld hebben.
Volledige woninggegevens. Elk portaal heeft eigen vereisten, maar de meeste portalen vereisen minimaal: referentienummer, prijs, woningtype, stad, provincie, slaapkamers, badkamers, minstens een foto en een beschrijving in een ondersteunde taal.
Bedrijfsinstellingen. Uw bedrijf moet een geldig e-mailadres en valuta geconfigureerd hebben. Sommige portalen (zoals Kyero) vereisen ook een websitedomein in de Website-instellingen, en minstens een websitetaal die overeenkomt met de ondersteunde talen van het portaal.
Portaalspecifieke inloggegevens. Idealista vereist een klantcode. Fotocasa vereist een API-sleutel, e-mailadres en telefoonnummer. Deze worden ingevoerd in het portaalconfiguratiepaneel op de Feed Export-pagina.

Verschil tussen Feed Export en Feed Manager

Tesoro CRM heeft twee afzonderlijke systemen voor het delen van woninggegevens:

Kenmerk	Feed Export	Feed Manager
Locatie	Settings > Feed Export	Settings > Feed Manager
Doel	Publiceren naar vaste vastgoedportalen	Delen met partnerkantoren en aangepaste systemen
Portalen	14 vooraf gedefinieerde portalen	Onbeperkt, zelf in te stellen
Woningselectie	Per woning toewijzen via “Add MLS”	Via filtercriteria (locatie, type, prijs, etc.)
Configuratie	Schakelaar per portaal	Zelf feeds aanmaken met filters en relaties
Feed-URL	Automatisch per portaal	Automatisch per partnerkantoor met uniek token

Gerelateerde onderwerpen

Overzicht MLS en portalen Begrijp het verschil tussen directe portaalverbindingen en de Feed Manager.

Portalen verbinden en configureren Stapsgewijze instructies voor het inschakelen en configureren van portalen.

Woningen publiceren naar portalen Wijs portalen toe aan individuele woningen en beheer publicatie.

Feed Manager Maak aangepaste XML-feeds aan voor partnerkantoren en externe systemen.