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
N_FOLHA Texto(20) Chave Primria
NOME Texto(100)
N_IDENTIFICADOR Texto(20)
CARTEIRA Texto(50)
EMPRESA_CNPJ Texto(18)
ESTADO Byte
FUNCAO Texto(50)
DEPARTAMENTO Texto(50)
HORARIO Texto(50)
NIVEL_ACESSO Texto(50)
ADMISSAO DATA
DEMISSAO DATA
OBS Texto(255)
N_PIS Texto(20)
ENDERECO Texto(100)
BAIRRO Texto(30)
CIDADE Texto(50)
UF Texto(2)
CEP Texto(9)
CPF Texto(20)
RG Texto(255)
EXPEDICAO DATA
SSP Texto(2)
NASCIMENTO DATA
PAI Texto(100)
MAE Texto(100)
TELEFONE Texto(20)
CELULAR Texto(20)
EMAIL Texto(255)
NATURALIDADE Texto(50)
NACIONALIDADE Texto(50)
FILTRO1 Texto(50)
FILTRO2 Texto(50)
ASSINATURA_ELETRONICA
Texto(50)
N_PROVISORIO Texto(20)
N_PROVISORIO_INI DATA
N_PROVISORIO_FIM DATA
SEXO_MASCULINO BIT
EXCLUIR_FUNCIONARIO BIT
INVISIVEL BIT
MOTIVO_DEMISSAO Texto(50)
AFAST_DATA_INI DATA

DESCRIO
N Folha do funcionrio, usado como campo chave na
integrao
Nome do funcionrio
N Identificador do funcionrio
N do documento
CNPJ ou CPF da empresa com um dos formatos:
99.999.999/9999-99(CNPJ) ou 999.999.999-99(CPF)
0-Ativo, 1-Bloqueado, 2-Desligado, 3-Livre
Nome da funo exercida pelo funcionrio
Nome do setor/departamento do funcionrio
Nome da tabela de horrio que o funcionrio segue
Nome do Nvel de Acesso seguido pelo funcionrio
Data de admisso do funcionrio
Data de demisso do funcionrio
Observao referente ao funcionrio
N do PIS do funcionrio
Endereo que o funcionrio reside
Bairro que o funcionrio reside
Cidade que o funcionrio reside
Estado que o funcionrio reside
CEP que o funcionrio reside
N do CPF do funcionrio
N do Registro Geral (documento de identidade) do
funcionrio
Data da Expedio do documento de identidade
rgo Expeditor SSP do documento de identidade
Data de nascimento do funcionrio
Nome do pai do funcionrio
Nome da me do funcionrio
N do telefone do funcionrio
N do telefone celular do funcionrio
Endereo de E-mail do funcionrio
Naturalidade do funcionrio
Nacionalidade do funcionrio
Nome do campo cadastrado como Filtro1
Nome do campo cadastrado como Filtro2
Assinatura eletrnica do funcionrio
N Provisrio utilizado pelo funcionrio
Data que inicia a validade do n provisrio
Data do trmino da utilizao do n provisrio
0-Feminino, 1-Masculino
0-No excluir, 1-Realizar Excluso
0-Visvel, 1-Invisvel
Motivo da demisso do funcionrio
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
AFAST_JUSTIFICATIVA Texto(7)
LEITURA_STATUS BIT
LEITURA_DATA DATA/HORA
LEITURA_RESPOSTA Texto(255)

Data final do afastamento

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
NUMERO Inteiro Chave Primria
DESCRICAO Texto(50)
DIA_SEMANA Inteiro Chave Primria
ENTRADA1 Texto(5)
SAIDA1 Texto(5)
ENTRADA2 Texto(5)
SAIDA2 Texto(5)
ENTRADA3 Texto(5)
SAIDA3 Texto(5)
ENTRADA4 Texto(5)
SAIDA4 Texto(5)
ENTRADA5 Texto(5)
SAIDA5 Texto(5)
FECHAMENTO Inteiro
TOLERANCIA_EXTRA Texto(5)
TOLERANCIA_FALTA Texto(5)
EXCLUIR_HORARIO Bit
DIA_FOLGA Bit
DIA_EXTRA Bit
LEITURA STATUS Bit
LEITURA_DATA Data/Hora
LEITURA_RESPOSTA Texto(255)

DESCRIO
Nmero do horrio (usado como chave). Tamanho:
4 dgitos.
Descrio do horrio
Dia da Semana (usado como chave)
Corresponde a primeira entrada do dia
Corresponde a primeira sada do dia
Corresponde a segunda entrada no dia
Corresponde a segunda sada do dia
Corresponde a terceira entrada do dia
Corresponde a terceira sada do dia
Corresponde a quarta entrada do dia
Corresponde a quarta sada do dia
Corresponde a quinta entrada do dia
Corresponde a quinta sada do dia
Hora de fechamento do dia
Minutos de tolerncia para clculo de extras
Minutos de tolerncia para clculo de faltas
0= no excluir 1= realizar excluso
0= no folga 1= folga
0= no extra 1= extra
0= no importado pelo sistema 1 = j importado
Data em que o horrio foi importado

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
170
170
170

DESCRICAO
HORRIO170
HORRIO170
HORRIO170

DIA_SEMANA
1
2
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
ID
DATA
ENTRADA1
SAIDA1
ENTRADA2
SAIDA2
ENTRADA3
SAIDA3
ENTRADA4
SAIDA4
ENTRADA5
SAIDA5
NOME
N_FOLHA
N_IDENTIFICADOR
N_PIS

DESCRICAO
Nmero nico das batidas do dia
Data da batida
Primeira entrada
Primeira sada
Segunda entrada
Segunda sada
Terceira entrada
Terceira sada
Quarta entrada
Quarta sada
Quinta entrada
Quinta sada
Nome do funcionrio
N da folha do funcionrio
N identificador do funcionrio
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