XML Import

Met de XML Import-functie kunt u woninggegevens automatisch importeren vanuit externe vastgoedportalen en feeds. In plaats van woningen handmatig aan te maken, configureert u een XML-feed en Tesoro CRM haalt de gegevens periodiek op en synchroniseert ze met uw woningbestand.

Beheer uw XML-feeds via Settings > XML Import.

Alleen voor beheerders

De XML Import-pagina is alleen toegankelijk voor gebruikers met de rol Admin.

---

Wat is XML Import?

XML Import stelt u in staat om woninggegevens te ontvangen van externe bronnen zoals vastgoedportalen en projectontwikkelaars. Deze bronnen leveren hun woningaanbod aan via een XML-feed: een URL die een gestructureerd bestand bevat met alle woninggegevens, inclusief beschrijvingen, prijzen, locaties en foto’s.

Tesoro CRM leest deze feed, vergelijkt de gegevens met uw bestaande woningen (op basis van het referentienummer) en:

• Maakt nieuwe woningen aan als het referentienummer nog niet bestaat.
• Werkt bestaande woningen bij als het referentienummer al bekend is.
• Markeert verwijderde woningen als een woning niet meer in de feed voorkomt.

De import draait automatisch ‘s nachts. U kunt ook op elk moment een handmatige update starten.

---

Ondersteunde providers

Tesoro CRM ondersteunt de volgende XML-feedproviders:

Provider	Waarde	Beschrijving
Kyero	kyero	Internationaal vastgoedportaal gericht op Spanje
Inmobalia	inmobalia	Vastgoedsoftware en -portaal in Spanje
Sooprema	sooprema	Vastgoedbeheersoftware
Think Spain	think_spain	Vastgoedportaal voor Spaans onroerend goed
RedSP V3	red_sp	Real Estate Development - Spain (versie 3)
RedSP V4	red_sp_v4	Real Estate Development - Spain (versie 4)

Provider niet in de lijst?

Heeft uw vastgoedportaal een XML-feed maar staat de provider niet in de lijst? Neem contact op met het Tesoro-team om ondersteuning voor een nieuwe provider aan te vragen.

---

Een XML-feed toevoegen

1. Ga naar Settings > XML Import.

2. Klik op de knop om een nieuwe feed toe te voegen. Het feedformulier opent in een zijpaneel.

3. Vul de feedgegevens in:

   Veld	Verplicht	Beschrijving
   Feed name	Ja	Een herkenbare naam voor deze feed (bijv. “Kyero - Projectontwikkelaar X”).
   Provider	Ja	De XML-provider van de feed. Kies uit de ondersteunde providers (zie bovenstaande tabel).
   URL	Ja	De volledige URL naar het XML-bestand (bijv. https://example.com/feed.xml).
   Off/On	Nee	Schakel de feed in of uit. Alleen actieve feeds worden automatisch ‘s nachts verwerkt.
   Relation	Nee	Koppel de feed aan een relatie (bijv. een projectontwikkelaar of makelaarskantoor). Alleen relaties van het type Company Project Developer of Real Estate Agency worden getoond.
   Default commission	Ja	Het standaard commissiepercentage (%) dat wordt toegepast op geimporteerde woningen.
   Default agent	Nee	De standaard medewerker die wordt toegewezen als eigenaar van geimporteerde woningen.
   Remove property status	Ja	De status die een woning krijgt wanneer deze uit de feed verdwijnt (standaard: Removed by feed).
   Draft/Active	Ja	Bepaalt of nieuw geimporteerde woningen de status Draft of Active krijgen.
   Publish website	Ja	Bepaalt of geimporteerde woningen direct zichtbaar zijn op uw website.

4. Klik op Save om de feed op te slaan.

Controleer de feed-URL

Zorg ervoor dat de XML-feed-URL correct is en toegankelijk is via het internet. Een ongeldige of onbereikbare URL zal ertoe leiden dat de import mislukt.

---

Feedinstellingen bewerken

Klik op een bestaande feed in het overzicht om het zijpaneel te openen. U kunt alle velden aanpassen en vervolgens opslaan via:

• Save and stay — slaat de wijzigingen op en houdt het zijpaneel open.
• Save and exit — slaat de wijzigingen op en sluit het zijpaneel.

---

Woningen uitsluiten met filters

Nadat u een feed heeft opgeslagen en de feedgegevens zijn geanalyseerd, verschijnt er een sectie Exclude from feed. Hiermee kunt u bepaalde woningen uitsluiten van de import op basis van hun kenmerken.

Analyse van feedgegevens

Na het opslaan van een nieuwe feed analyseert Tesoro CRM de XML-feed op de achtergrond. Dit kan even duren bij grote feeds. Tijdens het verwerken ziet u de melding “Extracting property details”. Zodra de analyse klaar is, verschijnen de filteropties automatisch.

Beschikbare filters

Filter	Beschrijving
Location	Sluit woningen uit op basis van hun locatie (stad/dorp). U kunt meerdere locaties selecteren.
Property type	Sluit woningen uit op basis van het woningtype (bijv. villa, appartement). U kunt meerdere typen selecteren.
Province	Sluit woningen uit op basis van de provincie. U kunt meerdere provincies selecteren.
Min price / Max price	Sluit woningen uit die buiten het opgegeven prijsbereik vallen.

De waarden in de dropdownmenu’s (locatie, woningtype, provincie) worden automatisch ingevuld op basis van de gegevens die in de XML-feed zijn aangetroffen.

Hoe werken uitsluitingsfilters?

Woningen die overeenkomen met een geselecteerde filterwaarde worden uitgesloten van de import. Als u bijvoorbeeld de locatie “Marbella” selecteert, worden woningen in Marbella niet geimporteerd.

---

Een handmatige update uitvoeren

Feeds worden automatisch elke nacht bijgewerkt. Als u niet wilt wachten, kunt u een handmatige update starten:

1. Ga naar Settings > XML Import.

2. Klik op een actieve feed om het zijpaneel te openen.

3. Klik op de knop Update manually onderaan het zijpaneel.

4. Er verschijnt een bevestigingsmelding. Het importproces start op de achtergrond.

Verwerkingstijd

Het importproces draait op de achtergrond en kan enkele minuten duren, afhankelijk van het aantal woningen in de feed. De geimporteerde woningen verschijnen zodra de verwerking is voltooid.

---

Geimporteerde woningen bekijken

U kunt de woningen die bij een specifieke feed horen bekijken:

1. Open een feed in het zijpaneel.

2. Klik op de knop Details (bovenaan het zijpaneel).

3. Er opent een overzicht met alle woningen die aan deze feed zijn gekoppeld, inclusief naam, status, referentienummer, prijs en gekoppelde deals.

Klik op een woning in het overzicht om naar de detailpagina van die woning te navigeren.

---

Een feed verwijderen

Let op: woningen worden verwijderd

Wanneer u een feed verwijdert, worden ook de bijbehorende woningen verwijderd die geen actieve deals hebben. Woningen met gekoppelde deals blijven behouden.

1. Open de feed die u wilt verwijderen.

2. Klik op de knop Delete onderaan het zijpaneel.

3. Er verschijnt een overzicht met:

   • Het totaal aantal woningen in de feed.
   • Het aantal woningen dat zal worden verwijderd.
   • Een lijst van de woningen die verwijderd zullen worden, met hun naam, status, referentienummer, prijs en eventuele deals.

4. Controleer het overzicht en klik op Delete [aantal] properties om de feed en de verwijderbare woningen definitief te verwijderen.

---

Hoe de import werkt (technisch)

Voor gebruikers die willen begrijpen hoe het importproces op de achtergrond functioneert:

1. Feed ophalen — Tesoro CRM downloadt het XML-bestand van de opgegeven feed-URL.
2. XML verwerken — Het bestand wordt geparsed en opgesplitst in individuele woningrecords.
3. Filters toepassen — Woningen die overeenkomen met de uitsluitingsfilters worden overgeslagen.
4. Woningen opslaan — Per woningrecord wordt op basis van het referentienummer (ref) bepaald of het een nieuwe of bestaande woning betreft. Nieuwe woningen worden aangemaakt, bestaande woningen worden bijgewerkt.
5. Afbeeldingen verwerken — Foto’s uit de feed worden gedownload en aan de woning gekoppeld.
6. Opruimen — Woningen die niet meer in de feed voorkomen, krijgen de geconfigureerde verwijderstatus (bijv. Removed by feed).
7. Statistieken bijwerken — Het aantal succesvol geimporteerde en mislukte records wordt vastgelegd.

---

Veelvoorkomende problemen

Probleem	Mogelijke oorzaak	Oplossing
Geen woningen geimporteerd	De feed-URL is onbereikbaar of retourneert een leeg bestand.	Controleer of de URL correct is en toegankelijk is in een browser.
”Extracting property details” blijft staan	De feed is zeer groot en wordt nog verwerkt, of de verwerking is mislukt.	Wacht enkele minuten. Als het blijft hangen, sla de feed opnieuw op.
Woningen missen gegevens	De XML-feed bevat niet alle verwachte velden.	Neem contact op met de feedprovider om de volledigheid van de feed te controleren.
Dubbele woningen	Het referentienummer (ref) in de feed is niet uniek of ontbreekt.	Controleer bij de provider of elk woningrecord een uniek ref-element bevat.
Foutmelding bij opslaan	Een verplicht veld is niet ingevuld.	Controleer of alle verplichte velden (feed name, provider, URL, commission, remove property status, publish website) zijn ingevuld.
Woningen verdwijnen na update	De woningen komen niet meer voor in de XML-feed.	Dit is normaal gedrag. Woningen die uit de feed verdwijnen krijgen de geconfigureerde verwijderstatus. Controleer bij de provider of dit correct is.

---

Veelgestelde vragen

Hoe vaak wordt de feed automatisch bijgewerkt? De automatische import draait elke nacht. U kunt daarnaast op elk moment een handmatige update starten.

Kan ik meerdere feeds toevoegen? Ja, u kunt meerdere XML-feeds configureren, elk met een eigen provider, URL en filterinstellingen.

Wat gebeurt er met woningen die uit de feed verdwijnen? Woningen die niet meer in de feed voorkomen, krijgen de status die u heeft ingesteld bij Remove property status (standaard: Removed by feed). Ze worden niet permanent verwijderd, zodat u ze kunt terugvinden en indien nodig handmatig herstellen.

Kan ik een feed tijdelijk uitschakelen? Ja, zet de schakelaar Off/On op uit. De feed wordt dan niet meer automatisch verwerkt totdat u deze weer inschakelt.

Worden afbeeldingen ook geimporteerd? Ja, als de XML-feed afbeeldings-URL’s bevat, worden de foto’s automatisch gedownload en aan de woningen gekoppeld.