04. Instellingen en rechten
Niet alle Media Partners zullen zowel handmatige als automatische mode willen of kunnen ondersteunen. Een Media Partner die kosten doorberekend per pand, bijvoorbeeld een drukker die brochures ontwikkeld, zal kiezen voor de handmatige mode. Het is namelijk erg onwaarschijnlijk dat een makelaar automatisch altijd van al zijn aanbod een brochure wilt laten drukken.
Ook zullen niet alle Media Partners al het aanbod kunnen accepteren. Zo zijn er Portals gespecialiseerd in huuraanbod; zij willen enkel huur panden. En zo zijn er weer andere Portals die enkel bedrijfsmatig aanbod willen.
De status van een publicatie (een pand waarvan de gegevens gedeeld worden met een Media Partner) kunnen zichtbaar zijn in de software van de Content Partner. En het heeft natuurlijk alleen zin om de status te tonen bij de relevante panden. De status van de publicatie naar een Portal met enkel bedrijfsmatige panden zullen zo nooit getoond moeten worden bij een particulier pand.
Om bovenstaande netjes te kunnen faciliteren heeft de Connector een aantal instellingen welke door de beheerder van de Connector per Media Partner worden ingesteld. Het is belangrijk dat deze instellingen juist zijn ingesteld. Vraag als Media Partner daarom altijd naar de instellingen van de Connector, om er zeker van te zijn dat deze juist zijn ingesteld!
Instellingen
Hieronder een overzicht van de meest relevante instellingen voor Media Partners:
| Instelling | Standaard waarde | Omschrijving |
|---|---|---|
| Countries | - | Deze instelling Countries bevat de landcodes van de landen waar de panden zich moeten bevinden. Indien geen landcode is ingesteld (=standaard waarde) dan wordt er niet gefilterd op land. |
| Accepts Residential Properties | Ja | Deze instelling geeft aan of de Media Partner in staat is om particuliere panden te verwerken. |
| Accepts Commercial Properties | Nee | Deze instelling geeft aan of de Media Partner in staat is om bedrijfsmatige panden te verwerken. |
| Accepts Agricultural Properties | Nee | Deze instelling geeft aan of de Media Partner in staat is om agrarische panden te verwerken. |
| Accepts Properties For Sale | Ja | Deze instelling geeft aan of de Media Partner in staat is om koop panden te verwerken. |
| Accepts Properties For Rent | Ja | Deze instelling geeft aan of de Media Partner in staat is om huur panden te verwerken. |
| Accepts Properties For Pacht | Nee | Deze instelling geeft aan of de Media Partner in staat is om pacht panden te verwerken. |
En dan zijn er ook nog een aantal instellingen die bepalen op welke manier het aanvragen van contracten verloopt (Auto Accept = ja/nee) en op welke manier het publiceren verloopt (handmatig en/of automatisch):
| Instelling | Standaard waarde | Omschrijving |
|---|---|---|
Auto Accept | Nee | Deze instelling geeft aan of alle verzoeken voor een contract tussen het makelaarskantoor en de Media Partner automatisch worden geaccepteerd (zonder dat de Media Partner hier dus een actie voor hoeft uit te voeren). |
| Nee | Deze instelling bepaalt of de automatische mode beschikbaar is voor een makelaarskantoor voor de betreffende Media Partner. | |
Manual Publish Available | Ja | Deze instelling bepaalt of de handmatige mode beschikbaar is voor een makelaarskantoor voor de betreffende Media Partner. |
| Auto Accept Deactivation | Nee | Deze instelling geeft aan of alle verzoeken voor beëindiging van een contract tussen het makelaarskantoor en de Media Partner automatisch worden geaccepteerd (zonder dat de Media Partner hier dus een actie voor hoeft uit te voeren). |
Rechten
Er zijn enorme hoeveelheden gegevens van een pand beschikbaar. Maar lang niet alle gegevens zijn relevant voor iedere Media Partner. Daarnaast zijn er gegevens die de makelaar simpelweg niet wil delen met Media Partners. Denk hierbij bijvoorbeeld aan de transactie gegevens ('voor welke prijs is het pand uiteindelijk daadwerkelijk verkocht?'). De beheerder van de Connector bepaalt per Media Partner de rechten. Hieronder een overzicht van de meest relevante rechten voor Media Partners:
| Recht | Standaard waarde | Omschrijving |
|---|---|---|
| Buyer Details | Nee | Dit recht bepaalt of de contactgegevens van de kopers/huurders bij een pand worden meegeleverd. |
| Cadestre Details | Ja | Dit recht bepaalt of de kadastrale gegevens bij een pand worden meegeleverd. |
| Floor Details | Nee | Dit recht bepaalt of de details van de verdiepingen (incl. kamers) bij een pand worden meegeleverd. |
| HighResPhoto | Nee | Dit recht bepaalt of de hoge resolutie ('de originele') foto's worden meegeleverd. Naast de originele foto's worden de links naar 'genormaliseerde' foto's' meegeleverd (foto's die prima geschikt zijn voor b.v. het gebruik op websites). |
| Owner Details | Nee | Dit recht bepaalt of de contactgegevens van de verkopers/verhuurders bij een pand worden meegeleverd. |
| PriceHistory | Nee | Dit recht bepaalt of de prijs geschiedenis bij een pand worden meegeleverd. |
| Transaction Details | Nee | Dit recht bepaalt of de transactie gegevens bij een pand worden meegeleverd. |
Bovenstaande rechten hebben betrekking tot de details van een pand. Voor relaties worden altijd alle gegevens beschikbaar gesteld. Wel moet de Media Partner het recht hebben om relaties via de Connector op te halen. Dit wordt bepaald door de API rechten.
API rechten
De API van de Connector bevat een 12-tal functies (methods) bedoelt voor Media Partners. Per Media Partner kan de beheerder van de Connector bepalen welke van deze 12 functies toegankelijk zijn voor een Media Partner. Door API functies af te schermen kan worden voorkomen dat een Media Partner een API functie per ongeluk aanroept zonder dat hier een noodzaak voor is.
Of een Media Partner relaties kan ophalen wordt bepaald door het recht van een Media Partner voor het aanroepen van de functie 'GetRelations'. Hieronder een overzicht van de 12 functies (API methods) en het standaard recht.
Met deze API method geeft de Media Partner aan dat hij het verzoek voor een contract tussen een makelaarskantoor en de Media Partner accepteert.
| API recht | Standaard waarde | Omschrijving |
|---|---|---|
| Ophalen van contracten: | ||
| GetAllMediaContracts | <toegang> | Met deze API method krijgt de Media Partner een overzicht van alle Contracten. |
| GetPendingActivationRequests | <toegang> bij 'Auto Accept = nee' | Met deze API method krijgt de Media Partner een lijst van alle Contract verzoeken. |
| GetPendingDeactivationRequests | <toegang> bij 'Auto Accept = nee' | Met deze API method krijgt de Media Partner een lijst van alle Contract beëindiging verzoeken. |
| GetActiveMediaContracts | <toegang> | Met deze API method krijgt de Media Partner een overzicht van alle actieve Contracten. |
| Accepteren/weigeren contracten: | ||
| AcceptMediaContractActivationRequest | <toegang> bij 'Auto Accept = nee' | Met deze API method geeft de Media Partner aan dat hij het verzoek voor een contract tussen een makelaarskantoor en de Media Partner accepteert. |
| RejectMediaContractActivationRequest | <toegang> bij 'Auto Accept = nee' | Met deze API method geeft de Media Partner aan dat hij het verzoek voor een contract tussen een makelaarskantoor en de Media Partner niet accepteert. |
| ConfirmMediaContractDeactivationRequest | <toegang> bij 'Auto Accept = nee' | Met deze API method geeft de Media Partner aan dat hij het verzoek voor beëindiging een contract tussen een makelaarskantoor en de Media Partner al dan niet accepteert. |
| Ophalen van paden | ||
| GetRealEstatePropertySummariesForRealtor | <toegang> | Met deze API method krijgt de Media Partner de pand samenvattingen van alle panden van het opgegeven Contract ('makelaarskantoren'). |
| GetRealEstatePropertyXml | <toegang> | Met deze API method krijgt de Media Partner alle pand gegevens van het opgegeven pand. |
| Ophalen van relaties | ||
| GetRelations | <geen toegang> | Met deze API method krijgt de Media Partner de relaties van het opgegeven Contract ('makelaarskantoor'). |
| Overige | ||
| GetAllRealEstatePropertySummaries | <geen toegang> | Met deze API method krijgt de Media Partner alle pand samenvattingen van alle Contracten ('makelaarskantoren'). |
| GetRealEstatePropertyForRealtor | <geen toegang> | Met deze API method krijgt de Media Partner alle pand gegevens van het opgegeven Contract ('makelaarskantoren'). |
| SuspendMediaContract | <geen toegang> | Met deze API method blokkeert de Media Partner de publicatie van panden door de makelaar naar de Media Partner. |