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: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 <attribute> element under <attribute> 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 be 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 attribute 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 typology number
                allowed values:

                    Typology   URN                   PT value
                    =========================================
                    T0         urn:concept:none      T0

                    T1         urn:concept:1         T1

                    T2         urn:concept:2         T2

                    T3         urn:concept:3         T3

                    T4         urn:concept:4         T4

                    T5         urn:concept:5         T5

                    T6         urn:concept:6         T6

                    T7         urn:concept:7         T7

                    T8         urn:concept:8         T8

                    T9         urn:concept:9         T9

                    T9+        urn:concept:more      T9+

                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):

                    Floor Number   URN                    PT value
                    ====================================================
                    cellar         urn:concept:cellar     semi-cave

                    1              urn:concept:floor-1    1

                    2              urn:concept:floor-2    2

                    3              urn:concept:floor-3    3

                    4              urn:concept:floor-4    4

                    5              urn:concept:floor-5    5

                    6              urn:concept:floor-6    6

                    7              urn:concept:floor-7    7

                    8              urn:concept:floor-8    8

                    9              urn:concept:floor-9    9

                    10+            urn:concept:
                                   floor-higher-10        10+

                    attic          urn:concept:attic      águas furtadas

                    ground floor   urn:concept:
                                   ground-floor           rés do chão

                -->
                <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):

                    Value          URN                    PT value
                    ==================================================
                    ground floor   urn:concept:
                                   ground-floor           térreo

                    more           urn:concept:more       3 andares ou
                                                          mais

                    one floor      urn:concept:
                                   one-floor              1 andar

                    two floors     urn:concept:
                                   two-floors             2 andares

                -->
                <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:

                    Value   URN                    PT value
                    =========================================
                    1       urn:concept:1          1

                    2       urn:concept:2          2

                    3       urn:concept:3          3

                    4+      urn:concept:
                            4-or-more              4 ou mais

                -->
                <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:

                    Value    URN                    PT value
                    ===========================================
                    A+       urn:concept:a-plus     A+

                    A        urn:concept:a          A

                    B        urn:concept:b          B

                    B-       urn:concept:b-minus    B-

                    C        urn:concept:c          C

                    D        urn:concept:d          D

                    E        urn:concept:e          E

                    F        urn:concept:f          F

                    G        urn:concept:g          G

                    Isento   urn:concept:exempt     isento / em
                                                    curso

                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:

                    Value        URN                    PT value
                    ================================================
                    apartment    urn:concept:
                                 apartment              prédio

                    block        urn:concept:block      bloco de
                                                        apartamentos

                    house        urn:concept:house      isolado

                    infill       urn:concept:infill     emplty

                    loft         urn:concept:loft       loft

                    ribbon       urn:concept:ribbon     em banda

                    tenement     urn:concept:tenement   nao aparece


                allowed values for houses (rent and sales):

                    Value           URN                  PT value
                    ================================================
                    detached        urn:concept:
                                    detached             isolada

                    farm            urn:concept:farm     quinta

                    residence       urn:concept:
                                    residence            mansão/
                                                         palacete

                    ribbon          urn:concept:ribbon   em banda

                    semi detached   urn:concept:
                                    semi-detached        germinada

                    tenement        urn:concept:
                                    tenement             nao aparece


                allowed values for stores (rent and sales):

                    Value                  URN                   PT value
                    =========================================================
                    block                  urn:concept:block     bloco de
                                                                 apartamentos

                    historical building    urn:concept:
                                           historical-building   no edifício
                                                                 histórico

                    office building        urn:concept:
                                           office-building       no centro de
                                                                 escritórios

                    private house          urn:concept:
                                           private-house         na casa
                                                                 particular

                    separate               urn:concept:
                                           separate              no edifício
                                                                 separado

                    shopping centre        urn:concept:
                                           shopping-centre       no centro
                                                                 comercial

                    tenement house         urn:concept:
                                           tenement-house        bi-familiar

                -->
                <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):

                    Value                 URN                   PT value
                    ==========================================================
                    breezeblock           urn:concept:
                                          breezeblock           bloco de betão

                    brick                 urn:concept:brick     tijolo

                    cellular concrete     urn:concept:
                                          cellular-concrete     betão celular

                    concrete              urn:concept:
                                          concrete              betão

                    concrete plate        urn:concept:
                                          concrete-plate        blocos de
                                                                painéis

                    hydroton              urn:concept:
                                          hydroton              argila
                                                                expandida

                    other                 urn:concept:other     outro

                    reinforced concrete   urn:concept:
                                          reinforced-concrete   betão armado

                    silikat               urn:concept:
                                          silikat               blocos de
                                                                silicato

                    wood                  urn:concept:wood      madeira

                -->
                <attribute>
                    <urn>urn:concept:building-material</urn>
                    <value>urn:concept:breezeblock</value>
                </attribute>
                <!-- optional | building ownership
                allowed values for apartments (rent and sales):

                    Value               URN                 PT value
                    ===================================================
                    full ownership      urn:concept:
                                        full-ownership      propriedade
                                                            plena

                    limited ownership   urn:concept:
                                        limited-ownership   cooperativa

                    share               urn:concept:share   quota de
                                                            propriedade

                    usufruct            urn:concept:
                                        usufruct            usufruto/
                                                            arrendamento

                -->
                <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):

                    Value       URN                  PT value
                    ==========================================
                    aluminium   urn:concept:
                                aluminium            alumínio

                    plastic     urn:concept:
                                plastic              PVC

                    wooden      urn:concept:wooden   madeira

                -->
                <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):

                    Value                URN                  PT value
                    ========================================================
                    alarm                urn:concept:alarm    sistema de
                                                              alarme

                    anti burglary door   urn:concept:
                                         anti-burglary-door   portas e
                                                              janelas de
                                                              segurança

                    closed area          urn:concept:
                                         closed-area          nao aparece

                    entryphone           urn:concept:
                                         entryphone           video porteiro

                    monitoring           urn:concept:
                                         monitoring           vigilância

                    roller shutters      urn:concept:
                                         roller-shutters      estores
                                                              eletricos

                -->
                <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:

                    Value                    URN                 PT value
                    =====================================================
                    fiber optic              urn:concept:
                    connection               fiber-optic-
                                             connection          internet

                    phone                    urn:concept:phone   telefone


                allowed values for houses (rent and sales), stores (rent and sales):

                    Value                    URN                  PT value
                    ==========================================================
                    cesspool                 urn:concept:
                                             cesspool             fossa

                    electricity              urn:concept:
                                             electricity          eletricidade

                    fiber optic              urn:concept:
                    connection               fiber-optic-
                                             connection           internet

                    gas                      urn:concept:gas      gás

                    phone                    urn:concept:phone    telefone

                    sewage                   urn:concept:sewage   esgoto

                    water                    urn:concept:water    água

                    water purification       urn:concept:
                                             water-purification   sistema de
                                                                  filtragem de
                                                                  água


                allowed values for lots (rent and sales):

                    Value         URN                  PT value
                    ================================================
                    cesspool      urn:concept:
                                  cesspool             fossa

                    electricity   urn:concept:
                                  electricity          eletricidade

                    gas           urn:concept:gas      gás

                    rafinery      urn:concept:
                                  rafinery             fossa séptica

                    sewage        urn:concept:sewage   esgoto

                    telephone     urn:concept:
                                  telephone            telefone

                    water         urn:concept:water    água


                allowed values for warehouses (rent and sales):

                    Value                    URN                  PT value
                    ==========================================================
                    cesspool                 urn:concept:
                                             cesspool             fossa

                    electricity              urn:concept:
                                             electricity          eletricidade

                    fiber optic              urn:concept:
                    connection               fiber-optic-
                                             connection           internet

                    gas                      urn:concept:gas      gás

                    phone                    urn:concept:phone    telefone

                    power                    urn:concept:power    sistema
                                                                  trifásico

                    sewage                   urn:concept:sewage   esgoto

                    water                    urn:concept:water    água

                    water purification       urn:concept:
                                             water-purification   sistema de
                                                                  filtragem de
                                                                  água

                -->
                <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):

                    Value                         URN                  PT value
                    ================================================================
                    air conditioning              urn:concept:
                                                  air-conditioning     ar
                                                                       condicionado

                    balcony                       urn:concept:
                                                  balcony              varanda

                    basement                      urn:concept:
                                                  basement             cave

                    garage                        urn:concept:garage   garagem

                    garden                        urn:concept:garden   jardim

                    lift                          urn:concept:lift     elevador

                    non smoking (only rent)       urn:concept:
                                                  non-smoking          apenas não
                                                                       fumadores

                    pool                          urn:concept:pool     piscina

                    reduced mobility              urn:concept:
                    accessible                    reduced-mobility-    Acessibilidade
                                                  accessible           para pessoas
                                                                       com mobilidade
                                                                       reduzida

                    separate kitchen              urn:concept:
                                                  separate-kitchen     cozinha
                                                                       separada

                    terrace                       urn:concept:
                                                  terrace              terraço

                    two storey                    urn:concept:
                                                  two-storey           duplex

                    usable room                   urn:concept:
                                                  usable-room          lavandaria


                allowed values for houses for rent:

                    Value                         URN                  PT value
                    ===============================================================
                    air conditioning              urn:concept:
                                                  air-conditioning     ar
                                                                       condicionado

                    attic                         urn:concept:attic    sótão

                    basement                      urn:concept:
                                                  basement             cave

                    furnished                     urn:concept:
                                                  furnished            mobiliário

                    garage                        urn:concept:garage   garagem

                    pool                          urn:concept:pool     piscina

                    garden                        urn:concept:garden   jardim

                    terrace                       urn:concept:
                                                  terrace              terraço

                    balcony                       urn:concept:
                                                  balcony              varanda

                    reduced mobility              urn:concept:
                    accessible                    reduced-mobility-    Acessibilidade
                                                  accessible           para pessoas
                                                                       com mobilidade
                                                                       reduzida


                allowed values for houses for sale:

                    Value                         URN                 PT value
                    ===============================================================
                    air conditioning              urn:concept:
                                                  air-conditioning    ar
                                                                      condicionado

                    attic                         urn:concept:attic   sótão

                    basement                      urn:concept:
                                                  basement            cave

                    garage                        urn:concept:garage  garagem

                    pool                          urn:concept:pool    piscina

                    garden                        urn:concept:garden  jardim

                    terrace                       urn:concept:
                                                  terrace             terraço

                    balcony                       urn:concept:
                                                  balcony             varanda

                    reduced mobility              urn:concept:
                    accessible                    reduced-mobility-   Acessibilidade
                                                  accessible          para pessoas
                                                                      com mobilidade
                                                                      reduzida

                allowed values for stores (rent and sales):

                    Value                         URN                 PT value
                    ==============================================================
                    air conditioning              urn:concept:
                                                  air-conditioning    ar
                                                                      condicionado

                    asphalt access                urn:concept:
                                                  asphalt-access      acesso
                                                                      asfaltado

                    lift                          urn:concept:
                                                  elevator            elevador

                    furnished                     urn:concept:
                                                  furnished           mobiliário

                    heating                       urn:concept:
                                                  heating             aquecimento

                    parking                       urn:concept:
                                                  parking             estacionamento

                    reduced mobility              urn:concept:
                    accessible                    reduced-mobility-   Acessibilidade
                                                  accessible          para pessoas
                                                                      com mobilidade
                                                                      reduzida

                    shop window                   urn:concept:
                                                  shop-window         montra de
                                                                      loja

            -->
                <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:

                    Value             URN                  PT value
                    ===================================================
                    dishwasher        urn:concept:
                                      dishwasher           máquina de
                                                           lavar louça

                    fridge            urn:concept:fridge   frigorífico

                    furnished         urn:concept:
                                      furnished            mobiliário

                    oven              urn:concept:oven     forno

                    stove             urn:concept:stove    fogão

                    tv                urn:concept:tv       TV

                    washing machine   urn:concept:
                                      washing-machine      máquina de
                                                           lavar roupa

                -->
                <attribute>
                    <urn>urn:concept:equipment-types</urn>
                    <value>urn:concept:dishwasher</value>
                </attribute>
                <!-- optional | heating
                only one value is allowed for apartments (rent and sales):

                    Value         URN                  PT value
                    =================================================
                    boiler        urn:concept:boiler   sala da
                                                       caldeira

                    electrical    urn:concept:
                                  electrical           elétrico

                    gas           urn:concept:gas      gás

                    other         urn:concept:other    outro

                    tiled stove   urn:concept:
                                  tiled-stove          recuperador de
                                                       calor

                    urban         urn:concept:urban    aquecimento-
                                                       central

                allowed values for warehouses (rent and sales), garages (rent and sales):

                    Value   URN             PT value
                    ================================
                    yes     urn:concept:y   sim
                    no      urn:concept:n   não

            -->
                <attribute>
                    <urn>urn:concept:heating</urn>
                    <value>urn:concept:urban</value>
                </attribute>
                <!-- optional | heating types
                multiple values are allowed for houses (rent and sales):

                    Value             URN                 PT value
                    ====================================================
                    biomass           urn:concept:
                                      biomass             biomassa

                    coal              urn:concept:coal    carvão

                    electric          urn:concept:
                                      electric            aquecimento
                                                          central

                    fireplace         urn:concept:
                                      fireplace           lareira

                    gas               urn:concept:gas     gás

                    geothermal        urn:concept:
                                      geothermal          geotérmica

                    heat pump         urn:concept:
                                      heat-pump           bomba de calor

                    oil               urn:concept:oil     aquecimento a
                                                          óleo

                    solar collector   urn:concept:
                                      solar-collector     coletor solar

                    stove             urn:concept:stove   recuperador de
                                                          calor

                    urban             urn:concept:urban   aquecimento
                                                          central


            -->
                <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):

                    Value           URN                PT value
                    ===============================================
                    to completion   urn:concept:
                                    to-completion      por terminar

                    to renovation   urn:concept:
                                    to-renovation      por renovar

                    used            urn:concept:used   pronto a
                                                       habitar


                allowed values for houses for sale, warehouses (rent and sales):

                    Value              URN                PT value
                    ==================================================
                    to completion      urn:concept:
                                       to-completion      por terminar

                    to renovation      urn:concept:
                                       to-renovation      por renovar

                    unfinished close   urn:concept:
                                       unfinished-close   Fase de
                                                          acabamento

                    unfinished open    urn:concept:
                                       unfinished-open    aberto
                                                          inacabado

                    used               urn:concept:used   pronto a
                                                          habitar

                -->
                <attribute>
                    <urn>urn:concept:construction-status</urn>
                    <value>urn:concept:to-completion</value>
                </attribute>
                <!-- optional | use types
                allowed values for stores (rent and sales):

                    Value        URN                  PT value
                    =============================================
                    gastronomy   urn:concept:
                                 gastronomy           gastronomia

                    hotel        urn:concept:hotel    hotel

                    industrial   urn:concept:
                                 industrial           industrial

                    office       urn:concept:office   escritório

                    retail       urn:concept:retail   retalho

                    services     urn:concept:
                                 services             serviços
                                 

                allowed values for warehouses (rent and sales):

                    Value           URN                  PT value
                    ===============================================
                    commercial      urn:concept:
                                    commercial           retalho

                    manufacturing   urn:concept:
                                    manufacturing        fabrico

                    office          urn:concept:office   escritório

                    stock           urn:concept:stock    armazém

                -->
                <attribute>
                    <urn>urn:concept:use-types</urn>
                    <value>urn:concept:gastronomy</value>
                </attribute>
                <!-- optional | vicinity types
                allowed values for houses (rent and sales):

                    Value         URN                PT value
                    ============================================
                    forest area   urn:concept:
                                  forest-area        floresta

                    lake          urn:concept:lake   lago

                    mountains     urn:concept:
                                  mountains          montanhas

                    sea view      urn:concept:
                                  sea-view           mar


                allowed values for lots (rent and sales):

                    Value          URN                PT value
                    ================================================
                    forest area    urn:concept:
                                   forest-area        floresta

                    lake           urn:concept:lake   lago

                    mountains      urn:concept:
                                   mountains          montanhas

                    open terrain   urn:concept:
                                   open-terrain       terreno aberto

                    sea view       urn:concept:
                                   sea-view           mar

                -->
                <attribute>
                    <urn>urn:concept:vicinity-types</urn>
                    <value>urn:concept:forest-area</value>
                </attribute>
                <!-- optional | terrain type
                allowed values for lots (rent and sales):

                    Value                  URN                  PT value
                    ==========================================================
                    agricultural           urn:concept:
                                           agricultural         terreno
                                                                rústico

                    agricultural           urn:concept:
                    building               agricultural-
                                           building             terreno
                                                                agrícola

                    building               urn:concept:
                                           building             terreno urbano

                    commercial             urn:concept:
                                           commercial           terreno
                                                                industrial

                    developable            urn:concept:
                                           developable

                    green zone             urn:concept:
                                           green-zone           terreno
                                                                florestal

                    habitat                urn:concept:
                                           habitat              pequena
                                                                propriedade

                    industrial             urn:concept:
                                           industrial           terreno
                                                                industrial

                    non developable        urn:concept:
                                           non-developable

                    other                  urn:concept:other    outro

                    recreationa            urn:concept:
                                           recreational         terreno de
                                                                recreio

                    rustic                 urn:concept:rustic   terreno
                                                                rústico

                    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):

                    Value           URN                 PT value
                    ===================================================
                    asbestic tile   urn:concept:
                                    asbestic-tile       amianto

                    chopper         urn:concept:
                                    chopper             colmo

                    other           urn:concept:other   outro

                    roofing paper   urn:concept:
                                    roofing-paper       revestimento
                                                        para telhados

                    sheet           urn:concept:sheet   chapa metálica

                    shingle         urn:concept:
                                    shingle             telha

                    slate           urn:concept:slate

                    tile            urn:concept:tile    telha

                -->
                <attribute>
                    <urn>urn:concept:roofing</urn>
                    <value>urn:concept:asbestic-tile</value>
                </attribute>
                <!-- optional | roof type
                allowed values for houses (rent and sales):

                    Value      URN                PT value
                    =======================================
                    diagonal   urn:concept:
                               diagonal           inclinado

                    flat       urn:concept:flat   plano

                -->
                <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:

                    Value   URN                 PT value
                    =============================================
                    one     urn:concept:one     quarto
                                                individual

                    two     urn:concept:two     quarto duplo

                    three   urn:concept:three   quarto triplo ou
                                                superior

                -->
                <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):

                    Value             URN               PT value
                    =================================================
                    by the house      urn:concept:
                                      by-the-house      junto à casa

                    in construction   urn:concept:
                                      in-construction   no edifício

                    separate          urn:concept:
                                      separate          separado

                -->
                <attribute>
                    <urn>urn:concept:localization</urn>
                    <value>urn:concept:by-the-house</value>
                </attribute>
                <!-- optional | structure
                allowed values for garages (rent and sales):

                    Value   URN                 PT value
                    ============================================
                    brick   urn:concept:brick   construído em
                                                tijolo

                    shed    urn:concept:shed    barracão

                    tin     urn:concept:tin     barracão de metal

                    wood    urn:concept:wood    de madeira


                allowed values for warehouses (rent and sales):

                    Value   URN                 PT value
                    =========================================
                    brick   urn:concept:brick   construído em
                                                tijolo

                    glass   urn:concept:glass   de vidro

                    shed    urn:concept:shed    barracão

                    steel   urn:concept:steel   aço

                    tent    urn:concept:tent    estrutura da
                                                tenda

                    wood    urn:concept:wood    de madeira

                -->
                <attribute>
                    <urn>urn:concept:structure</urn>
                    <value>urn:concept:brick</value>
                </attribute>
                <!-- optional | fence types
                allowed values for houses (rent and sales):

                    Value      URN                  PT value
                    ==============================================
                    brick      urn:concept:brick    tijolo

                    concrete   urn:concept:
                               concrete             betão

                    hedge      urn:concept:hedge    sebe

                    metal      urn:concept:metal    metal

                    other      urn:concept:other    outro

                    wire       urn:concept:wire     malha de arame

                    wooden     urn:concept:wooden   madeira

                -->
                <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):

                    Value      URN                  PT value
                    ==========================================
                    unusable   urn:concept:
                               unusable             inabitável

                    usable     urn:concept:usable   habitável

                -->
                <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):

                    Value           URN             PT value
                    ============================================
                    asphalt         urn:concept:
                                    asphalt         asfalto

                    cobblestone     urn:concept:
                                    cobblestone     calçada

                    concrete        urn:concept:
                                    concrete        betão

                    hard surfaced   urn:concept:
                                    hard-surfaced   pavimentado

                    soft surfaced   urn:concept:
                                    soft-surfaced   não
                                                    pavimentado

                -->
                <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):

                    Value      URN                    PT value
                    ===========================================
                    city       urn:concept:city       cidade

                    country    urn:concept:country    campo

                    suburban   urn:concept:suburban   subúrbios

                -->
                <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>