Two new fields have been introduced to the Ad model for realestate-homes, realestate-leisure-sale, realestate-plot, realestate-project-unit, realestate-development-single. The new fields are named total_price and sales_cost_sum.
Total_price is a field that will contain the total price, that is the sum of the price suggestion, debt, sales tax and other sales costs.
Sales_cost_sum is a field that will contain the sum of all known sales cost like sales tax, official registrion, printing of documents etc.
Be aware of the old field total. This field must not be confused with the new total_price field. Therefore the old total field has been deprecated and will be removed on all Ad models for realestate (except realestate-development). If needed you can replace 'total' with an other new field 'price_with_collective_debt'. 'price_with_collective_debt' contain the same information as the old total field, but you should of course favor the new total_price field.
From 1.10.2018 the ad pages for realestate-homes and realestate-leisure-sale will be displayed in quite a new way when the new fields estate_summary, essential_info and local_area_name will be shown.
In addition there are two new link types where the rel-attribute is "urn:finn:realestate:prospectorder" and "urn:finn:realestate:prospectview".
Road tax is from 1.1.2018 inclueded in the trafic insurrance. The field road_tax_included is therefore removed from all motor ad types and searches.
wheel_sets has been removed on all motor ads, such as car-used-sale ads. The different types of tires is still included in the field
If you have any issues connecting to the APIs, please consult <a href="https://letsencrypt.org/docs/" target="_blank" rel="noopener">Let's Encrypt documentation page</a>
regulation on plot ads has been deprecated and will be removed after 12.08.2017. Instead you can use the new field
regulations, which is also used on other realestate ad types, and contains the same values as the deprecated field.
Image URL paths will change slightly as we switch to a new image delivery service. All clients manipulating or replacing URLs need to update to the new structure:
Image URL paths will not have this segment after 01.04.2017. A redirect to the new URL will be provided for some time.
Working today, but not provided in any of FINNs APIs until 01.04.2017.
If you are currently replacing
/dynamic/XXX/, you need to look for
/dynamic/default/ and replace both occurencies with
member_of_norboat_trade_association has been added to the ad types boat-dock, boat-new-sale, boat-used-wanted, boat-motor and boat-rent.
The field will have the value
true if the advertiser is registred in FINN admin as a member of Norboat.
The field road_tax_included is discontinued for ad types agriculture-tresher, agriculture-tools, agriculture-tractor, bus, construction and truck. Please make sure your clients/parsers do not break when not finding the field.
The image size
1598w is discontinued and replaced by
1600w. A redirect from 1598w to 1600w will be provided. Please make sure only to use documented image sizes.
As a part of the move from
https, we are forcing the the links to images, logos and other FINN pages to use
On the commercial property rent and sale search result (
realestate-business-sale), we are removing the size/living number field, and replacing it with a size/main, which is a number range.
school_cathcment_area on realestate searches (
realestate-letting) is being removed.
category on job searches (
job-part-time) is being removed. It has been replaced with the new facets
ownership_type field on the search result of realestate-leisure-sale and realestate-leisure-sale-abroad previously presented as a list of 1 element. This has now been fixed to be a single field of type "string", matching the model and the datatype on the ad-resource.
<finn:field name="ownership_type"> <finn:value>Andel</finn:value> </finn:field>
<finn:field name="ownership_type" value="Andel" />
Also, the following field descriptions (models) have been corrected:
furnishedon realestate-letting from Boolean to list of String
property_typeon realestate-letting-wanted from enum to list of String
livingon realestate-business-letting and realestate-business-letting from Number to Range
sizeon realestate-development-single (was listed twice in the model)
image-size resource is a configuration service that allows you manipulate images URLs to get image in alternative physical sizes
See API reference