3.1 Campos obrigatórios anúncios

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

O arquivo XML deve seguir a estrutura específica detalhada abaixo. Cada anúncio deve estar contido no nó**<Imovel>**.

Ejemplo

<?xml versão="1.0" codificação="UTF-8"?>
<OpenNavent>
    <dataModificacao>2024-09-22T12:00:00</dataModificacao>
   <Imoveis>
    <Imovel>
       <codigoAnuncio>12345</codigoAnuncio>
    </Imovel>
   </Imoveis>
</OpenNavent>

<aside> ⚠️

Importante: o elemento código Anúncio deve ser único e não pode ser repetido.

</aside>

Formato de arquivo XML

O arquivo deve começar com a declaração padrão: codificação="UTF-8":

<?xml versão="1.0" codificação="UTF-8"?>

Cabeçalho

No cabeçalho são enviados os dados de contato da empresa encarregada de elaborar o ficheiro (arquivo). Formato a enviar no cabeçalho de todos os arquivos:

<publicador>
         <codigoImobiliaria>32444</codigoImobiliaria>
         <emailUsuario>[email protected]</emailUsuario>
         <emailContato>[email protected]</emailContato>
         <nomeContato>João Paulo</nomeContato>
         <telefoneContato>1234-5678</telefoneContato> 
</publicador>

Título

O título do anúncio deve ser incluído no elemento Title, como chamada à ação principal, e deve ser mostrado logo acima da descrição. Este elemento deve ter entre 10 e 100 caracteres para todos os imóveis e não deve conter tags HTML.

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

<?xml versão="1.0" codificação="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
<Imoveis>
    <Imovel>
<título><![CDATA[Lindo Apartamento a venda em São Paulo]></título>
    </Imovel>
</Imoveis>
</OpenNavent>

Tipo de operação

Atualmente, há três tipos de transações disponíveis para publicar imóveis:

Para informar o tipo de transação, deve-se utilizar o elemento Operação

<?xml versão="1.0" codificação="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
 <Imoveis>
    <Imovel>
       <precos>
         <preco>
           <quantidade>180000</quantidade> 
           <moeda>BRL</moeda>
           <operacao>Venta</operacao>
          </preco>
        </precos>
      </Imovel>
  </Imoveis>
</OpenNavent>

Localização

As localizações de cada anúncio são informadas dentro da tag <localizacion>  (o <Localizacion>, dependendo do formato e da vertical).

<?xml versão="1.0" codificação="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
 <Imoveis>
    <Imovel>
      <localizacao>
         <endereco>Avenida Paulista 900</endereco>
         <idLocalidade>V1-D-525243</idLocalidade>
         <mostrarMapa>EXACTO</mostrarMapa>
         <latitude>-34.6216993</latitude>
         <longitude>46.651447</longitude>
       </localizacao>
    </Imovel>
 </Imoveis>
</OpenNavent>

Multimídia

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

<?xml versão="1.0" codificação="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
 <Imoveis>
    <Imovel>
     <multimidia>
        <plantas>
          <planta>
          <urlImagem> <![CDATA[https://
                 www.photo.net/planta_cozinha.jpg]]></urlImagem>
         <titulo>Cocina</titulo>
         </planta>
        </plantas>
         <imagens>
           <imagem>
            <urlImagem><![CDATA[https:
                //www.photo.net/img_123.jpg]]></urlImagem>
            <titulo>Hall de Entrada</titulo>
            </imagem>
           </imagens>
           <videos>
            <video>
              <codigoVideo><![CDATA[rs12I4SfBkCY]]></codigoVideo>
              <titulo>Sala principal</titulo>
             </video>
            </videos>
           <tours360>
            <tour360>
               <codigoTour360><![CDATA[https://
                                     virtualitour.com/tours/1123]]></codigoTour360>   		          <titulo>Sala principal</titulo>
             </tour360>
          </tours360>
     </multimidia>
    </Imovel>
 </Imoveis>
</OpenNavent>

Tipo de publicação

Para informar o tipo de publicação, deve-se utilizar <publicacao>

<tipoPublicacao><![CDATA[HOME]]></tipoPublicacao>  </publicacao>

<?xml versão="1.0" codificação="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
 <Imoveis>
    <Imovel>
      <publicacao>
         <tipoPublicacao><![CDATA[HOME]]></tipoPublicacao>   		
        </publicacao>
     </Imovel>
  </Imoveis>
</OpenNavent>

<aside> ⚠️

Importante: para publicar seu anúncio com sucesso, você precisa ter um plano Destaque, Super Destaque ou Simple.

</aside>

Exemplo completo de um XML

Aqui está um exemplo simplificado:

<?xml versão="1.0" codificação="UTF-8"?>
<OpenNavent>
  <dataModificacao>2024-09-22T12:00:00</dataModificacao>
<Imoveis>
    <Imovel>
      <codigoAnuncio>12345</codigoAnuncio>
      <codigoReferencia>ABC-123</codigoReferencia>
      <descricao> <![CDATA[Apartamento para venda Bela Vista.
               Excelente apartamento mobiliado, localizado a uma 
               quadrada Av. Paulista e do Metrô.]]> </descricao>
      </titulo> <![CDATA[Apartamento, 3 suítes, Bela Vista, São Paulo]>
              </titulo>
      <precos>
          <preco>
              <quantidade>180000</quantidade> 
              <moeda>BRL</moeda>
              <operacao>Venta</operacao>
           </preco>
         </precos>
       <tipoPropriedade>
         <idTipo><![CDATA[1]]></idTipo>
         <idSubTipo><![CDATA[45]]></idSubTipo>
        </tipoPropriedade>
       <multimidia>
         <imagens>
           <imagem>
            <urlImagem><![CDATA[https:
                //www.photo.net/img_123.jpg]]></urlImagem>
            <titulo>Hall de Entrada</titulo>
            </imagem>
           </imagens>
           <videos>
            <video>
              <codigoVideo><![CDATA[rs12I4SfBkCY]]></codigoVideo>
              <titulo>Sala principal</titulo>
             </video>
            </videos>
         </multimidia>
         <publicacao>
           <tipoPublicacao><![CDATA[HOME]]></tipoPublicacao>   		
         </publicacao>
         <publicador>
           <codigoImobiliaria>54561</codigoImobiliaria>
           <emailUsuario>[email protected]</emailUsuario>
          </publicador>
        <localizacao>
          <endereco>Avenida Paulista 900</endereco>
          <idLocalidade>V1-D-525243</idLocalidade>
          <localidade>Bela Vista, São Paulo, São Paulo,  Brasil</localidade>
          <mostrarMapa>EXACTO</mostrarMapa>
          <latitude>-34.6216993</latitude>
          <longitude>46.651447</longitude>
        </localizacao>
    </Imovel>
<!-- Mais anúncios -->
</Imoveis>
</OpenNavent>

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

Para excluir um anúncio, não deve ser enviado no XML.

En esta página: