CONTEÚDO
- Parametrizações
- Visão geral
- Elegibilidade
- Procedimentos
- Tiss Online
- Tiss Online Anexos
01. PARAMETRIZAÇÕES
Para funcionamento correto das integrações é necessário que a versão TISS configurada em seu Protheus seja igual ou superior a 3.05.00, nos campos BAU_TISVER e BA0_TISVER e também no parametro MV_TISSVER.
02. VISÃO GERAL
É possível, a partir da versão 0.105.1 configurar o Totvs Saúde - Portal Autorizador se integrar ao Totvs Saúde Planos - Linha Protheus e realizar as validações de elegibilidade de beneficiários, validações de cobertura de procedimentos e gravação de guias diretamente no produto Protheus.
Tradicionalmente o Totvs Saúde - Portal Autorizador possui um motor próprio de validação e gravação de dados que tem, de forma simplificada, uma arquitetura similar ao diagrama abaixo:
Ao trocar a forma de validação e gravação, o desenho arquitetural é alterado e fica a cargo da operadora decidir sua implantação.
Existem 3 momentos em que o Totvs Saúde - Portal Autorizador irá solicitar que o sistema de gestão realize ações. São eles: Elegibilidade do Beneficiário, Validação de procedimentos e Gravação das guias.
Este é um passo opcional e demanda algumas configurações dentro do Totvs Saúde - Portal Autorizador, do Totvs Saúde Planos - Linha Protheus e configurações de rede da operadora para funcionar adequadamente.
Importante
Caso a operadora decida utilizar o Totvs Saúde Planos - Linha Protheus como motor de validação e gravação, as 3 integrações devem estar ligadas e funcionando simultaneamente. Não sendo permitido habilitar apenas uma e deixar as demais desligadas, sob risco de haver inconsistências entre o que é autorizado e gravado nas guias.
A gravação de guias até o presente momento foi feito apenas em guias de Consulta, Odontológica, Internação e Prorrogação, e jornadas de SADT (Pronto Socorro, Exame, Execução pré-autorizado e tratamento seriado).
A partir do build 0.115.0 as jornadas de Anexos Clinicos(Radioterapia, Opme e Quimioterapia) e Situação inicial também estarão disponível.
03. ELEGIBILIDADE
Ao ativar esta opção a identificação e validação de elegibilidade do beneficiário será feita totalmente considerando o cadastro no SIGAPLS.
A validação mencionada é a informada na tela abaixo:
A API de integração de elegibilidade será configurada na tabela externalAPI 'INTEGRATION_ELEGIBILITY_API'.
Deve ser informado a URL do servidor REST Protheus conforme informações da documentação - API BeneficiaryElegibility - Elegibilidade do Beneficário
Se seu servidor REST Protheus estiver com SECURITY=1 ligado no appServer.ini (É o recomentado ligar esta segurança), será necessário informar 3 parâmetros no HAT.
Os parâmetros loginPLS, senhaPLS e urlTOKEN.
Login e Senha é o usuário e senha do protheus e a urlTOKEN é '{URL DO SEU SERVIDOR}/api/oauth2/v1/token?grant_type=password' .
Exemplo.: http://localhost:8081/rest/api/oauth2/v1/token?grant_type=password
Esta configuração é necessária para que ao acessar a API de elegibilidade seja validado a segurando do seu SERVIDOR REST.
Caso o login ou urlTOKEN não tenha sido informado, o acesso a API do Protheus ERP será feita diretamente e se o SECURITY=1 estiver ligado a requisição será negada por falta de autorização.
04. VALIDAÇÃO PROCEDIMENTOS
Ao ativar esta opção a validação de procedimentos será feita totalmente considerando o cadastro no SIGAPLS.
Caso a Opção "4 - Gravação de guia via tiss online" for ativada, independente do resultado da validação dos procedimentos na tela abaixo, o resultado final considerado na gravação será o da validação feita pelo tiss online.
A validação mencionada é a informada na tela abaixo:
A API de integração de autorização de procedimento será configurada na tabela externalAPI 'INTEGRATION_AUTH_PROCEDURE_API'.
Deve ser informado a URL do servidor REST Protheus conforme informações da documentação - Criação API PLS - Validação Procedimento
Se seu servidor REST Protheus estiver com SECURITY=1 ligado no appServer.ini (É o recomentado ligar esta segurança), será necessário informar 3 parâmetros no HAT.
Os parâmetros loginPLS, senhaPLS e urlTOKEN.
Login e Senha é o usuário e senha do protheus e a urlTOKEN é '{URL DO SEU SERVIDOR}/api/oauth2/v1/token?grant_type=password' .
Exemplo.: http://localhost:8081/rest/api/oauth2/v1/token?grant_type=password
Esta configuração é necessária para que ao acessar a API de elegibilidade seja validado a segurando do seu SERVIDOR REST.
Caso o login ou urlTOKEN não tenha sido informado, o acesso a API do Protheus ERP será feita diretamente e se o SECURITY=1 estiver ligado a requisição será negada por falta de autorização.
Após configuração e ativação no cadastro de API no HAT-ADMIN (Configurações/Configurações de Integração) o sistema já esta pronto para que as funcionalidades do HAT Autorização de Procedimento acesse o REST PROTHEUS.
05. GRAVAÇÃO DE GUIA VIA TISS ONLINE
Ao ativar esta opção a gravação e validação final da guia sera feita via TISS Online Solicitação de Procedimentos.
A validação mencionada é a informada na tela abaixo:
Realizada implementação para comunicar com o SIGAPLS via WS padrão Tiss solicitação de procedimentos.
Para ativar a autorização e gravação de guia direto no SIGAPLS basta informar o endpoint do serviço WebService Tiss Online de Solicitação de Procedimentos no HAT Admin.
Ao ativar esta implementação não serão análisadas nenhuma das tabelas no HAT e sim somente no SIGAPLS, incluindo pontos de entrada já utilizados.
Deve ser informado a URL do servidor WS Protheus de tissSolicitacaoProcedimento conforme informações da documentação - WebServices Mensagens TISS
06. GRAVAÇÃO DE ANEXOS VIA TISS ONLINE
Ao ativar esta opção a gravação e validação final das guias de Anexos Clinicos e Situação inicial serão feitas via TISS Online Lote Anexo.
Para ativar a autorização e gravação de guia direto no SIGAPLS basta informar o endpoint do serviço WebService Tiss Online de Lote Anexo no HAT Admin.
Ao ativar esta implementação não serão análisadas nenhuma das tabelas no HAT e sim somente no SIGAPLS, incluindo pontos de entrada já utilizados.
Deve ser informado a URL do servidor WS Protheus de loteAnexoWS conforme informações da documentação - Webservice tissLoteAnexo - WSPLSTISSA
Parâmetros - Ativação
Devido ao desenvolvimento gradual das jornadas, foram criados parametros especificos para ativação das integrações de validação de procedimentos e chamada do tiss online:
- Jornadas de SADT(Pronto Socorro, Exame, Execução pré-autorizado e tratamento seriado):
- São ativadas automaticamente ao informar o endpoint e defini-lo como "Ativo".
- Jornada de Consulta:
- É ativada ao informar o parametro 'tissOnlineConsulta' como "Sim".
- Jornadas de Internação e prorrogação:
- São ativadas ao informar o parametro 'tissOnlineInternacao' como "Sim".
- Jornada de Tratamento Odontológico:
- É ativada ao preencher no parametro 'tissOnlineOdonto' com o código da RDA que irá utilizar a integração, ou caso informe "ALL" será considerado para todos os prestadores.
Parâmetros - Opcional
Caso a operadora opte por autenticação de segurança em suas transações de comunicação padrão TISS
Campo | Conteúdo |
|---|---|
| paramKey | loginWS |
| paramDescri | Login cadastrado na tabela BSW |
Campo | Conteúdo |
|---|---|
| paramKey | senhaWS |
| paramDescri | Senha cadastrada na tabela BSW, criptografada do mesmo jeito que é gravado. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas