CONTEÚDO
A partir das versões:
|
Novo processo que permitirá com que as empresas que utilizam o processo de Controle de Benefícios do módulo TOTVS Gestão de Pessoas (Linha RM) 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 utilização do saldo de forma flexível, dentro das opções contratadas pela Empresa x Swile
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 da API interna do sistema:
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 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 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 o Benefício RM 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, clicar em Avançar e será apresentada a tela abaixo:
Para avançar no processo, é necessário que seja selecionado ao menos 1 das duas opções ou Envio de Funcionários ou Envio dos Pedidos de Beneficios. Caso não selecione uma das duas opções, será exibida a seguinte mensagem de alerta: |
Para executar o processo de envio de funcionários para a Swile, deverá marcar a opção Enviar Funcionários:
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.
Validação | Descrição do erro ou aviso |
---|---|
Telefone menor que 10 dígitos | Coligada: X Chapa: xxxxx O Campo de Telefone 3326565 sem caracteres de formatação 3326565 deve ter de 11 ou 10 dígitos numérico. |
Telefone não informado | O campo Telefone é de preenchimento Obrigatório. Funcionário não será integrado. |
E-mail não informado | O campo Email é de preenchimento Obrigatório. Funcionário não será integrado. |
E-mail inválido | Integração de Funcionário não realizada devido a Erro no envio dos Dados para Requisição. 3 - Dados inválidos: Nome do Colaborador (CPF Colaborador) com e-mail inválido (e-mail enviado). |
E-mail já cadastrado para outro colaborador | Integração de Funcionário não realizada devido a Erro no envio dos Dados para Requisição. 2 - Colaborador: Nome do Colaborador (CPF Colaborador) com e-mail já cadastrado (e-mail já existente). |
CPF já cadastrado | Integração de Funcionário não realizada devido a Erro no envio dos Dados para Requisição. 2 - Colaborador: Nome do Colaborador (CPF Colaborador) com CPF já cadastrado. |
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'.
Após o envio do Pedido de Benefício Swile, serão apresentados os Logs de Execução (Debug e Execução), com as informações do envio do pedido, conforme abaixo. Neste exemplo, temos o resumo do pedido com o Total do Pedido, Total de Colaboradores, Total de Itens e Data do Crédito e logo depois o corpo do Log trará os dados dos Benefícios por colaborador CPF, Código do Benefício Swile, Valor e Total do Colaborador.
Abaixo iremos exemplificar possíveis retornos da Swile que serão apresentados no Logs de Aviso, Debug e Execução.
Validação | Descrição do erro ou aviso |
---|---|
Código de Benefício Swile inválido | Integração de Pedido não realizada devido a Erro no envio dos Dados para Requisição. 3 - Dados inválidos: Processado com erros, favor visualizar os logs de processamento. |
Data de Credito menor que o dia da geração | Integração de Pedido não realizada devido a Erro no envio dos Dados para Requisição. 3 - Dados inválidos: Data de crédito dd/mm/yyyy 00:00 inválida, data de liberação de carga deve ser pelo menos 0 dias úteis a frente para que haja tempo suficiente para compensação bancária do seu pagamento. |
Colaborador não cadastrado no portal da Swile | Integração de Pedido não realizada devido a Erro no envio dos Dados para Requisição. 3 - Dados inválidos: Processado com erros, favor visualizar os logs de processamento. |
Exemplo:
Competência: 01/2024
Data limite informada no processo: 31/01/2024
Benefício RM | Data Início | Data Término | Comportamento na Integração |
---|---|---|---|
00001 | 01/01/2024 | 30/01/2024 | Será integrado, pois está dentro da vigência |
00002 | 01/01/2024 | - | Será Integrado, pois a data início é anterior ao dia 31/01 e não tem data fim. Neste caso, esse benefício sempre entrará na integração se for lançado |
00003 | 01/02/2024 | 28/02/2024 | Não será integrado pois inicia após o dia 31/01 |
00004 | 01/12/2023 | 31/12/2023 | Não será integrado pois a data término é menor que a competência da base. |
Para o envio de funcionários e Pedidos de Benefícios para a Swile, deverão ser marcadas as opções 'Enviar Funcionários' e 'Enviar Pedidos de Benefícios', informar os parâmetros ''Tipo de Atualização Funcionário (Ignorar/Substituir)', 'Enviar Email de Boas Vindas', 'Data do Email de Boas Vindas', ''Data do Crédito' e 'Data Limite'.
O processo irá enviar os funcionários e em seguida o pedido de benefícios:
Parametrizador - Integração Swile
De/Para benefícios Terceiros - Swile
Integração Benefícios com Swile
RHU - Benefícios e Remuneração Variável