Integrao

Ponto Secullum 4
Ponto Secullum 4 x Sistemas Externos
Wednesday, 13 de November de 2013 - Pgina 1 de 6

Introduo

Para integrao com sistemas externos o Ponto Secullum 4 possui diversos meios para
troca de informaes:

Integrao de cadastro de funcionrios

Via importao de arquivo texto com layout configurvel (menu Manuteno
> Importao de funcionrios);
Direto no banco de dados, via tabela integracao_externa;
Atravs de integrao personalizada (alterao especfica para o cliente).

Integrao de cadastro de Horrios

Direto no banco de dados, via tabela integracao_horarios
Atravs de integrao personalizada (alterao especfica para o cliente).

Integrao de registros de batidas

Via importao de arquivo texto com layout configurvel (menu Manuteno
> Exportao de Dados > Exportar Batidas);
Direto no banco de dados do sistema, atravs da view vw_batidas;
Atravs de integrao personalizada (alterao especfica para o cliente).

Neste documento, listamos informaes referentes integrao direta com o banco de

dados do sistema atravs das tabelas integracao_externa, integrao_horarios e a view
vw_batidas.

Ateno: Existem outras tabelas no banco de dados do sistema que so utilizadas para
seu funcionamento. No recomendamos a manipulao de nenhum dos objetos do banco de
dados (exceto integracao_externa, integrao_horarios, e vw_batidas), pois diversas
regras de negcios devem ser observadas e somente estes trs objetos foram especialmente
desenvolvidos para integrao, sendo assim, protegidos pelas regras do sistema.

Integrao com Cadastro de Pessoas

A tabela integracao_externa, indicada para clientes que necessitam transferir dados

de pessoas de algum sistema externo para o Ponto Secullum 4.
Nesta tabela, deve-se inserir os dados das pessoas para integrao e a cada 10
segundos o servio Gerenciador de Tarefas do Ponto Secullum 4 ir fazer a leitura dos
dados ainda no importados.
 Integrao
Ponto Secullum 4
Ponto Secullum 4 x Sistemas Externos
Wednesday, 13 de November de 2013 - Pgina 2 de 6

A tabela contm a seguinte estrutura:

CAMPO DESCRIO
N_FOLHA Texto(20) Chave Primria N Folha do funcionrio, usado como campo chave na
integrao
NOME Texto(100) Nome do funcionrio
N_IDENTIFICADOR Texto(20) N Identificador do funcionrio
CARTEIRA Texto(50) N do documento
EMPRESA_CNPJ Texto(18) CNPJ ou CPF da empresa com um dos formatos:
99.999.999/9999-99(CNPJ) ou 999.999.999-99(CPF)
ESTADO Byte 0-Ativo, 1-Bloqueado, 2-Desligado, 3-Livre
FUNCAO Texto(50) Nome da funo exercida pelo funcionrio
DEPARTAMENTO Texto(50) Nome do setor/departamento do funcionrio
HORARIO Texto(50) Nome da tabela de horrio que o funcionrio segue
NIVEL_ACESSO Texto(50) Nome do Nvel de Acesso seguido pelo funcionrio
ADMISSAO DATA Data de admisso do funcionrio
DEMISSAO DATA Data de demisso do funcionrio
OBS Texto(255) Observao referente ao funcionrio
N_PIS Texto(20) N do PIS do funcionrio
ENDERECO Texto(100) Endereo que o funcionrio reside
BAIRRO Texto(30) Bairro que o funcionrio reside
CIDADE Texto(50) Cidade que o funcionrio reside
UF Texto(2) Estado que o funcionrio reside
CEP Texto(9) CEP que o funcionrio reside
CPF Texto(20) N do CPF do funcionrio
RG Texto(255) N do Registro Geral (documento de identidade) do
funcionrio
EXPEDICAO DATA Data da Expedio do documento de identidade
SSP Texto(2) rgo Expeditor SSP do documento de identidade
NASCIMENTO DATA Data de nascimento do funcionrio
PAI Texto(100) Nome do pai do funcionrio
MAE Texto(100) Nome da me do funcionrio
TELEFONE Texto(20) N do telefone do funcionrio
CELULAR Texto(20) N do telefone celular do funcionrio
EMAIL Texto(255) Endereo de E-mail do funcionrio
NATURALIDADE Texto(50) Naturalidade do funcionrio
NACIONALIDADE Texto(50) Nacionalidade do funcionrio
FILTRO1 Texto(50) Nome do campo cadastrado como Filtro1
FILTRO2 Texto(50) Nome do campo cadastrado como Filtro2
ASSINATURA_ELETRONICA Assinatura eletrnica do funcionrio
Texto(50)
N_PROVISORIO Texto(20) N Provisrio utilizado pelo funcionrio
N_PROVISORIO_INI DATA Data que inicia a validade do n provisrio
N_PROVISORIO_FIM DATA Data do trmino da utilizao do n provisrio
SEXO_MASCULINO BIT 0-Feminino, 1-Masculino
EXCLUIR_FUNCIONARIO BIT 0-No excluir, 1-Realizar Excluso
INVISIVEL BIT 0-Visvel, 1-Invisvel
MOTIVO_DEMISSAO Texto(50) Motivo da demisso do funcionrio
AFAST_DATA_INI DATA Data inicial do afastamento
 Integrao
Ponto Secullum 4
Ponto Secullum 4 x Sistemas Externos
Wednesday, 13 de November de 2013 - Pgina 3 de 6

AFAST_DATA_FIM DATA Data final do afastamento

AFAST_JUSTIFICATIVA Texto(7)
LEITURA_STATUS BIT
LEITURA_DATA DATA/HORA
LEITURA_RESPOSTA Texto(255)
Justificativa do afastamento
0-No lido, 1-J lido pelo sistema
Data em que o sistema fez a leitura
Descrio do erro da importao (caso no ocorra
erro, campo fica nulo)

Observaes:

Os campos em azul so preenchidos automaticamente pelo sistema durante a

importao dos dados
O campo N_FOLHA chave primria. No pode haver duplicidade deste campo nem
preenchimento nulo do mesmo.
Os campos abaixo so de auto-cadastro, ou seja, caso no exista o registro no sistema,
estes sero cadastrados automaticamente:
Funo
Departamento
Filtro1
Filtro2

Os campos abaixo so obrigatrios, ao menos para a insero da linha do registro:

N_FOLHA (chave primria)
NOME
EMPRESA_CNPJ
HORARIO
N_PIS
ADMISSAO

Os campos abaixo, se no informados, iro assumir o valor de <No informado>

DEPARTAMENTO
FUNCAO

Para que o Gerenciador de Tarefas processe a linha inserida na tabela, a coluna

leitura_status deve estar com valor FALSE (zero em alguns bancos). Quando
necessrio atualizar algum registro desta tabela, atualize os dados da linha necessria e
modifique o campo leitura_status para assumir o valor False para que o sistema leia
novamente a linha.

Integrao com cadastro de horrios

A tabela integracao_horarios indicada para clientes que necessitam transferir dados

de horrios de algum sistema externo para o Ponto Secullum 4.
Nesta tabela, deve-se inserir os dados do horrio para integrao e a cada 10 segundos
o servio Gerenciador de Tarefas do Ponto Secullum 4 ir fazer a leitura dos dados ainda
no importados.

A tabela tem a seguinte estrutura:

 Integrao
Ponto Secullum 4
Ponto Secullum 4 x Sistemas Externos
Wednesday, 13 de November de 2013 - Pgina 4 de 6

CAMPO DESCRIO
NUMERO Inteiro Chave Primria Nmero do horrio (usado como chave). Tamanho:
4 dgitos.
DESCRICAO Texto(50)
Descrio do horrio
DIA_SEMANA Inteiro Chave Primria
Dia da Semana (usado como chave)
ENTRADA1 Texto(5)
Corresponde a primeira entrada do dia
SAIDA1 Texto(5)
Corresponde a primeira sada do dia
ENTRADA2 Texto(5)
Corresponde a segunda entrada no dia
SAIDA2 Texto(5)
Corresponde a segunda sada do dia
ENTRADA3 Texto(5)
Corresponde a terceira entrada do dia
SAIDA3 Texto(5)
Corresponde a terceira sada do dia
ENTRADA4 Texto(5)
Corresponde a quarta entrada do dia
SAIDA4 Texto(5)
Corresponde a quarta sada do dia
ENTRADA5 Texto(5)
Corresponde a quinta entrada do dia
SAIDA5 Texto(5)
Corresponde a quinta sada do dia
FECHAMENTO Inteiro
Hora de fechamento do dia
TOLERANCIA_EXTRA Texto(5)
Minutos de tolerncia para clculo de extras
TOLERANCIA_FALTA Texto(5)
Minutos de tolerncia para clculo de faltas
EXCLUIR_HORARIO Bit
0= no excluir 1= realizar excluso
DIA_FOLGA Bit
0= no folga 1= folga
DIA_EXTRA Bit
0= no extra 1= extra
LEITURA STATUS Bit
0= no importado pelo sistema 1 = j importado
LEITURA_DATA Data/Hora
Data em que o horrio foi importado
LEITURA_RESPOSTA Texto(255)
Resposta da importao (somente se houver
erro)

Observaes:

Os campos em azul so preenchidos automaticamente pelo sistema durante a

importao dos dados.
Nesta tabela, utilizada uma chave composta pelos campos numero e
dia_semana, j que no sistema possvel ter vrios dias da semana em um
nico horrio.
Os campos abaixo so obrigatrios
Numero
Dia_semana

Para que o Ponto Secullum 4 processe a linha, o campo leitura_status deve

estar como false (ou zero), isto indicar que o registro ainda no foi importado. Ao
ler a linha, o sistema ir marcar o campo como true (ou um), marcando assim o
registro para no ser lido novamente. Caso voc precise alterar dados de um
horrio, altere o campo para false (ou zero) novamente.
Nesta tabela, voc tambm pode informar vrios dias da semana para o mesmo
horrio. Ou seja, para cadastrar um horrio de segunda a sexta-feira, ser
necessrio inserir cinco linhas nesta tabela, cujo numero ser o mesmo, porm,
com o campo dia_semana diferente, correspondendo 1 (segunda-feira) ... 7
(domingo).
 Integrao
Ponto Secullum 4
Ponto Secullum 4 x Sistemas Externos
Wednesday, 13 de November de 2013 - Pgina 5 de 6

Exemplo:
NUMERO DESCRICAO DIA_SEMANA
170 HORRIO170 1
170 HORRIO170 2
170 HORRIO170 3

Ao ler a linha, alm de marcar como lida, o sistema informa a data e hora da
leitura no campo leitura_data. Caso no seja possvel cadastrar ou excluir o
horrio, a descrio do erro informada no campo leitura_resposta.

Lista dos respectivos dias da semana:

DIA VALOR NO BANCO DE DADOS
SEGUNDA-FEIRA 1
TERA-FEIRA 2
QUARTA-FEIRA 3
QUINTA-FEIRA 4
SEXTA-FEIRA 5
SBADO 6
DOMINGO 7

Como regra de banco, no poder haver 2 linhas com nmero de horrio e dia da
semana iguais.

Integrao com registro de batidas

A view vw_batidas indicada para leitura dados dos acessos registrados no sistema.
Cada linha retorna um dia de batidas do funcionrio

CAMPO DESCRICAO
ID Nmero nico das batidas do dia
DATA Data da batida
ENTRADA1 Primeira entrada
SAIDA1 Primeira sada
ENTRADA2 Segunda entrada
SAIDA2 Segunda sada
ENTRADA3 Terceira entrada
SAIDA3 Terceira sada
ENTRADA4 Quarta entrada
SAIDA4 Quarta sada
ENTRADA5 Quinta entrada
SAIDA5 Quinta sada
NOME Nome do funcionrio
N_FOLHA N da folha do funcionrio
N_IDENTIFICADOR N identificador do funcionrio
N_PIS N PIS do funcionrio

Exemplo de seleo

Selecionar um funcionrio especfico:

 Integrao
Ponto Secullum 4
Ponto Secullum 4 x Sistemas Externos
Wednesday, 13 de November de 2013 - Pgina 6 de 6

select * from vw_batidas where n_folha = 12345