Este artigo descreve o funcionamento do SnapProperty para enviar informações sobre os imóveis para o portal do Zap.

Visão geral

O SnapProperty gera um arquivo xml com as informações dos imóveis disponíveis para locação, seguindo a estrutura definida no Manual_Integração_Zap.pdf.

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]/zap, 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/zap/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 Zap	Tag do Zap	Descrição	Obrigatório	Objeto	Campo	Notas
Código do imóvel	CodigoImovel	Código para identificação do imóvel	Sim	Imóvel	Código	Ex.: I-060917
Tipo do imóvel	TipoImovel	Define o tipo de imóvel	Sim	Imóvel	Tipo do imóvel Zap	Notas sobre tipo do imóvel
Subtipo do imóvel	SubTipoImovel	Define o subtipo do imóvel	Sim	Imóvel	Subtipo do imóvel Zap	Notas sobre o subtipo do imóvel
Categoria do Imóvel	CategoriaImovel	Define a categoria do imóvel	Sim	Imóvel	Categoria do imóvel Zap ou Categoria imóvel zap do tipo de imóvel
UF	UF	O campo UF (Estado) é obrigatório para ‘todos’ os anúncios dentro do PLANO REGIONAL(PLANO FIT). Se a informação estiver ausente em um dos imóveis, o processo não é finalizado	Sim	Imóvel	UF
Cidade	Cidade		Sim	Imóvel	Cidade
Bairro	Bairro		Sim	Imóvel	Bairro
Número	Numero	estas informações não são divulgadas. Porém, são dados necessários juntamente com os campos UF,Cidade e Bairro,para que os anúncios sejam publicados como MAPA de localização, e que também apareçam para visualização no App do ZAP,que hoje já representa grande parte da nossa audiência	Não	Imóvel	Número
Complemento	Complemento		Não	Imóvel	Complemento
CEP	CEP	estas informações não são divulgadas. Porém, são dados necessários juntamente com os campos UF,Cidade e Bairro,para que os anúncios sejam publicados como MAPA de localização, e que também apareçam para visualização no App do ZAP,que hoje já representa grande parte da nossa audiência	Não	Imóvel	CEP
Preço de Venda	PrecoVenda	Deve ser preenchido quando for venda – campo numérico. Ex. Formato: 600.000(seiscentos mil reais)	Sim	Imóvel	Valor de de venda
Preço Locação	PrecoLocacao	Deve ser preenchido quando for locação – campo numérico. Ex. Formato: 500(quinhentos reais);	Não	Imóvel	Valor desejado do aluguel
Preço Locação Temporada	PrecoLocacaoTemporada		Não	-	-	Não é enviado
Preço condomínio	PrecoCondominio		Não	Imóvel	Valor do condomínio
Área útil	AreaUtil		Sim	Imóvel	Área provativa
Área Total	AreaTotal		Não	Imóvel	Área total
Unidade Métrica	UnidadeMetrica		Não	-	M2	Valor fixo
Qtd Dormitórios	QtdDormitorios		Sim	Imóvel	Dormitórios
Qtd Suítes	QtdSuites		Não	Imóvel	Suítes
Qtd Banheiros	QtdBanheiros		Não	Imóvel	Banheiros
Qtd Salas	QtdSalas		Não	Imóvel	Salas
Qtd Vagas	QtdVagas		Não	Imóvel	Vagas
Qtd Elevador	QtdElevador		Não
Qtd Unidades Andar	QtdUnidadesAndar		Não
Qtd Pessoas para Temporada	QtdPessoasParaTemporada		Não	-	-	Não é enviado
Ano Construção	AnoConstrucao		Não
Possuí Divida	PossuiDivida		Não
Saldo Dívida	SaldoDivida		Não
Valor Mensalidade Dívida	ValorMensalidadeDivida		Não
Parcelas Restantes da Dívida	QtdParcelasRestantesDivida		Não
Informações complementares	InformacoesComplementares		Não
Observação	Observacao	Neste campo é possível incluir um texto descritivo do anúncio, que detalha as características e informações relevantes para quem busca um imóvel. Este campo é opcional.	Não	Imóvel	Descrição
Data Última Parcela da Dívida	DataUltimaParcelaDivida		Não
Dia Vencimento Dívida	DiaVencimentoDivida		Não
Aceita Permuta	AceitaPermuta		Não
Aceita permuta de carro	AceitaPermutaCarro		Não
Aceita Permuta de Imóvel	AceitaPermutaImovel		Não
Aceita outro tipo de permuta	AceitaPermutaOutro		Não
Valor da Permuta de Carro	ValorPermutaCarro		Não
Valor da Permuta de Imóvel	ValorPermutaImovel		Não
Valor da Permuta de outro bem	ValorPermutaOutro		Não
Descrição da Permuta	DescricaoPermuta		Não
Acesso 24 horas	Acesso24Horas		Não
Água	Agua		Não
Ar Condicionado	ArCondicionado		Não
Armário Cozinha	ArmarioCozinha		Não
Armário embutido	ArmarioEmbutido		Não
Business Center	BusinessCenter		Não
Cerca	Cerca		Não
Churrasqueira	Churrasqueira		Não
Coffe shop	CoffeShop		Não
Convenções	Convencoes		Não
Copa	Copa		Não
Entrada de Caminhões	EntradaCaminhoes		Não
Endereço	Endereco	Este campo é preenchido automaticamente pelo ZAP com base no CEP enviado pelo cliente. No caso do CEP informado não existir na base dos Correios, a rua será exibida de acordo com as informações preenchidas na tag <Endereco>. Os demais campos relacionados à localização do imóvel,como bairro ou número, deverão ser informados pelo corretor, ou seja, não são preenchidos automaticamente.	Não	Imóvel	Logradouro
Escritório	Escritorio		Não
Escritório Virtual	EscritorioVirtual		Não
Esgoto	Esgoto		Não
Esquina	Esquina		Não
Estacionamento Rotativo	EstacionamentoRotativo		Não
Estacionamento Visitantes	EstacionamentoVisitantes		Não
Estrada Asfaltada	EstradaAsfaltada		Não
Garagem para barcos	GaragemBarcos		Não
Guarita	Guarita		Não
Heliponto	Heliponto		Não
Infra-estrutura internet	InfraInternet		Não
Jardim	Jardim		Não
Lago	Lago		Não
Lavoura	Lavoura		Não
Luz	Luz		Não
Marina	Marina		Não
Mezanino	Mezanino		Não
Pasto	Pasto		Não
Pátio Estacionamento	PatioEstacionamento		Não
Píer	Pier		Não
Piscina	Piscina		Não
Piso Elevado	PisoElevado		Não
Pista de Pouso	PistaPouso		Não
Playground	Playground		Não
Ponte Rolante	PonteRolante		Não
Quadra de Squash	QuadraSquash		Não
Quadra de Tênis	QuadraTenis		Não
Quadra Poliesportiva	QuadraPoliesportiva		Não
Quintal	Quintal		Não
TV a cabo	TV Cabo		Não
Varanda	Varanda		Não
Vestiário	Vestiario		Não
Vidros reflexivos	VidrosReflexivos		Não
WC empregada	WCEmpregada		Não
Quarto da Empregada	QuartoWCEmpregada		Não
Lavabo	Lavabo		Não
Estuda Permuta	EstudaPermuta		Não
Depósito Privativo no Subsolo	DepositoSubsolo		Não
Closet	Closet		Não
Hidromassagem	Hidromassagem		Não
Lareira	Lareira		Não
Frente para o Mar	FrenteMar		Não
Andar inteiro	AndarInteiro		Não
Área de serviço	AreaServico		Não
Bosque	Bosque		Não
Campo de futebol	CampoFutebol		Não
Casa de Caseiro	CasaCaseiro		Não
Casa de Fundo	CasaFundo		Não
Casa Principal	CasaPrincipal		Não
Caseiro	Caseiro		Não
Com serviço	ComServico		Não
Cozinha azulejada até o teto	CozinhaAzulejada		Não
Despensa	Despensa		Não
Energia Elétrica	EnergiaEletrica		Não
Entrada de serviço independente	EntradaServicoIndependente		Não
Entrada Facilitada	EntradaFacilitada		Não
Entrada Lateral	EntradaLateral		Não
Fogão	Fogao		Não
Freezer	Freezer		Não
Geladeira	Geladeira		Não
Germinado	Germinado		Não
Home Theather	HomeTheather		Não
Imóvel de exposição	ImovelExposição		Não
Interfone	Interfone		Não
Lava Roupas	LavaRoupas		Não
Lavanderia Coletiva	LavanderiaColetiva		Não
Isolada	Isolada		Não
Living Tabuas Largas	LivingTabuasLargas		Não
Meio Andar	MeioAndar		Não
Micro-ondas	Microondas		Não
Oferta	Oferta		Não
Paiol	Paiol		Não
Para Incorporação	ParaIncorporacao		Não
Pista de Cooper	PistaCooper		Não
Pista de Skate	PistaSkate		Não
Poço	Poco		Não
Poço Artesiano	PocoArtesiano		Não
Pronto para Morar	ProntoMorar		Não
Refeitório	Refeitorio		Não
Roupa de Banho	RoupaBanho		Não
Roupa de Cama	RoupaCama		Não
Roupa de Mesa	RoupaMesa		Não
Sala de Almoço	SalaAlmoco		Não
Sala de Jantar	SalaJantar		Não
Sala íntima	SalaIntima		Não
Salão de Vídeo/Cinema	SalaVideo		Não
Salão de Festas	SalaoFestas		Não
Segurança Interna	SegurancaInterna		Não
Semigeminada	Semigeminada		Não
Spa/Hidromassagem	SpaHidromassagem		Não
Stand de Vendas no Local	StandVendasLocal		Não
TV	TV		Não
Utensílios de Cozinha	UtensiliosCozinha		Não
Utilize FGTS	UtilizeFGTS		Não
Ventilador de teto	VentiladoresTeto		Não
Visite Imóvel Decorado	VisiteImovelDecorado		Não
Clube	Clube		Não
Children Care	ChildrenCare		Não
Curral	Curral		Não
Mobiliado	Mobiliado		Não
Recuo	Recuo		Não
Solarium	Solarium		Não
Casa Mista	CasaMista		Não
Casa de Alvenaria	CasaAlvenaria		Não
Casa de Madeira	CasaMadeira		Não
Terraço	Terraco		Não
Tipo de Oferta	TipoOferta		Não
Valor de Entrada	ValorEntrada		Não
Valor Mensal	ValorMensal		Não
Descrição da Localização	DescricaoLocalizacao		Não
Valor do IPTU	ValorIPTU		Não	Imóvel	Valor do IPTU
Espaço Gourmet	EspacoGourmet		Não
Laje	Laje		Não
Vista Panorâmica	VistaPanoramica		Não
Área de lazer	AreaLazer		Não
Academia	Academia		Não
Ventilação Natural	VentilacaoNatural		Não
Banheira	Banheira		Não
Platibanda	Platibanda		Não
Janelas Grandes	JanelasGrandes		Não
Janelas de alumínio	JanelaAluminio		Não
Muro de Vidro	MuroVidro		Não
Balaustre	Balaustre		Não
Escada	Escada		Não
Drywall	Drywall		Não
Gás Encanado	GasEncanado		Não
Rampas	Rampas		Não
Arandelas	Arandelas		Não
Cimento Queimado	CimentoQueimado		Não
Gesso - Sanca - Teto rebaixado	GessoSanca		Não
Acessibilidade	Acessibilidade		Não
Aquário	Aquario		Não
Isolamento Acústico	IsolamentoAcustico		Não
Isolamento Térmico	IsolamentoTermico		Não
Porcelanato	Porcelanato		Não
Piso Laminado	PisoLaminado		Não
Piso de Madeira	PisoMadeira		Não
Piso vinílico	PisoVinilico		Não
Papel de Parede	PapelParede		Não
Móveis Planejados	MoveisPlanejados		Não
Ofurô	Ofuro		Não
Muros e Grades	MurosGrades		Não
Blindex	Blindex		Não
Cozinha Americana	CozinhaAmericana		Não
Ambientes Integrados	AmbientesIntegrados		Não
Sala Pequena	SalaPequena		Não
Sala Grande	SalaGrande		Não
Edícula	Edicula		Não
Hall de Entrada	HallEntrada		Não
Cozinha Grande	CozinhaGrande		Não
Biblioteca	Biblioteca		Não
Horta	Horta		Não
Orquidário	Orquidario		Não
Varanda Gourmet	VarandaGourmet		Não
Churrasqueira na Varanda	ChurrasqueiraVaranda		Não
Cozinha Pequena	CozinhaPequena		Não
Rede de Telefone	RedeTelefone		Não
Reservatório de Água	ReservatorioAgua		Não
Restaurante	Restaurante		Não
Rio	Rio		Não
Rua Asfaltada	RuaAsfaltada		Não
Sala Ginástica	SalaGinastica		Não
Salão de jogos	SalaoJogos		Não
Sauna	Sauna		Não
Sede	Sede		Não
Segurança na Rua	SegurancaRua		Não
Segurança Patrimonial	SegurancaPatrimonial		Não
Silos	Silos		Não
Sistema de incêndio	SistemaIncendio		Não
Telefone	Telefone		Não
Portaria Fechada	PorteiraFechada		Não
Fotos	Fotos UrlArquivo Principal Alterado		Não	Fotos do imóvel	URL da imagem, verifica se imóvel possui foto principal e verifica se a foto atual é a principal se sim envia 1, sempre recebe valor 0

Notas

Tipo do imóvel

Quando o campo "Tipo de imóvel Zap" do imóvel não é preenchido, o sistema utiliza o campo "Tipo de imóvel Zap" do objeto "Tipo de imóvel" associado ao imóvel.

Os valores disponíveis para os campos "Tipo de imóvel Zap" dos objetos "Imóvel" e "Tipo de imóvel" são definidos no conjunto de valores da lista de opções "Tipo de imóvel Zap".

Subtipo do imóvel

Referências

Manual de integração do Zap

O desenvolvimento desta integração foi baseado no Manual_Integração_Zap.pdf

Inicio do processo

O processo é automático e começa quando o serviço ~~CobrancaEnviarArquivoRetornoSchedule~~ no sistema agrupa todos os imóveis disponíveis para locação e gera um arquivo XML no formato Portal Zap.

término do processo

O processo termina quando o arquivo XML é gerado e consumido pelo Portal Zap.

Pré requisitos para geração do arquivo

O agendamento de serviço é um pré-requisito para o processo automático de geração de arquivo XML no SnapProperty. É necessário que o contrato de prestação de serviços entre a administradora de imóveis e o Portal Zap esteja em vigor.

Ativação do serviço "geração de arquivo XML"

O serviço ~~CobrancaEnviarArquivoRetornoScheduler~~, agrupa os imóveis disponíveis para locação e gera uma arquivo XML para consumo do Portal Zap,

Métodos utilizados:

~~CobrancaServico.enviarRetornoCobranca(retorno); ?~~

~~CobrancaTecnoSpeed.EnviarRetornoCobranca();?~~

Para a ativação do serviço de geração de arquivo XML e necessário o agendamento de serviços, para configurá-lo siga os passos abaixo:

Acesse o SnapProperty
Clique em "Configurações"
No campo "Pesquisar" digite "Classes do apex"
Clique no botão "Agendar apex"
Preencha os campos solicitados - todos os campos são obrigatórios
1. Nome do trabalho (informe o nome que deseja para identificar este agendamento)
2. Classe do apex (informe o nome do serviço que deseja agendar, neste caso é o "~~CobrancaEnviarArquivoRetornoScheduler~~"
3. Freqüência (selecione a recorrência nas opções "Semanal" ou "Mensal" e um ou mais dias da semana para a repetição)
4. Iniciar (informe a data inicio que o serviço deve estar ativo)
5. Finalizar (informe a data fim que o serviço deve expirar)
6. Horário de inicio preferencial (selecione o horário que o serviço deve iniciar sua execução)
Clique no botão "Salvar"

Configuração da pasta pública

Está configuração é para o apontamento onde o arquivo XML gerado, será encaminhado para o consumo do Portal Zap. A cada apontamento de um novo arquivo o mesmo irá substituir o existente.

Para configurá-lo siga os passos abaixo:

Acesse o SnapProperty
Clique em "Configurações"
.....

Cancelamento do serviço "geração de arquivo XML"

Para configurar o cancelamento do serviço ~~CobrancaEnviarArquivoRetornoScheduler,~~ siga os passos abaixo:

Acesse o SnapProperty
Clique em "Configurações"
No campo "Pesquisar" digite "Classes do apex"
Pesquise o serviço "~~CobrancaEnviarArquivoRetornoSchedule"~~
Clique no botão "Editar"
~~Preencha os campos solicitados - todos os campos são obrigatórios~~
1. ~~Nome do trabalho (informe o nome que deseja para identificar este agendamento)~~
2. ~~Classe do apex (informe o nome do serviço que deseja agendar, neste caso é o "CobrancaEnviarArquivoRetornoScheduler"~~
3. ~~Freqüência (selecione a recorrência nas opções "Semanal" ou "Mensal" e um ou mais dias da semana para a repetição)~~
4. ~~Iniciar (informe a data inicio que o serviço deve estar ativo)~~
5. ~~Finalizar (informe a data fim que o serviço deve expirar)~~
6. ~~Horário de inicio preferencial (selecione o horário que o serviço deve iniciar sua execução)~~
Clique no botão "Salvar"