Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 29

changes.mady.by.user Maicon Alvarenga Molina

Gravado em

comparado com

Nova versão 83

changes.mady.by.user Mikael Colombo Isaac

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


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



Nota
titleImportante

Este novo processo está sendo liberado para que os clientes Unimed possam iniciar o processo de homologação interna e ainda não se indica o uso em produçãonã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


Informações
titlePacote 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: 24/05/2024

Ú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.
4
1.2311

12.1.2311.14 / 12.1.2311.13 / 12.1.2311.12 / 

12.1.2311.

9

11 / 12.1.2311.

9

10 / 12.1.

2307

2311.

15

9

totvs-hgp-webservices_

12.1.

2307.15

2311



Totvs custom tabs box
tabsProcedimento para Implantação, Procedimento para Configuração, Procedimento para Utilização
idspasso1,passo2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso1

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.


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.


Informações
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:

Image Added



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:

Image Added


Em algumas situações também foi necessário adicionar o certificado da Autoridade Certificadora Raiz Brasileira v5:

Image Added


Para isso, baixar o certificado autoridade.cere 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



totvs-custom-tabs-box-items
defaultno
referenciapasso2

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:

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

Totvs custom tabs box items
defaultno
referenciapasso3

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

Conector de Widget
width500
urlhttps://www.youtube.com/watch?v=w0YttveLW_M&feature=youtu.be
height300


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




HTML
			<style>				div.theme-default .ia-splitter #main {					margin-left: 0px;				}				.ia-fixed-sidebar,				.ia-splitter-left {					display: none;				}				#main {					padding-left: 10px;					padding-right: 10px;					overflow-x: hidden;				}				.aui-header-primary .aui-nav,				.aui-page-panel {					margin-left: 0px !important;				}				.aui-header-primary .aui-nav {					margin-left: 0px !important;				}			</style>