4.1 Campos obligatorios emprendimientos


Inicio

API

1. Primeros pasos

3. Modelos de avisos

4. Pase a producción

5. Callbacks

6. Mostrar ubicación en mapa

7. Zona Demand

8. Integración de sólo lectura

9. Asociar inmobiliarias

XML

1. Primeros pasos

2. Ejemplos de XML por país

3. Estructura para avisos

3.1 Campos obligatorios

4. Estructura para emprendimientos

4.1 Campos obligatorios

5. Errores XML

6. ¿Cómo leer el XML de resultado?

7. Pase a producción

8. Callbacks

9. Mostrar ubicación en mapa

10. Zona Demand

Soporte

A continuación listamos las etiquetas que forman parte de la estructura del XML para emprendimientos.

El archivo debe comenzar con la etiqueta raíz <OpenNavent> y contener una fecha de modificación y la sección de <Desarrollos>.

Ejemplo

<OpenNavent>
    <fechaDeModificacion>2025-10-06</fechaDeModificacion>
    <Desarrollos>
        <Desarrollo>
            ...
        </Desarrollo>
    </Desarrollos>
</OpenNavent>

Encabezado

En la encabezado se envían los datos de contacto de la empresa encargada de elaborar el fichero. Formato a enviar en el encabezado de todos los archivos:

<publicador>
         <codigoImobiliaria>Juan Pérez</codigoImobiliaria>
         <emailAsesor>[email protected]</emailAsesor>
         <emailDeContacto>[email protected]</emailDeContacto>
         <nombreDeContacto>[email protected]</nombreDeContacto>
         <telefoneDeContato>+54 11 1234-5678</telefoneDeContato> 
</Publicador>

Título

El título del anuncio debe incluirse en el elemento Title, como llamada a la acción principal, y debe mostrarse justo encima de la descripción. Este elemento debe tener entre 10 y 100 caracteres para todas las propiedades y no debe contener tags HTML.

La descripción tiene hasta 65 mil caracteres y son obligatorios los dos campos.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
    <fechaDeModificacion>2025-10-06</fechaDeModificacion>
    <Desarrollos>
        <Desarrollo>
           <titulo><![CDATA[Lindo Apartamento a venda em São Paulo]]></titulo>
            <descripcion><![CDATA[Venta de Departamento 3 AMBIENTES en           Caballito.]]></descripcion>
        </Desarrollo>
    </Desarrollos>
</OpenNavent>

Tipo de operación

Actualmente, hay tres tipos de transacciones disponibles para publicitar propiedades:

Para informar el tipo de transacción se debe utilizar el elemento Operacion.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <fechaDeModificacion>2024-09-22T12:00:00</fechaDeModificacion>
  <Desarrollos>
    <Desarrollo>
     <tipoPropriedade>
        <idTipo><![CDATA[1]]></idTipo>
     </tipoPropriedade>
    </Desarrollo>
  </Desarrollos>
</OpenNavent>

Ubicación

Las ubicaciones de cada aviso se informan dentro del tag <localizacion> (o <Localizacion>, según el formato y vertical).

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <fechaDeModificacion>2024-09-22T12:00:00</fechaDeModificacion>
  <Desarrollos>
    <Desarrollo>
      <localizacion>
        <direccion>SAN JUAN, AV. 879</direccion>
        <idUbicacion>V1-C-1003689</idUbicacion>
        <ubicacion>San Telmo,Capital Federal,Argentina</ubicacion>
        <codigoPostal>1067</codigoPostal>
        <muestraMapa>EXACTO</muestraMapa>
        <longitud>-58.3804357</longitud>
        <latitud>-34.6220813</latitud>
      </localizacion>
    </Desarrollo>
  </Desarrollos>
</OpenNavent>

Multimedia

Todas las fotos, videos, planos y recorridos 360 deben estar dentro del nodo multimedia.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <fechaDeModificacion>2024-09-22T12:00:00</fechaDeModificacion>
  <Desarrollos>
    <Desarrollo>
     <multimedia>
       <planos>
          <plano>
            <urlImagen>URL_IMAGEN</urlImagen>
            <titulo>TITULO_PLANO</titulo>
         </plano>
      </planos>
      <imagenes>
         <imagen>
            <urlImagen>URL_IMAGEN</urlImagen>
            <titulo>TITULO_IMAGEN</titulo>
          </imagen>
      </imagenes>
      <videos>
        <video>
            <codigoVideo>CODIGO_VIDEO</codigoVideo>
            <titulo>TITULO_VIDEO</titulo>
          </video>
        </videos>
        <recorridos360>
           <recorrido360>
             <codigoRecorrido360>CODIGO_360</codigoRecorrido360>
             <titulo>TITULO_360</titulo>
          </recorrido360>
        </recorridos360>
      </multimedia>
    </Desarrollo>
  </Desarrollos>
</OpenNavent>

Tipo de publicación

Para informar el tipo de publicación se debe utilizar el elemento <tipoDePublicacion>. Mediante este tag tipoDePublicacion, se puede indicar la exposición del aviso que se desea publicar. La exposición de los avisos se ordena de la siguiente manera:

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <fechaDeModificacion>2024-09-22T12:00:00</fechaDeModificacion>
  <Desarrollos>
    <Desarrollo>
      <publicacion>
        <tipoDePublicacion><![CDATA[HOME]]></tipoDePublicacion>   		
      </publicacion>
   </Desarrollo>
  </Desarrollos>
</OpenNavent>

<aside> ⚠️

Importante: para que el envío de ofertas como planes Destacado, Super Destacado funcione correctamente, asegúrese de que tenga crédito disponible.

</aside>


Ejemplo completo de un XML

A continuación, se presenta un ejemplo simplificado:

<OpenNavent>
    <fechaDeModificacion>2025-10-06</fechaDeModificacion>
    <Desarrollos>
        <Desarrollo>
            <codigoAviso>PROYECTO123</codigoAviso>
            <titulo>Residencias del Parque</titulo>
            <localizacion>
                <direccion>Avenida Siempre Viva 742</direccion>
                <idUbicacion>12345</idUbicacion>
            </localizacion>
            <publicador>
                <codigoInmobiliaria>MI-CODIGO-CLIENTE</codigoInmobiliaria>
            </publicador>

            <unidades>
                <unidad>
                    <codigoAviso>PROYECTO123-DEPTO-A</codigoAviso>
                    <titulo>2 ambientes luminoso con amenities</titulo>
                    <caracteristicas>
                        <caracteristica>
                            <id>2</id> <valor>50</valor>
                        </caracteristica>
                    </caracteristicas>
                    <precios>
                        <precio>
                            <monto>110000</monto>
                            <moneda>USD</moneda>
                            <operacion>Venta</operacion>
                        </precio>
                    </precios>
                    <multimedia>
                        <imagenes>
                            <imagen>
                                          <urlImagen><https://ejemplo.com/foto_depto_a1.jpg></urlImagen>
                            </imagen>
                        </imagenes>
                    </multimedia>
                </unidad>

                <unidad>
                    <codigoAviso>PROYECTO123-DEPTO-B</codigoAviso>
                    <titulo>3 ambientes en esquina, vista panorámica</titulo>
                    ...
                </unidad>
            </unidades>
            </Desarrollo>
        </Desarrollos>
</OpenNavent>

Eliminar un aviso (Baja)

Para eliminar un aviso, el mismo no debe ser enviado en el XML.

Unidades

Dentro de <unidades>, por cada departamento, casa o lote, debe haber una etiqueta <unidad>. Esta es la información que el comprador final ve como un aviso individual.