01. Contracten
Voordat een makelaarskantoor panden en/of relaties kan delen met een Media Partner heeft het kantoor dus een Contract nodig. De Connector heeft een interface (API) voor Content Providers waarmee contracten aangevraagd kunnen worden. De beschrijving van de API voor Content Providers valt buiten de scope van deze Wiki. Het is enkel belangrijk om te weten dat een Content Provider dus vanuit de software aan de makelaar de mogelijkheid kan bieden om lijsten van Media Partners op te vragen en voor een geselecteerde Media Partner een verzoek voor een Contract in te dienen. Venum biedt deze mogelijkheid aan haar gebruikers.
Defintie: Contract
Een Contract is een overeenkomst tussen een makelaarskantoor en een Media Partij waarbij het makelaarskantoor aangeeft de gegevens van alle of van geselecteerde panden te willen delen met de Media Partner. Het aanvragen van een Contract (door het makelaarskantoor) en het bevestigen van het Contract (door de Media Partner) verloopt via de Connector.
En ook het verzoek om een Contract te beëindigen (door het makelaarskantoor) en de bevestiging hiervan (door de Media Partner) verloopt via de Connector.
Auto Accept
Sommige Media Partners willen, voordat ze panden van een makelaarskantoor accepteren, eerst een (papieren) overeenkomst met het makelaarskantoor sluiten. Vaak is dit het geval als het makelaarskantoor per pand moet gaan betalen, of een maandelijks tarief moet gaan betalen. Er zijn echter ook Media Partners die alle panden van alle makelaarskantoren accepteren. Voor deze Media Partners is het hebben van een (papieren) overeenkomst helemaal niet relevant. Ieder verzoek van een makelaarskantoor voor een Contract is direct akkoord. Om het gemakkelijk te maken heeft de Connector hier een functie voor ingebouwd die Contract verzoeken voor een Media Partner met instelling 'Auto Accept = ja' direct accepteren. De makelaar krijgt dus gelijk na het indienen van een verzoek voor een Contract gelijk akkoord en kan dus direct panden gaan delen.
Voor Media Partners met instelling 'Auto Accept = nee' werkt het anders. Deze Media Partners zullen met enige regelmaat bij de Connector Contract verzoeken op moeten vragen. Vervolgens kan de Media Partner het Contract (enkele dagen later) accepteren of weigeren.
Auto Accept = ja
De Media Partner hoeft niets te doen. Verzoeken van een makelaarskantoor voor de activatie van een Contract voor een Media Partner worden direct en volautomatisch geaccepteerd door de Connector.
Auto Accept = nee
De Media Partner haalt zelf met regelmaat (bijvoorbeeld 1x per dag) een lijst op met verzoeken voor activatie van Contracten. Vervolgens accepteert of weigert de Media Partner het verzoek door de API van de Connector aan te roepen.