DT Adequações PTU Integrações 8.0

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

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.2407

12.1.2407.3 / 12.1.2407.2 / 12.1.2407.1 / 12.1.2407.0

totvs-hgp-webservices_12.1.2407

12.1.2403

12.1.2403.9 / 12.1.2403.8 / 12.1.2403.7 / 12.1.2403.6 / 12.1.2403.5 / 12.1.2403.4

totvs-hgp-webservices_12.1.2403

12.1.2311

12.1.2311.14 / 12.1.2311.13 / 12.1.2311.12 / 12.1.2311.11 / 12.1.2311.10 / 12.1.2311.9

totvs-hgp-webservices_12.1.2311

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.

Em caso de dúvidas sobre como realizar as configurações das variáveis de ambiente, esse documento pode ser consultado https://tdn.totvs.com/display/public/LDT/Como+criar+variaveis+de+ambiente+visiveis+ao+Datasul+no+Tomcat

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/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