XML format and structure

Header

<header>: Represents user and market information. Tags to include:

  1. <owner_email>: Represents the client's email address on your side. The email is just for tracking purposes. We use an Authorization protocol to connect client credentials on our side and your feed. This means that the client will be notified via email, once we enable your feed and the client needs to allow it.
  2. <site_urn>: Represents our marketplace where your system wants to publish clients properties.
ValueDescription
urn:site:imovirtualcomPublish at Imovirtual
urn:site:otodomplPublish at Otodom
urn:site:storiaroPublish at Storia

Header example URL

<header>
    <owner_email>
        <![CDATA[  ]]>
    </owner_email> // optional
    <site_urn>urn:site:imovirtualcom</site_urn>
</header>

Advert payload

<adverts>: Starts the encoding for individual adverts.
<advert>: Represents a property listing, and all elements and attributes for the advert will be under this tag. Every advert is individually identified by this tag, and there’s no limit on adverts' insertions.

The XML feed follows a specific structure:

Basic Elements
Basic Elements are to be applied to all adverts, and most of these elements are mandatory.
All basic elements must be wrapped in an <element_name> element and have the following structure:

<adverts>
    <advert>
           // simple elements
        <element_name>
            <![CDATA[  ]]>
        </element_name>
		// elements with child/children
        <element_name>
            <element_child>
                <![CDATA[  ]]>
            </element_child>
        </element_name>
    </advert>
</adverts>

Note: some elements and the values of their children's elements have specific values that must be checked against the basic elements in the XML template file.

Attributes per Categories

All attributes and characteristics must be wrapped in an element under ; you can add as many attributes as necessary for each property advert, based on category available attributes and have the following structure:

<attribute>
    <urn>attribute_name</urn>
    <value>attribute_value</value>
</attribute>

HTML vs XML tags

HTML tags in the description will not be properly interpreted without adding the <![CDATA[ at the start of the description and ]]> at the end. Without this, from XML perspective, those HTML tags are treated as XML tags, and since they are empty, they are removed. Update the XML file with the <![CDATA[ ]]> to the description to send HTML tags if necessary.

XML template file

Below you will find all available attributes per categories.

📘

Bear in mind that individual parameter or attribute values may vary depending on the marketplace.

<?xml version="1.0" encoding="UTF-8"?>
<!-- mandatory | root element -->
<data>
    <header>
        <!-- mandatory | agency email on your side -->
        <owner_email>[email protected]</owner_email>
        <!-- mandatory | site target | site where agency manages his inventory -->
        <site_urn>urn:site:imovirtualcom</site_urn>
    </header>
    <!-- mandatory | list of all adverts to be published or updated on agency account -->
    <adverts>
        <!-- mandatory | repeat element per each advert -->
        <advert>
            <!-- optional|mandatory | custom fields 
            to help identify the advert as unique -->
            <custom_fields>
                <!-- mandatory | alfanumeric | external_id
                unique partner advert id used to add or update the advert
                -->
                <id>ABC0123456789</id>
                <!--  optional | alfanumeric | reference_id
                agency reference id to show in advert details page
                -->
                <reference_id>ABC0123456789</reference_id>
            </custom_fields>
            <!-- mandatory | string | title | less than 70 characters -->
            <title>advert title</title>
            <!-- mandatory | string | description | less than 4096 characters 
            use html tags for formating the description -->
            <description>Fugiat architecto beatae delectus asperiores et. Repellat harum dolore quia ipsam ullam. Voluptas eius recusandae repellat quis accusantium.</description>
            <!-- category & category type - mandatory string 
            allowed values:
                apartments for sale             urn:concept:apartments-for-sale
                apartments for rent             urn:concept:apartments-for-rent
                apartments for vacation         urn:concept:apartments-for-vacation
                
                houses for sale                 urn:concept:houses-for-sale
                houses for rent                 urn:concept:houses-for-rent
                houses for vacation             urn:concept:houses-for-vacation
                
                rooms for rent                  urn:concept:rooms-for-rent
                
                lots for sale                   urn:concept:lots-for-sale
                lots for rent                   urn:concept:lots-for-rent
                
                stores for sale                 urn:concept:stores-for-sale
                stores for rent                 urn:concept:stores-for-rent
                
                warehouses for sale             urn:concept:warehouses-for-sale
                warehouses for rent             urn:concept:warehouses-for-rent
                
                garages for sale                urn:concept:garages-for-sale
                garages for rent                urn:concept:garages-for-rent
                
                offices for sale                urn:concept:offices-for-sale
                offices for rent                urn:concept:offices-for-rent
                
                buildings for sale              urn:concept:buildings-for-sale
                buildings for rent              urn:concept:buildings-for-rent
                
                farms and estates for sale      urn:concept:farms-and-estates-for-sale
                farms and estates for rent      urn:concept:farms-and-estates-for-rent
                
                goodwill                        urn:concept:goodwill
            -->
            <category_urn>urn:concept:apartments-for-sale</category_urn>
            <!-- consultant contact details - optional
            it will displayed at advert details page depending on user package 
            if omitted agency contact details will be displayed
            -->
            <contact>
                <!-- consultant name - mandatory string -->
                <name>Consultant Name</name>
                <!-- consultant email - mandatory string
                unique email for consultant. it will be used to add or update consultant data
                -->
                <email>consultant.email@domain</email>
                <!-- consultant phone - mandatory string
                9 digit format
                -->
                <phone>910000000</phone>
                <!-- consultant photo - optional string - url for consultant photo
                minimum resolution allowed: 60x60
                recommended resolution: 66x66
                maximum file size allowed: 5 MB
                -->
                <photo>http://path.to/consultant/photo.jpg</photo>
            </contact>
            <!-- mandatory | double | property rent or sales price -->
            <!-- use a dot for decimal
    
            max value for apartments: 5000000
            max value for houses: 15000000
            max value for lots: 30000000
            max value for buildings: 47500000
    
            price 0 is allowed and will be displayed as "on demand"
            for that on-demand atributte shall be included
            -->
            <price>
                <value>123000</value>
                <!-- mandatory | string | price currency
                -->
                <currency>EUR</currency>
            </price>
            <!-- optional | double | rent price
            sets the optional rent price for "for sale" categories. 
            use a dot for decimal
            -->
            <rent_price>
                <value>123000</value>
                <!-- mandatory | string | rent price currency
                -->
                <currency>EUR</currency>
            </rent_price>
            <!-- optional | double | deposit price
            sets the optional deposit value for "for rent" categories   
            use a dot for decimal
            -->
            <deposit_price>
                <value>123000</value>
                <!-- mandatory | string | deposit price currency
                -->
                <currency>EUR</currency>
            </deposit_price>
            <!-- mandatory | array of images
            minimum 1, maximum 60
            minimum resolution allowed: 300x300
            recommended resolution: 1280x1024
            maximum file size allowed: 5 MB
            -->
            <!-- mandatory | array of images
            minimum 1, maximum 60
            minimum resolution allowed: 300x300
            recommended resolution: 1280x1024
            maximum file size allowed: 5 MB
            -->
            <images>
                <!-- repeat element for each image -->
                <image>
                    <!-- image URL | mandatory -->
                    <url>http://domain/image1.jpg</url>
                    <!-- image text | optional -->
                    <text>image A</text>
                    <!-- image order | optional 
                    if omitted by default will be the order of the images on the array 
                    -->
                    <order>1</order>
                </image>
            </images>
            <!-- optional | property movie
            the url for a Youtube or Vimeo movie to be displayed on the advert detail page 
            -->
            <movie_url>https://www.youtube.com/watch?v=xxxxxxxx</movie_url>
            <!-- optional | virtual walk
            must be a valid URL from Youtube, Vimeo, Cupix, Matterport or Kuula
            -->
            <virtual_walk>https://www.youtube.com/watch?v=xxxxxxxx</virtual_walk>
            <!-- optional | floor plan
            URL of an image. Must be a valid image URL (shortlinks are not accepted)
            -->
            <floor_plan>http://domain/image1.jpg</floor_plan>
            <!-- mandatory | property coordinates -->
            <location>
                <!-- mandatory | latitude -->
                <lat>41.573603</lat>
                <!-- mandatory | longitude-->
                <lon>-7.214126</lon>
                <!-- optional | exact coordinates 
                by default false
                if true will display a pin in the advert details map view -->
                <exact>true</exact>
            </location>
            <!-- mandatory | array of property attributes -->
            <attributes>
                <!-- repeat element for each attribute/urn -->
                <!-- mandatory | optional tipology number
                allowed values:
                    T0      urn:concept:none
                    T1      urn:concept:1
                    T2      urn:concept:2
                    T3      urn:concept:3
                    T4      urn:concept:4
                    T5      urn:concept:5
                    T6      urn:concept:6
                    T7      urn:concept:7
                    T8      urn:concept:8
                    T9      urn:concept:9
                    T9+     urn:concept:more
                mandatory for apartments and houses
                optional for farms and estates
                ignored for other categories
                -->
                <attribute>
                    <urn>urn:concept:number-of-rooms</urn>
                    <value>urn:concept:none</value>
                </attribute>
                <!-- optional | floor number
                allowed values for apartments (rent and sales), stores (rent and sales):
                    cellar            urn:concept:cellar
                    1                 urn:concept:floor-1
                    2                 urn:concept:floor-2
                    3                 urn:concept:floor-3
                    4                 urn:concept:floor-4
                    5                 urn:concept:floor-5
                    6                 urn:concept:floor-6
                    7                 urn:concept:floor-7
                    8                 urn:concept:floor-8
                    9                 urn:concept:floor-9
                    10+               urn:concept:floor-higher-10
                    garret            urn:concept:garret
                    ground floor      urn:concept:ground-floor
                -->
                <attribute>
                    <urn>urn:concept:floor-no</urn>
                    <value>urn:concept:floor-1</value>
                </attribute>
                <!-- mandatory | optional double area: urn:concept:net-area-m2 , urn:concept:gross-area-m2, urn:concept:terrain-area-m2
                use a dot for decimal
                allowed values:
                for apartments (rent and sales), stores (rent and sales), warehouses (rent and sales), offices (rent and sales), buildings (rent and sales) and goodwill:
                    urn:concept:net-area-m2 - mandatory area element is considered the net area 
                    urn:concept:gross-area-m2 - optional element is considered the gross area
    
                for houses (rent and sales):
                    urn:concept:net-area-m2 - mandatory area element is considered the net area 
                    urn:concept:terrain-area-m2 - required element is considered the plot/terrain area
                    urn:concept:gross-area-m2 - optional element is considered the gross area

    
                for rooms for rent and garages (rent and sales):
                    urn:concept:net-area-m2 - mandatory area element is considered the net area

                for lots (rent and sales):
                    urn:concept:net-area-m2 - mandatory area element is considered the net area
                -->
                <attribute>
                    <urn>urn:concept:net-area-m2</urn>
                    <value>120</value>
                </attribute>
                <attribute>
                    <urn>urn:concept:gross-area-m2</urn>
                    <value>150.6</value>
                </attribute>
                <attribute>
                    <urn>urn:concept:terrain-area-m2</urn>
                    <value>1500</value>
                </attribute>
                <!-- optional | int | year
                property construction year
                -->
                <attribute>
                    <urn>urn:concept:construction-year</urn>
                    <value>2000</value>
                </attribute>
                <!-- optional | int | number of floors
                only for apartments (rent and sales)
                -->
                <attribute>
                    <urn>urn:concept:building-floors-num</urn>
                    <value>5</value>
                </attribute>
                <!-- optional | number of floors
                allowed values for houses (rent and sales):
                    ground floor      urn:concept:ground-floor
                    more              urn:concept:more
                    one floor         urn:concept:one-floor
                    two floors        urn:concept:two-floors
                -->
                <attribute>
                    <urn>urn:concept:floors-in-building</urn>
                    <value>urn:concept:ground-floor</value>
                </attribute>
                <!-- optional | number of bathrooms
                available for categories apartments (rent and sales) and houses (rent and sales)
                allowed values:
                    1       urn:concept:1
                    2       urn:concept:2
                    3       urn:concept:3
                    4+      urn:concept:4-or-more
                -->
                <attribute>
                    <urn>urn:concept:number-of-bathrooms</urn>
                    <value>urn:concept:2</value>
                </attribute>
                <!-- mandatory - energy certificate
                    except for categories "rooms for rent", "lots", "garages"
                    energy certificate values:
                    A+          urn:concept:a-plus
                    A           urn:concept:a
                    B           urn:concept:b
                    B-          urn:concept:b-minus
                    C           urn:concept:c
                    D           urn:concept:d
                    E           urn:concept:e
                    F           urn:concept:f
                    G           urn:concept:g"
                    Isento      urn:concept:exempt
                    if omitted by default will be urn:concept:exempt, as also refers to "In progress"
                -->
                <attribute>
                    <urn>urn:concept:energy-certificate</urn>
                    <value>urn:concept:a</value>
                </attribute>
                <!--  mandatory for apartments and houses for vacations | integer | local accommodation license identifier number
                the "/AL" suffix will be added automatically
                -->
                <attribute>
                    <urn>urn:concept:number-of-user-license</urn>
                    <value>1286529</value>
                </attribute>
                <!-- optional | int | owner vat number
                only for apartments, houses, rooms (rent)
                -->
                <attribute>
                    <urn>urn:concept:owner-vat-number</urn>
                    <value>123456</value>
                </attribute>
                <!--  optional | date | availability date
                available for apartments (rent and sales), houses (rent and sales), rooms for rent, stores for rent
                -->
                <attribute>
                    <urn>urn:concept:free-from</urn>
                    <value>2025-01-01</value>
                </attribute>
                <!-- optional | building type
                allowed values for apartments (rent and sales), rooms for rent:
                   apartment     urn:concept:apartment
                   block         urn:concept:block
                   house         urn:concept:house
                   infill        urn:concept:infill
                   loft          urn:concept:loft
                   ribbon        urn:concept:ribbon
                   tenement      urn:concept:tenement

                allowed values for houses (rent and sales):
                   detached           urn:concept:detached
                   farm               urn:concept:farm
                   residence          urn:concept:residence
                   ribbon             urn:concept:ribbon
                   semi detached      urn:concept:semi-detached
                   tenement           urn:concept:tenement

                allowed values for stores (rent and sales):
                   block                    urn:concept:block
                   historical building      urn:concept:historical-building
                   office building          urn:concept:office-building
                   private house            urn:concept:private-house
                   separate                 urn:concept:separate
                   shopping centre          urn:concept:shopping-centre
                   tenement house           urn:concept:tenement-house
                -->
                <attribute>
                    <urn>urn:concept:building-type</urn>
                    <value>urn:concept:apartment</value>
                </attribute>
                <!-- optional | building material
                allowed values for apartments (rent and sales), houses (rent and sales):
                   breezeblock              urn:concept:breezeblock
                   brick                    urn:concept:brick
                   cellular concrete        urn:concept:cellular-concrete
                   concrete                 urn:concept:concrete
                   concrete plate           urn:concept:concrete-plate
                   hydroton                 urn:concept:hydroton
                   other                    urn:concept:other
                   reinforced concrete      urn:concept:reinforced-concrete
                   silikat                  urn:concept:silikat
                   wood                     urn:concept:wood
                -->
                <attribute>
                    <urn>urn:concept:building-material</urn>
                    <value>urn:concept:breezeblock</value>
                </attribute>
                <!-- optional | building ownership
                allowed values for apartments (rent and sales):
                   full ownership         urn:concept:full-ownership
                   limited ownership      urn:concept:limited-ownership
                   share                  urn:concept:share
                   usufruct               urn:concept:usufruct
                -->
                <attribute>
                    <urn>urn:concept:building-ownership</urn>
                    <value>urn:concept:full-ownership</value>
                </attribute>
                <!-- optional | windows type
                allowed values for apartments (rent and sales), houses (rent and sales):
                   aluminium      urn:concept:aluminium
                   plastic        urn:concept:plastic
                   wooden         urn:concept:wooden
                -->
                <attribute>
                    <urn>urn:concept:windows-type</urn>
                    <value>urn:concept:aluminium</value>
                </attribute>
                <!-- optional | security types
                allowed values for apartments (rent and sales), houses (rent and sales), stores (rent and sales), warehouses (rent and sales):
                   alarm                   urn:concept:alarm
                   anti burglary door      urn:concept:anti-burglary-door
                   closed area             urn:concept:closed-area
                   entryphone              urn:concept:entryphone
                   monitoring              urn:concept:monitoring
                   roller shutters         urn:concept:roller-shutters
                -->
                <attribute>
                    <urn>urn:concept:security-types</urn>
                    <value>urn:concept:alarm</value>
                </attribute>
                <!-- optional | media types
                allowed values for apartments (rent and sales), rooms for rent:
                   cable television              urn:concept:cable-television
                   fiber optic connection        urn:concept:fiber-optic-connection
                   phone                         urn:concept:phone

                allowed values for houses (rent and sales), stores (rent and sales):
                   cable television            urn:concept:cable-television
                   cesspool                    urn:concept:cesspool
                   electricity                 urn:concept:electricity
                   fiber optic connection      urn:concept:fiber-optic-connection
                   gas                         urn:concept:gas
                   phone                       urn:concept:phone
                   sewage                      urn:concept:sewage
                   water                       urn:concept:water
                   water purification          urn:concept:water-purification

                allowed values for lots (rent and sales):
                   cesspool         urn:concept:cesspool
                   electricity      urn:concept:electricity
                   gas              urn:concept:gas
                   rafinery         urn:concept:rafinery
                   sewage           urn:concept:sewage
                   telephone        urn:concept:telephone
                   water            urn:concept:water

                allowed values for warehouses (rent and sales):
                   cesspool                    urn:concept:cesspool
                   electricity                 urn:concept:electricity
                   fiber optic connection      urn:concept:fiber-optic-connection
                   gas                         urn:concept:gas
                   phone                       urn:concept:phone
                   power                       urn:concept:power
                   sewage                      urn:concept:sewage
                   water                       urn:concept:water
                   water purification          urn:concept:water-purification
                -->
                <attribute>
                    <urn>urn:concept:media-types</urn>
                    <value>urn:concept:phone</value>
                </attribute>
                <!-- optional | extras types 
                allows duplication of name for each extras types value
                allowed values for apartments (rent and sales):
                    air conditioning                 urn:concept:air-conditioning
                    balcony                          urn:concept:balcony
                    basement                         urn:concept:basement
                    garage                           urn:concept:garage
                    garden                           urn:concept:garden
                    lift                             urn:concept:lift
                    non smoking (only rent)          urn:concept:non-smoking
                    pool                             urn:concept:pool
                    reduced mobility accessible      urn:concept:reduced-mobility-accessible
                    separate kitchen                 urn:concept:separate-kitchen
                    terrace                          urn:concept:terrace
                    two storey                       urn:concept:two-storey
                    usable room                      urn:concept:usable-room

                allowed values for houses for rent:
                    air conditioning                 urn:concept:air-conditioning
                    attic                            urn:concept:attic
                    basement                         urn:concept:basement
                    furnished                        urn:concept:furnished
                    garage                           urn:concept:garage
                    pool                             urn:concept:pool
                    garden                           urn:concept:garden
                    terrace                          urn:concept:terrace
                    balcony                          urn:concept:balcony
                    reduced mobility accessible      urn:concept:reduced-mobility-accessible

                allowed values for houses for sale:
                    air conditioning                 urn:concept:air-conditioning
                    attic                            urn:concept:attic
                    basement                         urn:concept:basement
                    garage                           urn:concept:garage
                    pool                             urn:concept:pool
                    garden                           urn:concept:garden
                    terrace                          urn:concept:terrace
                    balcony                          urn:concept:balcony
                    reduced mobility accessible      urn:concept:reduced-mobility-accessible

                allowed values for stores (rent and sales):
                    air conditioning                 urn:concept:air-conditioning
                    asphalt access                   urn:concept:asphalt-access
                    lift                             urn:concept:elevator
                    furnished                        urn:concept:furnished
                    heating                          urn:concept:heating
                    parking                          urn:concept:parking
                    reduced mobility accessible      urn:concept:reduced-mobility-accessible
                    shop window                      urn:concept:shop-window
            -->
                <attribute>
                    <urn>urn:concept:extras-types</urn>
                    <value>urn:concept:air-conditioning</value>
                </attribute>
                <attribute>
                    <urn>urn:concept:extras-types</urn>
                    <value>urn:concept:lift</value>
                </attribute>
                <!-- optional | equipment types
                allowed values for apartments (rent and sales), rooms for rent:
                   dishwasher           urn:concept:dishwasher
                   fridge               urn:concept:fridge
                   furnished            urn:concept:furnished
                   oven                 urn:concept:oven
                   stove                urn:concept:stove
                   tv                   urn:concept:tv
                   washing machine      urn:concept:washing-machine
                -->
                <attribute>
                    <urn>urn:concept:equipment-types</urn>
                    <value>urn:concept:dishwasher</value>
                </attribute>
                <!-- optional | heating
                allowed values for apartments (rent and sales):
                    boiler               urn:concept:boiler
                    central heating      urn:concept:central-heating
                    electrical           urn:concept:electrical
                    gas                  urn:concept:gas
                    other                urn:concept:other
                    tiled stove          urn:concept:tiled-stove
                    urban                urn:concept:urban
            
                allowed values for warehouses (rent and sales), garages (rent and sales):
                    yes      urn:concept:y
                    no       urn:concept:n
            -->
                <attribute>
                    <urn>urn:concept:heating</urn>
                    <value>urn:concept:central-heating</value>
                </attribute>
                <!-- optional | heating types
                allowed values for houses (rent and sales):
                    biomass              urn:concept:biomass
                    coal                 urn:concept:coal
                    electric             urn:concept:electric
                    fireplace            urn:concept:fireplace
                    gas                  urn:concept:gas
                    geothermal           urn:concept:geothermal
                    heat pump            urn:concept:heat-pump
                    oil                  urn:concept:oil
                    solar collector      urn:concept:solar-collector
                    stove                urn:concept:stove
                    urban                urn:concept:urban
            
            -->
                <attribute>
                    <urn>urn:concept:heating-types</urn>
                    <value>urn:concept:biomass</value>
                </attribute>
                <!-- optional | construction status
                allowed values for apartments (rent and sales), houses for rent, stores (rent and sales):
                   to completion      urn:concept:to-completion
                   to renovation      urn:concept:to-renovation
                   used               urn:concept:used

                allowed values for houses for sale, warehouses (rent and sales):
                   to completion         urn:concept:to-completion
                   to renovation         urn:concept:to-renovation
                   unfinished close      urn:concept:unfinished-close
                   unfinished open       urn:concept:unfinished-open
                   used                  urn:concept:used
                -->
                <attribute>
                    <urn>urn:concept:construction-status</urn>
                    <value>urn:concept:to-completion</value>
                </attribute>
                <!-- optional | use types
                allowed values for stores (rent and sales):
                   gastronomy      urn:concept:gastronomy
                   hotel           urn:concept:hotel
                   industrial      urn:concept:industrial
                   office          urn:concept:office
                   retail          urn:concept:retail
                   services        urn:concept:services

                allowed values for warehouses (rent and sales):
                   commercial         urn:concept:commercial
                   manufacturing      urn:concept:manufacturing
                   office             urn:concept:office
                   stock              urn:concept:stock
                -->
                <attribute>
                    <urn>urn:concept:use-types</urn>
                    <value>urn:concept:gastronomy</value>
                </attribute>
                <!-- optional | vicinity types
                allowed values for houses (rent and sales):
                   forest area      urn:concept:forest-area
                   lake             urn:concept:lake
                   mountains        urn:concept:mountains
                   sea view         urn:concept:sea-view

                allowed values for lots (rent and sales):
                   forest area       urn:concept:forest-area
                   lake              urn:concept:lake
                   mountains         urn:concept:mountains
                   open terrain      urn:concept:open-terrain
                   sea view          urn:concept:sea-view
                -->
                <attribute>
                    <urn>urn:concept:vicinity-types</urn>
                    <value>urn:concept:forest-area</value>
                </attribute>
                <!-- optional | terrain type
                allowed values for lots (rent and sales):
                   agricultural               urn:concept:agricultural
                   agricultural building      urn:concept:agricultural-building
                   building                   urn:concept:building
                   commercial                 urn:concept:commercial
                   developable                urn:concept:developable
                   green zone                 urn:concept:green-zone
                   habitat                    urn:concept:habitat
                   industrial                 urn:concept:industrial
                   non developable            urn:concept:non-developable
                   other                      urn:concept:other
                   recreationa                urn:concept:recreational
                   rustic                     urn:concept:rustic
                   urban                      urn:concept:urban
                -->
                <attribute>
                    <urn>urn:concept:terrain-type</urn>
                    <value>urn:concept:agricultural</value>
                </attribute>
                <!-- optional | roofing
                allowed values for houses (rent and sales):
                   asbestic tile      urn:concept:asbestic-tile
                   chopper            urn:concept:chopper
                   other              urn:concept:other
                   roofing paper      urn:concept:roofing-paper
                   sheet              urn:concept:sheet
                   shingle            urn:concept:shingle
                   slate              urn:concept:slate
                   tile               urn:concept:tile
                -->
                <attribute>
                    <urn>urn:concept:roofing</urn>
                    <value>urn:concept:asbestic-tile</value>
                </attribute>
                <!-- optional | roof type
                allowed values for houses (rent and sales):
                   diagonal      urn:concept:diagonal
                   flat          urn:concept:flat
                -->
                <attribute>
                    <urn>urn:concept:roof-type</urn>
                    <value>urn:concept:diagonal</value>
                </attribute>
                <!-- optional | non smoking
                only for rooms for rent:
                -->
                <attribute>
                    <urn>urn:concept:non-smoking</urn>
                    <value>urn:concept:yes</value>
                </attribute>
                <!-- optional | room size
                allowed values for rooms for rent:
                    one        urn:concept:one
                    two        urn:concept:two
                    three      urn:concept:three
                -->
                <attribute>
                    <urn>urn:concept:roomsize</urn>
                    <value>urn:concept:one</value>
                </attribute>
                <!-- optional | affordable rentals
                only for apartments for rent, houses for rent, rooms for rent:
                -->
                <attribute>
                    <urn>urn:concept:affordable-rentals</urn>
                    <value>urn:concept:yes</value>
                </attribute>
                <!-- optional | lighting
                only for garages (rent and sales):
                -->
                <attribute>
                    <urn>urn:concept:lighting</urn>
                    <value>urn:concept:y</value>
                </attribute>
                <!-- optional | localization
                allowed values for garages (rent and sales):
                    by the house         urn:concept:by-the-house
                    in construction      urn:concept:in-construction
                    separate             urn:concept:separate
                -->
                <attribute>
                    <urn>urn:concept:localization</urn>
                    <value>urn:concept:by-the-house</value>
                </attribute>
                <!-- optional | structure
                allowed values for garages (rent and sales):
                    brick      urn:concept:brick
                    shed       urn:concept:shed
                    tin        urn:concept:tin
                    wood       urn:concept:wood
                
                allowed values for warehouses (rent and sales):
                    brick      urn:concept:brick
                    glass      urn:concept:glass
                    shed       urn:concept:shed
                    steel      urn:concept:steel
                    tent       urn:concept:tent
                    wood       urn:concept:wood
                -->
                <attribute>
                    <urn>urn:concept:structure</urn>
                    <value>urn:concept:brick</value>
                </attribute>
                <!-- optional | fence types
                allowed values for houses (rent and sales):
                    brick         urn:concept:brick
                    concrete      urn:concept:concrete
                    hedge         urn:concept:hedge
                    metal         urn:concept:metal
                    other         urn:concept:other
                    wire          urn:concept:wire
                    wooden        urn:concept:wooden
                -->
                <attribute>
                    <urn>urn:concept:fence-types</urn>
                    <value>urn:concept:brick</value>
                </attribute>
                <!-- optional | fence
                only for lots (rent and sales), warehouses (rent and sales):
                -->
                <attribute>
                    <urn>urn:concept:fence</urn>
                    <value>urn:concept:y</value>
                </attribute>
                <!-- optional | garret type
                allowed values for houses (rent and sales):
                    unusable      urn:concept:unusable
                    usable        urn:concept:usable
                -->
                <attribute>
                    <urn>urn:concept:garret-type</urn>
                    <value>urn:concept:usable</value>
                </attribute>
                <!-- optional | market type 
                defines the type of market  
                allowed values for "for sale" categories: apartments, houses, stores, garages, warehouses:
                    secondary (default if omitted)      urn:concept:secondary
                    primary                             urn:concept:primary
                -->
                <attribute>
                    <urn>urn:concept:market</urn>
                    <value>urn:concept:primary</value>
                </attribute>
                <!-- optional | height
                defines ceiling height
                only for warehouses (rent and sales):
                -->
                <attribute>
                    <urn>urn:concept:height</urn>
                    <value>410</value>
                </attribute>
                <!-- optional | office space
                only for warehouses (rent and sales):
                -->
                <attribute>
                    <urn>urn:concept:office-space</urn>
                    <value>urn:concept:yes</value>
                </attribute>
                <!-- optional | parking
                allowed values for warehouses (rent and sales):
                    asphalt            urn:concept:asphalt
                    cobblestone        urn:concept:cobblestone
                    concrete           urn:concept:concrete
                    hard surfaced      urn:concept:hard-surfaced
                    soft surfaced      urn:concept:soft-surfaced
                -->
                <attribute>
                    <urn>urn:concept:parking</urn>
                    <value>urn:concept:asphalt</value>
                </attribute>
                <!-- optional | location
                allowed values for houses (rent and sales), lots (rent and sales):
                    city          urn:concept:city
                    country       urn:concept:country
                    suburban      urn:concept:suburban
                -->
                <attribute>
                    <urn>urn:concept:location</urn>
                    <value>urn:concept:city</value>
                </attribute>
                <!-- optional | social facilities
                only for warehouses (rent and sales)
                -->
                <attribute>
                    <urn>urn:concept:social-facilities</urn>
                    <value>urn:concept:yes</value>
                </attribute>
                <!-- optional | rent to students
                only for apartments for rent
                -->
                <attribute>
                    <urn>urn:concept:rent-to-students</urn>
                    <value>urn:concept:yes</value>
                </attribute>
                <!-- optional | boolean | auto extend
                determines whether advert has to be automatically extended or not   
                accepted values are "false" or "true" (default if omitted)
                -->
                <auto_extend>
                    <value>true</value>
                </auto_extend>
                <!-- optional | yes and no elements
                allowed values for all categories:
                    urn element for "Price negotiable"      urn:concept:price-negotiable
                    urn element for "On demand"             urn:concept:on-demand
                    urn element for "Remote services"       urn:concept:remote-services
                    
                    allowed values:
                        urn:concept:no       by default if omitted
                        urn:concept:yes      attribute(s) will be marked as yes on the advert details page
                     -->
                <attribute>
                    <urn>urn:concept:price-negotiable</urn>
                    <value>urn:concept:yes</value>
                </attribute>
            </attributes>
        </advert>
    </adverts>
</data>