01. DADOS GERAIS
Produto: | TOTVS Saúde Planos |
---|---|
Linha de Produto: | Linha Datasul |
Segmento: | Saúde |
Módulo: | HVP |
Função: | Central PTU |
País: | Brasil |
Importante
Este novo processo está sendo liberado para que os clientes Unimed possam iniciar o processo de homologação interna e não deve ser habilitado em produção antes da finalização do plano de teste da Unimed Brasil.
02. SITUAÇÃO/REQUISITO
A fim de adequar o sistema para que o mesmo esteja aderente as novas integrações disponibilizadas pela Unimed Brasil (PTU Integrações 8.0), foram realizadas diversas alterações com o objetivo de atender tal propósito.
03. SOLUÇÃO
- Criado novo serviço que permite o envio automático de novos beneficiário cadastrados, transferidos e liberados (equivalência A1300)
- Envio automático de alteração ou exclusão de beneficiários
- Criada nova tela na Central PTU que permite consultar o status dos envios realizados
- Criada nova tela na Central PTU que permite consultar o status dos beneficiários recebidos
- Adicionado o campo "Controle Unimed" na edição e detalhes de beneficiários
- Desenvolvida nova interface para configurar os parâmetros usados no serviço em hgp.integrationsParams
- Criado novo serviço que permite receber beneficiários de outras unidades (equivalência A100/A200)
- Criado SP para atender situações de envio manual de beneficiários que não tenham sido enviados anteriormente para a Unimed Brasil
- Criado serviço que permite receber informações de compartilhamento de risco de beneficiários vindos da Unimed Brasil
- Criado SP que permite atualização manual do código de beneficiário da Unimed Brasil via arquivo CSV.
- Adicionado pontos de CPC no envio e recebimento de beneficiários
Pacote Complementar
Os arquivos abaixo contém as últimas correções e ajustes do processo e podem ser utilizados com a versão indicada:
Últimas atualizações:
- 26/07/2024 - Endpoint de compartilhamento de risco /riskSharing passa a ser /beneficiarios/compartilhamento-riscos. Melhorias gerais;
- 07/08/2024 - Ajuste na importação do código de controle da Unimed do Brasil. Ajuste nos envios do complemento de endereço, e do código do país do RG.
- 08/08/2024 - Ajuste no formato da resposta ao recebimento de beneficiários com compartilhamento de risco.
- 15/08/2024 - Ajuste nos envios relacionados ao Motivo de Exclusão do Beneficiário, Nome da Mãe e Tipo de Contratação.
- 21/08/2024 - Ajustes referentes a:
- obrigatoriedade do Código Família Beneficiário;
- quando o campo Código Município Naturalidade não estiver preenchido enviar valor nulo;
- a não obrigatoriedade do CNS;
- a geração de movimentação ao alterar o campo Nome Social;
- e ao reprocessamento da movimentação ao realizar algum ajuste no cadastro do beneficiário.
- 23/08/2024 - Ajustes referentes a:
- quando os telefones nos contatos do beneficiário forem excluídos enviar um registros com os campos interno com valor nulo;
- não exceder o tamanho do texto do órgão emissor do RG.
- 30/08/2024 - Ajustes referentes a:
- tipo do campo codigoControleUnimed
- tratativa no envio de beneficiários com repasse
- tratativa na reativação de um beneficiário
- 06/09/2024 - Ajustes referentes a:
- Exportação Nome social e Gênero social
- Importação Carteira do beneficiário
- Geração integração PTU Integração ao importar exportação de beneficiário
- Tratativas no processo de repasse
- 13/09/2024 - Ajustes referentes a:
- Tipo de logradouro
- Código da operadora ANS
- Adequado o processo de alteração de repasse para enviar corretamente as requisições
- Envio de beneficiário com doença pré-existente
- Indicador de acidente de trabalho
- 19/09/2024 - Ajustes referentes a:
- Envio de ramal
- Caracteres especiais no endereço
- Alertas identificados como erros no recebimento de beneficiários
- 04/10/2024 - Ajustes referentes a:
- Ajustes diversos na seção de compartilhamentoRisco
- 08/11/2024 - Ajustes referentes a:
- Ajustes no fluxo de repasses
- Ajustes flag de carência do usuário
- Ajustes endereços
- 29/11/2024 - Ajustes referentes a:
- Envio correto das informações sobre carências;
- 13/13/2024 - Ajustes referentes a:
- Reprocessamento de movimentos com sucesso parcial
- Recebimento de compartilhamento de risco
- Filtro de modalidades ativas para envio
- Melhorias gerais
- 20/12/2024 - Ajustes referentes a:
- Abono carências na inclusão
Versão | Compilação Progress 12 para os patches disponíveis (Bancos Progress e Oracle) | Arquivo .war Tomcat (todos patches) (renomear arquivo conforme nome indicado abaixo) |
---|---|---|
12.1.2411 | Sem mudanças | |
12.1.2407 | ||
12.1.2403 | ||
12.1.2311 | Suporte encerrado |
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.
Após configurar as variáveis acima e reiniciar o Tomcat, utilize a URL abaixo para garantir que o ambiente reconheceu corretamente os valores:
<SERVIDOR>:<PORTA>/totvs-hgp-webservices/ptu/v8/integrations/gateway/serverInfo
Exemplo:
Considerações especiais sobre o Java
Durante a homologação foram detectados alguns problemas de validação de certificado, relacionados à versão do Java utilizado para executar o Tomcat.
A versão que se mostrou mais estável foi a 11.0.24-LTS:
Em algumas situações também foi necessário adicionar o certificado da Autoridade Certificadora Raiz Brasileira v5:
Para isso, baixar o certificado autoridade.cer e importar no java do seu ambiente:
.../<seu_java>/bin/keytool -importcert -cacerts -file ./autoridade.cer -alias autoridadev5
Obs: o comando acima vai solicitar a senha do certificado, que é: changeit
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.
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
A URL final chamada é 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
Webinar PTU Integrações 8.0
Documentações Relacionadas:
Central PTU - Movimentação de Beneficiário
Como criar variaveis de ambiente visiveis ao Datasul no Tomcat
Central de Integrações Saúde Planos (hgp.integrationsParams)
DSAUGPSCONTRAT2-19082 DT Autenticação Token - Recebimento Compart. Risco
DSAUGPSCONTRAT2-18799 DT SP para Envio Manual no Serviço de Movimentação de Beneficiários
DSAUGPSCONTRAT2-18985 DT SP Carga Código Controle Do Beneficiário
CPC827_CPC_BOSAUPTUINTEGRATIONS
CPC826_CPC_BOSAUPTUINTEGRATIONSCOMPRISCO