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

CONTEÚDO

1. Parametrizações
2. Visão geral
3. Elegibilidade
4. Procedimentos
5. Tiss Online
6. 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.

Atenção: Em ambientes Linux é necessário renomear  alguns arquivos da pasta protheusData/tiss/schemas deixando o nome dos arquivos em letras minúsculas. Esses arquivos seriam:

tissv

tisswebservicesv

tisssolicitacaoprocedimentov

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.

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 2 parâmetros no HAT.

Os parâmetros loginPLS, senhaPLS.

Login e Senha é o usuário e senha do protheus.

Esta configuração é necessária para que ao acessar a API de elegibilidade seja validado a segurando do seu SERVIDOR REST.

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 2 parâmetros no HAT.

Os parâmetros loginPLS, senhaPLS.

Login e Senha é o usuário e senha do protheus.

Esta configuração é necessária para que ao acessar a API de elegibilidade seja validado a segurando do seu SERVIDOR REST.

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.

Também é possível configurar para a busca de procedimento ser realizada diretamente no PLS, utilizando o parâmetro buscaProcedimentoPLS. Para mais informações, acesse: DT Alteração no backend para busca de procedimento direto no PLS. 

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:

1. Jornadas de SADT(Pronto Socorro, Exame, Execução pré-autorizado e tratamento seriado):
   1. São ativadas automaticamente ao informar o endpoint e defini-lo como "Ativo".
2. Jornada de Consulta:
   1. É ativada ao informar o parametro 'tissOnlineConsulta' como "Sim".
3. Jornadas de Internação e prorrogação:
   1. São ativadas ao informar o parametro 'tissOnlineInternacao' como "Sim".
4. Jornada de Tratamento Odontológico:
   1. É 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

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