Linha Microsiga Protheus

Árvore de páginas


CONTEÚDO

  1. Visão geral
  2. Exemplo de utilização
    1. Procedimentos para implantação
      1. Schemas
      2. Configurações
    2. Procedimentos para utilização
    3. Mensagens TISS WebService

01. VISÃO GERAL

As mensagens no padrão TISS, Troca de Informações na Saúde Suplementar, são mensagens padronizadas que serão trocadas entre prestadores e operadoras de saúde suplementar. Tem como objetivo a interoperabilidade entre os diversos sistemas de informação e reduzir a assimetria de informações dessas trocas de dados. 

O Protheus disponibiliza WebServices via protocolo SOAP sob o padrão TISS para facilitar o compartilhamento dessas informação entre operadora e prestadores. Este serviço permite que as informações sejam intercambiadas entre sistemas diversos na WEB e acopladas em diferentes APIs.

02. EXEMPLO DE UTILIZAÇÃO

Procedimentos para Implantação

Schemas

As trocas de mensagens deverão respeitar os arquivos de schemas vigentes da ANS. Estes arquivos, com a versão e composições utilizada no objeto de envio, devem constar na pasta "/Protheus_data/tiss/schemas" no servidor. 

Baixe a última versão dos schemas que podem ser obtidos no Portal da ANS. Descompacte-os na pasta "/Protheus_data/tiss/schemas". Caso a pasta não exista cria essa estrutura.

Este processo, de baixar a última versão dos schemas, pode ser feito de forma automática pelo processo "Atualizar TISS" da rotina "Versões TISS". Acesse o processo e selecione a opção "schemas". Em caso de dúvida, acesse o Manual do Processo de Virada de Versão.

Configurações

No ambiente onde será executado o WebService TISS, será necessário realizar inclusão de dois parâmetros no arquivo appserver.ini, caso não existam. 

Aviso!

Caso não exista no Appserver.ini as informações abaixo, algumas mensagens TISS não irão funcionar!

Acesse a pasta onde fica localizado o server do ambiente e abra o arquivo "Appserver.ini".

No arquivo Appserver.ini, procure a sessão onde consta o nome do ambiente. Exemplo: Caso o ambiente seja chamado de P12_NOVOAMBIENTE, localize no arquivo a sessão [P12_NOVOAMBIENTE].

No final dessa sessão, adicione os seguintes parâmetros, caso não existam:

  1. JEMP e JFIL, que significam empresa e filial onde o sistema deve logar.

  2. Logo, no JEMP, colocar a empresa/grupo onde deseja iniciar o processo, como por exemplo, caso a empresa seja do grupo 01, deve-se colocar JEMP=01.

  3. No JFIL, deve-se colocar a filiar onde será iniciado o processo. Por exemplo, caso a filial seja M SP 01, deve ser colocado JFIL=D M SP 01.

Abaixo, um exemplo do arquivo Appserver.ini configurado de maneira correta:

image2018-10-15_17-50-34.png


  1. No sistema “Configurador”, selecione as opções “Ambiente/Cadastro/Parâmetro” e configure os parâmetros:
    1. Configure o parâmetro MV_PLTIDEB  e indica se ativa o Log Sim ou Não (1 - Ativa o log para exibir na tela de console de server).
    2. Configure o parâmetro MV_PLTILOG  e indica de Ativa o Log Sim ou Não (1 - Ativa o log para a gravação em arquivo).  
  2.  Após a primeira utilização da rotina “TISS Online” (WSPLSTISSON) o sistema cria automaticamente no servidor a seguinte estrutura de diretórios para tratamento dos arquivos gerados pela rotina.

mceclip2.png

Procedimentos para Utilização

Para utilizarmos um WebService mensagem TISS, devemos informar, como endpoint, o endereço, a porta do servidor e o serviço requerido neste formato: http://[endereçoportal]:[porta]/[tissServico].APW

Exemplo: http://127.0.0.0:1234/tissRecursoGlosa.APW

Estes endereços serão os endpoints que deverão ser informados para as requisições dos prestadores.

Mensagens TISS WebService:

CancelaGuia - Envia solicitação de cancelamento de uma ou mais guias.

ComunicacaoBeneficiario - Envia comunicado de internação ou alta de um beneficiário.

LoteAnexo - Apresentação do anexo de situação inicial de odontologia e solicitação de autorização de tratamento de quimioterapia, radioterapia e OPME.

LoteGuias - Apresentação de cobrança de consultas, SP/SADT, resumo de internação, honorários e odontologia.

RecursoGlosa - Envia recurso sobre glosa ocorrida em um lote ou em guias do prestador.

SolicitacaoDemonstrativoRetorno - Solicitação de demonstrativo de análise de conta de medicina, demonstrativo de pagamento de medicina e odontologia.

SolicitacaoProcedimento - Solicitação de autorização de serviços de SP/SADT, internação, prorrogação de internação e tratamento em odontologia.

SolicitacaoStatusAutorizacao - Solicita status sobre pedido de autorização recebido pela operadora.

SolicitacaoStatusProtocolo - Solicita informação de lote de cobrança recebido pela operadora.

VerificaEligibilidade - Solicita informação sobre a elegibilidade de um beneficiário da operadora.

SolicitacaoStatusRecursoGlosa - Solicita informação sobre recurso de glosa enviado pelo prestador à operadora.


Utilização do Portal

  1. Deve ser implementada uma sessão de host no arquivo de “INI” do Protheus.

Exemplo: 

[LOCALHOST:82]
ENABLE=1
PATH=C:\MP8\WEB\PP
ENVIRONMENT=LOCAL
INSTANCENAME=PLS
RESPONSEJOB=JOB_PP
JEMP=99
JFIL=01

      2. Esta sessão não deve ser a mesma utilizada para o portal. Somente nesta sessão de acesso criada para o Tiss OnLine (WSPLSTISSON) se faz necessário a declaração das seguintes variáveis.

  • Informar o nome da empresa 

    JEMP=99

  • Informar o código da filial 

    JFIL=01

      3. Após o Protheus receber a solicitação Online a rotina Tiss OnLine (WSPLSTISSON) inicia tradução e criação do arquivo XML.

      4. O arquivo XML criado será enviado para a pasta “\TISS\ONLINE\CAIXAENTRADA”.

      5. Para dar continuidade, siga o processo conforme o “Importador XML” descrito no bops 0000126588, o qual tem como raiz a pasta “\TISS\ONLINE”.

  • Estão disponíveis para utilização do Tiss OnLine as seguintes WebServices:
Nome da TransaçãoExemplo de Como Chamar em sua aplicação
tissLoteGuiashttp://localhost:82/tissLoteGuias.apw
tissSolicitacaoProcedimentohttp://localhost:82/tissSolicitacaoProcedimento.apw
tissSolicitacaoStatusAutorizacaohttp://localhost:82/tissSolicitacaoStatusAutorizacao.apw
tissTransmiteMensagemhttp://localhost:82/tissTransmiteMensagem.apw
tissVerificaElegibilidadehttp://localhost:82/tissVerificaElegibilidade.apw
tissCancelaGuiahttp://localhost:82/tissCancelaGuias.apw
tissLoteAnexohttp://localhost:82/tissLoteAnexo.apw
tissTransmiteMensagemZIPhttp://localhost:82/TransmiteMensagemZIP.apw


  • A transação “tissTransmiteMensagemZIP”, é utilizada somente na versão “2.01.03”, assim para esta transação o parâmetro

“MV_TISSVER” deve ser alimentado com a versão “2.01.03”, conforme orientações de configuração do bops 0000126588 do importador XML. Para as demais transações podem ser utilizadas em qualquer versão.

  • Para o retorno do wsdl correspondente deve ser informado o parâmetro no final da URL. “?wsdl”