Histórico da Página

...

02. VISÃO GERAL

Novo processo que permitir às permitirá com que as empresas que utilizam o processo de Controle de Benefícios do módulo TOTVS Gestão de Pessoas (Linha RM) enviarem enviem os valores dos benefícios calculados para uma carteira de benefícios da Swile, para serem utilizados pelos seus colaboradores através de um cartão de credito de benefícios disponibilizado pela Swile, com a possibilidade de usar o utilização do saldo de forma flexível, dentro das opções contratadas pela Empresa x Swile

03. SOLUÇÃO

Criada Foi criada a configuração para ativar a integração com a Swile e informar os dados: Id Work Group, Usuário, Senha e URL Base.

Criada uma tabela auxiliar para vincular os códigos de Benefícios do RM com os códigos de Benefícios da Swile.

Criado um processo para enviar os dados necessários através de da API interna do sistema:

• Os dados dos funcionários (nome, CPF, telefone, e-mail, sexo, data de nascimento, situação).
• Os dados do pedido informados na Tela de Pedidos de Benefícios (CPF do funcionário, CNPJ da coligada, Código do benefício Swile associado e valor do benefício).

Após realizada a ativação da integração e a configuração dos Benéficos RM x Swile, o usuário deverá utilizar o processo de Integração Benefício com Swile para enviar os dados Dados do funcionário e o Pedidos de Benefícios.

...

Para fazer o envio de dados de funcionários e pedidos para a Swile é necessário marcar o parâmetro 'Ativar Integração com Swile', em Totvs Gestão de Pessoas | Configurações | Parâmetros | Configurações | Integração com Terceiros e APIs | APIs | Integração API Swile. Após marcar o parâmetro, serão habilitados os campos para preenchimento, conforme a o exemplo abaixo.:

Considerando em Totvs Gestão de Pessoas | Valorização | Controle de Benefícios | Benefícios e Remuneração Variável, os benefícios abaixo que serão fornecidos para os funcionários: 

...

Em Totvs Gestão de Pessoas | Valorização | Controle de Benefícios | Tabelas Auxiliares | De/Para Benefícios Terceiro, vincular os o Benefício RM x ao Benefício Swile. 

Para executar o processo de envio de funcionários e benefícios para a Swile, deverá ir em Totvs Gestão de Pessoas | Valorização | Controle de Benefícios | Processos | Integração Benefício com Swile, clique clicar em Avançar e será apresentada a tela abaixo:

...

Após marcada a opção 'Enviar Funcionários', informar o 'Tipo de Atualização Funcionário (Ignorar/Substituir)', 'Enviar Email de Boas Vindas' e 'Data do Email de Boas Vindas', conforme desejado.

Após executar o processo será apresentado o log com o retorno da integração realizada.

Abaixo iremos exemplifica possíveis retornos que serão apresentados no Logs de Aviso, Debug e Execução.

...

• Quando existe mais de um funcionário vinculado a mesma pessoa, a integração verifica o vinculo de contrato mais recente para enviar. isto porque a Swile valida Isto se deve ao fato da Swile validar a pessoa (dados pessoais) e não contrato de trabalho. Caso integrasse os dois vínculos, retornaria erro de duplicidade de Colaborador. Com isto não é necessário enviar novamente a pessoa através do processo de integração em caso de cadastro de novo vínculo.
• Quando um vínculo é demitido, é possível enviar a atualização do cadastro do funcionário para Swile através da integração marcando a opção 'substituir'. O Colaborador é inativado na Swile. Porém , porém a Swile não valida se o colaborador está ativo ou não para receber o pedido de benefício do Colaborador. Neste caso, é bom importante se atentar quando for enviar os pedidos se está com o filtro dos funcionários desejados.
• Uma vez que o Colaborador está inativo no portal da Swile, não é possível ativar novamente a mesma pessoa através da integração, pois a Swile não trata essa ativação através da API. Quando enviado o cadastro de um colaborador inativo na Swile, o parceiro tenta cadastrar novamente o Colaborador. Neste caso, é retornado erro de colaborador já existente. Para ativar o colaborador no portal da Swile o mesmo deve ser feito através o portal do parceiro.
• O envio de e-mail de boas vindas é opcional.
• Não é feita a integração do cadastro do dependente para a Swile, somente do colaborador. Caso exista benefícios lançados para o dependente o mesmo será enviado como pedido, vinculando ao colaborador.

...

Para o envio de Pedidos de Benefícios para a  Swile, deverá marcar a opção 'Enviar Pedidos de Benefícios',e  informar os parâmetros , 'Data do Crédito' e 'Data Limite'.

...

• É necessário ter o funcionário cadastrado na Swile para poder realizar um pedido. Caso não exista, será necessário cadastrá-lo pelo Portal da Swile ou utilizando a integração de funcionários.
• A Swile valida a data de credito do pedido, devendo ser maio maior que o dia da geração do pedido. 
• Quando vinculado mais de um benefício RM a um mesmo benefício da Swile, os valores lançados para o funcionário e/ou dependentes são acumulados no mesmo código de benefício da Swile e enviados via API.
• O processo de integração verifica data limite informado na tela do processo se está dentro da vigência benefícios lançados para o funcionário conforme ocorre no Lançamento de Benefícios de Funcionários para Folha de Pagamento.

Exemplo:

Competência: 01/2024

Data limite informada no processo: 31/01/2024

...

O processo irá enviar os funcionários e em seguida o pedido de benefícios.:

05. DEMAIS INFORMAÇÕES

Parametrizador - Integração Swile

...