A aplicação de Integração Senior x Secullum RH foi desenvolvida com o objetivo de permitir a comunicação direta entre os dois sistemas, facilitando a importação de funcionários e a exportação de cálculos.

Como realizar a configuração da integração

Para iniciar a utilização da integração, é necessário realizar a instalação do sistema através do Agente de Integração Senior

Após a instalação, abra a aplicação da Integração Senior e selecione a opção Configurações.

Nesta tela, devem ser preenchidos os dados de conexão tanto do Secullum RH quanto do sistema Senior, além da definição de parâmetros para importação de funcionários.

Configuração do Secullum RH

Nos campos referentes ao Secullum RH, devem ser informados:

E-mail: e-mail do usuário (deve estar configurado para utilizar a Integração Com Sistemas no Secullum RH e com permissões da LGPD no usuário utilizado);

Senha: senha do e-mail do usuário;

Banco ID: número do banco de dados do Secullum RH;

A opção Testar Conexão deve ser executada obrigatoriamente, pois é responsável por validar a conexão com o banco de dados, verificar permissões e obter informações necessárias para o funcionamento do sistema.

Configuração do Senior

Para o sistema Senior, devem ser informados os dados de acesso ao WebService: (esses dados devem ser coletados diretamente com a Senior.)

URL do Servidor: endereço de acesso ao servidor da API;

Usuário: usuário do sistema Senior;

Senha: senha do usuário do sistema Senior;

Também é possível definir filtros para busca de funcionários:

Empresa ID: identificador da empresa no Senior;

Início Período: define o período de admissões e demissões a ser considerado na importação;

Como funciona a importação de funcionários

A funcionalidade de importação permite trazer automaticamente os cadastros de funcionários do sistema Senior para o Secullum RH, incluindo tanto funcionários admitidos quanto demitidos.

Para que o processo funcione corretamente, é necessário que a empresa cadastrada em ambos os sistemas possua o mesmo CNPJ. Também deve existir pelo menos um horário cadastrado no Secullum RH, pois todos os funcionários importados serão vinculados a esse horário.

Durante a importação, o sistema realiza automaticamente a criação de funções e departamentos que não existirem no Secullum. Além disso, dados adicionais cadastrados no Senior também serão importados, desde que estejam disponíveis.

Como funciona a exportação de cálculos

Para que a exportação funcione corretamente, é necessário configurar previamente quais colunas serão exportadas. Essa configuração é realizada no arquivo configuracao.json, localizado na pasta do programa.

Cada coluna do Secullum RH deve ser associada ao número do evento correspondente no sistema Senior.

Exemplo de colunas a serem exportadas:

• Horas Normais

• Horas Faltas

• Horas Extras 50%

Neste caso, o arquivo deve ser configurado da seguinte forma:

É importante observar que deve ser utilizada vírgula ao final de cada linha, exceto na última dentro do bloco de colunas. Caso seja necessário incluir novas colunas futuramente, basta adicioná-las seguindo o mesmo padrão.

Após a configuração, a exportação pode ser realizada acessando a opção Exportar Cálculos, informando o período desejado e clicando em Concluir. O sistema irá exportar os valores totais de cada coluna configurada, considerando exclusivamente o período informado.

AVISO
A opção de exportação de cálculos deve ser configurada e executada manualmente, pois neste processo é necessário configurar um filtro do período desejado para exportação.

Agendamento de execução

A aplicação permite automatizar a execução dos processos através do Agendador de Tarefas do Windows.

Para isso, deve-se criar uma tarefa básica apontando para o executável da aplicação e informar o argumento “enviar”, responsável por executar a importação de funcionários automaticamente.

1- Abra o Agendador de Tarefas do Windows.

2- Selecione a opção Criar Tarefa Básica e informe um nome para a tarefa.

3- Defina a periodicidade da execução (exemplo: diariamente).

-Em Ação, selecione Iniciar um programa;

4- Configure o caminho da aplicação conforme o padrão:

Importante: substituir {caminho} pelo diretório correto da aplicação, por exemplo: C:\Program Files (x86)\IntegracaoSenior Embora os campos “Adicionar argumentos” e “Iniciar em” sejam opcionais, é essencial configurá-los corretamente para garantir o funcionamento da tarefa agendada.

A integração foi testada utilizando a versão XT 6.10.4.112 do sistema Senior.
Para outras versões, recomenda-se a realização de testes para validar o funcionamento da integração.

Onde verificar logs e erros da integração

A aplicação gera arquivos de log que registram todas as execuções, incluindo inicializações, finalizações, importações realizadas e possíveis erros.

Esses logs são fundamentais para análise e diagnóstico de problemas, além de servirem como registro das operações executadas com sucesso.

Os arquivos ficam armazenados na pasta Logs, localizada no diretório raiz da aplicação, e são organizados por data.

Conclusão

A integração entre o Senior e o Secullum RH automatiza o processo de cadastro de colaboradores e facilita a exportação de cálculos, garantindo maior confiabilidade nos dados.

Para evitar problemas, é essencial validar corretamente as configurações iniciais, manter o arquivo de configuração atualizado e acompanhar os logs após cada execução. Esses cuidados garantem que a integração funcione de forma estável e segura no ambiente.

Em caso de dúvidas, consulte o Suporte.