| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente. O pacote está disponível no portal (https://suporte.totvs.com/download) 1. Acesse o menu . |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| | Totvs custom tabs box |
|---|
| tabs | Servidor de Aplicação,Tela de Parâmetros,Certificado Digital,Broker Escalável,CPC's,Autenticação |
|---|
| ids | conf1,conf2,conf3,conf4,conf5,conf6 |
|---|
| | Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | conf1 |
|---|
| A comunicação TISS agora se integra ao ERP, eliminando a necessidade de uma infraestrutura separada (JBoss). Com essa mudança, a gestão do serviço é otimizada. | Aviso |
|---|
A aplicação htzfoundation.ear passa a ser , que anteriormente integrava os Webservices da TISS, agora está dividida em duas estruturas distintas a partir da versão TISS: | Versão TISS | WAR |
|---|
| 4.01.00 | totvs-java-hgp-tiss-webservices-40100.war |
| | 4.00.01 | totvs-java-hgp-tiss-webservices-40001.war |
|
Para que a comunicação com o Progress funcione corretamente, é necessário que as variáveis TOTVS_HOST, TOTVS_USERNAME e TOTVS_PASSWORD estejam configuradas no servidor, podendo ser via parâmetros de inicialização do Tomcat (como serviço do Windows/Linux ou arquivo de configuração) ou variáveis de ambiente no servidor em que o Tomcat é inicializado. Esse padrão é utilizado por outras aplicações e é possível que já estejam disponíveis em seu ambiente, e nesse caso, nenhuma ação é necessária. Na página Configurar servidor de aplicação TOMCAT é possível verificar um exemplo de configuração. |
| Totvs custom tabs box items |
|---|
| Comunicação - A URL do serviço deve ser o servidor + porta onde a aplicação está rodando:
Endpoints - Quando o campo relacionado ao endpoint apontar para o novo serviço, o sistema realizará a comunicação via Tomcat.
warning | As URL's a serem informadas são as fornecidas pela Unimed do Brasil para comunicação com o WSD referente à cada mensagem. |
Exemplo:
Editando e preenchendo o campo do endpoint da mensagem de Solicitação Status da Transação (0360)Protocolo: Ao realizar uma consulta de Status da Transação através da Consulta Status da Transação (hat0110p/hat.transactionStatusInquiry), Protocolo a comunicação será realizada através do novo serviço e não mais pelo Foundation.
| Versão TISS | Exemplo |
|---|
| 4.01.00 | /totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo |
| Aviso |
|---|
Assim como as URL's da Unimed do Brasil s devem ser preenchidas nessa tela, é necessário atualizar os endpoints do serviço na Unimed do Brasil para que o WSD comunique com cada mensagem, sendo elas: É necessário substituir o <servidor> e <porta> conforme seu ambiente. |
Log Auxiliar - Habilita/desabilita a geração de arquivos auxiliares contendo os dados de entrada e saída das comunicações realizadas no PTU Online, úteis para ambientes de homologação e validação de informações.
- Os arquivos serão gerados seguindo a nomenclatura: "Operação" + "Código da transação" + "Descrição da transação" + "Data" + "Hora".json
- Operação poderá ser: Envio, Resposta, Recebimento ou Resposta de Recebimento
- Exemplo de arquivos gerados:
 Image Removed - Quando habiitado é necessário informar um diretório válido para exportação, normalmente um diretório de rede que o PASOE consiga acessar.
- Quando desabilitado nenhum arquivo será exportado.
 Image Removed | Aviso |
|---|
Essa funcionalidade é similar à pasta "xmlwslog" que existia no servidor do Foundation, com a diferença que os arquivos serão gerados em formato JSON e não mais XML. Para verificar os XMLs que trafegaram de fato pelo WSD da Unimed do Brasil, pode ser utilizada a consulta de fases da transação pela Interface Única.
| Totvs custom tabs box items |
|---|
| O processo de certificação digital segue o padrão de conectores https no Tomcat e é similar à configuração anteriormente existente no JBoss. Na página SSL/TLS Configuration How-To é possível verificar a documentação da Apache a respeito desse processo. É necessário habilitar o conector https no arquivo server.xml do servidor, referenciando a um keystoreFile que tenha importado o certificado digital disponibilizado pela Unimed do Brasil. Também é necessário importar esse certificado para o Java utilizado na inicialização do Tomcat. Dessa forma será possível realizar as comunicações de envio e recebimento de transações com o WSD de intercâmbio. Exemplo:  Image Removed
Na página Configuração de HTTPS para o Datasul for THF é possível verificar maiores detalhes sobre essa configuração. | | Totvs custom tabs box items |
|---|
| 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-java-hgp-ptuonline-tiss-webservices-40100.war ou totvs-java-hgp-tiss-webservices-40001.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-saudehgp-planos-ptuonlinewebservices", sendo necessário que o cliente inclua através dos Parâmetros Foundation (btb962aa) um novo registro contendo esse alias.
Exemplo:
No programa BTB962AA (Parâmetros Foundation), criar um novo registro contendo o alias "totvs-saudehgp-planos-ptuonlinewebservices":  Image Added
 Image Added Image Removed
| Aviso |
|---|
Caso o cliente deseje isolar a parte Progress do PTU Online da Comunicação 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-saudehgp-planos-ptuonlinewebservices" 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. |
| Totvs custom tabs box items |
|---|
| Gostaríamos de informar que a recente migração para o novo serviço TISS ao TOMCAT não afetou o uso das funcionalidades para clientes que utilizam programas de CPC na comunicação TISS. O que isso significa para você: - Processo de Utilização FamiliarUsual: As regras de negócio e operações em tela do TISS permanecem inalteradas, garantindo uma experiência familiar e intuitiva.
- Funcionalidades Acessíveis: Todas as funcionalidades do TISS que você já conhece e utiliza continuam disponíveis, sem necessidade de adaptação.
- Comunicação TISS: O processo de comunicação TISS via CPC permanece inalterado, sem interrupções ou modificações.
|
| Totvs custom tabs box-items |
|---|
|
- Autenticação de Usuário na mensagem TISS
O padrão TISS já prevê uma segurança via usuário e senha, essas informações agora passam a ser validadas conforme as regras de negócio do sistema.
Segue abaixo a imagem das tags:
 Image Added - Autenticação de usuário e senha no formato MD5
Exemplo:
 Image Added
- Regra de Negócio do Sistema
No menu Manut. Usuários Portal Prestador (hat.secretary):
 Image Added
Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
 Image Added
| Aviso |
|---|
Ao preencher o campo Senha a senha é criptografada, para manter a segurança da privacidade da senha o campo na mensagem TISS é preenchido no formato MD5. Exemplo:  Image Added
|
- Na aba Prestadores Associados deve haver um registro do prestador da mensagem com os devidos parâmetros:
O campo "Papel" deve ser preenchido como Serviço/Prestador caso esteja como Padrão o usuário não terá permissão para realizar a comunicação TISS.
O campo "Status" deve estar Ativo.
Exemplo:
 Image Added
- Exemplo Mensagem TISS (Solicitação Status Protocolo):
 Image Added
|
|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| tabs | Solicitação,Status,Consulta,Envio,Outros |
|---|
| ids | fase1,fase2,fase3,fase4,fase5 |
|---|
| referencia | passo3 |
|---|
| O Padrão TISS define um conjunto abrangente de mensagens eletrônicas para viabilizar a troca de informações entre operadoras de planos de saúde, prestadores de serviços de saúde e a ANS. Cada mensagem possui uma função específica dentro do fluxo de comunicação, otimizando e padronizando os processos. Para facilitar a consulta, compilei uma lista das principais mensagens TISS existentes, agrupadas por Tipo de Serviço: | Totvs custom tabs box |
|---|
| default | no |
|---|
| tabs | Solicitação,Status,Consulta,Envio,Resumo,Endpoints |
|---|
| ids | fase1,fase2,fase3,fase4,fase5,fase6 |
|---|
| referencia | passo3 |
|---|
| | totvs-custom-tabs-box-items |
|---|
| default | yes |
|---|
| referencia | fase1 |
|---|
|
|
de Autorização (TISS-13): Envia uma solicitação à operadora para autorizar a realização de um procedimento ou evento em saúde.Solicitação de Cancelamento de Glosa (TISS-18): Solicita o cancelamento de uma glosa em um lote de guias enviado anteriormente.Solicitação de Ressarcimento de Glosa (TISS-19): Solicita o ressarcimento de um valor glosado em um lote de guias enviado anteriormente.Demonstrativo de Retorno
Solicitação Procedimento
|
Solicitação de Estorno de Glosa (TISS-20): Solicita o estorno de um valor glosado em um lote de guias enviado anteriormente. Exemplo:
 Image Added
|
| Totvs custom tabs box items |
|---|
|
Protocolo de Recebimento de Lote de Guias (TISS-2): Confirmação da operadora de que recebeu o lote de guias enviado.Situação de Lote de Guias (TISS-21): Consulta o status de um lote de guias enviado anteriormente.Situação de Autorização (TISS-14): Consulta o status de uma solicitação de autorização enviada anteriormente.
Solicitação Status Protocolo
Solicitação Status Recurso Glosa
Solicitação Status de Autorização
Exemplo:
 Image Added
|
Situação de Débito (TISS-17): Consulta o status de um débito gerado para o prestador.| Totvs custom tabs box items |
|---|
|
Consulta (TISS-12): Consulta dados básicos de um beneficiário, como nome, plano e cobertura.Consulta de Procedimento (TISS-11): Busca por informações sobre um procedimento específico, como código, descrição e valor de referência.Consulta de Órgão Emissor (TISS-10): Objęcie de dados sobre um determinado órgão emissor de guias, como CNPJ e razão social.Consulta de Operadora (TISS-9): Obtenção de informações sobre uma operadora de plano de saúde, como nome, código ANS e endereços.Consulta de Glosa (TISS-25): Consulta detalhes sobre uma glosa em um lote de guias.
Verifica Elegibilidade
Recurso Glosa
Cancela Guia
Exemplo:
 Image Added
|
| Totvs custom tabs box items |
|---|
|
Envio de (TISS-1): Envia um conjunto de guias TISS para a operadora para solicitação de reembolso.Envio de Dados para a ANS (TISS-23): Transmite eletronicamente dados obrigatórios à ANS, como estatísticas de atendimento e produção de serviços.
Lote Anexo
Envio Documentos
Exemplo:
 Image Added
|
| Totvs custom tabs box items |
|---|
|
Controle de Erros (TISS-8): Troca de mensagens para identificar e corrigir erros na comunicação entre o prestador e a operadora.Mensagem de Teste (TISS-7): Envio de mensagem para testar a comunicação entre o prestador e a operadora.
Estruturas Convertidas
- Prestador - Operadora
 Image Added - Operadora - Prestador
 Image Added
|
| Totvs custom tabs box items |
|---|
| |
Mensagem de Cancelamento (TISS-6): Cancela uma mensagem enviada anteriormente. |
|
|
