Base Filtro Integração da Base de Dados

De WikiBase

Conceitos da integração da base de dados do cliente com o site.

Visão Geral

A atualização da base de dados e arquivos do cliente no Site é feita através do programa IExpress.

O IExpress faz a leitura de um arquivo padrão (veja layout a seguir) onde estão todas as informações cadastrais das entidades que serão importadas, incluindo os arquivos pertinentes a cada entidade e transmite os dados para o site do cliente.

Arquivo de Entidades

O arquivo de entidades deve ser do tipo texto (sugerimos o nome Entdados.txt) com colunas fixas onde cada linha representará um registro e as colunas fixas representaram os campos.

Cada tipo de entidade é identificada por um código padrão (posição 7 de cada registro), conforme os padrões a abaixo:

  • 1 - Condomínio
  • 2 - Condômino
  • 3 - Unidade
  • 4 - Arquivo
  • 5 - Proprietário (Locador)
  • 6 - Locatário (Inquilino)
  • 7 - Corretor
  • 8 - Síndico (no caso de profissional externo)
  • 9 - Gerentes (podendo ser atendentes também)

Layout

Tipo 1 (Condomínio)

Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 7 1 1 - Condomínio.
*Código Interno 8 10 O código interno é único para identificação da entidade e não deverá se repetir em nenhuma outra (exceto para arquivos onde deverá ser informado o código interno da entidade responsável), sugestão Tipo+Código do condomínio
*Nome da Entidade 18 40 Nome do Condomínio
Código da Entidade Responsável 58 10 Sem uso para a entidade do tipo condomínio.
*Status 68 1 A-Ativo C-Cancelado (o status C deverá ser utilizado para desativar um condomínio no site).
Endereço 69 40  
Complemento 109 40  
Bairro 149 20  
Município 169 20
Estado 189 2  
CEP 191 9  
Telefone Comercial 200 20  
Telefone Fax 220 20  
DDD Comercial 240 4  
DDD Fax 244 4  
CNPJ 248 20  
Inscrição Estadual 268 20  
CEI 288 20  
Nome do Responsável 308 30  
Tipo de Condomínio 338 25  
Código da unidade de síndico 363 10 Código interno da unidade do síndico ou código interno do síndico profissional externo.
Login 373 20 Utilizado para o acesso ao site, caso esteja vazio será utilizado o Código Interno.
Senha 393 20  
Código do Gerente 413 10 Código Interno do Gerente - Podendo ser também atendente, não esquecer que o registro de gerente deve ser informado antes
Email 423 60  

Tipo 2 (Condômino)

Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 7 1 2-Condômino
*Código Interno 8 10 O código interno é único para identificação da entidade e não deverá se repetir em nenhuma outra (exceto para arquivos onde deverá ser informado o código interno da entidade responsável), sugestão Tipo + Código Condomínio + Código do Condômino
*Nome da Entidade 18 40 Nome do Condômino
Login 58 20 Utilizado para acesso ao site, caso vazio será utilizado o Código Interno.
Senha 78 20  
*Código da Entidade Responsável 98 10 Código Interno do Condomínio
Email 108 60  
Tipo de Pessoa 168 1 F-Física J-Jurídica.
*Status 169 1 A-Ativo C-Cancelado (o status C deverá ser utilizado para desativar um condômino no site).
Tipo de Endereço 170 15  
Endereço 185 40  
Complemento 225 40  
Bairro 265 20  
Município 285 20  
Estado 305 2  
CEP 307 9  
Aceita Receber Email 316 1 T-True F-False
Sexo 317 1 M-Masculino F-Feminino
CPF 318 20  
Identidade 338 20  
Órgão Emissor 358 10  
Data de Emissão 368 10 DD/MM/AAAA
Data de Nascimento 378 10 DD/MM/AAAA
Profissão 388 20  
CNPJ 408 20  
Inscrição Estadual 428 20  
Nome do Responsável 448 30  
Inscrição Municipal 478 20  
Telefone Residencial 498 20  
Telefone Comercial 518 20  
Telefone Fax 538 20  
DDD Residencial 558 4  
DDD Comercial 562 4  
DDD Fax 566 4  
Telefone Móvel 570 20  
DDD Móvel 590 4  
Código do Gerente 594 10 Não é utilizado neste tipo de entidade, porém o espaço deve ficar reservado.

Tipo 3 (Unidade)

Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 7 1 3-Unidade
*Código da Unidade 8 10 Código interno do condomínio mais o código da unidade.
Tipo de Unidade 18 30  
*Descrição da Unidade 48 30  
Balancete por Email 88 1 T-True F-False

Tipo 4 (Arquivo)

Dica.png

Os arquivos deverão ser gerados em formatos válidos para visualização na Internet.

Sugerimos os formatos HTML ou PDF.

Os arquivos provenientes de sistemas de folha de pagamento do condomínio também poderão ser incorporados ao site, desde que respeitem as exigências do layout.


Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 7 1 4-Arquivo
*Código Interno 8 10 Código interno da Entidade a qual o arquivo pertence.
*Pasta 18 50 Descrição da pasta de exibição no site.
*Tipo 68 50 Descrição do tipo de arquivo para exibição no site.
*Descrição do Arquivo 118 50 Nome do arquivo para exibição no site.
*Acesso 168 1 P-Público R-Restrito. Arquivos públicos poderão ser vistos por todas as entidades filhas, arquivos restritos serão vistos somente pela entidade (Ex. Se um balancete for de acesso público poderá ser visto por todas as unidades do condomínio, sendo privado somente o condomínio (síndico) poderá ver.
Data de Expiração 169 10 DD/MM/AAA. Até que data o arquivo estará disponível no site.
Data Inicial 179 10 DD/MM/AAA. Data inicial referente ao período do arquivo.
Data Final 189 10 DD/MM/AAA. Data Final referente ao período do arquivo.
*Status 199 1 A-Ativo C-Cancelado (o status C deverá ser utilizado para desativar o arquivo no site).
*Arquivo 200 120 Nome do arquivo incluindo o caminho que pode ser absoluto ou relativo.

Tipo 5 (Proprietário/Locador)

Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 7 1 5-Proprietário
*Código Interno 8 10 O código interno é único para identificação da entidade e não deverá se repetir em nenhuma outra (exceto para arquivos onde deverá ser informado o código interno da entidade responsável), sugestão Tipo+Código do proprietário.
*Nome da Entidade 18 40 Nome do proprietário.
Login 58 20 Utilizado para acesso ao site, caso vazio será o Código Interno.
Senha 78 20  
Código da Entidade Responsável 98 10 Não utilizado para esse tipo de entidade.
Email 108 60  
Tipo de Pessoa 168 1 F-Física J-Jurídica
*Status 169 1 A-Ativo C-Cancelado (o status C deverá ser utilizado para desativar o proprietário no site).
Tipo de Endereço 170 15  
Endereço 185 40  
Complemento 225 40  
Bairro 265 20  
Município 285 20  
Estado 305 2  
CEP 307 9  
Aceita Receber E-mail 316 1 T-True F-False
Sexo 317 1 M-Masculino F-Feminino
CPF 318 20  
Itentidade 338 20  
Órgão Emissor 358 10  
Data da Emissão 368 10 DD/MM/AAAA
Data de Nascimento 378 10 DD/MM/AAAA
Profissão 388 20  
CNPJ 408 20  
Inscrição Estadual 428 20  
Nome do Responsável 448 30  
Inscrição Municipal 478 20  
Telefone Residencial 498 20  
Telefone Comercial 518 20  
Telefone Fax 538 20  
DDD Residencial 558 4  
DDD Comercial 562 4  
DDD Fax 566 4  
Telefone Móvel 570 20  
DDD Móvel 590 4  
Código do Gerente 594 10 Código Interno do Gerente - Podendo ser também atendente, não esquecer que o registro de gerente deve ser informado antes

Tipo 6 (Locatário/Inquilino)

Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 7 1 6-Locatário
*Código Interno 8 10 O código interno é único para identificação da entidade e não deverá se repetir em nenhuma outra (exceto para arquivos onde deverá ser informado o código interno da entidade responsável), sugestão Tipo + Código do Locador + Código do Imóvel ou Código do Locatário.
*Nome da Entidade 18 40 Nome do locatário.
Login 58 20 Utilizado para acesso ao site, caso vazio será o Código Interno.
Senha 78 20  
*Código da Entidade Responsável 98 10 Código interno do proprietário.
Email 108 60  
Tipo de Pessoa 168 1 F-Física J-Jurídica
*Status 169 1 A-Ativo C-Cancelado (o status C deverá ser utilizado para desativar o locatário no site).
Tipo de Endereço 170 15  
Endereço 185 40  
Complemento 225 40  
Bairro 265 20  
Município 285 20  
Estado 305 2  
CEP 307 9  
Aceita Receber E-mail 316 1 T-True F-False
Sexo 317 1 M-Masculino F-Feminino
CPF 318 20  
Itentidade 338 20  
Órgão Emissor 358 10  
Data da Emissão 368 10 DD/MM/AAAA
Data de Nascimento 378 10 DD/MM/AAAA
Profissão 388 20  
CNPJ 408 20  
Inscrição Estadual 428 20  
Nome do Responsável 448 30  
Inscrição Municipal 478 20  
Telefone Residencial 498 20  
Telefone Comercial 518 20  
Telefone Fax 538 20  
DDD Residencial 558 4  
DDD Comercial 562 4  
DDD Fax 566 4  
Telefone Móvel 570 20  
DDD Móvel 590 4  
Código do Gerente 594 10 Não é utilizado neste tipo de entidade, porém o espaço deve ficar reservado.

Tipo 8 (Síndico/Profissional Externo)

Atencao.png

Esse tipo de registro deverá ser gerado somente no caso do síndico não ser um condômino ligado à uma unidade do condomínio.

Porém, no caso da unidade ter um locatário (inquilino) e o síndico ser o condômino, ele deverá ser vinculado como profissional externo para evitar acesso do locatário com poder de síndico.

Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 8 1 8-Síndico
*Código Interno 8 10 O código interno é único para identificação da entidade e não deverá se repetir em nenhuma outra (exceto para arquivos onde deverá ser informado o código interno da entidade responsável), sugestão Tipo + Código do Condomínio + '99999'.
*Nome da Entidade 18 40 Nome do síndico.
Login 58 20 Utilizado para acesso ao site, caso vazio será o Código Interno.
Senha 78 20  
Código da Entidade Responsável 98 10  
Email 108 60  
Tipo de Pessoa 168 1 F-Física J-Jurídica
*Status 169 1 A-Ativo C-Cancelado (o status C deverá ser utilizado para desativar o síndico no site).
Tipo de Endereço 170 15  
Endereço 185 40  
Complemento 225 40  
Bairro 265 20  
Município 285 20  
Estado 305 2  
CEP 307 9  
Aceita Receber E-mail 316 1 T-True F-False
Sexo 317 1 M-Masculino F-Feminino
CPF 318 20  
Itentidade 338 20  
Órgão Emissor 358 10  
Data da Emissão 368 10 DD/MM/AAAA
Data de Nascimento 378 10 DD/MM/AAAA
Profissão 388 20  
CNPJ 408 20  
Inscrição Estadual 428 20  
Nome do Responsável 448 30  
Inscrição Municipal 478 20  
Telefone Residencial 498 20  
Telefone Comercial 518 20  
Telefone Fax 538 20  
DDD Residencial 558 4  
DDD Comercial 562 4  
DDD Fax 566 4  
Telefone Móvel 570 20  
DDD Móvel 590 4  
Código do Gerente 594 10 Não é utilizado neste tipo de entidade, porém o espaço deve ficar reservado.

Tipo 9 (Gerente/Atendente)

Atencao.png

Caso se opte por gerar, esse tipo de registro deverá ser o primeiro do arquivo, possibilitando a identificação do código interno do gerente dentro das entidades do tipo Condomínio ou Proprietário.


Os campos obrigatórios estão indicados com (*).

Campo Posição Tamanho Observações
*Sequencial 1 6 Sequencial do registro Ex.: 000001 .. 00000N
*Tipo 8 1 9-Gerente
*Código Interno 8 10 O código interno é único para identificação da entidade e não deverá se repetir em nenhuma outra (exceto para arquivos onde deverá ser informado o código interno da entidade responsável), sugestão Tipo + Código do Gerente.
*Nome da Entidade 18 40 Nome do gerente.
Login 58 20 Utilizado para acesso ao site, caso vazio será o Código Interno.
Senha 78 20  
Código da Entidade Responsável 98 10  
Email 108 60  
Tipo de Pessoa 168 1 F-Física J-Jurídica
*Status 169 1 A-Ativo C-Cancelado (o status C deverá ser utilizado para desativar o síndico no site).
Tipo de Endereço 170 15  
Endereço 185 40  
Complemento 225 40  
Bairro 265 20  
Município 285 20  
Estado 305 2  
CEP 307 9  
Aceita Receber E-mail 316 1 T-True F-False
Sexo 317 1 M-Masculino F-Feminino
CPF 318 20  
Itentidade 338 20  
Órgão Emissor 358 10  
Data da Emissão 368 10 DD/MM/AAAA
Data de Nascimento 378 10 DD/MM/AAAA
Profissão 388 20  
CNPJ 408 20  
Inscrição Estadual 428 20  
Nome do Responsável 448 30  
Inscrição Municipal 478 20  
Telefone Residencial 498 20  
Telefone Comercial 518 20  
Telefone Fax 538 20  
DDD Residencial 558 4  
DDD Comercial 562 4  
DDD Fax 566 4  
Telefone Móvel 570 20  
DDD Móvel 590 4  
Código do Gerente 594 10 Não é utilizado neste tipo de entidade, porém o espaço deve ficar reservado.

Arquivos de Exemplo

Atencao.png

O arquivo Icondo.zip contém a estrutura de todos os arquivos gerados, incluindo o arquivo de entidades e gráficos em XML.

Como exemplo foram gerados arquivos do tipo HTML.

Gráficos

O ICondo permite a demonstração de estatísticas financeiras dos condomínios em formato de gráficos.

Porém, para que os gráficos sejam montados no site, além do arquivo de entidades mencionado acima deverá ser gerado um arquivo no padrão XML para cada condomínio com os dados para a montagem dos gráficos.

Atencao.png

Os arquivos XML referentes aos gráficos também deverão ser informados no arquivo de entidades, seguindo o layout do Registro Tipo 4 - Arquivo.

Arquivo de Exemplo

Grafico.xml


Funcionalidades