Pular para o conteúdo principal

Setembro

Melhorias entregues em 08/09/2026​

Aprimoramento no registro e integração das despesas de plano de saúde​

Foi disponibilizada uma melhoria na integração entre os sistemas de Folha de pagamento e Recursos Humanos, aprimorando o controle das despesas de plano de saúde utilizadas no cálculo da folha.

A partir dessa melhoria, havendo evento com classificação "Plano de saúde - PLANOSAUDE" ou "Procedimentos médicos - PROCEDMED", o sistema passa a registrar o vínculo entre a despesa de plano de saúde do beneficiário, cadastrada no Recursos Humanos, e o evento da Folha em que essa despesa foi efetivamente paga.

Com o vínculo, passam a ser identificados:

  • o ID da despesa de plano de saúde utilizada no cálculo;
  • o ID do evento da Folha ao qual a despesa está vinculada;
  • o valor efetivamente pago da despesa no evento.

Nova função de cálculo: Foi disponibilizada a função de cálculo PlanoSaudeDespesas.registroCalculo(despesa.id, valorDespesa), que permite registrar o pagamento da despesa de plano de saúde no evento calculado.

A função foi adicionada aos eventos padrão:

  • 188 – Procedimentos médicos;
  • 229 – Despesas com plano de saúde – Mensalidade;
  • 240 – Despesas com plano de saúde – Adesão.

Esses eventos utilizam a função PlanoSaudeDespesas.buscaDespesasPlanoSaude(calculo.competencia) para buscar as despesas de plano de saúde cadastradas no RH.

Para o cálculo realizado pela fórmula, devem ser informados obrigatoriamente o ID da despesa e o valor efetivamente pago. O registro somente é realizado quando a despesa do RH é utilizada no cálculo do evento.

Eventos que possuem a classificação Plano de saúde - PLANOSAUDE ou Procedimentos médicos - PROCEDMED, mas que não utilizam as despesas de plano de saúde do RH, não realizam o registro desse vínculo. Isso ocorre quando o valor é informado por meio de lançamento de variável ou cálculo automático via fórmula, por exemplo.

IMPORTANTE

Caso seja necessário realizar lançamentos na mesma competência de despesas de plano de saúde no RH e também por meio de variáveis ou cálculo automático em fórmulas, e ambas as informações precisem ser enviadas ao eSocial, recomenda-se utilizar eventos diferentes para cada origem do lançamento. Essa configuração garante que as informações sejam identificadas e geradas corretamente no envio ao eSocial.

  • Ajuste de folhas calculadas antes da liberação da melhoria, para a correta geração do objeto planSaude, do domínio de pagamentos, ao eSocial:

Para possibilitar o envio correto ao eSocial das informações correspondentes a Plano de saúde, o ajuste das folhas calculadas antes da liberação da melhoria, foi disponibilizado um novo endpoint de SL "/api/folha/pagamento-plano-saude-despesa" para inserção dos dados do vínculo entre o evento calculado em folha e as despesas de plano de saúde, oriundas do RH, utilizadas no cálculo do evento.

Para as folhas já existentes antes da implementação da melhoria, eram considerados apenas os eventos com classificação Plano de saúde - PLANOSAUDE oriundos do RH ou do cadastro de variáveis. Dessa forma, eventos calculados automaticamente por meio de fórmula customizada, ainda que possuam a classificação Plano de saúde - PLANOSAUDE, somente serão gerados quando também estiverem lançados em variável.

Ajuste na integração das despesas de plano de saúde no domínio de pagamentos​

Ajustamos a geração do objeto planSaude, do domínio de pagamentos, passando a considerar eventos com classificação “Plano de saúde - PLANOSAUDE” ou “Procedimentos médicos - PROCEDMED”, com lançamentos oriundos das despesas de plano de saúde do RH, cadastro de variáveis ou cálculo automático através de fórmula customizada, conforme a configuração do parâmetro gerarPlanoSaudeApenasDespesasRh.

  • Quando o parâmetro estiver habilitado: serão consideradas exclusivamente as informações provenientes das despesas de plano de saúde do RH.
  • Quando estiver desabilitado: serão considerados os lançamentos das diferentes origens, sendo gerados os dados de ambos quando houver divergência em Valor, CNPJ da operadora de plano de saúde ou registro ANS. Caso essas informações sejam iguais entre os lançamentos, será gerado apenas o lançamento proveniente do RH.