Feed Manager: aangepaste feeds delen

Naast de vaste 14 portaalverbindingen kunt u eigen feeds maken. Filter + één of meer partnerkantoren = unieke URL per kantoor. Handig voor samenwerkende kantoren, gelieerde vestigingen of integraties die een XML-feed via URL kunnen lezen.

Klik om te vergroten

Feed Manager, alle aangepaste feeds.

Vindt u onder Settings → Feed Manager.

Wanneer gebruikt u dit?

• U deelt uw aanbod met een samenwerkend kantoor
• U levert een feed aan een externe website of integratie
• U wilt per kantoor een andere selectie tonen, bijvoorbeeld alleen bepaalde locaties, prijsklassen of tags

MLS-portalen vs Feed Manager

Kenmerk	MLS-portaalverbinding	Feed Manager
Doel	Publiceren naar gevestigd vastgoedportaal	Delen met partnerkantoren of aangepaste systemen
Config	Schakelaar per portaal	Zelf feeds aanmaken met filters
Woningselectie	Per woning kiezen portaal	Via filtercriteria
Ontvangers	Vaste portalen	Elk kantoor of systeem via URL
Feed-URL	Auto per portaal	Auto per partnerkantoor

Opmerking

Aanvulling op directe portaalverbindingen, niet vervangend. Gebruik portaalverbindingen voor Kyero/Idealista/etc., Feed Manager voor partnerships en aangepaste integraties.

---

Een feed aanmaken

1. Open Feed Manager → klik Add feed.

2. Basisinformatie:

   Veld	Verplicht	Wat
   Feed name	Ja	3, 100 tekens, uniek binnen uw bedrijf
   Description	Nee	3, 8.000 tekens

3. Filtercriteria (sectie 2. Property filters), uitklapbare panelen, vul wat relevant is:

   Filter	Wat
   Relation	Filter op eigenaar/contact (multi-select met zoek)
   Location	Selecteer steden
   Property type	Multi-select woningtypen
   Bedrooms	Knoppenbalk 1, 6+
   Bathrooms	Knoppenbalk 1, 6+
   Price range	Min / max prijs
   Tags	Selecteer hashtags (multi-select met zoek)

   Systeem slaat auto op als dynamisch filter.

   Niet alles invullen verplicht

   Geen filters = alle woningen erin. Stel alleen in wat relevant is voor het partnerkantoor.

4. Kantoren koppelen (sectie 3. Agencies): klik de plus-tegel, zoek het partnerkantoor via Search agencies en klik Attach Agencies. Elk gekoppeld kantoor verschijnt als eigen kaart met een Active-schakelaar.

5. Save (Ctrl+S / Cmd+S). Auto-status Active.

De XML-link bestaat pas na Save

Een net gekoppeld kantoor heeft nog geen token, en dus geen link. Tesoro maakt het token pas aan tijdens het opslaan. Ziet u nog geen Copy XML link-knop, sla dan eerst op en open de feed daarna opnieuw.

---

Feed-URL en tokens

Per gekoppeld kantoor:

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

• URL levert woningdata als XML
• Elk kantoor eigen token = per-kantoor tracking
• Systeem houdt bij: request_count (hoe vaak opgehaald) + last_access (laatste keer)

Deel alleen met vertrouwde partners

Met URL + token kan iedereen de feed lezen zonder inloggen.

De link kopieert u per kantoor met de knop Copy XML link op de kaart van dat kantoor. De knop verandert kort in Copied!.

---

Een samenwerking pauzeren of stoppen

Elk gekoppeld kantoor heeft een eigen Active-schakelaar op zijn kaart in sectie 3. Agencies. Dat is het instrument voor een samenwerking die tijdelijk of definitief stopt, en het is bijna altijd de betere keuze dan het kantoor verwijderen.

Actie	Wat het kantoor merkt	Wat er met de link gebeurt
Active uitzetten	De feed blijft werken maar bevat nul woningen	Link blijft geldig, token blijft bestaan
Kantoor verwijderen	De link geeft een foutmelding dat het token ongeldig is	Token verdwijnt definitief

Het verschil is groter dan het lijkt. Zet u een kantoor op inactief, dan krijgt hun systeem nog steeds een geldig XML-bestand, alleen zonder woningen. Hun import loopt dus niet vast op een fout, de advertenties verdwijnen gewoon. Verwijdert u het kantoor, dan breekt hun koppeling.

Heractiveren herstelt dezelfde link

Zet u het kantoor later weer op Active, dan blijft het oorspronkelijke token behouden, net als de tellers request_count en last_access. Het kantoor hoeft niets te wijzigen, hun bestaande URL werkt weer. Daarom hoeft u bij een hervatte samenwerking geen nieuwe link te sturen.

Tesoro blijft de toegang meetellen zolang de link wordt opgevraagd, ook als het kantoor op inactief staat. Aan last_access ziet u dus of een gedeactiveerd kantoor uw feed nog steeds bevraagt.

---

Feeds beheren

Overzichtstabel

Kolom	Wat
Feed name	Naam van de feed
Properties	Aantal woningen dat aan filter voldoet
Agencies	Aantal gekoppelde kantoren
Last update	Datum laatste wijziging
Status	Active of Offline

Paginering: 10, 20, 30, 40 of 50 per pagina.

Bewerken

In de kolom Actions staan twee iconen: een potlood en een prullenbak. Klik het potlood → het zijpaneel opent met de huidige waarden → wijzig → Save.

Verwijderen

Klik de prullenbak → bevestiging. URL’s stoppen direct met werken.

Eerst de kantoren loskoppelen

Een feed met gekoppelde kantoren kunt u niet verwijderen. Tesoro meldt dan: “Remove all agencies from the feed before deleting it”. Haal de kantoren er eerst af, of zet ze op inactief als u de samenwerking alleen wilt pauzeren.

Definitief

Partnerkantoren die deze feed gebruiken ontvangen geen data meer. Communiceer met hen voor verwijdering.

---

Status: Active of Offline

Status	Wat
Active	Levert data via URL
Offline	Gedeactiveerd, levert niets meer

Wijzig via Edit. Offline behoudt de feed maar levert niets, handig voor tijdelijke pauze zonder verwijderen.

---

Filtercriteria zijn dynamisch

Filters worden opgeslagen als dynamisch filter en opnieuw toegepast bij elke opvraag van de feed-URL.

Dit betekent automatische updates wanneer:

• Nieuwe woning matcht criteria
• Bestaande woning wijzigt waardoor wel/niet meer in scope
• Woning verwijderd

Geen handmatig refresh nodig

Portefeuille verandert → feed past zich automatisch aan bij volgende uitlees.

---

In aanmerking komende statussen

Een woning verschijnt in een Feed Manager-feed als ze:

1. Het filter matcht
2. Display on Website aan
3. Display on Feed aan (default uit, expliciet aanzetten)
4. Status in lijst: Pending Approval, Active, Sold, Rented, Under Offer, Off Market, Negotiating, Under Contract, Open House, Key Ready, Under Construction, Removed by Feed
5. Kyero-compatibele validatie geslaagd

---

Veelgemaakte fouten

Feed toont 0 woningen

1. Filter te smal?
2. Display on Website én Display on Feed aan?
3. Status in in-aanmerking-komende lijst?
4. Kyero-validatie geslaagd (referentie, prijs, type, stad, provincie, slaapkamers, badkamers, beschrijving, ≥1 foto)?

Kantoor klaagt geen data te ontvangen

1. Staat het kantoor zelf nog op Active in sectie 3. Agencies? Dit is de meest voorkomende oorzaak. Een kantoor op inactief krijgt een geldige feed zonder woningen, dus zij zien geen foutmelding, alleen een leeg bestand.
2. Status van feed = Active?
3. URL + token nog geldig (kantoor niet verwijderd?)
4. Filterresultaat = niet leeg?

---

Gerelateerd

MLS-portalen overzichtHet verschil tussen portaalverbindingen en Feed Manager.

Portalen verbindenKyero, Idealista, Fotocasa en 12 andere portalen aansluiten.

Aanbiedingen publicerenPortalen toewijzen per woning + Kyero Prime.