Web Service TISS Envio de Documentos - WSPLSENDOC

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
   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 dados
   
5. Tabelas utilizadas

01. VISÃO GERAL

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

A) 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

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

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

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

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

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 

03. Parâmetros no arquivo AppServer.ini 

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. 

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

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

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

05. TABELAS UTILIZADAS 

• 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