Histórico da Página

01. DADOS GERAIS

Produto:	TOTVS Saúde Planos
Linha de Produto:	Datasul
Segmento:	Saúde
Módulo:	HAT - Atendimento ao Público HRC - Revisão de Contas Médicas
Função:	Portal do Prestador Autorizador Web Importa/Processa XML Lote Guias (hrc.importProcessTissGuideBatch) Exportação Mvimentos para Cobrança (hrc0510m) TISSCancelaGuia TISSComunicacaoBeneficiario TISSLoteAnexo TISSSolicitacaoProcedimento TISSSolicitacaoStatusAutorizacao TISSVerificaElegibilidade
País:	Brasil
Requisito:	DSAUGPSCONTAS-27591 DSAUGPSCONTAS-27631 DSAUGPSAUTOR-20767

02. SITUAÇÃO/REQUISITO

...

Adequações das alterações da versão TISS 4.02.00.

...

Início de Vigência em 01/06/2025 e limite de implantação em 30/11/2025.

03. SOLUÇÃO

As alterações visam compatibilizar o módulo os módulos Revisão de Contas e Atendimento ao Público do TOTVS Saúde Planos - Linha Datasul as alterações da TISS 4.02.00

...

conf1,conf2,conf3

Totvs custom tabs box

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

Totvs custom tabs box items

default	yes
referencia	passo2

Totvs custom tabs box

Adequações Atendimento ao Público, Adequações Revisão de Contas, Tabelas de domínio TISS 4.02.00, Lote Guias, Monitoramento TISS
ids	atendimento,contas,tabelas,loteguias,monitoramento

tabs

Servidor de Aplicação,Broker Escalável,Autenticação

ids

conf1

a parametrização da propriedade com.totvs.saude.tiss.version do Autorizador Web com o valor 4.02.00

Para que a comunicação funcione corretamente, é necessário que o Tomcat onde é executado o serviço totvs-hgp-tiss-webservices-40200.war reconheça as variáveis abaixo. A configuração pode ser feita diretamente nos scripts de inicialização do Tomcat (mais detalhes e exemplos aqui: Como criar variaveis de ambiente visiveis ao Datasul no Tomcat) ou mesmo diretamente como variáveis de ambiente do sistema operacional:

TOTVS_HOST: <host>:<porta> do serviço do Tomcat do Datasul. Ex: http://meu-datasul:8080

TOTVS_USERNAME: usuário de login que será utilizado para autenticação Basic no Datasul para execução dos serviços

TOTVS_PASSWORD: senha que será utilizada junto ao parâmetro acima

Obs: estas variáveis são utilizadas por outras aplicações, portanto é possível que já estejam configuradas no seu ambiente, e nesse caso, nenhuma ação é necessária, apenas a conferência.

:

Image Added

Para Portal Prestador é necessário parametrizar a Versão TISS Configurações do Portal Prestador (hac.portPrestConfig) com 4.02.00:

Image Added

Totvs custom tabs box items

referencia
default	yes

atendimento

Com

o novo serviço, a aplicação htzfoundation.ear (JBoss) passa a ser dividida em um artefato distinto no Tomcat, contendo somente os Webservices TISS conforme a versão:

Informações

Versão TISS

Artefato

totvs-hgp-tiss-webservices-40200.war

Informações

title	Dica para validar esta etapa

Aviso

O Autorizador Web e Portal e Prestador devem ser parametrizados para nova versão juntos.

É necessário que seja parametrizado no programa Manutenção Parâmetros Revisão de Contas (hrc.paramrc) a versão da TISS para que sejam compatíveis na hora de comunicar, sem ocorrer falhas.

Image Added

Após configurar as variáveis de ambiente e reiniciar o Tomcat, utilize a URL abaixo para validar se o ambiente as reconheceu corretamente:

http://<SERVIDOR>:<PORTA>/totvs-hgp-webservices/ptu/v8/integrations/gateway/serverInfo

O resultado deve ser semelhante a isto:

Image Removed

As variáveis precisam aparecer nesta consulta antes de prosseguir para a próxima etapa. Caso contrário ocorrerão problemas de comunicação.

O novo serviço utiliza o conceito de Broker Escalável, onde é possível direcionar as chamadas ao Progress para um broker específico, isolando o back-end de outras aplicações, como o ERP por exemplo.

Toda comunicação encaminhada da aplicação totvs-hgp-tiss-webservices-40200.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-saude-planos-tiss-webservices", sendo necessário que o cliente inclua através do Empresas do Foundation (html.companies) um novo registro contendo esse alias.

Exemplo:
No programa html.companies (Empresas do Foundation), criar um novo registro nos Cadastros relacionados → Servidores de aplicação, contendo o alias "totvs-saude-planos-tiss-webservices":

Image Removed

Totvs custom tabs box items

default	no
referencia	contas

Executar o SPP para que seja trocada a versão da TISS para 4.02.00
1. tiss\spp\sp_atualiza_versao_4_02_00.p
No TOTVS12, acesse o programa Manutenção Layout (hte.layout) e realize a importação do arquivo database\dados\tablas.d utilizando a opção Importar para efetuar a inclusão do novo layout.
1. Programas de layout que serão criados:
  1. LATISS-E40200 - LAYOUT DE EXPORTACAO TISS - 4.02.00
  2. Image Added

conf2

Aviso

Caso o cliente deseje isolar a parte Progress dos Webservices TISS em um broker separado, deve ser criada uma nova instância do PASOE, referenciando-a através do campo "Servidor Aplicação". Para maiores detalhes sobre a criação da instância no PASOE, ver a documentação: Criando uma instância PASOE através do OpenEdge Explorer

Caso o cliente não deseje fazer essa separação, basta criar o registro com o alias "totvs-saude-planos-tiss-webservices" referenciando para o mesmo "Servidor Aplicação" existente.

Na página Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas REST é possível verificar maiores detalhes sobre essa configuração.

Para integrar com o novo serviço, deve ser realizada a autenticação do prestador na própria mensagem, conforme previsto pelo manual da TISS:

Image Removed

Exemplo de preenchimento no XML:

Image Removed

A habilitação do prestador ocorre através do cadastro Manutenção de Usuários Portal do Prestador (hat.secretary).

O campo loginPrestador a ser informado no XML será o Usuário informado nesse cadastro
O campo senhaPrestador a ser informado no XML será a Senha informada nesse cadastro, em formato MD5
- Exemplo - formato MD5 de "totvs@123" gerado através do link https://www.md5hashgenerator.com/:
  Image Removed

Na aba Prestadores Associados deve haver o vínculo do prestador informado na tag "codigoPrestadorNaOperadora" com o papel de Serviço:

Image Removed

Caso o papel esteja como Padrão, o Status como Inativo, o vínculo com o prestador não exista ou a senha não corresponda, o usuário não terá permissão para integrar com o serviço, sendo retornada a mensagem:

Falha na autenticação. Usuário ou senha incorretos ou o usuário informado não tem permissão para utilizar esse serviço nesse prestador e/ou versão da TISS
- Exemplo:

Image Removed

Totvs custom tabs box items

referencia
default	no

conf3

tabelas

Terminologia de Classificação Brasileira de Ocupações (CBO) - Tabela 24

Adicionado CBO novo 223575 Obstetriz na listagem de CBOs.

Image Added

Terminologia de status da guia e do protocolo - Tabela 47

Image Added

Terminologia da versão do componente de comunicação do padrão - Tabela 69 Image Added

http://

- <servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/loteGuias

Para validar se um endpoint está no ar, pode ser acessado o endereço via navegador, acrescido de ".wsdl".

Exemplo: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoProcedimento.wsdl - deverá ser retornada a estrutura XML da mensagem.

Image Removed

Um prestador pode consumir ambos serviços simultaneamente .

Exemplo: Para Solicitação de Procedimentos, integrar com o endpoint antigo e para o Cancelamento de Guia, integrar com o endpoint novo.

Essa abordagem permite à Operadora realizar a homologação/migração de forma parcial, por prestador e por mensagem.

- )

Totvs custom tabs box items

default	no
referencia	passo3	loteguias

O Foundation Saúde está preparado para receber arquivos XML na versões 4.02.00 da TISS:
1. Manualmente
  1. Na tela Upload XML, selecione o arquivo com uma das novas versões;
  2. Clique em Upload;
  3. O sistema irá importar o arquivo;
2. Por meio dos web services, cujos endereços podem ser consultados por meio da página de serviços do JBOSS (Ex: http://enderecoDoFoundation:<porta>/jbossws/services):
  - TISSSolicitacaoStatusAutorizacaoV_4_02_00WS;
  - TISSSolicitacaoProcedimentoV_4_02_00WS;
  - TISSComunicacaoBeneficiarioV_4_02_00WS;
  - TISSVerificaElegibilidadeV_4_02_00WS;
  - TISSCancelaGuiaV_4_02_00WS;
  - TISSSolicitacaoStatusRecursoGlosaV_4_02_00WS;
  - TISSSolicitacaoStatusProtocoloV_4_02_00WS;
  - TISSLoteAnexoV_4_02_00WS;
  - TISSRecursoGlosaV_4_02_00WS;
  - TISSLoteGuiasV_4_02_00WS;
  - TISSSolicitacaoDemonstrativoRetornoV_4_02_00WS;
Webservices TISS:
- TOMCAT (Lote Guias: http://

Não houve alteração no processo de utilização das funcionalidades que envolvem os Webservices TISS. Todas as regras de negócio (incluindo CPC's) foram mantidas.

O que irá diferenciar os serviços será o endpoint com que o prestador realizará a integração de cada mensagem, conforme destacado a seguir:

Aviso

Solicitação Demonstrativo de Retorno: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/solicitacaoDemonstrativoRetorno
Solicitação Status Protocolo: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/solicitacaoStatusProtocolo
Envio de Documentos: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/envioDocumentos
Cancela Guia: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/cancelaGuia
Verifica Elegibilidade: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/pedidoElegibilidade
Comunicação Beneficiário: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/comunicacaoBeneficiario
Solicitação Status de Autorização: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/solicitaçãoStatusAutorizacao
Solicitação Status Recurso Glosa: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/solicitaçãoStatusRecursoGlosa
Recurso Glosa: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/recursoGlosa
Solicitação Procedimento: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/solicitacaoProcedimento
Lote Anexo: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/loteAnexo
Lote Guias: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-<versao>/api/loteGuias

É necessário substituir o <servidor> e <porta> conforme seu ambiente e a <versao> conforme a TISS (40100 para 4.01.00 ou 40001 para 4.00.01).

Exemplo comparativo de endpoints da TISS 4.02.00:

Mensagem TISS

Endpoint antigo (JBoss)

Endpoint novo (Tomcat)

Solicitação Demonstrativo de Retorno

http://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoDemonstrativoRetornoV_4_02_00WS

http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoDemonstrativoRetorno

Solicitação Status Protocolo

http://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusProtocoloV_4_02_00WS

http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoStatusProtocolo

Solicitação Status de Autorização

http://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusAutorizacaoV_4_02_00WS