Especificaciones para el formato XCP

Extensión Inmoenter

En este documento se intenta describir de una forma simple y concreta el formato a utilizar para construir un XML que contenga la información de propiedades. Este documento está dirigido a todos aquellos que quieran desarrollar un sistema automatizado para la creación de dicho XML. Suponemos que el lector tiene conocimientos en sistemas de información relacionados con los lenguajes XML y los elementos de validación XML Schema, así como estar familiarizado con el diseño de bases de datos y tipos de datos. En los elementos utilizados en la estructura del documento XML no hemos querido utilizar abreviaturas, entendemos que algunas veces las abreviaturas pueden llevar a confusiones y que el objeto de estructura es que sea creada de forma automatizada así que pensamos que no deber ser ningún problema utilizar elementos con palabras completas, aunque la longitud final de caracteres en el elemento sea grande. Para las uniones de palabras utilizamos una inicial mayúscula. Así tendremos elementos tales como <observacionesCaracteristicas> o <centrosComerciales> y no <observ-caract> o <centcomerc> difíciles en lectura o recordar donde comienza o termina la abreviatura.

Para más información sobre XML y XML Schema puede consultar la siguiente dirección, http://www.w3c.org/XML y http://www.w3c.org/XML/Schema

 

 

Estructura base XCP

El formato XCP es un formato XML creado por SpainHouses.net.

El formato base es suficiente para importar propiedades completas.

La documentación oficial del formato XCP puede encontrarse en: https://www.spainhouses.net/es/inmobiliarias/especificaciones-publicacion.html

 

Extensión Inmoenter

Esta extensión es una ampliación del formato XCP desarrollada para importar/exportar información
pública de propiedades manejadas desde un sistema de Gestión Inmobiliaria Inmoenter, teniendo en
cuenta los datos adicionales que este sistema soporta.

Al tratarse de una ampliación del formato XCP básico, es totalmente compatible con este, que añade
(nunca altera o invalida) información a cada propiedad contenida.

Más documentación:

https://v2.inmoenter.com/api/xcpExample.xml
XML de ejemplo con la extensión Inmoenter

https://v2.inmoenter.com/api/xcp.xsd
XML Schema (.XSD)

https://v2.inmoenter.com/api/xcpHelpers.xml
XML con tablas de campos codificados (incluidos las necesarias para la extensión).

 

Los elementos adicionales de esta extensión se incluyen dentro de un elemento <extensionInmoenter>, que a su vez, se ubica dentro de cada elemento <propiedad> que describe la información de un inmueble.
El elemento <extensionInmoenter> no es obligatorio, por lo que cada propiedad puede contenerlo o no; por otra parte sólo puede aparecer una vez por cada propiedad.
De la misma manera, todos los elementos contenidos en <extensionInmoenter> son opcionales.

Siguiendo la noma del formato XCP básico, los campos codificados que referencian valores en otras tablas tienen el prefijo tipo, y son los siguientes:

tipoCocina, tipoAgua, tipoAcceso, tipoSalon y tipoLuz

La correspondencia entre los códigos numéricos y los valores que representan para cada campo puede encontrarse en https://v2.inmoenter.com/api/xcpHelpers.xml.

La mayor parte de los campos de la extensión Inmoenter son obvios y no requieren mayor explicación, sin embargo existen algunos que si conviene detallar, ya sea por su significado o por su estructura:

Campos ibi, reciboAgua, reciboLuz y reciboTelefono: Sólo tienen sentido en las propiedades en alquiler e indican si estos recibos están incluidos en el precio o no.

Campo tiempoEspera: Sólo válido para propiedades en construcción; señala el plazo, en meses, en que la propiedad será entregada.

Campo superficieTotalExt: Amplia la información del campo superficieTotal del formato XCP básico, permitiendo indicar una unidad de medida específica para este valor.

Campo hipoteca y relacionados: Sólo para propiedades en venta; indica si la propiedad tiene o no hipoteca y su parámetros.

Campo zonaExt: Amplia la información del campo zona del formato básico, incluyendo las versiones en los diferentes idiomas, de la misma manera que los campos del tipo tipoDescripcion.

Campo internacional y relacionados: indica si la propiedad está ubicada en el extranjero y, si es así, el país, el estado y la localidad.
El campo paisInternacional está habilitado para poder expresar el país en los diferentes idiomas, de la misma manera que los campos del tipo tipoDescripcion.

 

 

Campos de la extensión Inmoenter

Tipo dato Bloque lógico Valor semántico Extra Tipo dato XSD
publicidad caracteres general xs:string
horarioVisita caracteres general xs:string
exclusiva lógico general xs:boolean
cartel lógico general xs:boolean
planos lógico general xs:boolean
escritura lógico general xs:boolean
ibi lógico general xs:boolean
subvencion lógico general xs:boolean
reciboAgua lógico general xs:boolean
reciboLuz lógico general xs:boolean
reciboTelefono lógico general xs:boolean
 
tiempoEspera entero estado cantidad (meses) xs:integer
 
superficieTotalExt decimal superficies cantidad decimal tipoSuperficiesExt
superficiePatio decimal superficies tipoSuperficies
 
hipoteca lógico precios xs:boolean
cantidadHipoteca entero precios xs:integer
interesHipoteca decimal precios xs:decimal
duracionHipoteca caracteres precios xs:string
cuotaHipoteca entero precios xs:integer
 
zonaExt caracteres ubicación tipoDescripcion
internacional lógico ubicación xs:boolean
paisInternacional caracteres ubicación tipoInternacional
estadoInternacional caracteres ubicación xs:normalizedString
localidadInternacional caracteres ubicación xs:normalizedString
direccion caracteres ubicación xs:string
 
dormitoriosDobles entero estructura cantidad xs:integer
dormitoriosSimples entero estructura cantidad xs:integer
numeroTerrazas entero estructura cantidad xs:integer
tipoCocina entero estructura asociado a tcocina xs:integer
tipoSalon entero estructura asociado a tsalon xs:integer
lavadero lógico estructura xs:boolean
despensa lógico estructura xs:boolean
patio lógico estructura xs:boolean
vistasAlMar lógico estructura xs:boolean
 
tipoAgua entero características asociado a tagua xs:integer
tipoLuz entero características asociado a tluz xs:integer
tipoAcceso entero características asociado a tacceso xs:integer
distanciaAcceso entero características cantidad xs:integer
unidadDistanciaAcceso caracteres características xs:string
tipoOfertaIE caracteres características oferta en el formato de IE xs:integer
alquilerInformacion caracteres Información en diferentes idiomas de las condiciones de alquileres de vacaciones o temporadas xs:string
ocupaciones complejo fechas no disponibles en alquileres vacacionales y temporadas xs:string
 
url caracteres url del detalle de la propiedad xs:anyURI

 

 

 

Histórico de cambios

Fecha Descripción
15/05/2025 Añadido tipos para ofertas especiales (vacaciones y temporadas)
22/04/2025 Revision de campos
23/09/2021 Versión inicial