Especificaciones para el formato XCP
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 |