InteClick ­ O clique inteligente Manual de integração de XML Português ­ Brasil ­ Imóveis versão 1.0.1. 14pt ­ bold ­ blue 1. O que é InteClick imóveis? InteClick imóveis é um portal de Internet com objetivo de oferecer gratuitamente informações para pessoas que estejam procurando imóveis para compra, venda, locação ou temporada. Inteclick imóveis é a solução ideal para construtoras, incorporadoras, imobiliárias e corretores de imóveis disponibilizarem seus imóveis na Internet. 2. Como envio meus imóveis para o InteClick Imóveis? Para enviar seus imóveis, você deverá entrar em contato com um representante da InteClick e solicitar o cadastro de sua empresa ou seu cadastro, obtendo seu login de cliente único. Após seu cadastro, você poderá enviar seus imóveis de 2 maneiras: 1. através da criação de um arquivo com formato XML 2. através da leitura automática de seu site, por um sistema automatizado da InteClick O pedido de afiliação ao sistema poderá ser realizado através do e­mail: [email protected] Não existe nenhum custo para implementar ou disponibilzar seus imóveis, é inteiramente grátis e buscamos oferecer um serviço de qualidade para o usuário ter acesso ao maior número de imóveis disponíveis em sua região e fazer a opção inteligente em sua compra ou locação, buscamos a liberdade de conteúdo e opção de escolha. 3. XML 3.1 O que é XML? XML (eXtensible Markup Language) é uma nova forma de padronização de dados, através de marcadores especiais, é possível criar listas de informações e enviar dados entre websites. O XML é um formato para a criação de documentos com dados organizados de forma hierárquica. Pela sua portabilidade, já que é um formato que não depende das plataformas de hardware ou de software, um banco de dados pode, através de uma aplicação, escrever em um arquivo XML, e um outro banco distinto pode ler então estes mesmos dados. Baseado em: Wikipédia, a enciclopédia livre. Informações detalhadas podem ser encontradas em: http://pt.wikipedia.org/wiki/XML 3.2. Criando um XML Você poderá solicitar a sua equipe de software a criação de um arquivo XML. O XML poderá ser criado em qualquer linguagem de programação, inserindo os dados nos locais informados e exportando para um arquivo texto com extensão .XML. Recomendamos que o arquivo seja em encoding UTF­8. Lista de campos e especificações para o arquivo XML Para cada imóvel enviado, você criará um bloco de XML, iniciando por <product> e terminando por </product> contendo os dados abaixo: Campo Nome em Português Descrição Sintaxe Obrigatório/Opci
onal url url url única do alfanumérico produto em seu (2000) site. Através desta url o usuário da InteClick irá chegar em seu site e identificará o produto como único na Inteclick. Exemplo: http://www.meu
site.com.br/imov
el?id=123 Sim / Campo­chave product_id id_produto Código único do numérico ou produto em seu alfanumérico sistema, você (50) poderá utilizar este campo para localizar Não facilmente o produto no site da Inteclick e fazer qualquer ajuste online. title titulo Título do produto, imóvel ou anúncio. Exemplo: Apartamento, 2 dormitórios, liberadade ou Lindo apartamento a venda, oportunidade única. alfanumérico (80) Sim currency unidade­moneta
ria Unidade alfanumérico monetária do (20) valor do imóvel Utilize R$ para real do Brasil, US$ para dolar americano, EUR para euros Não Default: R$ price preco Preço do imóvel (sem a moeda, utilize o ponto como separador) Exemplo: 2600000.00 (dois milhões e seisssentos mil) numérico ­ ponto como separador de decimal Não Caso não seja preencido, o site poderá adicional uma frase genérica como: sob consulta description descricao Descrição do imóvel a ser exibida na tela de detalhes. texto Sim action disponibilidade Ação a ser realizada sobre o imóvel opções: update: para cadastrar ou atualizar o cadastro. delete: para remover o cadastro Não obrigatório Default: Update type tipo Tipo do produto alfanumérico a ser (80) disponibilizado opções: Imóveis Não obrigatório Default: Imóveis commercial tipo­de­venda Tipo de alfanumérico Sim comercialização (80) do produto opções: Venda, Locação ou Temporada sub_type categoria Categoria de seu produto alfanumérico (80) opções: Apartamento, Casa, Terreno, Ponto Comercial, etc Sim step Fase de construção, lançamento ou novo Fase de construção do empreendiment
o alfanumérico (80) opções: pré­venda em construção lançamento últimas unidades novo usado Não obrigatório addrees endereço Endereço do Imóvel alfanumérico (255) Não obrigatório neighborhood bairro Bairro do Imóvel alfanumérico (255) Não obrigatório city cidade Cidade do Imóvel alfanumérico (255) Sim state estado Estado do alfanumérico Imóvel (80) Indicamos utilizar ou siga de estado (SP, RJ, MG..) ou nome do estado (São Paulo, Rio de Janeiro, Minas Gerais) Sim country pais País do Imóvel alfanumérico (80) Não obrigatório Default: Brasil rooms numero de quartos Número de dormitórios numérico Não obrigatório area area Área total do imóvel em metros quadrados numérico Não obrigatório garage vagas na garagem Número de vagas na garagem numérico Não obrigatório latitude Latitude Posição geográfica do imóvel (latitude). Utilizado para aplicativos móveis com geo­localização float, separado Não obrigatório por ponto e sinal negativo. Exemplo: ­12.323333 longitude Longitude Posição geográfica do imóvel (longitude) float, separado Não obrigatório por ponto e sinal negativo. Exemplo: ­12.323333 photo_url foto_url Url da foto principal do imóvel em seu site alfanumérico (2000) Não photo_url_extra foto_url_extra url de fotos alfanumérico adicioonais de (2000) seu imóvel. Para cada foto extra, você poderá’çriar uma linha <photo_url_extra
>http:...</photo_
url_extra> Não Campos extras: Você poderá também configurar campos extras em seu arquivo, por exemplo, enviando o cliente do site InteClick para uma url de fale conosco, chat online, atendimento ao vivo ou quem somos de sua empresa ou disponibilizar seu telefone de contato direto em seu anúncio na opção "Ver Telefone". Campo Nome em Português Descrição Sintaxe Obrigatório/Opci
onal merchant_id id_parceiro Código único de seu empreendiment
o (construtora, incorporadora, imobiliária, corretor de imóvel, ou representando comercial). Com este código, você irá administrar seus imóveis online numérico (12) Código informado no momento da afiliação ao sistema. Sim na plafaforma do site. merchant nome_parceiro O nome fantasia alfanumérico de sua empresa (80) (exemplo: Empresa A Imóveis) Não email email E­mail de alfanumérico contato para (80) todos os imóveis anunciados. Utilize o email no cabecalho, caso deseje que todos os imóveis tenham o mesmo e­mail de contato. Não phone telefone Telefone de sua alfanumérico empresa para (80) ser exibir no botão "Ver Telefone" Não url url Url de seu site alfanumérico para receber os (2000) contatos dos imóveis. Utilize no cabecalho o campo url, caso deseje receber os clientes em uma págia de fale conosco. Não Como criar um XML para o InteClick com linguagem PHP Criar o XML de sua empresa é bastante simples. Primeiro, crie um arquivo chamado inteclick.php, neste documento programe: <?php // Cria uma variável para armazenar o código XML a ser escrito no arquivo $xml = ‘<?xml version="1.0" encoding="utf­8"?> <inteclick>’; // Local para incluir os dados de seus imóveis $xml .= ‘ </inteclick>’; // grava o arquivo contendo o código XML $file = fopen( "inteclick.xml","w"); fwrite( $file, $xml ); fclose($file); ?> o arquivo gerado deverá ser: <?xml version="1.0" encoding="utf­8"?> <inteclick> </inteclick> Em seguida, obtenha os produtos de sua empresa, utilizando mysql, postgree, oracle e gere a listagem de seus imóveis, aumentando a variável $xml. Looping para obtenção dos dados de seus imóveis (foreach, for, while, etc). $xml .= ‘ <product>’; $xml .= ‘ <product_id>’ . $id_do_imovel . ‘</product_id>’; $xml .= ‘ <title>’ . $titulo . ‘</title>’; // utilize os outros campos conforme tabela acima $xml .= ‘ </product>’; O arquivo final gerado ficará semelhante ao modelo abaixo: <?xml version="1.0" encoding="utf­8"?> <inteclick> <product> <product_id>123456</product_id> <type>Imóveis</type> <commercial>Venda</commercial> <sub_type>Apartamento</sub_type> <title>Apartamento Residencial 3 dormitórios ­ a 2 quadras do metro</title> <description>Apartamento situado a 2 quadras da Avenida Paulista</description> <url>http://seusite.com.br/urldoimovel123456</url> <photo_url>http://seusite.com.br/imagem.jpg</url> <photo_url_extra>http://seusite.com.br/imagemextra1.jpg</url> <photo_url_extra>http://seusite.com.br/imageextra2.jpg</url> <country>Brasil</country> <state>SP</state> <city>São Paulo</city> <neighborhood>Consolação</neighborhood> <address>Rua Frei Canera, 33. Ap 32</address> <currency>R$</currency> <price>640000.00</price> </product> <product> …. </product> </inteclick> Termos para localização deste manual: ­ Manual de integração para imobiliárias ­ Manual de integração para sites de imobiliárias ­ Manual de integração para sites de imóveis ­ Manual de integração XML ­ Manual de envio de imóveis para Inteclick Já tenho um XML gerado para outro software? Posso enviar meu XML para o Inteclick? Sim. O InteClick tem a tecnologia para ler qualquer XML de softwares e sites comerciais. Você não precisará fazer outro XML, apenas informar a equipe do Inteclick o modelo que deseja usar e o local em seu site para download do seu arquivo atual. Contato de Apoio Técnico Inteclick http://br.inteclick.com Seg. a Sex. das 10:00 as 18:00 horas +55 11 3280 4251 [email protected]