Email Registration of your Serial Numbers
We have set up an email system for estate and letting agents to make the process of registering your reference numbers quick and easy.
We also have an api system system and a manual registration system it is up to you which one(s) you decide to use.
In order to use this system please create your script and then contact us so that we may test and approve your script before going live on the system.
Sending us your Serial Numbers
In order to send property serial number information to us via email you first need to obtain your 'Secret Code' from your user profile on the website (found near the bottom of the page).
We have developed a strong error resistant email registration system which is easy to adopt for your agencies systems.
In order to send us serial number information you need to send us a plain text email. HTML emails will instantly be deleted from the system.
Message/Email Subject
The subject line of the email must be of the format:
< Username > ||| < SecretCode>
Where < Username> should be replaced with your site username and < SecretCode> should be replaced with your secret code. The fields are seperated by three consecutive '|' (pipe) characters. There are to be no spaces in the subject line except where they exist within your site username.
Message Body
Email body follows a strict order with each field being seperated by a '|' (pipe) character. Each record is to end with '%END%' except for the final record. All records are required except for 'flat' and 'propertyURL'.
For each record of the email you need to provide the following data in the correct order (validation information included):
- System reference - Unique reference to property on your systems (min 1 char., max 100 char.)
- Your reference - Human readable reference (min 3 char., max 100 char.)
- Message - The SMS message returned to clients. Note: Does not need to include contact information, property price, or agency name. Please see our SMS writing guide for help (min 30 char., max 106 char.)
- Registration Number - Property registration number, not to include your agency shortcode. Note: If this registration number matches that of a property currently in the system with the same registration number the new record will superceed the previous property entry (min 3 char., max 30 char. alphanumeric only, no spaces)
- Street - Street Address of the property. Note: Including number of the property is optional (min 3 char., max 100 char., alphanumeric, spaces allowed)
- Town - Town/Area/Suburb of the property (min 3 char., max 100 char., alphanumeric, spaces allowed)
- Flat - Flat number of the property. Note: Optional field (min 3 char., max 100 char., alphanumeric, spaces allowed)
- City - Nearest city of the property (min 3 char., max 100 char., alphanumeric, spaces allowed)
- Postcode - Postcode of the property. Note: Including number of the property is optional (min 3 char., max 12 char., alphanumeric, spaces allowed)
- Type - Listing type. Note: If there is an error on this field then listing type defaults to Sales.
- Type = 1: Property for Sale
- Type = 2: Property for Rental
- Price - Property price in GBP (£). Do not include the pound (£) sign, value is to be of integer type.
- Maximum sales price is £9,999,999.
- Maximum rental price is £99,999 per calendar month
- County - The county that the property resides in (min 3 char., max 100 char., alphanumeric, spaces allowed)
- Country - One of the following. Note: If error detected in this field then listing defaults to England.
- England or england
- Wales or wales
- Scotland or scotland
- Status - What you would like to do with the listing. Note: For property listin updates or deletions then the system reference fields must match. Field must be one of the following (on error defaults to 'new'):
- delete
- replace
- new
- Property URL - Related URL for the property. Note: This field is optional however if supplied must include the 'http://' and a correct format website address.
- Record End - If this isn't the final record then the record must be delimited using the '%END%' code. If this is the final record then this field is not required.
In many cases if the field is over the maximum number of characters then the field is simply cut to the maximum number of characters. If a field is supposed to be alphanumeric or does not reach the minimum number of characters then an error is generated.
Example
Below is a quick example to show how the email should look. If you have any questions then please feel free to get in touch about the system. Once you have your email script written please contact us to obtain an upload email address and to have your emails verified.
Message Subject:
My Lettings Agency|||53a3fab80db46ddf66b8fa8c950218cf
Message body:
201|Test_Street_24|3bed house,gch,double glazing,rear garden,new kitchen,recently renovated,bills included.|100|Test Street|Suburb1|Flat 1|Cardiff|CF200 0AA|2|350|New County|Wales|new|http://www.myurl.co.uk/view-property.php?id=201|%END%|202|Example_Street_99|Rustic property reqs rennovation,Grade A listed,large garden@rear|101|Example Street|Suburb2||Cardiff|CF99 9ZZ|1|380000|New County|Wales|replace|http://www.myurl.co.uk/view-property.php?id=202