Element:
|
Required:
|
Definition:
|
| <?xml version="1.0" encoding="UTF-8"?> |
yes |
The very first line of the feed. This can be either UTF-8, UTF-16 or ISO-8859-1 |
| <root> |
yes |
Opens the document |
<Propertyshowrooms>
<feed_version>2</feed_version>
</ Propertyshowrooms> |
yes |
Identifies the Propertyshowrooms feed version. |
| <property> |
yes |
Opens the property node for each individual property. |
| <date>2004-04-05 13:45:45</date> |
yes |
Must be datetime which is 19 characters and is usually the last modified date for the property as it is in your database. This must follow or be converted to standard datetime format of: YYYY-MM-DD HH:MM:SS. This is used in conjunction with the <id> tag to determine if the property should be added or updated. |
| <ref>ABC123456</ref> |
yes |
Alphanumeric, max 20 characters. This is the unique identifier for each property that you list. You will have something similar in you database so its recommended that you use this for ease of identification. This is used in conjunction with the <date> tag to determine if the property should be added or updated. This will need to be a unique reference number or the system will not except the property |
| <price>200000</price> |
yes |
Numeric, max 8 characters. This is used in conjunction with <price_freq> and <currency> tags to establish the pricing for the property in question. This is the price the price the property is for sale at. Please only use whole numbers only with no punctuation. (e.g, 200000 NOT 200,000 or 200.000,00 or 200,000.00) No deviations from this method will be accepted. For development price variations, enter the LOWEST PRICE and use the <desc> node to detail pricing options. |
| <currency>EUR</currency> |
yes |
Used in conjunction with <price> tag. This must be the correct and up-to-date official ISO currency code. You can look up your curreny code below:
|
| <price_freq>sale</price_freq> |
yes |
Alpha 'sale' for properties for sale. Do not put anything else in this tag, This tag used in conjunction with <price> and <currency> tags. |
| <part_ownership>0</part_ownership> |
no |
Numeric. '1' denotes price does not represent 100% ownership. Applicable only when <price_freq> is set to 'sale'. Empty, missing tag or '0' denotes a 'normal' property for sale. |
| <leasehold>1</leasehold> |
no |
Numeric. '1' denotes leasehold is being offered. Applicable only when <price_freq> is set to 'sale'. Empty, missing tag or '0' denotes a freehold is for sale. |
| <isnewdevelopment>1</isnewdevelopment> |
no |
Numeric. "1" denotes it is a new development, "0" denotes it is resale.
An empty or missing tag will denote a resale property |
|
<type>
<en>Townhouse</en>
</type>
|
yes |
Alpha. Property type in ENGLISH only. Will be converted to one of the following property types during import:
| Apartment |
Cabin |
Business |
Maisonette |
Flat |
| Airport |
Garage |
Penthouse |
House |
Cavehouse |
| Land |
Rural |
Villa |
Church |
Hospital |
| Village |
Townhouse |
Game Reserve |
Ruins |
Other |
|
| <town>Marbella</town> |
yes |
Alpha. This needs to be the nearest locale, town or city, preferably a valid Postal location (eg: Javea, Nerja, Paris, Berlin). |
| <province>Andalusia</province> |
yes |
Alpha. This needs to be the 1st administrative division the town is located in. (e.g, the first divisions that a country is divided into, Andalucía, Hampshire, Texas) AKA Province, Region, County, State. This does not include small municipalities that lie within another larger region or tourist names for areas (e.g, Costa del Sol or the Algarve for instance), preferably a valid Postal province or region. |
| <country>Spain</country> |
yes |
Alpha. Country name, (eg: Germany, France). |
| <location_detail>Malaga</location_detail> |
no |
Alphanumeric. max 50 characters Free text used to describe an area that is important to the location of your listing. for instance, if your listing is in Marbella the province has to be Andalusia (as above) but you may like to add Malaga in this tag to show that it is in Malaga municipality. |
| <beds>3</beds> |
yes |
Numeric. Number of bedrooms, '0' denotes 'no beds' (Studio apartment). Whole numbers ONLY. Not 1.5 etc. |
| <baths>2</baths> |
yes |
Numeric. Number of bathrooms, '0' denotes 'no baths'. Whole numbers ONLY. Not 1.5 etc. |
| <pool>1</pool> |
yes |
Numeric. '1' denotes a pool is available and '0' denotes 'no pool'. |
<surface_area>
<built>200</built>
<plot>3000</plot>
<terrace>60</terrace>
</surface_area> |
no |
Numeric. All areas must be in square meters. Use whole numbers only, with no punctuation (i.e. 200000 NOT 200,000 or 200.000,00 or 200,000.00). |
<distancetobeach>100</distancetobeach>
<distancetoshops>2000</distancetoshops> |
no |
Numeric. All distances must be in meters, leave blank or zero if not applicable. |
| <orientation>East</orientation> |
no |
Alpha. North, East, South, West. Can be left blank if unknown. |
| <views>Sea, Mountains</views> |
yes |
Alphanumeric. Up to 200 characters free text, NO HTML or page breaks, Links or Logos. |
| <carpark>1</carpark> |
no |
Numeric. 1 denotes car park is available. 0 denotes car park is not available. |
<waterconnection>1</waterconnection>
<electricityconnection>1</electricityconnection>
<telephoneconnection>1</telephoneconnection>
<elevator>0</elevator>
<fireplace>1</fireplace>
<solarium>0</solarium>
<storage>1</storage>
<watertank>1</watertank>
<safe>1</safe>
<airconditioning>1</airconditioning>
<centralheating>1</centralheating>
<floorheating>1</floorheating>
<fittedkitchen>1</fittedkitchen>
<doubleglazing>1</doubleglazing>
<irrigationsystem>1</irrigationsystem>
<jacuzzi>1</jacuzzi>
<sauna>1</sauna>
<gymnasium>1</gymnasium>
<tenniscourt>1</tenniscourt>
<alarm>1</alarm>
<security>1</security>
<gatedcommunity>1</gatedcommunity> |
no |
1 denotes yes, 0 denotes for no. |
<desc>
<en>English property description</en>
</desc> |
yes |
Alphanumeric. There should be no contact details or company information of any kind in any part of the description under any circumstances (i.e. email addresses, web addresses, company name or telephone numbers). There is no character limit but the absolute minimum is 50 characters long.
Descriptions should be encoded to ensure the following characters are encrypted.
Below is a list of the accepted html encoding:
| <b></b> |
<blockquote></blockquote> |
<br/> |
<center></center> |
| <cite></cite> |
<dfn></dfn> |
<em></em> |
<i></i> |
| <wbr> |
<p></p> |
<strong></strong> |
<sub></sub> |
| > |
& |
|
< |
| <u></u> |
<sup></sup> |
" |
­ |
Please note that any descriptions where the html is untidy or corrupt will be rejected.
|
<images>
<image id="1">
<url>http://www.website.com/images/141.jpg</url>
<primary>1</primary>
<title>
<en>title of the image</en>
</title>
</image>
</images> |
|
The images node has a maximum of 10 image's per property. Image id's start at 1 and end in 10. The url tag needs to be the absolute http url of each image. The original image size must be at least 640 x 480 pixels. No images below this size will be accepted It must also be a JPG image and end in the ".jpg" extension, No other types are supported. Primary tag denotes if is the main image for this property (the one that displays in Propertyshowrooms.com search results). Only one image per property can be marked as 'primary' images (empty or missing tag or '0' denotes a non-primary image). If this tag is not used, the first image listed will be imported as the 'primary' image. No watermarks or text of any kind are allowed in any of the images. Optional title tag, max 150 characters, describing the image. This format can be repeated for 10 images - up to <image id="10"> |
| </property> |
yes |
End of property node. |
| </root> |
yes |
MUST be the last line of the feed. |