Passo 6 - Autorização e gravação de guias via PLS

CONTEÚDO

1. Visão geral
2. Elegibilidade
3. Procedimentos
4. Tiss Online

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

Este é um passo opcional e demanda algumas configurações dentro do Totvs Saúde - Portal Autorizador e configurações de rede da operadora para funcionar adequadamente. 

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

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

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

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

Parâmetros - Opcional

Caso a operadora opte por autenticação de segurança em suas transações de comunicação padrão TISS