4.1 Campos obrigatórios imóvel novos

Inicio

API

1. Primeiros passos

3. Modelos de anúncios da API

4. Entrar em produção

5. Callbacks

6. Mostrar localização no mapa

8. Integração ReadOnly

9.Associar Imobiliárias

XML

1. Primeiros passos

2. Exemplos de XML por país

3. Estrutura para Anúncios

3.1 Campos obrigatórios

4. Estrutura para Lançamentos

4.1 Campos obrigatórios

5. Erros comuns XML

6. Como ler o XML do resultado?

7. Passar para produção

8. Callbacks

9. Mostrar localização no mapa

Médio

Abaixo listamos as tags que fazem parte da estrutura XML para startups.

O arquivo deve começar com a tag raiz <OpenNavent> e contém uma data de modificação e a seção <Lancamentos>.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
  <Lancamentos>
    <Lancamento>
      <codigoAnuncio>12345</codigoAnuncio>
     <codigoReferencia>ABC-123</codigoReferencia>
   </Lancamento>
  </Lancamento>
</OpenNavent>

Cabeçalho

Os dados de contato da empresa responsável pela elaboração do arquivo são enviados no Cabeçalho.Formato para enviar no cabeçalho de todos os arquivos:

<publicador>
         <codigoImobiliaria>Juan Pérez</codigoImobiliaria>
         <emailAsesor>[email protected]</emailAsesor>
         <emailContato>[email protected]</emailContato>
         <nomeContato>[email protected]</nomeContato>
         <telefoneContato>+54 11 1234-5678</telefoneContato> 
</Publicador>

Título

O título do anúncio deve ser incluído no elemento Título, como a chamada para ação principal, e deve ser exibido diretamente acima da descrição. Este elemento deve ter entre 10 e 100 caracteres para todas as propriedades e não deve conter tags HTML.

A descrição tem até 65 mil caracteres e ambos os campos são obrigatórios.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
    <dataModificacao>2025-10-06</dataModificacao>
    <Lancamentos>
        <Lancamento>
           <titulo><![CDATA[Lindo Apartamento a venda em São Paulo]]></titulo>
            <<descricao>><![CDATA[venda em São Paulo.]]></<descricao>>
        </Lancamento>
    </Lancamentos>
</OpenNavent>

Tipo de operação

Atualmente, há três tipos de transações disponíveis para listar propriedades:

Para informar o tipo de transação, o elemento deve ser usadoOperação.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
  <Lancamentos>
    <Lancamento>
      <precos>
       <preco>
         <operacao><![CDATA[VENTA]]></operacao>
         <quantidade><![CDATA[180000]]></quantidade>
         <moeda><![CDATA[BRL]]></moeda>
        <preco>
     </precos>
    </Lancamento>
  </Lancamentos>
</OpenNavent>

Localização

Os locais de cada anúncio são relatados dentro da tag <location> (ou <Localizacion>, dependendo do formato e da vertical).

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
  <Lancamentos>
    <Lancamento>
    <localizacao>
      <endereco>Avenida Paulista, 900</endereco>
      <idLocalidade>V1-D-525243</idLocalidade>
      <mostrarMapa>EXACTO</mostrarMapa>
      <latitude>-23.565383</latitude>
      </localizacao>
    </Lancamento>
  </Lancamentos>
</OpenNavent>

Multimídia

Todas as fotos, vídeos, plantas e tours 360 devem estar dentro do nó multimídia.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
  <Lancamentos>
    <Lancamento>
     <multimidia>
       <plantas>
          <planta>
            <urlImagem>URL_IMAGEN</urlImagem>
            <titulo>TITULO_PLANO</titulo>
         </planta>
      </plantas>
      <imagens>
         <imagem>
            <urlImagem>URL_IMAGEN</urlImagem>
            <titulo>TITULO_IMAGEN</titulo>
          </imagem>
      </imagens>
      <videos>
        <video>
            <codigoVideo>CODIGO_VIDEO</codigoVideo>
            <titulo>TITULO_VIDEO</titulo>
          </video>
        </videos>
        <tours360>
           <tour360>
             <codigoTour360>CODIGO_360</codigoTour360>
             <titulo>TITULO_360</titulo>
          </tour360>
        </tours360>
      </multimidia>
    </Lancamento>
  </Lancamentos>
</OpenNavent>

Etapa de lançamento

Se usa para informar el tipo de estado del desarrollo se debe utilizar el elemento etapaLancamento.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
  <Lancamentos>
    <Lancamento>
      <etapaLancamento>
        <![CDATA[Em Construção]]>
      </etapaLancamento>
    </Lancamento>
  </Lancamentos>
</OpenNavent>

Tipo de publicação

Para informar o tipo de publicação, deve-se utilizar o elemento<Tipo de postagem>. Usando esta tag PublicationType, você pode especificar a exibição do anúncio que deseja publicar. A exibição do anúncio é ordenada da seguinte forma:

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
  <Lancamentos>
    <Lancamento>
      <publicacao>
        <<tipoPublicacao>><![CDATA[HOME]]></<tipoPublicacao>>   		
      </publicacao>
   </Lancamento>
  </Lancamentos>
</OpenNavent>

<aside> ⚠️

Importante: para que as ofertas dos planos Destaque e Super Destaque funcionem corretamente, certifique-se de ter crédito disponível.

</aside>

Exemplo completo de um XML

Aqui está um exemplo simplificado:

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
  <Lancamentos>
    <Lancamentos>  
       "<codigoAnuncio>ABC-123</codigoAnuncio>
         <<titulo><![CDATA[Lindo Apartamento a venda em São Paulo]]></titulo>
         <<descricao>><![CDATA[venda em São Paulo.]]></<descricao>>
          <tipoPropriedade>
            <idTipo><![CDATA[34]]></idTipo>
          </tipoPropriedade>
          <multimidia>
              <plantas>
          <planta>
            <urlImagem>URL_IMAGEN</urlImagem>
            <titulo>TITULO_PLANO</titulo>
         </planta>
      </plantas>
      <imagens>
         <imagem>
            <urlImagem>URL_IMAGEN</urlImagem>
            <titulo>TITULO_IMAGEN</titulo>
          </imagem>
      </imagens>
      <videos>
        <video>
            <codigoVideo>CODIGO_VIDEO</codigoVideo>
            <titulo>TITULO_VIDEO</titulo>
          </video>
        </videos>
        <tours360>
           <tour360>
             <codigoTour360>CODIGO_360</codigoTour360>
             <titulo>TITULO_360</titulo>
          </tour360>
        </tours360>
      </multimidia>
    <localizacao>
         <endereco>Avenida Paulista, 900</endereco>
         <idLocalidade>V1-D-525243</idLocalidade>
         <mostrarMapa>EXACTO</mostrarMapa>
         <latitude>-23.565383</latitude>
      </localizacao>
     <publicacao>
        <<tipoPublicacao>><![CDATA[DESARROLLOS_HOME]]></<tipoPublicacao>>   		
      </publicacao>
      <publicador>
         <codigoImobiliaria>Juan Pérez</codigoImobiliaria>
         <emailAsesor>[email protected]</emailAsesor>
         <emailContato>[email protected]</emailContato>
         <nomeContato>[email protected]</nomeContato>
         <telefoneContato>+54 11 1234-5678</telefoneContato> 
   </Publicador>
   <unidades> 
        <unidad> 
       <codigoAnuncio>ABC-123</codigoAnuncio>
         <tipoPropriedade>
            <idTipo><![CDATA[2]]></idTipo>
          </tipoPropriedade>
         <<titulo><![CDATA[Lindo Apartamento a venda em São Paulo]]></titulo>
         <<descricao>><![CDATA[venda em São Paulo.]]></<descricao>>
         <caracteristicas>
           <caracteristica>
             <nome><![CDATA[SUPERFICIE_TOTAL]]></nome> 
             <id><![CDATA[CFT100]]></id>
             <valor>![CDATA[100000]]</valor>
             </caracteristica>
          </caracteristicas>
         <precos>
          <preco>
            <operacao><![CDATA[VENTA]]></operacao>
            <quantidade><![CDATA[VENTA]]></quantidade>
            <moeda><![CDATA[VENTA]]></moeda>
          <preco>
         </precos>        
         <multimidia>
           <plantas>
             <planta>
               <urlImagem>URL_IMAGEN</urlImagem>
               <titulo>TITULO_PLANO</titulo>
             </planta>
           </plantas>
          <imagens>
            <imagem>
             <urlImagem>URL_IMAGEN</urlImagem>
             <titulo>TITULO_IMAGEN</titulo>
          </imagem>
         </imagens>
         <videos>
          <video>
            <codigoVideo>CODIGO_VIDEO</codigoVideo>
            <titulo>TITULO_VIDEO</titulo>
          </video>
        </videos>
        <tours360>
           <tour360>
             <codigoTour360>CODIGO_360</codigoTour360>
             <titulo>TITULO_360</titulo>
          </tour360>
        </tours360>
      </multimidia>
    <etapaDesarrollo>"En Pozo"</etapaDesarrollo>
   </unidad> 
   </unidades> 
    </Lancamento>
  </Lancamentos>
</OpenNavent>

Excluir um anúncio (Cancelar inscrição)