Property requests

Requests placed against a property are added directly into the Dezrez software to be actioned by the estate agent.


Requests

The request system is located on the Dezrez servers and can be found on the link below. Before a request can be performed the user has to login or register, the login form is the same form used by the members area and all actions can be performed (register, forgotten password, etc.) The request system can be displayed in an iframe or in a new window but it has to run from the Dezrez servers to keep the whole process secure.

The type of property requests that can be placed are as follows:

  1. Request a brochure
  2. Request a viewing
  3. Request a callback
  4. Request a property valuation

When a property request is submitted the web engine tries to log the request against a client card for the user that is in the same branch as the property in question. If a client card isn't found it will prompt the user for more information so it can create a client card in that branch. Once this step has been completed the request will be automatically submitted to the estate agent.

The URL is: http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/PropertyRequest.aspx


Parameter reference

Parameter name Data type Value Description
apiKey string Example:
DEBF038A-8047-42F8-B0A8-12C35DA33F13
The API (Application Programing Interface) key is an identifier unique for the estate agent and needs to be provided with any request made to the dezrez web engine. After the initial request the web engine will attempt to store the API key for any subsequent request for that session. A key can be obtained from the dezrez web team (0845 465 2222). This is a compulsory value.
eaid int The Estate Agency ID – This number can be obtained from the dezrez web team (0845 465 2222). This is a compulsory value.
bid int The Estate Agency Branch ID – This number can be obtained from the property xml. This is a compulsory value.
sessionGUID string Example:
66ff1de8-0115-48d6-8417-74c238fc8704
The session GUID (Globally Unique Identifier) is used to identify the website users current session. This should be passed from your website to the dezrez web engine to maintain a constant session across the web engine. Not supplying the same sessionGUID with every request for a particular session will result in the website user having to log into the web engine multiple times. See Appendix A for sample code to generate a unique id. This is a compulsory value.
pid long Example: 258204 Dezrez ID for the property to be add/removed from the portfolio. This can be obtained from the property xml. A valid property ID has to be supplied for all request types. This is a compulsory value.
requesttype int The type of request based on the following key:

242 - viewing
220 - phone call
32 - brochure
241 - valuation

For example, you could create a link to request a viewing:

http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/PropertyRequest.aspx?apikey=DEBF038A-8047-42F8-B0A8-12C35DA33F13&eaid=398&bid=603&sessionGUID=02840429-0c46-464d-9d85-74f34e885581&pid=262450&requesttype=242

Request a phone call:

http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/PropertyRequest.aspx?apikey=DEBF038A-8047-42F8-B0A8-12C35DA33F13&eaid=398&bid=603&sessionGUID=02840429-0c46-464d-9d85-74f34e885581&pid=262450&requesttype=220

Request a brochure:

http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/PropertyRequest.aspx?apikey=DEBF038A-8047-42F8-B0A8-12C35DA33F13&eaid=398&bid=603&sessionGUID=02840429-0c46-464d-9d85-74f34e885581&pid=262450&requesttype=32

Request a valuation:

http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/PropertyRequest.aspx?apikey=DEBF038A-8047-42F8-B0A8-12C35DA33F13&eaid=398&bid=603&sessionGUID=02840429-0c46-464d-9d85-74f34e885581&pid=262450&requesttype=241
A valid property ID is required for a valuation request, this property ID isn't linked to the request in the Dezrez system.

Back to top

Appendix A - Sample GUID generation code


Classic ASP

copy

Function GetGuid() 
    Set TypeLib = CreateObject("Scriptlet.TypeLib") 
    GetGuid = Left(CStr(TypeLib.Guid), 38)
    GetGuid = replace(GetGuid, "{", "")
    GetGuid = replace(GetGuid, "}", "")
    Set TypeLib = Nothing 
End Function 
                                    
                                    

PHP

copy

function getGUID()
{
	$theGuid = uniqid(uniqid(), true);
	return $theGuid;
}
                                    
                                    

Javascript

copy

function createUUID() {
    // http://www.ietf.org/rfc/rfc4122.txt 
    var s = [];
    var hexDigits = '0123456789ABCDEF';
    for (var i = 0; i < 32; i++) {
        s[i] = hexDigits.substr(Math.floor(Math.random() * 0x10), 1);
    }
    s[12] = '4';  // bits 12-15 of the time_hi_and_version field to 0010 
    s[16] = hexDigits.substr((s[16] & 0x3) | 0x8, 1);  // bits 6-7 of the clock_seq_hi_and_reserved to 01 
    var uuid = s.join('');
    return uuid;
}
                                    
                                    

C#

copy

string sessionGUID = Guid.NewGuid().ToString();