Relatório de integração - Banco de dados Alexânia

1. Objetivo

O presente relatório tem o intuito de apresentar o fluxo de integração entre o banco do tributário e o Geo360. É importante destacar que os dados do Geo360 serão atualizados a partir do tributário. A integração deve ser iniciada após o consumo dos dados da Topocart pelo sistema tributário.

2. Sistema de integração

O sistema de integração foi desenvolvido na plataforma n8n (Sistema de workflow) versão free. O workflow é um sistema de gerenciamento de fluxo de trabalho que fornece uma infraestrutura para configuração, desempenho e monitoramento de tarefas sequenciadas.

• Disponível em: clique_aqui (opens in a new tab), para usuários com permissão.

• Diretório de localização do workflow: /opt/docker-alexania

Inicialmente vamos considerar as alterações dos últimos dois meses, posteriormente a atualização ocorrerá a cada 30 minutos através do workflow, que busca e incorpora as alterações e inserções realizadas nas últimas 24 horas.

3. Fluxo de atualização no Geo360

Os dados do Geo360 são atualizados a partir do workflow que consome os seguintes endpoints disponibilizados pelo cliente:

• contribuintes;
• ipCadCrt;
• ipCadDesdocrt;
• ipRelAreas;
• ipCadArea;
• logradouros;
• ipCobranca;
• imoveis.

Segue informações mais detalhadas para cada fluxo do workflow:

3.1 Pessoa (contribuintes)

Para a atualização dos dados do contribuinte, primeiramente é verificado se o código do cliente está presente no banco de dados do Geo360 para atualização. Quando o registro não existir, os dados da pessoa são inseridos na tabela correspondente.

3.1.1 Diagrama de workflow pessoa

3.2 Característica (ipCadCrt)

Cada característica do tributário corresponde a uma tabela de domínio no banco de dados do Geo360. A característica refere-se ao nome da tabela que irá armazenar o desdobro.

Ao identificar um novo código de característica, o workflow cria automaticamente uma nova tabela e adiciona uma coluna na tabela de referência correspondente, com o mesmo nome da característica.

Ou seja, além da criação da nova tabela de domínio, quando tipoCrt = E, a coluna da característica é criada na tabela de edificação, quando tipoCrt = T a coluna é criada na tabela de lote. Essa etapa é realizada automaticamente pelo sistema de integração.

Para criar um novo lote, siga o passo a passo do item 4.2.

Exemplo: Característica pedologia

3.2.1 Diagrama de workflow característica

3.3 Desdobro (ipCadDesdocrt)

O desdobro apresenta as descrições das características, ou seja, os valores pré-determinados que compõem a tabela de domínio (característica). Para atualização do desdobro, inicialmente é constatado se houve alguma alteração, e se o código já existe no banco de dados do Geo360.

Caso seja um novo registro, essa informação é inserida na sua respectiva tabela de domínio. Ressaltando que é de suma importância mapear no formulário do geo360 as novas características e seus respectivos desdobros.

3.3.1 Mapear no Geo360

Confirme no banco de dados o código do desdobro, nesse exemplo, vamos acrescentar o tipo de pedologia ARENOSO, com código = 5, na camada lote.

Para mapear um novo desdobro, é necessário acessar o gerenciador do módulo. No entanto, essa alteração só pode ser realizada por usuários administradores.

Clique na camada/tabela de referência, e selecione o formulário desejado:

Encontre a característica que deseja acrescentar o desdobro:

No formulário, clique em ‘Adicionar opção’, no primeiro campo digite a descrição, no segundo campo (valor bando de dados) insira o código correspondente ao desdobro no banco de dados, e salve as alterações.

3.3.2 Diagrama de workflow - Desdobro

3.4 Característica/Desdobro - Edificação e lote (ipRelAreas)

Conforme supracitado, a característica e o desdobro correspondem aos dados do domínio. Nessa etapa, o sistema de integração atualiza especificamente o dado do imóvel nas camadas de lote e edificação, após verificar nos dados do tributário se a característica/desdobro corresponde a terreno ou edificação.

Exemplo de característica do terreno, atualização na camada lote:

Exemplo de característica da edificação, atualização na camada edificação:

3.4.1 Diagrama de workflow

3.5 Área - Edificação e lote (ipCadAreas)

Inicialmente, o workflow identifica se a área corresponde a um atributo do terreno ou da edificação. Diante disso, atualiza na tabela correspondente, a área informada pelo tributário, sendo elas: área da testada do lote, área da profundidade do lote, área privativa do terreno e a área da edificação.

Além disso, se a edificação não existir, a partir do cod_area, cria-se a nova edificação. Para inserção de um novo imobiliário, siga as instruções do item 4.3. Após a criação da geometria, o fluxo de atualização seguirá pelo workflow.

3.5.1 Diagrama de workflow

3.6 Logradouro (Logradouros)

Foi adotado a partir de 650000 os novos códigos para os logradouros lançados pela Topocart. Portanto é imprescindível que essas informações sejam consumidas pelo tributário, para que possamos realizar tanto a atualização, quanto a inserção pelo sistema de integração.

Foi elaborado o processo de atualização de logradouro, porém, não adicionamos a parte de inserção para evitar que seja inserido códigos diferentes com mesmo nome de logradouro.

A atualização ocorrerá quando o código existir no Geo360. É importante ressaltar que, para a inserção de um novo logradouro, é necessário criar a geometria e preencher os atributos no Geo360.

Para criar a geometria do logradouro, siga as instruções do item 4.1.

3.6.1 Diagrama de workflow logradouro

3.7 Cobrança (ipCobranca)

O workflow verifica se todos os tipos de cobrança existem na tabela de desdobro na base de dados do Geo360. Quando é identificado um novo registro, a aplicação insere nas informações na tabela de domínio tipo_cobranca, de acordo com as novas informações fornecidas pelo cliente.

3.7.1 Diagrama de workflow cobrança

3.8 Imóveis (imoveis)

Para atualização e inserção de dados, a aplicação confirma se o código do imóvel existe no banco de dados do Geo360. Com base nessa verificação, a aplicação atualiza os dados nas tabelas associadas ao respectivo imóvel: lote, imobiliario, endereco_correspondencia, logradouro e imobiliario_pessoa. Se o código do imóvel não existir, a aplicação verifica se o lote já está cadastrado. Se o lote existir, um novo imóvel será registrado sem geometria. Caso o lote não exista, a aplicação cria tanto o lote quanto o imóvel, ambos sem geometria.

Quanto à criação da geometria, é necessário adicioná-la através do Geo360. Para isso, siga as instruções do item 4.3.

3.8.1 Diagrama de workflow imóvel

4 Lançamento de geometria

Para a inserção de novos registros oriundos do tributário, como dados de imóveis, lotes, logradouros e edificações, é essencial que a geometria seja criada no Geo360:

4.1 Geometria logradouro

A camada logradouro é representada por uma geometria tipo linha. Para dar início a criação do logradouro, é necessário clicar na camada e habilitar a edição.

No local desejado, habilite a ferramenta Desenhar na barra de ferramentas.

Em seguida, habilite a ferramenta Snap. Para facilitar a adição e criação de geometrias, essa ferramenta funciona como um imã, permitindo que ao criar um vértice, o cursor seja atraído para outro segmento existente.

Com as ferramentas ativadas, comece a desenhar. Cada clique adiciona um vértice. Vale ressaltar que outras geometrias podem ser utilizadas como referência quando a ferramenta Snap estiver ativada. Para encerrar o desenho, basta clicar duas vezes com o mouse. Ao encerrar, a geometria será salva automaticamente.

Para adicionar informações como nome, código e outros atributos, clique em cima da geometria desejada. Automaticamente irá abrir uma janela do lado direito da tela, clique no ícone para salvar. Alerto que é obrigatório o preenchimento do código no logradouro para que ocorra a atualização através da integração.

4.2 Geometria lote

Inserção de geometria em lotes existentes:

Na camada Lote, habilite a edição. Na mesma janela, abra a tabela de atributos:

Encontre a coluna geometria:

Classifique em ordem decrescente para visualizar os lotes que não possuem geometria (campo geom vazio):

Selecione o lote desejado, e no campo ferramenta para visualizar as opções disponíveis:

Selecione a opção Desenhar geometria:

Automaticamente irá acionar a ferramenta para desenhar, minimize a tabela de atributos. O lote é representado por um polígono. Com a ferramenta habilitada, adicione os vértices com um clique e para finalizar a criação, clique no primeiro vértice novamente para fechar o polígono. Vale ressaltar que outras geometrias podem ser utilizadas como referência quando a ferramenta Snap estiver ativada.

Para que o lote receba as atualizações por meio do workflow após a sua criação, é imprescindível a criação da geometria do imobiliário, pois em virtude da duplicidade de inscrição cartográfica entre lotes, não é possível atualizar o lote individualmente através do workflow. Para criar a geometria do imobiliário, siga as instruções do item 4.3.

Quando o registro do lote não existe na tabela de atributos, é necessário criar a geometria, e preencher alguns campos. Primeiramente, na camada Lote, habilite a edição, e selecione a ferramenta Desenhar.

Adicione os vértices. Para finalizar a criação, clique no primeiro vértice novamente criado para fechar o polígono.

Quando for um novo lote, é imprescindível o preenchimento do número cadastro e da inscrição cartográfica. Para editar informações referente ao lote, clique no ícone da caracterização na parte superior da janela à direita da tela.

O usuário será redirecionado para outra página, a aba de caracterização. Adicione as informações desejadas, e salve as alterações.

OBSERVAÇÃO: A aplicação não insere novos cadastros quando o lote possui inscrições cartográficas repetidas. Portanto, quando novas, é necessário realizar o cadastro manualmente no Geo360, conforme passo a passo:

Na camada Lote, habilite a edição, e selecione a ferramenta Desenhar.

Adicione os vértices. Para finalizar a criação, clique no primeiro vértice novamente criado para fechar o polígono.

Para editar informações referente ao lote, clique no ícone da caracterização na parte superior da janela à direita da tela.

O usuário será redirecionado para outra página, a aba de caracterização. Adicione as informações desejadas, e salve as alterações.

4.3 Geometria imobiliário

Primeiramente habilite a edição da camada:

Na mesma janela, abra a tabela de atributos:

Encontre a coluna Código área tributário terreno:

Filtre pelo código desejado:

Outra opção é ordenar de forma decrescente a coluna Geometria, para visualizar os imobiliários que não possuem geometria:

Selecione a linha do imobiliário desejado e habilite a ferramenta Desenhar geometria:

O imobiliário é representado por uma geometria do tipo ponto, clique uma única vez, no meio do lote para adicionar o ponto no local correto:

Selecione a camada lote, e clique sobre o lote em que o imobiliário foi lançado, para acessar a caracterização:

Preencha as informações do imóvel na aba de caracterização, nesta etapa é obrigatório informar o código do imóvel (numero_cadastro).

4.4 Geometria edificação

A camada edificação é representada por um polígono, selecione e habilite a edição da camada edificação.

Na mesma janela, abra a tabela de atributos:

Encontre a coluna Código área tributário:

Filtre pelo código desejado:

Outra opção é ordenar de forma decrescente a coluna Geometria, para visualizar as edificações que não possuem geometria:

Selecione a linha da edificação desejada e habilite a ferramenta Desenhar geometria:

Automaticamente a ferramenta de desenho será ativada, minimize a tabela de atributos e desenhe o polígono, adicionando os vértices. Para fechar o polígono da edificação, clique no primeiro vértice novamente:

Após a criação da edificação, é imprescindível vincular a edificação ao imobiliário, através da aba de caracterização. Selecione a camada lote e clique na geometria do lote em que a edificação está situada. Na aba lateral, clique no ícone de caracterização, para ser redirecionado.

Selecione a edificação e clique no ícone “Vincular edificação a unidade imobiliária selecionada”, conforme o exemplo a seguir, e salve as alterações.