1. Acesse o menu Importação Menu Datasul (men706aa) e importe o arquivo men_hvp.d.

2. Acesse o menu Programa Produto Datasul (bas_prog_dtsul) e altere o registro "hvp.ptuIntegrations" para liberar a permissão de acesso

3. Acesse o menu Atualiza Menu Usuário (mer010aa) e execute a atualização.

• Será disponibilizado novas opções de acesso em:
  • Central PTU - Movimentação de Beneficiário: aba Movimentação beneficiário
  • Central de Integrações Saúde Planos: aba PTU Movimentação

Para o correto funcionamento do serviço é necessário que o ambiente do cliente esteja com as variáveis de ambiente configuradas de acordo com o documento Configurar servidor de aplicação TOMCAT. Essas variáveis são compartilhadas por outros processos do Totvs, como a integração com Datasus para consulta do CNS e serviços da TISS. Assim, pode ser que elas já estejam configuradas. Caso esses parâmetros sejam alterados, eles podem impactar também nesses outros processos. A comunicação com o serviço da Unimed do Brasil é feita pelo Tomcat, por isso se faz necessárias essas configurações.

Também é necessário a configuração de algumas variáveis de ambiente no servidor do Tomcat sendo elas:

• TOTVS_PTU_JKS_FILE: Deve apontar o caminho do arquivo JKS/PFX com o certificado que será utilizado.
• TOTVS_PTU_JKS_PASS: Senha do arquivo JKS.

Conforme documentação da Unimed do Brasil, o certificado digital a ser utilizado deve ser o ICP-Brasil.

A configuração inicial do serviço deve ser realizada na aplicação Central de Integrações Saúde Planos (hgp.integrationsParams) conforme o item PTU Movimentação. Nessa documentação é possível encontrar a URL de exemplo da API da Unimed do Brasil, que deve ser configurada para que o Totvs, para que seja feito o envio das informações dos beneficiários.

Broker Escalável:

Como a Unimed deve disponibilizar um serviço para ser chamado pela Unimed do Brasil, para recebimento dos compartilhamentos de risco. Caso a sua Unimed entenda que irão recebemos muitas requisições desse tipo, este serviço permite a utilização do conceito de broker escalável. Para utilizar é necessário cadastrar o broker no programa Parâmetros Foundation (btb962aa) com o Alias totvs-hgp-webservices. Mais informações sobre o uso do broker escalável podem ser encontradas em Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas REST.

Versão do PTU

Implementado campo nas configurações para definir qual a versão do PTU que será utilizada nos processos.

Após o serviço ser habilitado, todas movimentações passíveis de envio para a Unimed Brasil serão processadas e enviadas de maneira automática. A movimentação pode ser consultada via Central PTU na aba PTU Movimentação.

Importante: Para beneficiários existentes na base é necessário que seja feita a atualização do Código de Controle Unimed. Foi disponibilizado a seguinte SP que permite importar o arquivo CSV que pode ser solicitado a Unimed Brasil.

Em situações especificas, onde seja necessário envio manual de dados que não tenham sido enviados de forma automática é possível fazer utilização da seguinte SP. 

Importante: Junto a Unimed do Brasil deve ser feita a configuração do endpoint para recebimento do compartilhamento de risco. Abaixo é possível verificar.

Endpoint externo do Compartilhamento de Risco:

http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/v8/integrations/beneficiarios/compartilhamento-riscos

Também criamos um endpoint que pode ser utilizado para verificar as as variáveis de ambiente do Tomcat estão configuradas corretamente. Esse serviço estará disponível somente a partir do patch 12.1.2311.12, 12.1.2403.8 e 12.1.2407.2.

Endpoint para validação de variáveis de ambiente:

http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/v8/integrations/gateway/serverInfo

Envio da movimentação de beneficiários

Adequação dos campos de acordo com o layout:

• cabecalho
  • codigoVersaoPtu: Adaptado para poder receber a nova versão ("011");
• dadosBeneficiario
  • valorMensalidade
  • rendaMensal
  • carteirinhaAnterior
  • idFilho
  • produtoAgregado
    • codigoUnimedDestino
    • tipoProduto
    • descricaoProduto
    • codigoPlanoDestino
    • dataRepasseUnimedDestino
    • dataInicioVigenciaProduto
    • dataFimVigenciaProduto
• dadosEmpresaContratante
  • dataInclusaoEmpresaUnimed 
  • dataExclusaoEmpresaUnimed
  • endereco
    • logradouroPrincipal: Tamanho aumentado para 80 caracteres;
    • complementoLogradouro: Tamanho aumentado para 80 caracteres;
    • bairro: Tamanho aumentado para 45 caracteres;
  • Adicionados dados de telefone do contratante:
    • telefone
      • tipoTelefone
      • ddd
      • numero
      • ramal
• dadosPlano
  • Tag de carencias renomeada para cobertura;
    
    • dataFimCarencia renomeada para dataFimCobertura;

• dadosPessoa
  • generoSocial: Adicionada opção N - Não binário;
  • rg
    • uf: Tratado para utilizar a codificação do IBGE;

Recebimento da movimentação de beneficiários de compartilhamento de risco

Adequação dos campos de acordo com o layout:

• cabecalho
  • codigoVersaoPtu: Adaptado para poder receber a nova versão ("011");
• dadosPlano
  • Tag de carencias renomeada para cobertura;
    
    • dataFimCarencia renomeada para dataFimCobertura;
• dadosPessoa
  • generoSocial: Adicionada opção N - Não binário;
  • rg
    • uf: Tratado para utilizar a codificação do IBGE;

Recebimento do retorno da movimentação de beneficiários de compartilhamento de risco

Adequação dos campos de acordo com o layout:

• cabecalho
  • codigoControleUnimedBrasil: Adicionado código de controle da Unimed do Brasil;

• dadosPlano
  • Tag de carencias renomeada para cobertura;
    
    • dataFimCarencia renomeada para dataFimCobertura;