Mudanças entre as edições de "Base Filtro Integração da Base de Dados"
(→Visão Geral) |
|||
(10 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
Linha 3: | Linha 3: | ||
==Visão Geral== | ==Visão Geral== | ||
− | A atualização da base de dados e arquivos do cliente no Site é feita através do programa | + | A atualização da base de dados e arquivos do cliente no Site é feita através do programa [[Base Filtro IExpress|IExpress]]. |
− | O | + | O [[Base Filtro IExpress|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=== | ===Arquivo de Entidades=== | ||
− | O arquivo de entidades deve ser do tipo texto (''sugerimos o nome | + | 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: | Cada tipo de entidade é identificada por um código padrão (''posição 7 de cada registro''), conforme os padrões a abaixo: | ||
Linha 320: | Linha 320: | ||
<td>316</td> | <td>316</td> | ||
<td>1</td> | <td>1</td> | ||
− | <td>''' | + | <td>'''T'''-True '''F'''-False</td> |
</tr> | </tr> | ||
<tr align='center'> | <tr align='center'> | ||
Linha 474: | Linha 474: | ||
<td>8</td> | <td>8</td> | ||
<td>10</td> | <td>10</td> | ||
− | <td>Código | + | <td>Código interno do condomínio mais o código da unidade.</td> |
</tr><tr align='center'> | </tr><tr align='center'> | ||
<td>Tipo de Unidade</td> | <td>Tipo de Unidade</td> | ||
Linha 501: | Linha 501: | ||
Sugerimos os formatos '''HTML''' ou '''PDF'''. | 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. | |
|} | |} | ||
Linha 1 095: | Linha 1 095: | ||
'''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.''' | '''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.''' | ||
|} | |} | ||
Linha 1 627: | Linha 1 629: | ||
[http://suporte.basesoft.com.br/Download/Updates/Grafico.xml '''Grafico.xml'''] | [http://suporte.basesoft.com.br/Download/Updates/Grafico.xml '''Grafico.xml'''] | ||
− | |||
− | |||
− | |||
[[:Categoria:Tutoriais Base Filtro|Funcionalidades]] | [[:Categoria:Tutoriais Base Filtro|Funcionalidades]] |
Edição atual tal como às 11h14min de 1 de junho de 2016
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 |
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 |
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)
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. |
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. |
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)
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 | |
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)
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 | |
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
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.
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. |