Ativação do Holerite Digital

O Holerite Digital foi desenhado para ser ativado pela própria empresa em um modelo de auto
serviço. Porém, antes de começar, é importante verificar algumas etapas, pois caso contrário o
processo pode não funcionar. Verifique se seu ambiente está pronto, consultando o checklist do
holerite digital com apoio da TI da sua empresa.

Importante: O Holerite Digital Wiipo necessita de uma versão do Senior Gestão de Pessoas com
módulo de Administração de Pessoas nas versões 6.2.35.24 e 6.2.34.91 ou superiores .

Requisitos Mínimos: Sistema Operacional Windows 64 bits nas versões

• Windows Server 2016

• Windows Server 2019

• Windows Server Versão 1903 ou superior

Se tudo estiver corretamente configurado, o processo é feito em apenas 4 passos

1. Ativação via Senior Gestão de Pessoas

Para ativar, basta acessar a tela de Cálculo de Folha que o convite aparecerá automaticamente
conforme a Figura 1:
 1 - Figura 1: Convite de ativação

2. Configuração do holerite e abrangência de empresa

Essa etapa é opcional, mas é importante para definir as empresas e definições do holerite. Essas
opções estão disponíveis no menu Diversos – Definições Holerite Digital (Figura 2)

2 - Figura 2: Definições do Holerite Digital

3. Processamento e publicação dos holerites

A publicação dos holerites digitais é realizada pela tela FRGERHOL – Geração de Holerite Digital.
Essa tela foi criada para que a publicação dos holerites seja feita apenas após a conferência dos
dados. É possível informar o período e o cálculo desejado conforme mostra a imagem da Figura 3.

3 - Figura 3: Geração Holerite Digital

4. Ativação via aplicativo wiipo
Uma vez que o processamento da etapa 3 foi concluída, os dados estarão prontos para que
seus colaboradores façam o cadastro no aplicativo dentro de 30 minutos. A obtenção do aplicativo
pode ser feita através das lojas da Google e Apple. Para facilitar a divulgação, você pode utilizar o
link da Wiipo - Aplicativo Holerite Digital 1.

4 - Figura 4: Aplicativo e telas de cadastro que solicitam CPF e Celular

Importante! O aplicativo valida o CPF e o Telefone de cada funcionário. Por isso é importante que o
CPF e Telefone de cada funcionário esteja atualizado.

Não funcionou! E agora?

Se você já realizou todos os passos de ativação e o aplicativo ainda não identifica seu cadastro, é
hora de verificar o seu ambiente com mais detalhes.

O checklist de ativação é um processo de verificação do ambiente. Ao final dele, você deve estar
apto a ativar seu holerite digital. Mas se não funcionar, utilize o preenchimento do checklist para
envio ao nosso suporte.

Checklist de Ativação – Holerite Digital Senior Wiipo

O checklist possui os itens mais comuns que podem ocorrer em clientes que não conseguiram ativar
o Holerite Digital sozinhos. Por isso, recomendamos revisar esses elementos para garantir que sua
ativação seja um sucesso 😊

1 https://wiipo.senior.com.br/holerite/index.html
 5 - Checklist do ambiente

https://wiipo.senior.com.br/holerite/Checklist_Ativacao_Holerite_Digital_Wiipo.docx

Se mesmo após essa verificação você ainda tiver dificuldades, envie o checklist preenchido através
de um chamado no chat em nosso site 2. Entraremos em contato e iremos te auxiliar na ativação

6 - Solicitando suporte Wiipo

2 https://wiipo.com/
1. Integrador Senior Wiipo (Digital)
O Senior Integrador Wiipo é um serviço da suíte de soluções da Senior Sistemas. Concebido para
simplificar a adoção e a experimentação de novos produtos da Senior, o integrador faz parte da
mídia de instalação, mas não ativa/contrata nenhum módulo automaticamente. Após a instalação, o
integrador basicamente fica aguardando interações dos usuários sobre a ativação de um módulo ou
produto para executar.

O objetivo do Integrador é entregar uma experiência digital aos usuários dos sistemas da Senior. Por
exemplo, é o integrador que permite que um Analista de RH ative o Holerite Digital diretamente do
Senior Gestão de Pessoas com apenas alguns cliques. O Holerite Digital é um produto gratuito que
leva a folha de pagamento para o celular dos colaboradores de forma segura e com privacidade.

2.1. O que fazer quando a ativação automática falhou?

Embora o integrador tenha sido concebido para não necessitar nenhuma intervenção, podem
ocorrer casos devido à complexidade ou configuração do ambiente do cliente onde o integrador não
consegue se configurar sozinho após a ativação do Holerite Digital.

Os itens a seguir visam orientar a TI do cliente a verificar situações que podem impedir o holerite
digital de funcionar e como contornar cada situação.

2.1.1. Verificando a situação do Serviço

Quando instalado, o integrador será listado como “Senior Integrador Wiipo” ou “Senior Integrador
Digital” nas novas versões. É importante verificar se o serviço está com Status “Running” ou
“Executando” e modo “Automatic” ou “Automático” conforme mostra a Figura 5.

7 - Figura 5: Serviço de Integração em execução

Caso o serviço não esteja executando, iniciar o mesmo e alterar o modo para automático. Se a
inicialização do serviço apresentar algum problema, verifique se existe espaço na sua instalação (Ver
Item 3.1.1. Limitação de espaço no caminho da instalação)

2.1.2. Senhas e permissões para execução do serviço

Alguns ambientes utilizam usuário e senha para execução de serviços e esse processo não pode ser
automatizado pela instalação. Por isso, caso o seu ambiente utilize senhas esse processo precisa ser
realizado manualmente. O usuário para execução do integrador digital deve ser ter permissão de
administrador. Para configurar a senha do serviço, basta acessar as propriedades do mesmo e
acessar a aba de autenticação conforme a Figura 6.
 8 - Figura 6: Configuração de credenciais para o integrador

Se forem realizadas alterações para uso de credenciais, é necessário reiniciar o serviço após essa
configuração.

2.1.3. Verificação do SQL Browser – Exclusivo para SQL Server

Ambientes que utilizam o SQL Server para o Senior Gestão de Pessoas | HCM, devem ter o serviço
“SQL Server Browser” em execução, pois esse serviço é utilizado pelo integrador para comunicação
com o banco de dados. O SQL Server Browser pode ser encontrado conforme a Figura 7 e deve estar
está com Status em “Running” ou “Executando” e modo “Automatic” ou “Automático”.

9 - Figura 7: Configuração do SQL Server Browser para ambientes com SQL Server

Se o serviço não estava em execução, iniciar o mesmo e alterar para o modo automático de
inicialização. Em seguira, realizar a reinicialização do serviço Senior Integrador.

2.1.4. Verificação do protocolo TCP/IP – Exclusivo para SQL Server

Ambientes que utilizam o SQL Server para o Senior Gestão de Pessoas | HCM, devem ter o protocolo
TCP/IP ativo, pois esse serviço é utilizado pelo integrador para comunicação com o banco de dados.
O protocolo TCP/IP pode ser encontrado conforme a Figura 8 e deve estar está com Status em
“Enabled” ou “Ativo”.

10 - Figura 8 - Configuração TCP/IP no SQL Server

2.1.5. Configuração de acesso ao banco – Exclusivo para SQL Server

As configurações para Aplicativos Java são necessárias para que o integrador tenha acesso ao banco
de dados no momento de uma ativação de produto digital. Para garantir que isso esteja correto,
acesse o SeniorConfigCenter.exe e verifique se os dados de conexão com o banco de dados estão
configurados. Após configurar, clicar em “Testar Conexão” e verificar se recebeu uma mensagem de
conexão realizada com sucesso.

11 - Figura 9: Configuração de Aplicativos Java

2.1.6. Verificação da instância do banco – Exclusivo para SQL Server

Caso você tenha uma instância do SQL Server é nomeada, é necessário verificar se o nome da
instância informada no passo 2.1.5 - Configuração de Aplicativos Java é igual ao nome que aparece
no serviço para SQL SERVER.

12 - Figura 10: Configuração de Aplicativos Java

13 - Figura 11: Nome da instância do SQL Server

Caso você encontre um nome de uma instância diferente da informada no passo 2.1.5 -
Configurações de Aplicativos Java, não altere os valores que já existe lá. Crie um arquivo dentro da
pasta da Wiipo em produção com o nome hcmJdbc.wiipo e salve dentro deste arquivo os dados da
sua conexão. A Figura 12 mostra um exemplo de como o conteúdo deve-se parecer.
 14 - Figura 12: Exemplo do arquivo hcmJdbc.wiipo

2.1.7. Verificação da arquitetura 64 bits – Exclusivo para Oracle

Ambientes com instalação de Oracle 64 bits, precisam baixar o “Pacote Básico” do instant-client
pelo endereço https://www.oracle.com/br/database/technologies/instant-client/winx64-64-
downloads.html conforme a versão do Oracle.

Depois descompacte ele dentro da pasta “.../Wiipo/instant-client” no ambiente de produção. Por

fim, adicione a variável de ambiente “ORACLE_INSTANT_CLIENT” o diretório aonde o instant-client
foi descompactado. Deve-se parecer como a Figura 13.

15 - Figura 13: Instalação Instant Client

2.1.8. Configuração de acesso ao banco – Exclusivo para Oracle

As configurações para Aplicativos Java são necessárias para que o integrador tenha acesso ao banco
de dados no momento de uma ativação de produto digital. Para garantir que isso esteja correto,
acesse o SeniorConfigCenter.exe e verifique se os dados de conexão com o banco de dados estão
configurados. Após configurar, clicar em “Testar Conexão” e verificar se recebeu uma mensagem de
conexão realizada com sucesso.

16 - Figura 14: Configuração de Aplicativos Java

2.1.9. Verificação da instância do banco – Exclusivo para Oracle

Caso você tenha uma instância do Oracle nomeada, é necessário verificar se o nome da instância
informada no passo 2.1.8 - Configuração de Aplicativos Java é igual ao nome que aparece dentro do
arquivo tnsnames.ora.
 17 - Figura 15: Configuração de Aplicativos Java

18 - Figura 16: Exemplo de arquivo tnsnames.ora

Caso você encontre um nome de uma instância diferente da informada no passo 2.1.8 -
Configurações de Aplicativos Java, não altere os valores que já existe lá. Crie um arquivo dentro da
pasta da Wiipo em produção com o nome hcmJdbc.wiipo e salve dentro deste arquivo os dados da
sua conexão. A Figura 12 mostra um exemplo de como o conteúdo deve-se parecer.

19 - Figura 17: Exemplo de arquivo hcmJdbc.wiipo

2.1.10. Acesso à internet

Para que um produto digital seja ativado automaticamente, o servidor onde roda o integrador
precisa ter acesso à algumas URLs disponíveis na internet. As seguintes URLs precisam estar
liberadas:

• https://wiipointegradorapi.senior.com.br

• https://s3.amazonaws.com/wiipointegradorapi.senior.com.br

• https://api.wiipo.com

Uma forma simples de verificar se o servidor tem os acessos necessários, é realizando o download
dos arquivos a seguir com o usuário que configurado no serviço do integrador:

• https://wiipointegradorapi.senior.com.br/latest.yml

• https://s3.amazonaws.com/wiipointegradorapi.senior.com.br/latest.yml

Caso você tenha proxy no seu ambiente, será necessário liberar o domínio listados nos servidores de
aplicação e middleware.

2.1.11. Atualização do integrador

Por padrão, o integrador busca se manter sempre atualizado. Porém, se existe limitação de acesso,
ou de execução conforme os itens acima, é possível que ele não tenha se atualizado
automaticamente. Para confirmar se o seu ambiente está com a última versão atualizada, baixe a
última versão através do seguinte endereço:
https://wiipointegradorapi.senior.com.br/WiipoInstaller.exe

https://wiipointegradorapi.senior.com.br/service.jar

Substitua o arquivo WiipoInstaller.exe e service.jar que existem na pasta Wiipo dentro de todos os
ambientes da Senior ( PRODUÇÃO, HOMOLOGAÇÃO, etc ) pela versão baixada. Em seguida, pare
temporariamente o serviço "Senior Integrador Wiipo" de todos os ambientes. É importante também
verificar o gerenciador de tarefas se há algum processo com o nome “Integrador” em execução. Se
houver, aguarde ele terminar ou encerre o processo manualmente.

Procure pela pasta com nome “install” que existe dentro da pasta Wiipo nos ambientes.

Procure pela pasta com nome “install” que existe dentro da pasta Wiipo nos ambientes. Dentro dela
existe um arquivo chamado “Uninstall Integrador.exe”, execute ele como administrador. Após
terminar o processo de desinstalação ative novamente o serviço "Senior Integrador Wiipo" do
ambiente de produção. Confira se dentro da pasta da Wiipo no ambiente de produção existe agora
uma pasta chamada “install” com o conteúdo da instalação.

Se a pasta não apareceu em alguns minutos, verifique novamente o passo 2.1.2. Senhas e
permissões para execução do serviço. O usuário informado no serviço não está conseguindo realizar
a instalação. Caso ele tenha permissão de administrador, mas não consiga realizar a instalação,
tente colocar o usuário do serviço como “Local System”.

Se a pasta “install” foi criada, ative novamente o serviço "Senior Integrador Wiipo" em todos os
ambientes.

2.1.12. Verificação de ativação de um holerite digital

Finalmente, verifique no ambiente de produção, dentro da pasta da Wiipo se existe o arquivo
config.wiipo. Este arquivo é gerado de forma automática após ativar o Holerite Digital no Gestão de
Pessoas.

Caso você não encontre o arquivo, pode conferir novamente o processo de ativação no
menu Diversos, clicando na opção Definição Holerite Digital conforme a Figura 18.

20 - Figura 18: Acesso do Holerite Digital via menu diversos

Ao abrir a tela, basta clicar no botão “ativar” conforme a Figura 19. Se o botão “ativar” não aparecer,
significa que a ativação já foi realizada com sucesso.
 21 - Figura 19: Ativação do Holerite Digital

2.1.13. Análise Técnica

Se você realizou todos os passos acima e ainda não consegue acessar os seus dados de holerite pelo
nosso aplicativo, você pode entrar em contato com nosso time através do chat disponível em
https://wiipo.com3.

Primeiro precisamos que você crie um arquivo chamado debug.wiipo dentro da pasta Wiipo no
ambiente de produção com o conteúdo “true”. Quando existe este arquivo no diretório da Wiipo, o
integrador vai gerar algumas informações que precisamos para identificar o problema que está
ocorrendo no seu ambiente. Aguarde alguns minutos até que sejam gerados os arquivos
logRun.wiipo e logService.wiipo.

Depois envie o Checklist de Ativação preenchido junto com esses dois arquivos para nosso suporte
através do chat em nosso site 4.

3. Limitações e orientações para desativar o serviço

Existem casos onde há a necessidade em separar o integrador para ambientes que tenham acesso à
internet. Além disso, também existem limitações na versão atual que serão resolvidas nas versões
futuras. Essa seção detalha alguns desses itens.

3.1.1. Limitação: Espaço no caminho da instalação

Por padrão, o Integrador Wiipo utiliza o mesmo modelo do Motor eSocial da Senior. Esses servi ços
não tem ainda suporte a espaços no caminho e por isso podem não funcionam nessas situações.
Nesse caso, é preciso verificar se o ambiente de instalação contém espaços. O integrador do e-social
e o integrador da Wiipo não funcionam com diretórios com espaço.

Exemplo de caminho inválido: "C:\Sistemas\Senior Producao"

Exemplo de caminho válido: "C:\Sistemas\Senior_Producao"

A versão com suporta à espaços no caminho de instalação ainda não está disponível.

3 https://wiipo.com/
4 https://wiipo.com
4. Ativação após aceite dos termos
Se após o aceite dos termos o Senior Gestão de Pessoas indicar uma mensagem conforme a Figura
20, significa que a o processo falhou em atualizar a situação de holerite digital.

22 - Figura 20 - Ativação indica que não foi concluída com sucesso

Nesse caso, a ativação pode ser concluída através do menu Diversos, clicando na opção Definição
Holerite Digital. As definições devem estar com S (Sim) na opção “Ativar Holerite Digital” conforme
mostra a Figura 21.

23 - Figura 21 - Definições do Holerite Digital