Especificación de importación XML

1. Empezando

Bienvenido a la Especificación Europea de Importación XML de Bienes Raíces. Este documento proporciona todos los detalles técnicos necesarios para crear un feed de propiedades que se integre con nuestra plataforma.

2. Visión

El feed XML de bienes raíces europeos es un alimentación absoluta, lo que significa que debe contener todas tus propiedades activas cada vez que se genera. Las propiedades que no estén incluidas en el feed se eliminarán automáticamente de nuestra plataforma.

Cómo se procesan las propiedades

3. Directrices y convenciones

Requerimientos Técnicos

• Todas las etiquetas XML DEBE estar en minúsculas
• La alimentación DEBE estar codificado en UTF-8
• Los saltos de línea en las descripciones deben utilizar caracteres de nueva línea reales (\n)
• Do use CDATA (secciones)
• Las URL deben ser absolutas (incluir URL completas) https:// prefijo)
• Cada cuenta requiere una URL de feed única

Estándares de formato de datos

4. Estructura del feed

Cada feed sigue esta estructura básica con un elemento raíz que contiene la identificación del feed, información del agente y uno o más nodos de propiedad.

<?xml version="1.0" encoding="UTF-8"?>
<root>

    <european_realestate>
        <feed_version>1</feed_version>
    </european_realestate>

    <agent>
        <id>YOUR_AGENT_ID</id>
        <name>Agency Name</name>
        <email>contact@agency.com</email>
        <!-- Additional agent fields... -->
    </agent>

    <property>
        <!-- Property 1 fields... -->
    </property>

    <property>
        <!-- Property 2 fields... -->
    </property>

    <!-- Additional properties... -->

</root>

Campos del nodo del agente

5. Referencia de nodos de propiedad

Campos centrales

<id>987654</id>

<date>2026-01-08 12:00:00</date>

<ref>ABC-123</ref>

Precios

<price>250000</price>

<currency>EUR</currency>

<price_period>month</price_period>

Ubicación

<country_code>ES</country_code>

<town>Marbella</town>

<region>Málaga</region>

<postcode>29600</postcode>

<location_detail>Costa del Sol</location_detail>

<location>
    <latitude>36.5108</latitude>
    <longitude>-4.8855</longitude>
</location>

Detalles de la propiedad

<type>apartment</type>

<condition>good_condition</condition>

<bedrooms>3</bedrooms>
<bathrooms>2</bathrooms>
<rooms>6</rooms>
<garage>1</garage>

<year_built>2020</year_built>

<surface_area>
    <built>150</built>
    <plot>500</plot>
</surface_area>

<energy_rating>
    <consumption>B</consumption>
    <emissions>C</emissions>
</energy_rating>

Contenido

<title>Stunning 3-Bedroom Apartment with Sea Views</title>

<desc>Beautiful modern apartment located in the heart of Marbella...</desc>

<url>https://example.com/property/123456</url>

<notes>Key available at office. Call before viewing.</notes>

Medios de Comunicación

<images>
    <image id="1">
        <url>https://example.com/images/main.jpg</url>
        <title>Living Room</title>
    </image>
    <image id="2">
        <url>https://example.com/images/bedroom.jpg</url>
        <title>Master Bedroom</title>
    </image>
</images>

<virtual_tour>https://my.matterport.com/show/?m=XXXXX</virtual_tour>

<video>
    <url>https://youtube.com/watch?v=XXXXX</url>
    <type>youtube</type>
</video>

<features>
    <feature>swimming_pool</feature>
    <feature>air_conditioning</feature>
    <feature>sea_views</feature>
</features>

6. Tipos de propiedad

Utilice estos valores para el <type> :

Apartamentos

Propiedades Comerciales

Casas de campo

Tierra y ruinas

Otra

Casas de pueblo

Villas

7. Lista de características

Incluya únicamente las características que se aplican a su propiedad:

8. Países admitidos

Utilice los códigos ISO 3166-1 alfa-2 para <country_code> :

9. Codificación de caracteres

Tu feed DEBE estar codificado en UTF-8Los caracteres especiales en el contenido del texto deben escaparse correctamente:

10. Prueba de tu feed

Paso 1: Validar la estructura XML

Antes de enviar su feed, valídelo utilizando un validador XML:

• Servicio de Validación de marcado W3C
• XMLValidation.com
• La mayoría de los navegadores modernos (abre el archivo XML directamente)

Paso 2: Verificar la codificación de caracteres

Verifique que su feed esté codificado correctamente en UTF-8:

• Comprobador de internacionalización del W3C

Paso 3: Verificar los campos obligatorios

Asegúrese de que todos los campos obligatorios estén presentes para cada propiedad:

• <id> — Identificación única de la propiedad
• <date> — Fecha de la última modificación
• <price> — Precio de la propiedad
• <status> — Estado de venta/alquiler
• <type> — Tipo de propiedad
• <country_code> — Código de país ISO
• <town> — Nombre de la ciudad/pueblo
• <desc> — Descripción de la propiedad

11. Automatización de actualizaciones

Una vez aprobado su feed, nuestro sistema sincroniza automáticamente sus propiedades diariamente.

Programación de sincronización

• Los feeds se procesan automáticamente cada 24 horas
• El procesamiento normalmente ocurre entre 01:00 - 05:00 CEST
• Los feeds grandes pueden tardar más tiempo en procesarse

BUENAS PRÁCTICAS

• Incluir siempre TODAS las propiedades activas en tu feed
• Actualizar el <date> campo cuando cambian los datos de la propiedad
• Asegúrese de que la URL de su feed se mantenga coherente y accesible
• Monitorea cualquier error de validación en tu panel de control

12. Obtener ayuda

Si tiene preguntas o encuentra problemas con su fuente XML:

• Correo electrónico: info@european.realestate
• Formulario de contacto: european.realestate/contact

Al contactar con el soporte, incluya:

• Su ID de agente
• La URL de tu feed
• Una descripción del problema
• Cualquier mensaje de error recibido