Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
iconfalse

A partir da versão:

  • 12.1.2302.141 e Superiores253
  • 12.1.2306.206
  • 12.1.2310.139

02. VISÃO GERAL

Novo processo que permitir às empresas que utilizam o processo de Controle de Benefícios do módulo TOTVS Gestão de Pessoas (Linha RM) enviarem 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 saldo de forma flexível, dentro das opções contratadas pela Empresa x Swile

...

  • Os dados dos funcionários (nome, CPF, telefone, e-mail, sexo, data de nascimento, situação, código do banco de pagamento, agência do banco de pagamento e conta bancária de pagamento).
  • 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).

...

ValidaçãoDescrição do erro ou aviso
Telefone menor que 10  digitosdígitos

Coligada: 1 X Chapa: xxxxx O Campo de Telefone 3326565 sem caracteres de formatação 3326565 deve ter de 11 ou 10 digitos dígitos numérico.

Telefone não informadoO campo Telefone é de preenchimento Obrigatório. Funcionário não será integrado.
E-mail não informadoO 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 colabadorcolaborador

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 (email 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.

...

  • 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 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 integrar 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 a Swile não valida se o colaborador está ativo ou não quando enviado algum pedido para receber o pedido de benefício do Colaborador. Neste caso, é bom se atentar quando for enviar os pedidos se está com o filtro desejado 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, tentando . 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 por lá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á acumulado e enviado o como pedido vinculando ao colaborador.

...

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 RM,  Código do Benefício Swile, Valor e Total do Colaborador.

Image RemovedImage Added

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

ValidaçãoDescriçã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..

Envio de pedido para funcionário não integrado


Observações

  • É 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 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.

...

Data limite informada no processo: 31/01/2024

Benefício RMData Início Data TérminoComportamento na Integração
0000101/01/202430/01/2024Será integrado, pois esta dentro da vigência
0000201/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
0000301/02/202428/02/2024Não será integrado pois inicia após o dia 31/01
0000401/12/202331/12/2023Não será integrado pois a data término é menor que a competência da base.
  • É possível fazer pedidos de benefícios específicos, informando o código de benefício RM no processo de integração. 
  • Não é feito a verificação de pedidos de benefícios duplicados, pois a Swile não faz esta verificação, podendo o usuário enviar quantos benefícios desejar. Neste caso deve ficar atento para não enviar o mesmo benefício de forma duplicada.
  • Não é feito o cancelamento de pedido de benefício via API, mesmo se o pedido constar como pendente no portal da Swile. Esse controle é todo gerenciado através do portal pelo Usuário

...