Histórico da Página

...

Informações

title	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Ú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

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

/ 12.1.2407.1 / 12.1.2407.2 / 12.1.2407.3 / 12.1.2407.

0

4	totvs-hgp-webservices

.war

_12.1.2407
12.1.2403	12.1.2403.4 / 12.1.2403.5 / 12.1.2403.6

/ 12.1.2403.7 / 12.1.2403.

4

8 / 12.1.2403.

5

9 / 12.1.2403.

6

10	totvs-hgp-webservices

.war

_12.1.2403
12.1.2311	12.1.2311.9 / 12.1.2311.10 / 12.1.2311.11

/ 12.1.2311.12 / 12.1.2311.

9

13 / 12.1.2311.

10

14 / 12.1.2311.

11

15	totvs-hgp-webservices_12.1.

war

2311

Totvs custom tabs box

tabs	Procedimento para Implantação, Procedimento para Configuração, Procedimento para Utilização
ids	passo1,passo2,passo3

Totvs custom tabs box items

default	yes
referencia	passo1

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.

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

default	no
referencia	passo2

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.

Totvs custom tabs box items

default	no
referencia	passo3

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

...

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

...

Árvore de páginas

Versões comparadas

Versão antiga 63

Nova versão 93

Chave

(renomear arquivo conforme nome indicado abaixo)