8. Integración de sólo lectura
4. Estructura para emprendimientos
6. ¿Cómo leer el XML de resultado?
El archivo debe comenzar con la declaración estándar: codificación="UTF-8":
<?xml version="1.0" encoding="UTF-8"?>
A continuación se define la estructura del XML.
El tag que debe tener el archivo como root del XML, debe ser <OpenNavent>, es el tag de más jerarquía, los demás tags están contenidos en él.
Este tag es utilizado para indicar la fecha de creación del archivo XML.
El propósito de este dato es evitar el reemplazo de un aviso de tipo emprendimiento modificado mediante la API posteriormente a la creación del XML.
De esta manera, si el XML fue generado a las 10:30AM y el emprendimiento modificado por la API a las 10:40AM, cuando se procese el XML no se modificará el emprendimiento.
El valor debe ser enviado en formato Unix Timestamp en milisegundos.
<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
...
</Desarrollo>
</Desarrollos>
</OpenNavent>
El archivo XML debe seguir la estructura específica que detallamos a continuación. Cada aviso de tipo emprendimiento debe estar contenido en el nodo <Desarrollo>.
Ejemplo
<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
..
</Desarrollo>
<!-- Más emprendimientos -->
</Desarrollos>
</OpenNavent>
El campo <codigoAviso> es el que contiene la referencia principal de tu aviso de tipo emprendimiento, la clave por la cual podrás acceder al mismo y a todos los datos relacionados a partir del momento en que se envié el anuncio por primera vez.
El <codigoAviso> debe ser único para todas las propiedades que se manejen desde la integración.
El contenido puede ser un número o un código alfanumérico, depende exclusivamente de la forma de identificación utilizada por la inmobiliaria, pero debe ser único y no repetirse dentro del XML. El mismo no podrá contener más de 100 caracteres, además se deben evitar tildes.
<aside> 🚨
Este dato es obligatorio
</aside>
<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
<codigoAviso>REO475061</codigoAviso>
</Desarrollo>
</Desarrollos>
</OpenNavent>
El campo <claveReferencia> define una referencia propia de la inmobiliaria para identificar al aviso. No es obligatorio y en caso de existir no es necesario que sea única.
El contenido puede ser un número o un código alfanumérico, depende exclusivamente de la forma de identificación utilizada por la inmobiliaria.
El contenido puede ser un número o un código alfanumérico, depende exclusivamente de la forma de identificación utilizada por la inmobiliaria.
<?xml version="1.0" encoding="UTF-8" ?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
<claveReferencia>ABC-123</claveReferencia>
</Desarrollo>
</Desarrollos>
</OpenNavent>
El tipo de propiedad se define con el tag <tipoDePropiedad>.
Dentro de este tag, están contenidos los tags idTipo, idSubtipo, tipo y subTipo.
<aside> 🚨
Este dato es obligatorio.
</aside>
Este tag es utilizado para indicar el tipo de propiedad que deseamos publicar.
Los id’s disponibles de los tipos de propiedad, para cada país, pueden obtenerse consultando el EndPoint de la API: /v1/tipopropiedades
<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
<tipoDePropiedad>
<idTipo><![CDATA[33]]></idTipo>
</tipoDePropiedad>
</Desarrollo>
</Desarrollos>
</OpenNavent>
Este tag es utilizado para indicar tipo de propiedad que deseamos publicar.
Los valores disponibles de los tipos de propiedades para cada país pueden obtenerse consultando el EndPoint de la API: /v1/tipopropiedades. Debe tomarse el valor de la key nombre, del resultado obtenido al usar el endpoint.
<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
<tipoDePropiedad>
<tipo><![CDATA[Desarrollo horizontal]]></tipo>
</tipoDePropiedad>
</Desarrollo>
</Desarrollos>
</OpenNavent>
Algunos tipos de propiedades cuentan con subtipos de Propiedades.
Los valores disponibles de cada subtipo de propiedad pueden obtenerse consultando el EndPoint de la API: /v1/tipopropiedades/{idtipopropiedad}/subtipos
<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
<tipoDePropiedad>
<idTipo><![CDATA[33]]></idTipo>
<idSubTipo><![CDATA[26]]></idSubTipo>
</tipoDePropiedad>
</Desarrollo>
</Desarrollos>
</OpenNavent>
Algunos tipos de propiedades cuentan con subtipos
Los valores disponibles de los tipos de propiedades para cada país pueden obtenerse consultando el EndPoint de la API: /v1/tipopropiedades/idtipopropiedad/subtipos. Debe tomarse el valor de la key nombre, del resultado obtenido al usar el endpoint.
<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
<fechaDeModificacion><![CDATA[1764583681966]]></fechaDeModificacion>
<Desarrollos>
<Desarrollo>
<tipoDePropiedad>
<tipo><![CDATA[Desarrollo horizontal]]></tipo>
<subTipo><![CDATA[Country]]></subTipo>
</tipoDePropiedad>
</Desarrollo>
</Desarrollos>
</OpenNavent>