Este artigo descreve as funcionalidades e configurações necessárias para a integração da plataforma digital SnapProperty com o Portal VivaReal.

Descrição do Integração
- - Inicio do processo
  - término do processo
- Pré requisitos para geração do arquivo

Visão geral

Referências

A integração foi desenvolvida de acordo com as orientações do manual de integração do portal, disponíveis em \

Endereço do arquivo

O arquivo xml fica disponível para consulta do portal no endereço https://us-central1-snapproperty-dev.cloudfunctions.net/api/imoveis/{nome-cliente]/vivareal, onde o parâmetro {nome-cliente} é fornecido pelo analista no início da implantação do projeto.

Endereço para teste de um imóvel

Para testar a geração do arquivo de um único imóvel pode ser utilizada a url https://us-central1-snapproperty-dev.cloudfunctions.net/api/imoveis/cliente/vivareal/id-imovel, onde:

cliente é o nome do cliente fornecido na implantação
id-imovel é o ID do imóvel na plataforma Salesforce (ex.: a054P00000vHl2zQAC)

Mapeamento dos campos

O arquivo xml é construído de acordo os campos descritos na tabela abaixo.

Campo do VivaReal	Tag do VivaReal	Descrição	Obrigatório	Objeto	Campo	Notas
Id do imóvel	ListingId		Sim	Imóvel	Código do imóvel
Tipo de uso	UsageType	tipo de uso do viva real	não	Tipo de uso	Tipo de uso [VivaReal]
Tipo de imóvel	PropertyType		não	Tipo de imóvel	Tipo de imóvel [VivaReal]
Descrição	Description		não	imóvel	Descrição
Preço Venda	ListPrice		não	Imóvel	valor para venda
Preço Aluguel	RentalPrice		não	Imóvel	Valor desejado do aluguel
Preço Condomínio	PropertyAdministrationFee		não	Imóvel	Valor do condomínio
Preço IPTU	YearlyTax		não	Imóvel	Valor mensal do IPTU	Valor do campo multiplicado por 12
Banheiros	Bathrooms	obrigatório em todos os imóveis, exceto, Lote / Terreno.	sim	Imóvel	Banheiros	Não são levados em conta os valores preenchidos no campo " Banheiros de empregada"
Quartos	Bedrooms	obrigatório em todos os imóveis residenciais	sim	Imóvel	Dormitórios
Suites	Suites		não	Imóvel	Suítes
Garagem	Garage		não	Imóvel	Vagas
Media	Media	lista de midias do imóvel, fotos ou vídeos	não	Foto do imóvel	-
Item	Item	tag de Media contem a foto do imóvel	não	Foto do imóvel	Url da imagem
Destaque	Featured	indica se o imóvel deve aparecer em destaque nas pesquisa, garantia de maior destaque no anuncio .	não	Imóvel	Destaque [VivaReal]
Título	Title	titulo no portal	não	Imóvel	Título [VivaReal]
Header	Header	cabeçalho do xml	-	-	-
Provedor	Provider	tag de cabeçalho (header) provedor do xml		-	-
Email	Email	tag de cabeçalho (header) email de contato do desenvolvedor	não	-	-
ContactName	ContactName	tag de cabeçalho (header) nome do contato do desenvolvedor	não	-	-
PublishDate	PublishDate	tag de cabeçalho (header) data de publicação do xml	não	-	-
Telephone	Telephone	tag de cabeçalho (header) telefone da empresa provedora	não	-	telefone da snapsystems
tipo de transação	TransactionType		não	imóvel	Disponível para locação /Disponível para venda	verifica se os campos estão selecionados se disponível para locação estiver selecionado envia " For Rent" se apenas o disponível para venda estiver selecionado envia "For sale" se os dos campos estiverem selecionados envia "Sale/Rent"
Location		tag de localização	não
País	County	tag de location país do imóvel	não	Imóvel	País
Estado	State	tag de location estado do imóvel	não	Imóvel	Estado / UF	O UF é enviado com uma propriedade abbreviation
Cidade	City	tag de location cidade de imóvel	não	Imóvel	Cidade	Campo de pesquisa é enviado o Name da cidade
vizinhança	Neighborhood'	tag de location bairro do imóvel	não	Imóvel	Bairro	Campo de pesquisa é enviado o nome do bairro
Zona	Zone	tag de location Zona de comercialização	não	Imóvel	Zona de comercialização	Zona de comercialização
Endereço	Adress	tag de location Endereço do imóvel	não	Imóvel	Logradouro
Número da rua	StreetNumber	tag de location numero da rua do imóvel	não	Imóvel	Número
Código Postal	PostalCode	tag de location cep do imóvel	não	Imóvel	Cep	Campo de pesquisa é enviado o name do cep
Latitude	Latitude	tag de location do imóvel	não	Imóvel	Localização geográfica	apenas a latitude
Longitude	Longitude	tag de location do imóvel	não	Imóvel	Localização geográfica	apenas a longitude
área	LotArea	obrigatório para tipos de propriedade, como Terrenos (Residencial e Comercial), Galpão /Depósito / Armazém, Fazenda/sítio e Chácara.	sim	Imóvel	Área terreno
área	LivingArea	obrigatório em todos os tipos de propriedade, exceto os listados acima, em LotArea.	sim	Imóvel	Área privativa
	ContactInfo	Informações de contato da administradora	não			este item não será enviado
	Name	Nome da administradora	não			este item não será enviado
	Email	Email da administradora	não			este item não será enviado
	Website	Website da administradora	não			este item não será enviado
	Logo	logo da administradora	não			este item não será enviado
	OfficeName	nome da agencia principal da administradora	não			este item não será enviado
	Telephone	telefone da administradora	não			este item não será enviado
	Location	localização da administradora tag de ContactInfo	não			este item não será enviado
	Country	País da administradora de imóveis	não			este item não será enviado
	State	Estado da administradora de imóveis	não			este item não será enviado
	City	Cidade da administradora de imóveis	não			este item não será enviado
	Neighborhood	Bairro da administradora de imóveis	não			este item não será enviado
	Address	Endereço da administradora de imóveis	não			este item não será enviado
	PostalCode	Cep da administradora de imóveis	não			este item não será enviado
Características	Features	Tag para declarar características do imóvel	não
Característica	Feature	Tag que contém cada característica	não

Características do imóvel

Abaixo são listadas as características aceitas pelo viva real :

Valor na Tag	Tradução
Close to main roads/avenues	Perto de vias de acesso
Close to shopping centers	Perto de Shopping Center
Close to public transportation	Perto de transporte público
Close to schools	Perto de Escolas
Close to hospitals	Perto de hospitais
Utilities	Serviços públicos essenciais
Gravel	Cascalho
Land	Terra
Cooling	Ar condicionado
Fenced Yard	Quintal
Balcony	Varanda
Warehouse	Depósito
Fireplace	Lareira
Furnished	Mobiliado
Fully wired	Cabeamento estruturado
Cable Television	TV a cabo
Internet Connection	Conexão à internet
Parking Garage	Garagem
Laundry	Lavanderia
Kitchen	Cozinha
Maid's Quarters	Área de serviço
Exterior View	Vista Exterior
Heating	Aquecimento
Home Office	Escritório
Lawn	Gramado
Reflective Pool	Espelhos d'água
Year Built	Mais de um andar
Pay-per-use Services	Serviço pay per use
Controlled Access	Vigia
TV Security	Circuito de segurança
Security Guard on Duty	Segurança 24h
Intercom	Interfone
Fenced Yard	Condomínio fechado
Alarm System	Sistema de alarme
Gym	Academia
Garden Area	Jardim
Elevator	Elevador
BBQ	Churrasqueira
Party Room	Salão de festas
Gourmet Area	Espaço gourmet
Playground	Playground
Pool	Piscina
Sports Court	Quadra Poliesportiva
Movie Theater	Cinema
Tennis court	Quadra de tênis
Green space / Park	Espaço verde / Parque
Game room	Salão de jogos
Reception room	Recepção
Band Practice Room	Garage band
Massage Room	Massagem
Sauna	Sauna
Jogging track	Pista de Cooper
Spa	Spa
Squash	Quadra de Squash
Ocean View	Vista para o mar
Mountain View	Vista para a montanha
Lake View	Vista para o lago
Veranda	Varanda gourmet
Generator	Gerador elétrico