Portal Netimóveis Documentação de Integração

Location

Temos três opções para divulgação de endereço

  • Divulgação do endereço completo (Logradouro e Número);

  • Divulgação somente do nome do Logradouro;

  • Divulgação somente do bairro;

Independente da escolha do cliente, o ideal é que o endereço completo seja sempre enviado. A informação completa é fundamental para que o imóvel fique bem posicionado nas pesquisas, e também disponível nas buscas realizadas por mapa.

Abaixo serão listadas as regras para a divulgação do endereço. Note que o único item que sofre alteração é o atributo displayAddress, que será configurado como: Neighborhood, Street ou All.

Caso o cliente opte por divulgar o endereço completo dos imóveis, o atributo displayAddress, deverá ser configurado como "All".

Importante

  • O elemento PostalCode é obrigatório em todos os anúncios enviados.

  • Para cidades com CEP único é obrigatório o envio do elemento State.

Exemplo displayAddress="All"

<?xml version="1.0" encoding="UTF-8"?>
<ListingDataFeed xmlns="http://www.netimoveis.com/schemas/1.0/NETSync"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="http://www.netimoveis.com/schemas/1.0/NETSync https://www.netimoveis.com/netsync/netsync.xsd>
  <Listings>
      <Listing>
        <Location displayAddress="All">
                <Country abbreviation="BR">Brasil</Country>
                <State abbreviation="SP">Sao Paulo</State>
                <City>São Paulo</City>
                <Zone>Zona Sul</Zone>
                <Neighborhood>Consolação</Neighborhood>
                <Address>Rua Bela Cintra</Address>
                <StreetNumber>539</StreetNumber>
                <Complement>APT 12</Complement>
                <PostalCode>01415-003</PostalCode>
                <Latitude>-23.5531131</Latitude>
                <Longitude>-46.659864</Longitude>
        </Location>
      </Listing>
  </Listings>
</ListingDataFeed>

Caso o cliente opte por divulgar as informações de endereço até o nome do logradouro, sem a exibição do numero, o atributo displayAddress, deverá ser configurado como "Street".

Exemplo displayAddress="Street"

<?xml version="1.0" encoding="UTF-8"?>
<ListingDataFeed xmlns="http://www.netimoveis.com/schemas/1.0/NETSync"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="http://www.netimoveis.com/schemas/1.0/NETSync https://www.netimoveis.com/netsync/netsync.xsd>
  <Listings>
    <Listing>
        <Location displayAddress="Street">
                <Country abbreviation="BR">Brasil</Country>
                <State abbreviation="SP">Sao Paulo</State>
                <City>São Paulo</City>
                <Zone>Zona Sul</Zone>
                <Neighborhood>Consolação</Neighborhood>
                <Address>Rua Bela Cintra</Address>
                <StreetNumber>539</StreetNumber>
                <Complement>APT 12</Complement>
                <PostalCode>01415-003</PostalCode>
                <Latitude>-23.5531131</Latitude>
                <Longitude>-46.659864</Longitude>
        </Location>
    </Listing>
  </Listings>
</ListingDataFeed>

Caso o cliente opte por divulgar as informações de endereço somente a nível de bairro, o atributo displayAddress, deverá ser setado como "Neighborhood".

Exemplo displayAddress="Neighborhood"

<?xml version="1.0" encoding="UTF-8"?>
<ListingDataFeed xmlns="http://www.netimoveis.com/schemas/1.0/NETSync"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="http://www.netimoveis.com/schemas/1.0/NETSync https://www.netimoveis.com/netsync/netsync.xsd>
  <Listings>
      <Listing>
          <Location displayAddress="Neighborhood">
                  <Country abbreviation="BR">Brasil</Country>
                  <State abbreviation="SP">Sao Paulo</State>
                  <City>São Paulo</City>
                  <Zone>Zona Sul</Zone>
                  <Neighborhood>Consolação</Neighborhood>
                  <Address>Rua Bela Cintra</Address>
                  <StreetNumber>539</StreetNumber>
                  <Complement>APT 12</Complement>
                  <PostalCode>01415-003</PostalCode>
                  <Latitude>-23.5531131</Latitude>
                  <Longitude>-46.659864</Longitude>
          </Location>
      </Listing>
  </Listings>
</ListingDataFeed>

Atenção

O formato mínimo deverá ser informado em todos os imóveis, fazem parte os elementos: Location, Country, State, City e Neighborhood. Sem elas ocorrerão erros de processamento do arquivo XML.

Exemplo do formato mínimo

<?xml version="1.0" encoding="UTF-8"?>
<ListingDataFeed xmlns="http://www.netimoveis.com/schemas/1.0/NETSync"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="http://www.netimoveis.com/schemas/1.0/NETSync https://www.netimoveis.com/netsync/netsync.xsd>
  <Listings>
      <Listing>
        <Location displayAddress="Neighborhood">
                <Country abbreviation="BR">Brasil</Country>
                <State abbreviation="SP">Sao Paulo</State>
                <City>São Paulo</City>
                <Neighborhood>Itaquera</Neighborhood>
        </Location>
      </Listing>
  </Listings>
</ListingDataFeed>

Elemento Zone

Se você trabalha com imóveis em cidades que existe divisão por zona(Zona Sul, Zona Norte, Zona Leste, Zona Oeste, etc.).

Em alguns casos, existem mais de um bairro com o mesmo nome, para essa situação, o elemento Zone ajuda na identificação do endereço exato.

Recomendamos que seja inserido o elemento Zone em Location para discriminar esse bairro.

Por exemplo o bairro, Vila Califórnia, em São Paulo, temos na Zona Sul e Zona Leste.

Exemplo

<?xml version="1.0" encoding="UTF-8"?>
<ListingDataFeed xmlns="http://www.netimoveis.com/schemas/1.0/NETSync"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="http://www.netimoveis.com/schemas/1.0/NETSync https://www.netimoveis.com/netsync/netsync.xsd>
  <Listings>
      <Listing>
        <Location displayAddress="Neighborhood">
               <Country abbreviation="BR">Brasil</Country>
               <State abbreviation="SP">São Paulo</State>
               <City>São Paulo</City>
               <Zone>Zona Sul</Zone>
               <Neighborhood>Vila Califória</Neighborhood>
        </Location>
      </Listing>
   </Listings>
</ListingDataFeed>

Dessa forma a integração irá considerar corretamente o bairro e o imóvel estará disponível para visualização.

Erros de codificação podem ocorrer

<State abbreviation="SP">Espírito Santo</State>
<City>Vitória</City>

Para contornar esse tipo de erro, informe com todos os acentos, e envolva o conteúdo dos elementos em CDATA

<State abbreviation="SP"><![CDATA[Espírito Santo]]></State>
<City><![CDATA[Vitória]]></City>
PreviousTransaction TypeNextMedia

Last updated

Logo

NITI