Histórico da Página
CONTEÚDO
- Visão Geralgeral
- Exemplo de utilização
- Procedimentos para implantação
- Schemas
- Configurações
- Procedimentos para utilização
- Mensagem Mensagens TISS WebServiceConfigurações
- Procedimentos para implantação
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 interfacesAPIs.
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 schemasarquivos, com a versão e mensagem composições utilizada no objeto de envio, devem constar na pasta "/Protheus_data/tiss/schemas" no no servidor. O schema em vigência na data da publicação deste documento é "tissWebServicesV3_05_00.xsd" e pode ser obtido no Portal da ANS.
Configurações:
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.
| Nota | ||
|---|---|---|
| ||
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:
JEMP e JFIL, que significam empresa e filial onde o sistema deve logar.
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.
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:
- No sistema “Configurador”, selecione as opções “Ambiente/Cadastro/Parâmetro” e configure os parâmetros:
- 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).
- 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).
- 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.
Procedimentos para Utilização
Para utilizarmos um WebService mensagem TISSPara enviarmos uma mensagem TISS via WebService, 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:
...
SolicitacaoStatusRecursoGlosa - Solicita informação sobre recurso de glosa enviado pelo prestador à operadora.
...
...
| HTML |
|---|
<!-- esconder o menu -->
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style>
|
Utilização do Portal
- 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ção | Exemplo de Como Chamar em sua aplicação |
|---|---|
| tissLoteGuias | http://localhost:82/tissLoteGuias.apw |
| tissSolicitacaoProcedimento | http://localhost:82/tissSolicitacaoProcedimento.apw |
| tissSolicitacaoStatusAutorizacao | http://localhost:82/tissSolicitacaoStatusAutorizacao.apw |
| tissTransmiteMensagem | http://localhost:82/tissTransmiteMensagem.apw |
| tissVerificaElegibilidade | http://localhost:82/tissVerificaElegibilidade.apw |
| tissCancelaGuia | http://localhost:82/tissCancelaGuias.apw |
| tissLoteAnexo | http://localhost:82/tissLoteAnexo.apw |
| tissTransmiteMensagemZIP | http://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”

