Manual de Importação via XML

Orientações gerais

Este manual tem o objetivo de padronizar o desenvolvimento e disponibilização dos arquivos XML pelas empresas Integradoras ou desenvolvedoras de sistemas imobiliários.


Realizamos neste documento referência a duas personas: INTEGRADOR (aquele que desenvolve os programas ou sistemas imobiliários) e CORRETOR (indivíduo devidamente cadastrado no CRECI e autorizado a usufruir do Portal Imobiliário).

1) INTEGRADOR: As regras abaixo devem ser seguidas em sua totalidade, respeitando e informando todas as informações obrigatórias e seus respectivos conteúdos com os formatos pré-determinados neste manual, para que a integração automática junto ao Portal Imobiliário do CRECI aconteça com sucesso.

2) INTEGRADOR: Todos os arquivos devem possuir o formato XML (de acordo com um dos dois padrões disponibilizados e que podem ser adotados - formato CRECI ou ZAP - sendo que o formato do XML ZAP adotado é o formato antigo antes de se tornar grupo ZAP, ou seja, não é o último formato do XML).

3) INTEGRADOR: Estes arquivos devem ser disponibilizados através de uma URL (ex.: www.dominioqualquer.com.br/nomedoarquivo.xml ).

4) INTEGRADOR: informe ao corretor o endereço da URL que foi disponibilizado o XML e qual é o formato desenvolvido (se é formato CRECI ou ZAP), para que o corretor possa cadastrar corretamente este XML dentro do Portal Imobiliário do CRECI.

5) CORRRETOR: De posse desta URL (link), você deverá acessar o portal imobiliário do CRECI com seu login e senha, e dentro do menu importações cadastrar seu XML disponibilizado pela Empresa Integradora ou Desenvolvedora de Sistemas Imobiliários.

6) CORRETOR: Você possui dúvidas de como cadastrar o XML? confira em nossos vídeos na página inicial deste tutorial e escolha o vídeo "Como inserir um XML para integrar os imóveis de forma automática?".


Leia com atenção todas as regras abaixo com os pontos mais importantes para o desenvolvimento e disponibilização deste arquivo XML.

Atualizado em 27/02/2020

O que é a importação XML?

O XML é um formato de arquivo adotado para troca de informações entre diversos sistemas utilizando a Internet como meio de comunicação.

Para facilitar a integração com o portal de imóveis do CRECI de forma automática, é necessário a disponibilização deste arquivo neste formato XML para integração de seus imóveis.

Todos imóveis deverão ser listados dentro deste arquivo no formato XML , respeitando padrões e regras aqui definidos, e assim poderão ser importados no portal de imóveis do CRECI para a sua respectiva conta/login do corretor.

Como funciona?

De posse da URL (link) disponibilizado pela Integradora (Desenvolvedores de Sistemas Imobiliários) o corretor deverá cadastrar esta URL (link) dentro do Portal Imobiliário em sua respectiva conta/login.

Diariamente o portal irá ler esta URL (link) do XML cadastrado em sua conta, caso todas as regras de preenchimento do padrão XML adotado estiverem corretas (regras que estão descritas neste manual), o sistema irá gravar os imóveis válidos dentro do portal imobiliário do CRECI.

O formato deste XML deve seguir os padrões definidos nessa documentação, principalmente as regras obrigatórias (constantes na coluna como obrigatórias) para que a carga seja lida corretamente.

Também é importante que a URL (link) esteja em pleno funcionamento para que o importador consiga realizar sua leitura.

Caso haja algum erro na publicação, no painel de importação de sua conta, você irá enxergar todos os detalhes do(s) erro(s) que estarão disponíveis para que sejam realizadas as devidas correções.

Atenção, a cada leitura diária *:

  • Todos os seus imóveis da carga anterior que não estejam na nova carga serão removidos.

  • Todos os seus imóveis da carga anterior que estejam na nova carga e que sofreram modificações, serão atualizados.

  • Todas as fotos da carga anterior que não estejam na nova carga serão removidas.

  • Todas as fotos da nova carga que não existiam, serão inseridas.

(* reiterando que esse procedimento acontecerá desde que você não modifique o endereço da url / link que está sendo integrado os seus imóveis, ou seja, se você alterar esse endereço de url / link de integração em uma próxima leitura, esse procedimento não irá funcionar).

Qual a Restrição?

  • O acesso ao portal somente estará disponível se o CORRETOR estiver regularmente inscrito no Conselho Regional de Corretores de Imóveis (CRECI).

  • Caso o CORRETOR não possua este arquivo XML (link disponibilizado pelo seu INTEGRADOR), não é possivel realizar a integração dos imóveis de forma automática, devendo assim o corretor realizar o cadastro manual de seus imóveis.


Quais os Padrões de XML?

Atualmente o Portal Imobiliário do CRECI adota os seguintes padrões de XML:

  • Padrão Portal CRECI

  • Padrão ZAP Imóveis (modelo adotado é o anterior ao que está em vigor atualmente após tornar grupo ZAP).

Confira abaixo as particularidades de cada padrão XML (O CRECI recomenda que seja utilizado o "padrão portal CRECI").


Padrão Portal CRECI

Este é o formato padrão definido pelo Portal do CRECI (recomendamos que as empresas fornecedoras de software de gestão imobiliária adotem este formato).

Nesse padrão é possível enviar os imóveis para que o portal possa carregar os imóveis dentro do sistema de forma automática.

Este padrão é atualizado constantemente através da criação de novas tags, e a cada alteração é importante realizar o seu devido ajuste.

Layout do XML: Formato CRECI

Abaixo segue um exemplo do resultado esperado do arquivo XML, que deve ser disponibilizado pelo INTEGRADOR

  • respeite a ordem das tags e a forma que estão escritas as tags, letras minúsculas e maiúsculas.

  • utilize a tag <![CDATA[ xxxxxx ]]> para conteúdos que tenham caracteres especiais, para que o XML não seja "quebrado" e não seja lido por conta destes caracteres especiais. Repare a sua utilização no exemplo abaixo no campo observação (neste instante utilizar apenas nas tags: obs, city e neighborhood). ATENÇÃO: remover espacos no inicio e no final , ex de uso incorreto com espaços em branco no inicio e no final: <![CDATA[ teste ]]>

  • ATENÇÃO: no campo big_file_url e small_file_url a referência para foto deve ser uma URL válida direta para o arquivo da foto e não deve ser uma montagem em tempo real da foto através de parametrizações na url , exemplo de uma url inválida : https : / / www . nomedodominio . com . br / foto.php?param=arquivootos/asdy13db13.jpg (esse tipo de parametrização será invalidada e recusada).



<publish xmlns="http://tempuri.org/XMLSchema1.xsd">


<client_info>

<creci>999999-f</creci>

</client_info>

<properties>

<property>

<common_data>

<total_area>1200.00</total_area>

<useful_area>79.00</useful_area>

<financing>1</financing>

<obs>

<![CDATA[Apartamento na Planta, 79m², 3 dormitórios e 1 Suíte,ou 2 Suítes com Living Ampliado. 2 Vagas, mais de 20 itens de lazer.Ótima Localização. Faça seu fluxo de pagamento.

Entrada mais mensais r$ 590,00

(11) 7778-9955 id 88*103153, CRECI 11]]>

</obs>

<reference_code>91</reference_code>

<master_type>M-1</master_type>

<type>M-1-T-1</type>

<purpose>

<season_price>1250.00</season_price>

<season_available>1</season_available>

<rent_price></rent_price>

<rent_available>0</rent_available>

<sell_price>10000000000.00</sell_price>

<sell_available>1</sell_available>

</purpose>

<address>

<show_map>1</show_map>

<latitude>-19.9709420</latitude>

<longitude>-43.9514930</longitude>

<show_address>1</show_address>

<type_address>Rua</type_address>

<street_address>Palmeiras</street_address>

<number>283</number>

<supplements>Apto 43 - Bloco B - Fundos</supplements>

<neighborhood>Barcelona</neighborhood>

<city>São Caetano do Sul</city>

<state>SP</state>

<region>ABC</region>

<zone>Sul</zone>

<zipcode>09560650</zipcode>

</address>

</common_data>

<composition>

<kitchen>1</kitchen>

<vagancy>2</vagancy>

<bathroom>3</bathroom>

<room>1</room>

<suite>1</suite>

<bedroom>3</bedroom>

</composition>

<photos>

<photo>

<order>1</order>

<big_file_url>

<![CDATA[

http://118579.motorimobiliario.com.br/pool//118579/52a5462d-de1c-49c7-ae0c-79a7baca9019//52a54b2a-9950-445c-a0eb-91cdbaca9019.B.jpg

]]>

</big_file_url>

<small_file_url>

<![CDATA[

http://118579.motorimobiliario.com.br/pool//118579/52a5462d-de1c-49c7-ae0c-79a7baca9019//52a54b2a-9950-445c-a0eb-91cdbaca9019.C.jpg

]]>

</small_file_url>

<label>Sao Caetano - Espaco mulher</label>

</photo>

<photo>

<order>2</order>

<big_file_url>

<![CDATA[

http://118579.motorimobiliario.com.br/pool//118579/52a5462d-de1c-49c7-ae0c-79a7baca9019//52a54b2a-9950-445c-a0eb-91cdbaca9019.D.jpg

]]>

</big_file_url>

<small_file_url>

<![CDATA[

http://118579.motorimobiliario.com.br/pool//118579/52a5462d-de1c-49c7-ae0c-79a7baca9019//52a54b2a-9950-445c-a0eb-91cdbaca9019.E.jpg

]]>

</small_file_url>

<label>Sao Caetano - Espaco mulher</label>

</photo>

</photos>

<characteristics>

<characteristic>

<room>

<label>Dormitórios 1</label>

</room>

<categories></categories>

</characteristic>

<characteristic>

<room>

<label>Dormitórios 2</label>

</room>

<categories></categories>

</characteristic>

<characteristic>

<room>

<label>Dormitórios 3</label>

</room>

<categories></categories>

</characteristic>

<characteristic>

<room>

<label>Suites 1</label>

</room>

<categories></categories>

</characteristic>

<characteristic>

<room>

<label>Vagas 1</label>

</room>

<categories></categories>

</characteristic>

<characteristic>

<room>

<label>Vagas 2</label>

</room>

<categories></categories>

</characteristic>

<characteristic>

<room>

<label>Salas 1</label>

</room>

<categories></categories>

</characteristic>

</characteristics>

</property>

</properties>

</publish>



Especificações (formato CRECI)

Especificações (formato CRECI)


Tipos do imóvel (formato CRECI)

Tipo do Imóvel (formato CRECI)


Subtipos do imóvel (formato CRECI)

Subtipos (formato CRECI)

Padrão ZAP Imóveis *

Este é o formato baseado na estrutura XML criado pelo Portal ZAP Imóveis (obs.: modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP, pois o ZAP alterou o layout XML após a união com o Viva Real).

Este padrão foi adotado para facilitar inicialmente o desenvolvimento dos XMLs pelas integradores (que desenvolvem sistemas imobiliários), uma vez que este formato já é amplamente adotado pelo mercado, disponibilizando de forma rápida o XML para o Portal do Creci para seus corretores e imobiliárias que utilizam seus sistemas.

O CRECI adicionou novas tags neste formato para complementar informações durante a integração dos imóveis, por isso consideramos este formato SEMELHANTE (pois acrescenta novas TAGS), mas ressaltamos que a integração irá funcionar mesmo sem estas novas tags que foram acrescentadas.

Para os integradores, solicitamos que incluam estas novas tags, complementando assim as informações dos imóveis dentro do portal do creci.

Abaixo o detalhamento do XML com o seu padrão e as regras básicas que devem ser seguidas para que os imóveis sejam integrados corretamente.


* ressaltamos que este formato ZAP mantém todas as tags utilizadas pelo portal ZAP (modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP), porém algumas Tags foram adicionadas para o Portal Imobiliário.


Layout do XML: Formato ZAP (modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP)*

Abaixo segue um exemplo do resultado esperado do arquivo XML, que deve ser disponibilizado pelo INTEGRADOR.

  • respeite a ordem das tags

  • respeite a forma que estão escritas as tags: letras minúsculas e maiúsculas.

  • utilize a tag <![CDATA[ xxxxxx ]]> para conteúdos que tenham caracteres especiais, para que o XML não seja "quebrado" e não seja lido por conta destes caracteres especiais. Repare a sua utilização no exemplo abaixo no campo observação (neste instante utilizar apenas nas tags: observação, cidade e bairro). ATENÇÃO: remover espacos no inicio e no final , ex de uso incorreto com espaços em branco no inicio e no final: <![CDATA[ teste ]]>

  • ATENÇÃO: na TAG UrlArquivo a referência para foto deve ser uma URL válida direta para o arquivo da foto e não deve ser uma montagem em tempo real da foto através de parametrizações na url , exemplo de uma url inválida : https : / / www . nomedodominio . com . br / foto.php?param=arquivootos/asdy13db13.jpg (esse tipo de parametrização será invalidada e recusada).



<Carga xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<Imoveis>

<Imovel>

<Creci>19023J</creci>

<CodigoCliente>208300112248</CodigoCliente>

<CodigoImovel>CA0028</CodigoImovel>

<TipoImovel>Casa</TipoImovel>

<SubTipoImovel>Casa Padrão</SubTipoImovel>

<CategoriaImovel>Térrea</CategoriaImovel>

<Cidade>São Paulo</Cidade>

<Bairro>Pinheiros</Bairro>

<Endereco>Rua Rebelo</Endereco>

<Numero>213</Numero>

<Complemento>

Casa 3

</Complemento>

<CEP>05321000</CEP>

<UF>SP</UF>

<Latitude>-19.9709420</Latitude>

<Longitude>-43.9514930</Longitude>

<PrecoVenda>6120000.00</PrecoVenda>

<PrecoLocacao></PrecoLocacao>

<PrecoLocacaoTemporada></PrecoLocacaoTemporada>

<PrecoCondominio>900.00</PrecoCondominio>

<AreaUtil>900</AreaUtil>

<AreaTotal>1998</AreaTotal>

<UnidadeMetrica>M2</UnidadeMetrica>

<QtdDormitorios>2</QtdDormitorios>

<QtdSuites>1</QtdSuites>

<QtdBanheiros>2</QtdBanheiros>

<QtdVagas>3</QtdVagas>

<QtdSalas>2</QtdSalas>

<QtdAndar>14</QtdAndar>

<Piscina>1</Piscina>

<SalaoFestas>1</SalaoFestas>

<Churrasqueira>1</Churrasqueira>

<Jardim>0</Jardim>

<Playground>1</Playground>

<QuadraPoliEsportiva>0</QuadraPoliEsportiva>

<Quintal>0</Quintal>

<PistaCooper>1</PistaCooper>

<Lareira>0</Lareira>

<Mobiliado>0</Mobiliado>

<Sauna>1</Sauna>

<TvCabo>0</TvCabo>

<ArCondicionado>0</ArCondicionado>

<Intefone>1</Intefone>

<Observacao>

<![CDATA[Casa muito agradável todos dormitórios e salas voltadas para o jardim. Gerador de energia.]]>

</Observacao>

<TipoOferta>1</TipoOferta>

<Fotos>

<Foto>

<NomeArquivo>F41104553393CBA7DF130F126201AE61E0CED030.jpg</NomeArquivo>

<URLArquivo>http://cdnx.servidor.com.br/_Fotos/2083/2248/F41104553393CBA7DF130F126201AE61E0CED030.jpg</URLArquivo>

<Principal>1</Principal>

<Alterada>0</Alterada>

</Foto>

<Foto>

<NomeArquivo>9BF7059650DAECAE4AEB4DE6E74B9FADB663950A.jpg</NomeArquivo>

<URLArquivo>http://cdnx.servidor.com.br/_Fotos/2083/2248/9BF7059650DAECAE4AEB4DE6E74B9FADB663950A.jpg</URLArquivo>

<Principal>0</Principal>

<Alterada>0</Alterada>

</Foto>

<Foto>

<NomeArquivo>4E40F58D79741B233C0D384F6185E86D6BC381BB.jpg</NomeArquivo>

<URLArquivo>http://cdnx.servidor.com.br/_Fotos/2083/2248/4E40F58D79741B233C0D384F6185E86D6BC381BB.jpg</URLArquivo>

<Principal>0</Principal>

<Alterada>0</Alterada>

</Foto>

</Fotos>

</Imovel>

</Imoveis>

</Carga>


* este formato ZAP mantém todas as tags utilizadas pelo portal ZAP (modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP), porém algumas Tags foram adicionadas para o Portal Imobiliário.


Especificações - formato ZAP (modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP)*

Especificações (formato ZAP)
* este formato ZAP mantém todas as tags utilizadas pelo portal ZAP (modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP), porém algumas Tags foram adicionadas para o Portal Imobiliário.


Tabela de Tipo, Subtipos e Categorias do imóvel - formato ZAP (modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP)*

Tabela Tipos ZAP
* este formato ZAP mantém todas as tags utilizadas pelo portal ZAP (modelo adotado é o anterior ao que está em vigor após tornar grupo ZAP), porém alguns Tipos, Subtipos e Categorias foram adicionados para o Portal Imobiliário.