Integração Wiipo - Folha X
A tela Integrações Wiipo centraliza os processos de integração entre a Folha X e a plataforma Wiipo, permitindo o envio e a sincronização de informações utilizadas pelos colaboradores no aplicativo, como demonstrativos de pagamento (holerites) e recibos de férias.
Essa integração foi criada para disponibilizar esses documentos de forma digital, proporcionando mais autonomia e praticidade aos colaboradores no acesso às suas informações trabalhistas.
Por meio dessa tela, é possível realizar a ativação da integração, enviar dados de empresas, colaboradores, holerites e recibos de férias, além de acompanhar sincronizações e definir quais informações da folha de pagamento devem ser disponibilizadas na plataforma.
Algumas atualizações ocorrem automaticamente por meio de processos de sincronização, garantindo que as informações permaneçam atualizadas entre os sistemas.
Importante
As funcionalidades da tela ficam disponíveis somente após a ativação da integração com a Wiipo
Permissões necessárias
Todas as integrações com a wiipo validam a mesma permissão:
- Integração com a Wiipo: res://senior.com.br/hcm/hcm_payroll_integration/actions/wiipoIntegration
A rotina de ativação da wiipo depende da permissão de Configurar e de Integrar.

Visão geral da integração Wiipo
Ativação
A aba Ativação representa a etapa inicial da integração com a plataforma Wiipo e deve ser utilizada durante a implantação da solução ou quando uma nova empresa realizar a configuração da comunicação pela primeira vez. Nessa etapa, são informadas as credenciais e definições necessárias para estabelecer a conexão entre os sistemas e habilitar as rotinas de integração.
A ativação é um processo obrigatório e deve ser concluída antes do envio de empresas, colaboradores, holerites e recibos de férias. Após a configuração, a empresa poderá iniciar a transmissão das informações para a plataforma Wiipo, permitindo que os colaboradores consultem documentos, como demonstrativos de pagamento e recibos de férias, diretamente no ambiente da solução.
Os campos disponíveis são:
- Empresa: identifica a empresa que será vinculada à integração.
- Nome do usuário: nome do responsável pela ativação.
- E-mail do usuário: endereço de e-mail utilizado para comunicação com a Wiipo.
- Telefone do usuário: telefone para contato do responsável pela integração.
- Status: indica a situação atual da integração.
- Ativar: botão utilizado para concluir o processo de ativação.
Importante
-
A ativação pode ser realizada apenas uma vez para cada ambiente. Após a conclusão do processo, os dados informados não podem ser alterados diretamente pela Folha X. Caso seja necessária alguma alteração, ela deverá ser solicitada à equipe responsável pela Wiipo
-
O e-mail informado durante a ativação possui papel fundamental no processo, pois é por meio dele que a Wiipo envia as orientações e credenciais necessárias para acesso ao portal da plataforma.
-
O processo de ativação não possui controle de lotes nem histórico de processamento. Como se trata de uma única chamada de integração, o resultado é apresentado imediatamente na tela, informando sucesso ou erro na operação
Empresas
A aba Carga de Empresas permite realizar o envio inicial das empresas e filiais cadastradas para a Wiipo. Esse processo cria a estrutura organizacional necessária na plataforma, garantindo que os demais dados, como colaboradores e documentos, sejam vinculados corretamente às respectivas filiais.
Botão Integrar: Ativa a integração para a empresa selecionada. Após clicar no botão, o sistema exibirá uma mensagem de confirmação:
“O processo será executado em segundo plano. Quando a operação for concluída, o resultado será disponibilizado por meio de uma notificação. Deseja continuar?”
- Sim: inicia a execução do processo e, após a conclusão, o sistema enviará uma notificação com o resultado da operação.
- Não: cancela a execução do processo, sem realizar nenhuma ação.
Colaboradores
A aba Carga de Colaboradores é responsável pela integração inicial dos dados cadastrais dos colaboradores elegíveis para a Wiipo. O envio dessas informações é essencial para que os colaboradores possam acessar seus documentos e demais funcionalidades disponibilizadas pela plataforma.
Critérios de inclusão e Dados obrigatórios para integração com a Wiipo
- Possuem o módulo de folha ativo;
- Não estejam demitidos na competência processada;
- Não possuam vínculo do tipo terceiro
Dados obrigatórios para integração com a Wiipo:
- CNPJ da filial;
- CPF do colaborador;
- Nome da mãe;
- Data de nascimento;
- Endereço;
- Número do endereço;
- E-mail pessoal;
- E-mail profissional;
- CEP;
- Bairro;
- Cidade;
- Estado;
- Descrição do cargo;
- CBO do cargo.
Quando um colaborador não possui todas as informações necessárias, o sistema gera avisos em log informando os registros que não puderam ser integrados.
Botão Integrar: Ativa a integração para a colaborador selecionado. Após clicar no botão, o sistema exibirá uma mensagem de confirmação:
“O processo será executado em segundo plano. Quando a operação for concluída, o resultado será disponibilizado por meio de uma notificação. Deseja continuar?”
- Sim: inicia a execução do processo e, após a conclusão, o sistema enviará uma notificação com o resultado da operação.
- Não: cancela a execução do processo, sem realizar nenhuma ação.
Holerites
A aba Carga de Holerites possibilita enviar os demonstrativos de pagamento para a Wiipo. Por meio dessa rotina, os colaboradores passam a ter acesso aos seus holerites diretamente na plataforma, conforme as definições de cálculo e regras de integração configuradas no sistema.
-
Colaborador (se não informada, busca todos os holerites disponíveis)
-
Definição de cálculo, tipos de cálculo aceitos:
- Folha mensal;
- Adiantamento salarial;
- 13º salário integral;
- Adiantamento 13º salário:
- Folha complementar:
- Folha de pagamento de dissídio.
- Folha mensal;
- O colaborador deve atender aos mesmos requisitos de campos obrigatórios descritos em Carga de Colaboradores, além de possuir dados bancários.
- Se o colaborador possui parcelas de eConsignado na competência, essas informações são incluídas automaticamente no holerite enviado. Você visualiza os detalhes das parcelas e possíveis pendências de pagamento diretamente na visualização do holerite.
- Ao excluir um cálculo que já foi enviado, execute novamente a carga de holerites da mesma definição de cálculo. O sistema busca colaboradores sem holerites calculados e os remove automaticamente da Wiipo.
Importante
-
A data de referência para busca de informações históricas depende do tipo de cálculo: para Adiantamento Salarial, 13º integral, Adiantamento 13º ou Pagamento de Dissídio, usa-se a data de pagamento; para demais tipos, usa-se o último dia do mês da competência.
-
Ao editar uma definição de cálculo (em Gestão de Pessoas > HCM > Cadastros Gerais > Cálculos > Definição de Cálculo), existe a aba Wiipo onde você pode habilitar o envio automático de holerites. Essa aba está disponível apenas para tipos de cálculo válidos para integração.
Férias
A aba Carga de Recibos de Férias permite integrar os recibos de férias calculados para a Wiipo. Após o envio, os documentos ficam disponíveis para consulta pelos colaboradores, facilitando o acesso às informações relacionadas aos períodos de férias programados e processados.
- Data de início;
- Data de término;
- Empresas;
- Colaboradores
- Programações que iniciam e terminam no período informado.
- Status da programação: Calculada.
- Colaboradores com campos obrigatórios preenchidos (conforme Carga de Colaboradores).
- Dados bancários obrigatórios.
Envio rápido via botão Enviar Wiipo:
- Na tela Gestão de Pessoas > Folha X > Férias > Programações, está disponível o botão Enviar Wiipo. Use-o para enviar programações com status Calculada diretamente, sem acessar a tela de carga. O processamento ocorre em segundo plano, e uma notificação confirma a conclusão. Atualize a página para visualizar o novo status.
- A exclusão de um recibo na Wiipo ocorre automaticamente quando você o exclui na Folha X. Se o status da programação é Enviado Wiipo, o sistema gera automaticamente um processo de integração para remover a programação na Wiipo. Você exclui recibos pela tela Gestão de Pessoas > Folha X > Férias > Programações ou coletivamente via Gestão de Pessoas > Folha X > Férias > Exclusão de Recibos de Férias. Se erros ocorrem na exclusão, use o botão Reprocessar Exclusões nesta aba para tentar novamente.
Configurações
A aba Configurações centraliza os parâmetros que controlam quais eventos da folha de pagamento serão considerados na integração com a Wiipo. Essa configuração permite adequar as informações enviadas, garantindo que apenas os eventos desejados sejam exibidos aos colaboradores na plataforma.
Habilitar/desabilitar: Integrar FGTS: as informações relacionadas ao FGTS serão enviadas para a Wiipo e ficarão disponíveis no demonstrativo de pagamento do colaborador. Isso permite consultar valores e bases utilizadas no cálculo do FGTS diretamente na plataforma.
Habilitar/desabilitar: Integrar informativa dedutora: serão enviadas para a Wiipo informações complementares que ajudam a compor determinados cálculos da folha de pagamento.
Habilitar/desabilitar: Integrar informativa: as informações complementares da folha de pagamento serão enviadas para a Wiipo e poderão ser visualizadas pelo colaborador no demonstrativo de pagamento.
English
Español

English
Español

