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). |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Totvs custom tabs box |
---|
tabs | Servidor de Aplicação,Tela de Parâmetros,Broker Escalável,CPC's |
---|
ids | conf1,conf2,conf4,conf5 |
---|
| 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, 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.
Aviso |
---|
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 Protocolo:
Ao realizar uma consulta de Status 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 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. |
|
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-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-hgp-webservices", 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-hgp-webservices": ![](/download/attachments/845771459/image-2024-6-3_10-24-55.png?version=1&modificationDate=1717421094833&api=v2)
![](/download/attachments/845771459/image-2024-6-3_10-26-8.png?version=1&modificationDate=1717421167687&api=v2)
Aviso |
---|
Caso o cliente deseje isolar a parte Progress 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-hgp-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. |
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 Familiar: 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 |
---|
default | no |
---|
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,Outros |
---|
ids | fase1,fase2,fase3,fase4,fase5 |
---|
referencia | passo3 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | fase1 |
---|
|
- Solicitação 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.
- Solicitação de Estorno de Glosa (TISS-20): Solicita o estorno de um valor glosado em um lote de guias enviado anteriormente.
|
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.
- Situação de Débito (TISS-17): Consulta o status de um débito gerado para o prestador.
|
Totvs custom tabs box items |
---|
|
- Consulta de Beneficiário (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.
|
Totvs custom tabs box items |
---|
|
- Envio de Lote de Guias (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.
|
Totvs custom tabs box items |
---|
|
Estruturas Convertidas
- Prestador - Operadora
Image Added - 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.
- Mensagem de Cancelamento (TISS-6): Cancela uma mensagem enviada anteriormente.Operadora - Prestador
Image Added
|
- 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:
![](/download/attachments/845771459/image-2024-6-3_12-0-37.png?version=1&modificationDate=1717426837727&api=v2) - Autenticação de usuário e senha no formato MD5
Exemplo:
![](/download/attachments/845771459/image-2024-6-3_12-14-4.png?version=1&modificationDate=1717427645630&api=v2)
- Regra de Negócio do Sistema
No menu Manut. Usuários Portal Prestador (hat.secretary):
Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
![](/download/attachments/845771459/image-2024-6-3_12-21-41.png?version=1&modificationDate=1717428101980&api=v2)
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: ![](/download/thumbnails/845771459/image-2024-6-3_12-50-6.png?version=1&modificationDate=1717429807060&api=v2)
|
- 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:
![](/download/attachments/845771459/image-2024-6-3_12-32-25.png?version=1&modificationDate=1717428745530&api=v2)
- Exemplo Mensagem TISS (Solicitação Status Protocolo):
![](/download/attachments/845771459/image-2024-6-3_12-58-16.png?version=1&modificationDate=1717430296787&api=v2)
|
|
|