A) Visão Geral


A integração com o portal ZAP Imóveis, visa publicar dados dos imóveis a serem locados, através de um XML que alimentará os dados relativos ao imóvel que será apresentado no portal. Foram criados dois serviços que estarão disponíveis a partir da versão 12.1.28, O primeiro retornará os dados do imóvel e o segundo, retornará as imagens cadastradas para este imóvel.

Importante: Para que a integração funcione corretamente, o imóvel em questão deverá possuir o campo "Realiza Integração com Portais Externos" marcado.
Além disso, a URL do Host deve permitir acesso externo, para que os XML's de integração consigam ser lidos pelo portal Zap Imóveis.

B) XML de Integração do Imóvel


Este serviço trará no formato de .xml, todos os dados pertinentes dos Imóveis, como sua descrição, imagens, detalhes do valor do aluguel, informações do endereço e do contato cadastrado entre outras. O formato utilizado é o seguinte:

http://servidor:porta/api/imb/v1/integracao/integra.xml

O .xml será exibido como no exemplo abaixo onde somente um imóvel está com o campo "Realiza integração com portais externos" marcado:

<?xml version="1.0" encoding="utf-8"?>
<ListingDataFeed schemaLocation="http://www.vivareal.com/schemas/1.0/VRSync" xmlns="http://www.vivareal.com/schemas/1.0/VRSync" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Header>
        <Provider>Responsável pelo desenvolvimento do arquivo</Provider>
        <Email>Email do responsável pelo desenvolvimento do arquivo</Email>
        <ContactName>Contato responsável pelo desenvolvimento do arquivo</ContactName>
        <PublishDate>Data de publicação</PublishDate>
        <Telephone>Telefone do responsável pelo desenvolvimento do arquivo</Telephone>
    </Header>
    <Listings>
        <Listing>
            <ListingID>C1I1</ListingID>
            <Title>Descrição do Imóvel</Title>
            <TransactionType>For Rent</TransactionType>
            <Media>
                <Item medium="image" primary="True">http://localhost:8051/api/imb/v1/integracao//images/1/1/10.jpg</Item>
                <Item medium="image" primary="False">http://localhost:8051/api/imb/v1/integracao//images/1/1/11.jpg</Item>
            </Media>
            <Details>
                <RentalPrice currency="BRL">3400.00000000</RentalPrice>
                <LivingArea unit="square metres">100</LivingArea>
                <Description><![CDATA[Campo Observação do cadastro de imóveis]]></Description>
                <PropertyAdministrationFee>0</PropertyAdministrationFee>
                <Bedrooms>1</Bedrooms>
                <Bathrooms>2</Bathrooms>
                <Suites>1</Suites>
                <Garage>1</Garage>
				<YearlyTax>0</YearlyTax>
            </Details>
            <Location>
                <Country abbreviation="BR">Brasil</Country>
                <State abbreviation="MG">Minas Gerais</State>
                <City>Belo Horizonte</City>
                <Neighborhood>Santa Lúcia</Neighborhood>
                <Address>Endereço</Address>
                <PostalCode>30350-300</PostalCode>
                <StreetNumber>1</StreetNumber>
            </Location>
            <ContactInfo>
                <Name>Nome</Name>
                <Email>[email protected]</Email>
                <Telephone>31-21229000</Telephone>
                <Location>
                    <Country abbreviation="Br">Brasil</Country>
                    <State abbreviation="MG">MG</State>
                    <Neighborhood>SANTA LÚCIA</Neighborhood>
                    <Address>AVENIDA RAJA GABAGLIA,2664</Address>
                    <PostalCode>30350-540</PostalCode>
                </Location>
            </ContactInfo>
        </Listing>
    </Listings>
</ListingDataFeed>

C) Serviço de Imagens do Imóvel


Este serviço será responsável por fazer a leitura da imagem do imóvel que participara da integração. Serão lidas e apresentadas as imagens cadastradas no imóvel, no seguinte formato:

http://servidor:porta/api/imb/v1/integracao/images/CodColigada/CodImovel/CodImagem.jpg

  • CodColigada: Coligada do imóvel cadastrado;
  • CodImovel: Código do imóvel cadastrado;
  • CodImagem: Código da imagem cadastrada.

Exemplo de URL que irá retornar uma imagem: http://localhost:8051/api/imb/v1/integracao/images/1/1/1.jpg

  • Sem rótulos