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

Panoramix

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><![CDATA[1764583681966]]></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><![CDATA[1764583681966]]></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><![CDATA[1764583681966]]></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><![CDATA[1764583681966]]></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><![CDATA[1764583681966]]></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

É utilizado para informar o estágio atual do lançamento imobiliário através do elemento etapaLancamento. Para consultar os valores possíveis que podem ser enviados neste campo, você pode utilizar a nossa API de Integrações através do método GET /v1/lancamentos/estagios.

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
  <dataModificacao><![CDATA[1764583681966]]></dataModificacao>
  <Lancamentos>
    <Lancamento>
      <etapaLancamento>
        <![CDATA[Em Construção]]>
      </etapaLancamento>
    </Lancamento>
  </Lancamentos>
</OpenNavent>

Data da Entrega

Data da entrega do emprendimiento. Deve indicar a data de entrega do emprendimiento.

Tem o formato: MM-YYYY

<?xml version="1.0" encoding="UTF-8"?>
<OpenNavent>
	<dataModificacao><![CDATA[1764583681966]]></dataModificacao>
	<Lancamentos>
		<Lancamento>
			<dataEntrega><![CDATA[12-2026]]></dataEntrega>
		</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><![CDATA[1764583681966]]></dataModificacao>
  <Lancamentos>
    <Lancamento>
      <publicacao>
        <<tipoPublicacao>><![CDATA[HOME]]></<tipoPublicacao>>   		
      </publicacao>
   </Lancamento>
  </Lancamentos>
</OpenNavent>

<aside> ⚠️

</aside>

Exemplo completo de um XML

Aqui está um exemplo simplificado: