02. Panden

Zodra een makelaarskantoor een Contract heeft met de Media Partner kan hij panden delen met de Media Partner. Voor het delen van panden biedt de Connector een API voor de Content Providers. De beschrijving van deze API valt buiten de scope van deze Wiki, maar het is belangrijk om te weten dat het delen dus via de software van de Content Provider gaat; dus vanuit Kolibri.

Manual / Auto publish (available)

Er zijn twee manieren waarop panden gedeeld kunnen worden: handmatig of automatisch. Bij handmatige mode kiest de makelaar per pand in de software er voor dat hij deze wilt delen met de geselecteerde Media Partner. Bij automatische mode hoeft de makelaar helemaal niets te doen; alle panden worden automatisch gedeeld met de Media Partner. Maakt de makelaar dus een nieuw pand aan in het software pakket dan wordt deze direct gedeeld met de Media Partner.

Manual Publish Available

Een makelaar kiest zelf welke mode hij wilt gebruiken. De opties waar de makelaar uit kan kiezen hangt echter af van de instellingen van de Media Partner. Sommige Media Partners ondersteunen de handmatige mode niet ('Manual Publish Available' = nee). In dit geval kan de makelaar dus mogelijk enkel de automatische mode activeren.

Auto Publish Available

Of de makelaar kan kiezen voor de automatische mode hangt af van de instelling van de Media Partner. Wordt de automatische mode niet ondersteund ('Auto Publish Available' = nee) dan kan de makelaar hier ook niet voor kiezen. In dit geval is dus mogelijk alleen de handmatige mode beschikbaar. Het mag duidelijk zijn dat het delen van panden alleen mogelijk is als minstens 1 van beide modes wordt ondersteund.

In onderstaande afbeelding is te zien dat de makelaar voor de geselecteerde Media Partner kan kiezen voor automatische of handmatige mode.

Panden ophalen

Nu de makelaar panden handmatig dan wel automatisch gedeeld heeft met de Media Partner is het voor de Media Partner zaak om de panden op te halen.

Om te voorkomen dat het proces van ophalen van panden door een Media Partner onnodig lang duurt en er onnodig veel dataverkeer plaats vindt verloopt het ophalen van panden in drie stappen:

1. Haal de lijst op met Contracten ('makelaarskantoren').
2. Haal een beperkte set van gegevens (pand summaries) op van alle actieve panden, per Contract ('makelaarskantoor').
3. Haal alleen de gegevens op van gewijzigde panden.

Door éérst een lijst op te halen van actieve Contracten hoeft de Media Partner zelf niet bij te houden welke Contracten er actief zijn. Houdt de Media Partner dit wel zelf bij dan kan stap 1 worden overgeslagen. Door vervolgens per Contract enkel een beperkte set van gegevens van de actieve panden op te halen kan de Media Partner op basis van de datum waarop het pand voor het laatst is gewijzigd bepalen of zijn versie van de pandgegevens overeenkomen met de meest recente pandgegevens. Heeft de Media Partner is zijn database een pand met een oude wijzigingsdatum dan is het dus zaak om de meest recente gegevens van het betreffende pand op te halen. Dit gebeurt in stap 3.

Bovenstaande 3 stappen kan de Media Partner een aantal keren (max. 2x) per dag doorlopen.

Pand gegevens

De gegevens van een pand zijn op te delen in 24 blokken of categorieën. Deze categorieën worden elders in deze Wiki uitvoerig beschreven. Het is echter niet zo dat iedere Media Partner altijd alle gegevens van een pand krijgt; dit hangt namelijk af van de rechten die een Media Partner heeft.