DT IMPLEMENTAÇÃO DO WEBSERVICE ENVIO DE DOCUMENTOS WSPLSENDOC

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Implementar WebService de comunicação TISS de Envio de Documentos.

03. SOLUÇÃO

Criado serviço para comunicação TISS, conforme especificações do Padrão TISS_Componente de Conteúdo e Estrutura_202111.

04. DEMAIS INFORMAÇÕES

Endpoint

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

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

Exemplo: http://127.0.0.1:433/W_PWSX010.APW/tissEnvioDocumentoWS

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 pasta "/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 rotina PLSA447, na opção "Schemas".

Regras do envio de documentos

Conforme definições TISS, o documento deverá ser enviado codificado em BASE64, deverá estar nos formatos previstos pela TISS (jpeg, pdf, png ou tiff) e deverá ter como tamanho máximo 10Mb.

Vinculo do Documento

O vínculo ocorre de acordo com as informações enviadas. Pode ser vinculado na BEA, BCI, BD5, BE4 ou B4D.

Para vínculo na BEA

Tag "naturezaGuia" = "1"  

Tag "numeroGuiaOperadora" = BEA_OPEMOV+BEA_ANOAUT+BEA_MESAUT+BEA_NUMAUT ou a tag "numeroGuiaPrestador" = BEA_NUMIMP

Para vínculo na BCI

Tag "naturezaGuia" = "2"  

Tag "numeroProtocolo" = BCI_CODPEG

Para vínculo na BD5/BE4

Tag "naturezaGuia" = "2"  

Tag "numeroGuiaOperadora" = número do protocolo (BD5/BE4_CODPEG) + número da guia (BD5/BE4_NUMERO) ou  tag "numeroGuiaPrestador" = BD5/BE4_NUMIMP

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"  

Tag "numeroProtocolo" = B4D_PROTOC ou a tag "numeroGuiaOperadora" = B4D_OPEMOV+B4D_CODLDP+B4D_CODPEG+B4D_NUMAUT

Consolidação e visualização do documento

A gravação do documento ocorre na base de conhecimento (tabelas ACB e AC9). Para visualizar o documento enviado acesse:

BEA

Acesse a rotina "Autorização SADT", selecione a guia no grid e clique em "Outras Ações" > "Conhecimento" > "Guia".

BCI

Acesse a rotina "Digitação de Contas", selecione a PEG no grid e clique em "Outras Ações" > "Documentos".

BD5/BE4

Acesse a rotina "Digitação de Contas", selecione a PEG no grid, clique em "Outras Ações" > "Selecionar". Na tela das guias, selecione a guia desejada no grid  e clique em "Outras Ações" > "Documentos".

B4D

Acesse a rotina "Protocolo/análise de Glosa", selecione o recurso no grid e clique em "Outras Ações" > "Anexos".

Registro do transação

Na tabela B1R, para cada requisição aceita (sendo o envio do documento um sucesso ou não) é gravado um protocolo (B1R_PRO TOC) e a requisição (B1R_REQUES). Caso não haja um erro de serviço interno ou violação de schema, a resposta também é registrada (B1R_RESPON).

Parâmetros

Criação de Parâmetro no arquivo Appserver.ini:

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:
      JEMP e JFIL, que significam empresa e filial onde o sistema deve logar, para realizar as consultas e gravação das informações.
   5. 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.
   6. 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.
   7. Abaixo, um exemplo do arquivo Appserver.ini configurado de maneira correta.

Alteração de dicionário

Foram criados os seguintes campos na tabela B1R:

Foi criado a chave única para a tabela BCI:

05. ASSUNTOS RELACIONADOS

• As regras de envio são descritas no manual da ANS "Padrão conteúdo & estrutura" de novembro de 2021, disponível no portal da ANS.