Integração Padrão com Folha via Arquivo TXT

Felipe Dietrich

Este post tem por finalidade apresentar as formas de integração padrão com folha, via arquivo texto.

Funcionamento

A integração via arquivo texto permite atualmente o recebimento das seguintes informações:

Cadastro de Empresas
Cadastro de Filiais
Cadastro de Setores
Cadastro de Cargos
Cadastro de Atividades
Colaboradores
Histórico de Filiais
Histórico de Setores
Histórico de Cargos
Histórico de Horários
Histórico de Atividades
Histórico de Atributos Adicionais
Afastamentos e Atestados
Gestores por Setor
Feriados
Feriados por Filial
Períodos Aquisitivos de Férias
Lançamento de Férias
Linhas de Transporte e Pontos de Referência

Este processo é realizado através da rotina "PACK_INTEGRACAO_FOLHA", podendo ser utilizado o método "GERAL" ou "GERAL_ONLINE", conforme definições que podem ser verificadas abaixo.

Requisitos

A integração padrão com folha através de arquivo texto utiliza a biblioteca Oracle UTL_FILE.
É necessário a configuração de um diretório no servidor Oracle para receber estes arquivos e a atribuição de permissões de acesso a este diretório para o usuário do ponto.
Veja aqui mais informações como realizar isto.

Layout dos Arquivos

O documento contendo o layout dos dados e os tipos de arquivos permitidos na integração pode ser verificado no documento abaixo na rede.

O:\FolhaPagamento\Integracao_Padrao\Documentos\Intfol_Estrutura_Arquivos_Offline.pdf

Formas de Integração

A integração possui duas formas de integração por arquivo que podem disponibilizadas para a folha.

1. Importação diária uma única vez

Neste formato os arquivos serão importados diariamente, apenas uma vez ao dia.
O nome de cada arquivo deve conter apenas o prefixo de cada tipo de informação concatenado com o dia atual no formado AAAAMMDD.

Exemplo arquivo de colaboradores
Nome do arquivo: "ADMITI20250109.TXT"
Onde:
ADMITI = prefixo do tipo de informação do arquivo.
20250109 = data atual no formado AAAAMMDD.

Dados de uma linha dentro do arquivo

A20241212041240      1     37002061                                                                            1 Milena Souza Leiria                                          F30/09/200512/08/2024N                                                                 1 0551647507423719760908                                                      220,                                                                                                                                                 37002063

Procedimento SQL que deve ser executado "GERAL"

begin
  pack_integracao_folha.geral( p_diretorio => 'TEMP_DIR'
                             , p_data => trunc(sysdate)
                             , p_possui_operacao => 'S' );
end;

O parâmetro "p_diretorio" indica o diretório no servidor Oracle que o usuário do ponto terá permissão para buscar os arquivos disponibilizados pela folha.
O parâmetro "p_data" indica a data base de busca dos arquivos no diretório.
O parâmetro "p_possui_operacao" indica se nos arquivos gerados pela folha foi adicionado as informações de operação e data da operação no início de cada linha, de acordo com o layout padrão de cada tipo de arquivo.

2. Importação sequencial, mais de uma vez por dia

Neste formato pode ser importado mais de um arquivo para cada tipo de arquivo existente, no mesmo dia, gerenciados de acordo com a sequência de arquivos gerados pela folha.
O nome de cada arquivo deve conter o prefixo de cada tipo de informação concatenado com o dia atual no formado AAAAMMDD e um sequencial diário de até 5 posições.

Exemplo arquivo de colaboradores
Nome do primeiro arquivo: "ADMITI2025010900001.TXT"
Onde:
ADMITI = prefixo do tipo de informação do arquivo.
20250109 = data atual no formado AAAAMMDD.
00001 = numeral indicando a sequência do arquivo gerado no dia para esse tipo de arquivo.

Caso a folha precise gerar um segundo arquivo de colaboradores no mesmo dia o nome do arquivo deve ser gerado o nome abaixo.

Nome do segundo arquivo: "ADMITI2025010900002.TXT"
Onde:
ADMITI = prefixo do tipo de informação do arquivo.
20250109 = data atual no formado AAAAMMDD.
00002 = numeral indicando a segunda sequência do arquivo gerado no dia para esse tipo de arquivo.

Procedimento SQL que deve ser executado "GERAL_ONLINE"

begin
  pack_integracao_folha.geral_online( p_diretorio => 'TEMP_DIR'
                                    , p_data => trunc(sysdate)
                                    , p_possui_operacao => 'S' );
end;

O parâmetro "p_diretorio" indica o diretório no servidor Oracle que o usuário do ponto terá permissão para buscar os arquivos disponibilizados pela folha.
O parâmetro "p_data" indica a data base de busca dos arquivos no diretório.
O parâmetro "p_possui_operacao" indica se nos arquivos gerados pela folha foi adicionado as informações de operação e data da operação no início de cada linha, de acordo com o layout padrão de cada tipo de arquivo.

Utilização dos tipos de arquivos sequenciais não sequenciais simultaneamente

A partir da versão 7.1.9.0 do Ponto Soft, foi previsto uma configuração para permitir a importação de arquivos sequenciais e de execução única simultaneamente.
Desta forma é possível que o sistema receba determinados arquivos por uma origem de integração e outros tipos de arquivos por uma segunda origem de integração.
Um exemplo de necessidade real destes casos é precisar receber os cadastros e históricos organizacionais da folha de pagamento do cliente e receber os afastamentos e atestados do sistema de medicina do trabalho do cliente.

Configurações necessárias

Para permitir o recebimento de arquivos sequenciais e não sequenciais simultaneamente, é necessário primeiramente organizar com os integradores, qual sistema vai gerar os arquivos não sequenciais, gerando apenas uma única vez por dia e qual sistema vai gerar os arquivos de forma sequencial, gerando mais de uma vez por dia.

Arquivos sequencias

Cadastrar o parâmetro customizado "INTFOL_TIPO_ARQUIVO_SEQUENCIAL" através da tela PSW7610, informando os prefixos dos tipos de arquivos que serão importados de forma sequencial pelo sistema.

Arquivos não sequencias

Os arquivos não sequencias serão todos os demais prefixos dos tipos de arquivos que não constam dentro do parâmetro customizado "INTFOL_TIPO_ARQUIVO_SEQUENCIAL".