Integração Base Locaçao - Procedimentos

De WikiBase

Regras Gerais

  1. A Integração sempre será unidirecional, tomando como fonte de dados o sistema Base Locação. Informações atualizadas no cadastro de imóveis do Base Casa não serão atualizadas no Base Locação, porém, qualquer informação atualizada no Base Locação abrangendo os campos relacionados a seguir, serão atualizadas automaticamente no Base Casa.
  2. Com relação ao cadastro de proprietários a integração atingirá os campos: status (ativo/inativo), nome, endereço completo, CPF, e-mail e telefones.
  3. Com relação ao cadastro de imóveis a integração atingirá os campos: status (livre/inativo/alugado), tipo, natureza, endereço completo, área (correspondente ao campo área útil do cadastro de imóvel no Base Locação), código do proprietário, valor (correspondente ao campo valor do aluguel do cadastro de imóvel no Base Locação) e, respectivamente, valor do condomínio e valor do IPTU.
  4. Cadastros de proprietários/imóveis pré-existentes no Base Casa deverão ser compatibilizados de acordo com os respectivos códigos no Base Locação através de um assistente, bem como outras configurações conforme orientações à seguir.
  5. Os proprietários e imóveis serão inseridos e/ou atualizados somente à partir do momento em que existir cadastro de administração que relacione o proprietário e o imóvel no sistema Base Locação.
Atencao.png

Os valores de aluguel, condomínio e IPTU terão sempre como origem o cadastro do imóvel, não existe nenhum tipo de atualização financeira do imóvel tendo como origem movimentações financeiras do Base Locação. Portanto, o imóvel será inserido no Base Casa somente se o campo Valor do Aluguel estiver preenchido e for maior que zero.

Ativando a Integração (Utilitários > Parâmetros Gerais > Outras Configurações > Integração com Base Locação)

A ativação do processo de integração é feita através do cadastro de parâmetros do Base Casa. Nessa tela, deverão ser configurados todos os campos necessários.
BaseCasa Parametros Integracao.JPG
Ao clicar na opção "Ativar" serão exibidos os campos necessários para a devida configuração:
  • Aba Caminhos
BaseCasa Integracao Caminhos.JPG
Nessa área deverão ser configurados os parâmetros necessários para a conexão com o banco de dados do Sistema Base Locação, essas configurações poderão ser conseguidas com a pessoa responsável pela administração do sistema ou através de contato com o suporte.
Campos:
  1. Servidor - Endereço IP do servidor do banco de dados.
  2. Local do banco de dados - Endereço físico do diretório do banco de dados.
  3. Nome do banco de dados - Nome do arquivo do banco de dados, no caso sqs2000.fdb.
  4. Usuário - Nome do usuário para conexão com o banco de dados.
  5. Senha - Senha de conexão como banco de dados.
Dica.png

O arquivo de configuração SQS2000Loca.ini, na seção dados, tem essas informações necessárias conforme o exemplo abaixo:

[Dados]

Servidor=192.168.0.2

Caminho=C:\BaseSoft\Dados\sqs2000.fdb

user_name=SYSDBA

password=masterkey

Observar que os campos "Local do banco de dados" e "Nome do banco de dados" são preenchidos de acordo com a chave Caminho.

  • Aba Informações Complementares
BaseCasa Integracao Informacoes.JPG
Nessa área deverão ser configurados os demais parâmetros da integração.
Campos:
  1. Filial padrão - Filial que deverá ser utilizada, caso não tenha nenhum mapeamento de filial para a integração entre o Base Locação e o Base Casa.
  2. Disponível para internet - Status do imóvel na inclusão automática, caso esteja marcado, todos os imóveis serão inseridos com status disponível. É aconselhável que este campo esteja desmarcado, assim é possível fazer uma validação dos cadastros antes do envio dos imóveis.
  3. Utilizar prefixo no referencial - Prefixo que poderá ser utilizado para compor a referência do imóvel. Esse campo é opcional, porém, independente do prefixo o referencial sempre será composto pelo código de origem do imóvel no Base Locação.
Também é possível mapear filiais distintas para a inclusão de imóveis, caso haja a necessidade basta fazer o mapeamento por filial, conforme o exemplo abaixo. Porém, para as filiais que não tiverem nenhum tipo de mapeamento sempre será utilizado o campo "Filial padrão" e, não havendo necessidade, esse tipo de configuração é dispensada.
BaseCasa Integracao InformacoesFiliais.JPG


Atencao.png

O mapeamento de filial somente terá efeito na inclusão automática de novos imóveis, caso haja alguma alteração de filial no banco de dados do Base Locação e o imóvel já esteja integrado ao Base Casa, a alteração de filial não surtirá efeito.


  • Aba Sincronismo


BaseCasa Integracao InformacoesSincronismo.JPG


Nessa área deverão ser configurados os parâmetros para o módulo de integração.
Atencao.png

As demais opções da integração serão ativadas somente após a configuração desses parâmetros.

Compatibilizando os Códigos (Utilitários > Integração com Base Locação > Compatibilização de Códigos)

Poderão ocorrer situações em que o cadastro do proprietário ou imóvel já tenha sido feito no Base Casa, porém sem nenhum tipo de vínculo com o sistema Base Locação.
Nesse caso, antes de inciar o programa de integração esses cadastros deverão ser compatibilizados, ou seja, para cada proprietário e imóvel cadastrado no Base Casa deverá ser apontado o código correspondente no Base Locação.


BaseCasa Integracao Copatibilizacao.JPG


Atencao.png

Os clientes e imóveis originados do Base Locação que não tiverem a compatibilização de códigos com o Base Casa, serão considerados como novos cadastros. Portanto, a compatibilização de códigos é importante para evitar a duplicidade de cadastros.

Iniciado o programa de integração, a inclusão de novos clientes e imóveis provenientes do Base Locação será automática, dispensando a necessidade de novo cadastro no Base Casa.

Primeira Carga (Utilitários > Integração com Base Locação > Primeira Carga)

A execução da primeira carga é o próximo passo após à compatibilização dos códigos.
Esse procedimento gera os primeiros arquivos de LOG para atualização de todos os imóveis no sistema Base Casa.


Dica.png

A primeira carga poderá ser executada mais de uma vez, porém só serão criados LOG's para imóveis que ainda não tenham sido incluídos.

Após a execução da primeira carga, a manutenção de LOG's tanto para inclusão quanto para atualização dos cadastros passa a ser automática e a repetição desse procedimento deverá ser feita somente em algum caso especial, por exemplo alguma eventual falha do banco de dados.


Atencao.png

Para evitar duplicidade de cadastro, verifique a compatibilização dos códigos (passo anterior).

Qualquer imóvel proveniente do Base Locação que não tenha o respectivo código compatibilizado no Base Casa será encarado como um novo cadastro.


BaseCasa Integracao PrimeiraCarga.JPG

Executando o Módulo de Integração

O módulo de integração com o sistema Base Locação está incluído na instalação completa e update a partir da versão 1.0.5 do Base Casa em conjunto com a versão 1.8.0.490 do Base Locação. No momento da instalação, o executável (Base_Locacao_Integracao.exe) será copiado para o mesmo diretório do sistema.


BaseCasa Integracao Diretorio.JPG


A execução do programa é automática através do menu de inicialização, porém ele ficará ativo somente depois de feitas as configurações iniciais.


BaseCasa Integracao Atalhos.JPG


Na primeira execução será feita a inclusão dos dados que não tiverem os códigos compatibilizados e a alteração dos cadastros compatibilizados.


Dica.png

Para esclarecer dúvidas sobre códigos compatibilizados voltar ao item Compatibilizando os códigos (Utilitários > Integração com Base Locação > Compatibilização de Códigos).


A opção restaurar (clicando com o botão direto do mouse sobre o ícone) abre a tela do módulo de integração exibindo os LOG's que por ventura não foram enviados para o Base Casa.


Dica.png

O limite de tentativas de envio poderá ser configurado, conforme explicado no início.

Após a correção das inconsistências, que será explicado mais adiante, as tentativas de envio poderão ser zeradas através do botão "zerar tentativas" para que um novo envio seja feito.


BaseCasa Integracao Logs.JPG


O botão "Relatório" acessa a relação de LOG's pendentes, onde poderão ser consultadas as inconsistências encontradas na integração.


BaseCasa RelacaoLogs tela.JPG


Modelo
BaseCasa RelacaoLogs modelo.JPG


Dica.png

As inconsistências poderão ocorrer, principalmente, devido à incompatibilidade de endereços relacionada aos campos UF, município e bairro, geralmente por erros de digitação no Base Locação ou falta da informação no sistema Base Casa.

No caso de inclusão/atualização de proprietários a informação será processada, porém o endereço do proprietário não será atualizado.

No caso de imóveis a informação será processa somente após a correção das inconsistências explicado adiante.


Corrigindo Inconsistências de Endereço

Estados não importados no Base Casa

Acessar a opção Utilitários > Importar UF, através do menu principal do Base Casa.
BaseCasa ImportarUF.JPG

Erros de digitação

O primeiro passo é alterar o cadastro do proprietário ou imóvel, fazendo com que os campos estejam de acordo com os padrões do Base Casa.
Porém, poderão ocorrer situações onde a correção não seja possível, como por exemplo um bairro que já esteja cadastrado em vários imóveis.
Esses casos poderão ser corrigido através do arquivo de mapeamento (Base_Integracao.map) que estará no diretório do Base Casa.


BaseCasa Integracao ArquivoMapeamento.JPG


Esse arquivo poderá ser editado pelo bloco de notas e nele serão incluídos os mapeamentos para UF, município e estado, conforme o exemplo abaixo.


BaseCasa Integracao ArquivoMapeamento exemplo.JPG


Segundo o exemplo acima:
  1. Todos os campos estado que estiverem preenchidos com "RR" serão substituídos por "RJ" na integração.
  2. Todos os campos município que estiverem preenchidos com "RIO DE FEVEREIRO" serão substituídos por "RIO DE JANEIRO" na integração.
  3. Todos os campos bairro que estiverem preenchido com "RECREIO BANDEIRANTES" serão substituídos por "RECREIO DOS BANDEIRANTES" na integração, seguindo o mesmo critério para os demais bairros do arquivo.


Dica.png

Originalmente, o arquivo Base_Integracao.map já vai com algumas inconsistências corrigidas na instalação, levando em consideração a tabela pré-cadastrada de municípios e bairros do sistema Base Locação, confrontando com os dados válidos para o Base Casa.

Essas informações deverão ser complementadas de acordo com o cadastro de cada cliente.



Categoria:Notas de Versões Base Casa