Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
   1. Tela XXX
      1. Outras Ações / Ações relacionadas
         
   2. 1. EndPoint
      2. Schemas
      3. Regras do envio de documentos
      4. Vínculo dos Documentos
      5. Consolidação e visualização do documento no remote
      6. Registro das transações
      7. Exemplo de uso prático
   3. Parâmetros no arquivo Appserver.ini
      
   4. Alterações no dicionário de dadosTela XXXPrincipais Campos e Parâmetros
      
   5. Tabelas utilizadas

   
   

   01. VISÃO GERAL

   Âncora
   VIS VIS

   Criação do webservice padrão TISS, referente ao envio de documentos entre Prestador e Operadora, conforme especificações da ANS - Agência Nacional de Saúde Suplementar.

   
   

   
   

   02. EXEMPLO DE UTILIZAÇÃO

   ...

   03. TELA XXXXX

   Outras Ações / Ações relacionadas

   ...

   04. TELA XXXXX

   Principais Campos e Parâmetros
   

   ...

   Card documentos
   Informacao Use esse box para destacar informações relevantes e/ou de destaque. Titulo IMPORTANTE!

   Âncora
   EXP EXP

   A) Endpoint

   Âncora
   endpoint endpoint

   Para enviar uma requisição para o serviço WSPLSENDOC (envio de documentos), deve-se utilizar como endpoint o Endereço (URL) e Porta do Portal do Plano de Saúde, mais o sufixo com a chamada do webservice: "tissEnvioDocumentoWS.apw".

   Estrutura: http://[endereçoportal]:[porta]/[chamada_serviço].apw

   Exemplo: http://127.0.0.1:433/tissEnvioDocumentoWS.apw

   
   

   B) Schemas

   Âncora
   schema schema

   O serviço utiliza protocolo de comunicação SOAP e deverá respeitar a estrutura TISS (Troca de Informações na Saúde Suplementar), vigente da ANS. Os arquivos de schemas da TISS, com a versão utilizada, devem constar na subpasta Schemas, que fica no diretório Protheus_Data. O caminho padrão - que pode variar de acordo com a instalação do sistema - é "/Protheus_Data/tiss/schemas" no servidor.

   O schema em vigência na data da publicação deste documento é "tissWebServicesV4_00_01.xsd", e pode ser obtido no Portal da ANS. A atualização também pode ser realizada através da função de Atualização automática de Terminologias, na rotina PLSA447, na opção "Schemas".

   
   

   C) Regras do envio de documentos

   Âncora
   regras regras

   Conforme definições TISS, o documento deve ser enviado codificado em BASE 64, devendo estar nos formatos previstos pela TISS (jpeg, pdf, png ou tiff), além de ter como tamanho máximo 10Mb.

   
   

   D) Vínculo dos Documentos

   Âncora
   vinculo vinculo

   O vínculo ocorre de acordo com as informações enviadas. Pode ser vinculado na BEA, BCI, BD5, BE4 ou B4D, de acordo com a informação presente na tag <naturezaGuia> (1 - Solicitação; 2 - Faturamento e 3 - Recurso Glosa):

   • • Para vínculo na BEA

   - Tag "naturezaGuia" = "1"  

   - Vínculo pelas tags:  "numeroGuiaOperadora" = BEA_OPEMOV+BEA_ANOAUT+BEA_MESAUT+BEA_NUMAUT ou "numeroGuiaPrestador" = BEA_NUMIMP

   
   

   • • Para vínculo na BCI

   - Tag "naturezaGuia" = "2"  

   - Vínculo pela tag: "numeroProtocolo" = BCI_CODPEG

   
   

   • • Para vínculo na BD5/BE4

   - Tag "naturezaGuia" = "2"  e as tags <numeroGuiaOperadora> ou <numeroGuiaPrestador> presentes na requisição.

   - Vínculo pelas tags: "numeroGuiaOperadora" = número do protocolo (BD5/BE4_CODPEG) + número da guia (BD5/BE4_NUMERO) ou "numeroGuiaPrestador" = BD5/BE4_NUMIMP

   OBS: Caso o protocolo seja do tipo 05 (Internação), será vinculado na BE4, caso contrário, será vinculado na BD5.

   
   

   • • Para vínculo na B4D

   - Tag "naturezaGuia" = "3"  

   - Vínculo pelas tags: "numeroProtocolo" = B4D_PROTOC ou "numeroGuiaOperadora" = B4D_OPEMOV+B4D_CODLDP+B4D_CODPEG+B4D_NUMAUT

   
   

   E) Consolidação e visualização do documento no remote

   Âncora
   visual visual

   A gravação do documento ocorre na base de conhecimento (tabelas ACB e AC9). Para visualizar o documento enviado, é necessário acessar a Base de Conhecimento de cada rotina, conforme instruções abaixo:

   • • BEA

   No remote, acesse Atualizações / Atendimento / Autorização SADT. Selecione a guia no grid e clique em Outras Ações / Conhecimento / Guia, para que os sistema exiba os anexos vinculados.

   
   

   • • BCI

   No remote, acesse Atualizações / Proc. Contas / Digitação de Contas. Selecione a PEG no grid e clique em Outras Ações / Documentos, para que os sistema exiba os anexos vinculados.

   
   

   • • BD5/BE4

   No remote, acesse Atualizações / Proc. Contas / Digitação de Contas. Selecione a PEG onde a guia desejada está alocada e então, clique em Outras Ações / Selecionar. O sistema irá exibir todas as guias que estão associadas a PEG, bastando selecionar no grid a guia, e após, clicar em Outras Ações / Documentos, para que os sistema exiba os anexos vinculados.

   
   

   • • B4D

   No remote, acesse Atualizações / Proc. Contas / Protocolo/Análise de Glosa. Selecione o protocolo de recurso no grid e clique em Outras Ações / Anexos, para que os sistema exiba os anexos vinculados.

   
   

   F) Registro das transações

   Âncora
   registro registro

   Na tabela B1R - Protocolo de transação, para cada requisição enviada ao webservice (sendo o envio de documento acatado ou não), é gravado um protocolo (B1R_PRO TOC) e a requisição (o conteúdo da requisição SOAP, no campo B1R_REQUES). Caso não haja um erro de serviço interno ou violação de schema, a resposta dado pelo webservice também será gravado, no campo B1R_RESPON.

   
   

   G) Exemplo de uso prático 

   Âncora
   gifuso gifuso

   Image Added

   
   

   
   

   03. Parâmetros no arquivo AppServer.ini 

   Âncora
   PARAM PARAM

   Abaixo, colocamos algumas informações que são vitais para o correto funcionamento do Webservice de Envio de Documentos, no tocante a configuração do arquivo Appserver.ini:

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

         2. Acesse a pasta onde fica localizado o server do ambiente e abra o arquivo Appserver.ini.
         3. No arquivo Appserver.ini, procure a sessão onde consta o nome do ambiente.
            Exemplo: Caso o nome do ambiente seja "P12_NOVOAMBIENTE", localize no arquivo a sessão [P12_NOVOAMBIENTE].
         4. No final dessa sessão, adicione os seguintes parâmetros, caso não existam, que são JEMP e JFIL, que significam empresa e filial, onde o sistema deve logar, para realizar as consultas e gravação das informações:
            • JEMP - Informe a empresa/grupo onde deseja iniciar o processo, como por exemplo, caso a empresa seja do grupo 01, deve-se colocar JEMP=01;
            • JFIL - Informe a filial onde será iniciado o processo. Por exemplo, caso a filial seja M SP 01, deve ser colocado JFIL=M SP 01.
      2. Abaixo, um exemplo do arquivo Appserver.ini configurado de maneira correta.
      3. Image Added

   
   

   
   

   04. Alterações de Dicionário de Dados 

   Âncora
   alt alt

   • Criação dos seguintes campos na tabela B1R:

   B1R - Protocolo de transação
   SX3 - Informações dos Campos
   Campo	Descrição
   Campo	B1R_REQUES
   Tipo	Memo
   Tamanho	100
   Decimal	0
   Título	Request
   Descrição	Request do WebService
   Usado	Sim
   Obrigatório	Não
   Browse	Não
   Ordem	15
   Campo	Descrição
   Campo	B1R_RESPON
   Tipo	Memo
   Tamanho	100
   Decimal	0
   Título	Response
   Descrição	Response do WebService
   Usado	Sim
   Obrigatório	Não
   Browse	Não
   Ordem	16

   
   

   • Criação da chave única (X2_UNICO) para a tabela BCI:

   BCI - Protocolo de Entrega de Guias
   SX2 - Informações da tabela
   Campo	Descrição
   X2_UNICO	BCI_FILIAL+BCI_CODOPE+BCI_CODLDP+BCI_CODPEG

   
   

   
   

   05. TABELAS UTILIZADAS 

   Âncora
   TAB TAB

   • B1R - Protocolo de transação
   • B4D - Cabeçalho Recurso de Glosa    
   • BCI - Protocolo de Entrega de Guias 
   • BD5 - Processamento de Contas
   • BE4 - Internações
   • BEA - Complementos Movimentações

   ...