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:

Última atualização: 26/07/2024 - Endpoint de compartilhamento de risco /riskSharing passa a ser /beneficiarios/compartilhamento-riscos. Melhorias gerais.

Versão

Compilação Progress 12

(Bancos Progress e Oracle)

Arquivo .war Tomcat (todos patches)

(renomear arquivo conforme nome indicado abaixo)

12.1.2407.0

12.1.2407.0

totvs-hgp-webservices.war

12.1.2403.4 / 12.1.2403.5 / 12.1.2403.6

12.1.2403.4 / 12.1.2403.5 / 12.1.2403.6

totvs-hgp-webservices.war

12.1.2311.9 / 12.1.2311.10 / 12.1.2311.11

12.1.2311.9 / 12.1.2311.10 / 12.1.2311.11

totvs-hgp-webservices.war

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

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