Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Web services de Demonstrativos padrão TISS 3.02.01 

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Saúde

Módulo:

SIGAPLS - Plano de Saúde

Rotina:

Rotina

Nome Técnico

PLSA973

Tratamentos Webservices

Rotina(s) envolvida(s)

Nome Técnico

WSPLSTISSO

Webservice Tiss

PLSA973L

Validação das transações WS Tiss
PLSA498Lote de Pagamento
PLSRECGLORecurso de Glosa

Chamados Relacionados

TTIUPU

País(es):

Brasil

Banco(s) de Dados:

Todos relacionais homologados.

Tabelas Utilizadas:

BA0 - Operadora de Saúde

B4D - Cabeçalho Recurso de glosa

B4E - Itens Recurso de glosa

BVO - Tentativas de Recurso de glosa

BCT - Motivos de glosas

Sistema(s) Operacional(is):

Windows® / Linux®

Descrição

Disponibilizado a funcionalidade de retorno em formato XML da solicitação de Recurso de Glosa e Solicitação de Status do Recurso de Glosa, conforme padrão TISS 3.02.01 da ANS.

Agora, é possível enviar um XML para o servidor do Protheus com as informações dos recursos de eventuais glosas feitas em protocolos, guias e itens das guias, bem como consultar o status das solicitações de recursos de glosa. O sistema irá gravar o recurso solicitado ou buscar na base de dados a situação de determinado recurso de glosa já realizado anteriormente e retornar um arquivo XML com os dados recursados no formato padrão, para ser tratado por outros sistemas. O arquivo enviado com as informações das solicitações deve obedecer o padrão da TISS 3.02.01.

Para que seja possível o retorno tanto do recurso de glosa ou do status do mesmo, foram utilizados os webservices tissRecursoGlosa e tissSolicitacaoStatusRecursoGlosa, que devem ser baixados do site da Agência Nacional de Saúde - ANS.

 

Importante

 

Antes de executar o compatibilizador UPDWSRG é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador ( \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (\PROTHEUS11_DATA\SYSTEM).
  • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
  • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
  • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
  • O compatibilizador deve ser executado com a Integridade Referencial desativada*.

 

Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.

 

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

 

  1. Em TOTVS Smart Client, digite U_UPDWSRG no campo Programa Inicial.
    1. Clique em OK para continuar.
    2. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
  2. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. 
      É apresentada uma mensagem explicativa na tela.
    2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento. 

Atualizações do Compatibilizador

1.  Criação de Campos no arquivo SX3 – Campos:

  • Tabela BA0 - Operadoras de Saúde

    Campo

    BA0_CRIPRZ

    Tipo

    C

    Tamanho

    12

    Decimal

    0

    Título

    Glos Prz Rec

    Descrição

    Glosa para prazo recurso

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Val. Sistema

    ExistCpo("BTQ", "38"+M->BA0_CRIPRZ,1)

    Help

    Indica o código da glosa caso o prazo limite para recurso de glosa seja atingido.

    Campo

    BA0_TABPRZ

    Tipo

    C

    Tamanho

    2

    Decimal

    0

    Título

    Tab Glos Prz

    Descrição

    Tabela da glosa do prazo

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Help

    Indica a tabela padrão que corresponde a glosa escolhida para o prazo limite de recurso de glosa

    Campo

    BA0_DESPRZ

    Tipo

    C

    Tamanho

    100

    Decimal

    0

    Formato

    @!

    Título

    Des glos prz

    Descrição

    Descrição glosa do prazo

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Relação

    IIF(!INCLUI,ALLTRIM(POSICIONE("BTQ",1,XFILIAL("BTQ")+BA0->BA0_TABPRZ+BA0->BA0_CRIPRZ,"BTQ_DESTER")),"")

    Help

    Descrição da glosa do prazo do recurso

    Campo

    BA0_CRILIM

    Tipo

    C

    Tamanho

    12

    Decimal

    0

    Título

    Glos Lim Rec

    Descrição

    Glosa para limite recurso

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Val. Sistema

    ExistCpo("BTQ", "38"+M->BA0_CRILIM,1)

    Help

    Define qual o codigo de glosa será exibido quando o limite de recurso de glosa for atingido

    Campo

    BA0_TABLIM

    Tipo

    C

    Tamanho

    2

    Decimal

    0

    Título

    Tab Glos Lim

    Descrição

    Tabela da glosa de limite

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Help

    Tabela da glosa escolhida para quando o limite de recurso de glosa é atingido

    Campo

    BA0_DESLIM

    Tipo

    C

    Tamanho

    100

    Decimal

    0

    Formato

    @!

    Título

    Des glos lim

    Descrição

    Descrição glosa do limite

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Relação

    IIF(!INCLUI,ALLTRIM(POSICIONE("BTQ",1,XFILIAL("BTQ")+BA0->BA0_TABLIM+BA0->BA0_CRILIM,"BTQ_DESTER")),"")

    Help

    Descrição da glosa para quando o limite de recurso de glosa é atingido.

  • Tabela B4E - Itens Recurso Glosa

    Campo

    B4E_QTDIRP

    Tipo

    N

    Tamanho

    3

    Decimal

    0

    Título

    Qtd.Rec.Port

    Descrição

    Qtd.Rec.Incluidos Portal

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Help

    Quantidade de recursos de glosa efetuados para o item

  • Tabela BVO - Histórico de Recurso de Glosa

    Campo

    BVO_CODRDA

    Tipo

    C

    Tamanho

    6

    Decimal

    0

    Título

    Cod. RDA

    Descrição

    Codigo da RDA

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Help

    Código da Rede de Atendimento

    Campo

    BVO_LOTEPR

    Tipo

    C

    Tamanho

    12

    Decimal

    0

    Título

    Num Lot Pres

    Descrição

    Numero Lote Prestador

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Help

    Numero Lote gerado pelo prestador

    Campo

    BVO_ENVXML

    Tipo

    C

    Tamanho

    4

    Decimal

    0

    Título

    Prot EnvXML

    Descrição

    Protocolo Envio XML

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Help

    Protocolo gerado sempre que o prestador envia um xml com recurso de glosa

    Campo

    BVO_GUIRGP

    Tipo

    C

    Tamanho

    20

    Decimal

    0

    Título

    Gui RecGl Pr

    Descrição

    Guia Recurso Glosa Presta

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Help

    Numero da guia do recurso de glosa do prestador

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

2.  Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:

  • Pesquisa BTQBA0:

Alias

BTQBA0

Tipo

1

Sequência

01

Coluna

DB

Descrição

Terminologias Tiss

Contém

BTQ

Alias

BTQBA0

Tipo

2

Sequência

01

Coluna

01

Descrição

Cod Tabela + Cód Ter

Alias

BTQBA0

Tipo

4

Sequência

01

Coluna

01

Descrição

Cod Tabela

Contém

BTQ_CODTAB

Alias

BTQBA0

Tipo

4

Sequência

01

Coluna

02

Descrição

Cód Termo

Contém

BTQ_CDTERM

Alias

BTQBA0

Tipo

4

Sequência

01

Coluna

03

Descrição

Desc. Termo

Contém

BTQ_DESTER

Alias

BTQBA0

Tipo

4

Sequência

01

Coluna

04

Descrição

Vigencia De

Contém

BTQ_VIGDE

Alias

BTQBA0

Tipo

4

Sequência

01

Coluna

05

Descrição

Vigencia Até

Contém

BTQ_VIGATE

Alias

BTQBA0

Tipo

5

Sequência

01

Contém

BTQ->BTQ_CDTERM

Alias

BTQBA0

Tipo

6

Sequência

01

Contém

BTQ->BTQ_CODTAB == "38" .AND. (BTQ->BTQ_VIGDE <= DDATABASE .AND. (BTQ->BTQ_VIGATE >= DDATABASE .OR. EMPTY(BTQ->BTQ_VIGATE)))

 

3.  Criação de Índices no arquivo SIX – Índices:

Índice

B4E

Ordem

4

Chave

B4E_FILIAL+B4E_OPEMOV+B4E_ANOAUT+B4E_MESAUT+B4E_NUMAUT+B4E_CODPAD+B4E_CODPRO

Descrição

Operadora+Ano Auditori+Mes Autori+Nro Autori+Tp.Pad.+Cod.Proc.

Proprietário

S

Índice

BVO

Ordem

3

Chave

BVO_FILIAL+BVO_OPEMOV+BVO_CODLDP+BVO_CODPEG+BVO_NUMAUT+BVO_ORIMOV+BVO_SEQUEN+BVO_CODPAD+BVO_CODPRO+BVO_SEQREC

Descrição

Ope+LocDig.+PEG+Nro Autori+Orimov+Sequen+TbPad+CodPro+SeqRec

Proprietário

S

Índice

BVO

Ordem

4

Chave

BVO_FILIAL+BVO_CODPEG+BVO_ENVXML

Descrição

PEG+Prot EnvXML

Proprietário

S

4.  Criação de Gatilhos no arquivo SX7 – Gatilhos:

  • Tabela BA0 – Operadoras de Saúde

Campo

BA0_CRIPRZ

Sequência

001

Campo Domínio

BA0_TABPRZ

Tipo

P

Regra

BTQ->BTQ_CODTAB

Posiciona?

S

Chave

XFILIAL("BTQ")+"38"+M->BA0_CRIPRZ

Condição

BTQ->BTQ_CODTAB == "38"

Proprietário

S

Campo

BA0_CRIPRZ

Sequência

002

Campo Domínio

BA0_DESPRZ

Tipo

P

Regra

BTQ->BTQ_DESTER

Posiciona?

S

Chave

XFILIAL("BTQ")+"38"+M->BA0_CRIPRZ

Condição

BTQ->BTQ_CODTAB == "38"

Proprietário

S

Campo

BA0_CRILIM

Sequência

001

Campo Domínio

BA0_TABLIM

Tipo

P

Regra

BTQ->BTQ_CODTAB

Posiciona?

S

Chave

XFILIAL("BTQ")+"38"+M->BA0_CRILIM

Condição

BTQ->BTQ_CODTAB == "38"

Proprietário

S

Campo

BA0_CRILIM

Sequência

002

Campo Domínio

BA0_DESLIM

Tipo

P

Regra

BTQ->BTQ_DESLIM

Posiciona?

S

Chave

XFILIAL("BTQ")+"38"+M->BA0_CRILIM

Condição

BTQ->BTQ_CODTAB == "38"

Proprietário

S

Procedimento para Utilização

Para o correto funcionamento da funcionalidade, todo o ambiente da TISS já deve estar configurado, bem como a necessidade de recarregar a versão da Tiss , para que ocorra a atualização da Tabela BVR, que armazena as chamadas das funções responsáveis pelo recurso de glosa e pela solicitação do status de recurso de glosa.

Abaixo, iremos colocar os pontos de observação principais, para que haja a correta utilização da funcionalidade:

  • Configurações iniciais
    • Verificar se na pasta Schemas possui os arquivos wsdl de nomes tissRecursoGlosaV3_02_01.wsdl e tissSolicitacaoStatusRecursoGlosaV3_02_01.wsdl na versão 3.02.01. A pasta Schemas fica localizada na seguinte estrutura: protheus_data\tiss\schemas (ou seja, a pasta Schema está dentro da pasta Tiss, que fica dentro da pasta protheus_data)


      Figura 1 - Estrutura da pasta TISS e suas subpastas, demonstrando a pasta Schemas com os arquivos wsdl (ServiceWeb) da TISS 3.02.01

    • Caso não encontre este webservice ou queira atualizar a pasta apenas com a versão vigente, será necessário baixar a versão 3.02.01 no site da ANS, no endereço: http://www.ans.gov.br/images/stories/Plano_de_saude_e_Operadoras/tiss/Padrao_tiss/tiss3/padraotiss_comunicacao_030201.zip .Realize a descompactação dos arquivos na pasta Schemas (conforme item anterior) e verifique se todos os arquivos estão na pasta.
    • O arquivo de configuração do servidor deverá estar com as configurações corretas para trabalhar com a TISS online.
      • Verificar se na seção [HTTP] do arquivo de configuração do servidor está presente a configuração de UPLOADPATH (apenas para efeito de exemplo: UPLOADPATH=\tiss\online\caixaentrada)
      • Verificar na seção referente ao Portal que irá receber as solicitações (exemplo; [localhost:8021])  se está configurado o JOB de processamento para a TISS e as variáveis JEMP (código da empresa) e JFIL (filial da empresa). Veja um exemplo abaixo:

        [localhost:8021]
        ENABLE=1
        .......................
        RESPONSEJOB=JOB_TISS
        JEMP=99
        JFIL=01

      • Verificar a existência do JOB para processamento da TISS (citado no tópico acima) que deverá ser identificado pelo colchetes. Exemplo: [JOB_TISS]

      • Caso haja dúvidas, entrar em contato com o suporte.

    • Recarregar versão da tiss, para atualização da tabela BVR, que contêm a chamada para função do recurso de glosa e solicitação de status do mesmo.

Características dos arquivos - Recurso de glosa

Abaixo, listamos as características de cada tipo de Recurso de glosa (Protocolo, Guia, Item) na solicitação, ou seja, o que é necessário para que seja possível a solicitação do XML.

  1. O arquivo XML que será enviado para o servidor da Operadora que irá retornar os dados deverá estar no formato esperado pela TISS 3.02.01 de Recurso de Glosa.
  2. Recurso de glosa possui como único campo de pesquisa (conforme padrão TISS) a tag <numeroProtocolo>. Nesta caso, o prestador deverá enviar como número de Protocolo o número da PEG. Somente é válido e considerado o número da PEG para pesquisa da glosa para gravar os recursos. Caso seja inserido outra informação, os dados não serão gravados.
    1. Logo, na tag <numeroProtocolo> deverá ser inserido o número de alguma PEG, como por exemplo: <ans:numeroProtocolo>000006</ans:numeroProtocolo>
  3. A tag <objetoRecurso> identifica se o recurso de glosa é de Protocolo (valor 1) ou guia (valor 2)


    Figura 2 - Exemplo de um arquivo XML de Recurso de Glosa de Protocolo (validado pelo programa ValidadorTISS*)


    Figura 3 - Exemplo de um arquivo XML de Recurso de Glosa de guia com guia completa (validado pelo programa ValidadorTISS*)


    Figura 4 - Exemplo de um arquivo XML de Recurso de Glosa de Guia com itens(validado pelo programa ValidadorTISS*)

     

  4. Solicitação de Status de Recurso de Glosa - Para solicitar o status de um recurso de glosa o arquivo XML é simples, a principal tag que deve ser informada é a tag <numeroProtocolo> que é composta pelo número da PEG + número sequencial que é gerado no envio do recurso de glosa.

    Figura 5 - Exemplo de um arquivo XML de Solicitação de Status de Recurso de Glosa (validado pelo programa ValidadorTISS*)

Funcionamento do WebService

  1. Após as configurações (caso seja necessário), basta apenas acessar o endereço do Portal da Operadora que está configurado para a TISS com a porta de acesso, acrescido do nome do servidor de transação desejado - tissRecursoGlosa ou tissSolicitacaoStatusRecursoGlosa - mais a terminação .apw, para que o sistema identifique que se trata de um acesso para o webservice. Ficaria da seguinte maneira:

    Exemplo de chamada WebService

     

    http://enderecoOperadora:3580/tissRecursoGlosa.apw

    http://enderecoOperadora:3580/tissSolicitacaoStatusRecursoGlosa.apw

    Deve ser obrigatoriamente deste jeito a chamada, onde informamos o endereço do servidor que será usado mais o webservice que será chamado (no caso, tissRecursoGlosa ou tissSolicitacaoStatusRecursoGlosa) e a terminação .apw, para que o sistema possa processar e entender que se trata de uma solicitação via webservice

  2. O sistema irá receber a solicitação, verificar qual o tipo de recurso de glosa (protocolo, guia completa ou item), ou se é uma solicitação de status de recurso de glosa  e checar se o xml está de acordo com o schema para solicitação destes serviços. Caso o XML de solicitação esteja incorreto, os dados não serão gravados ou então o sistema não encontrará os dados do recurso de glosa caso se trate de uma solicitação de status de recurso de glosa.
  3. Caso esteja em ordem, o sistema irá realizar as verificações necessárias e no final, irá devolver um arquivo XML com os dados do recurso de glosa solicitado ou consultado.
  4. Com este XML de retorno, o prestador pode trabalhar com as informações dentro de seus sistemas, de forma independente da Operadora
  5. Para cada recurso de glosa gravado com sucesso ou solicitação de status de recurso de glosa encontrada com sucesso, o sistema grava o XML gerado numa pasta com o código da RDA, dentro da pasta caixasada, que fica em tiss\online\caixasaida (a pasta TISS é a pasta que fica dentro do protheus_data). Ou seja, se o RDA de código 000002 solicitar/consultar um recurso de glosa, o sistema irá criar uma pasta chamada "000002" dentro da pasta caixasaida. Se já existir uma pasta com o código da RDA, o XML gerado será salvo dentro da mesma

    Figura 6  - Estrutura da pasta caixasaida, onde temos uma pasta com o código da RDA que solicitou/consultou um recurso de glosa. Dentro desta pasta, temos o XML gerado.


    Figura 7 - Exemplo de XML de Recebimento de recurso de glosa de Protocolo (validado pelo programa ValidadorTISS*)


    Figura 8 - Exemplo de XML de Recebimento de recurso de glosa de guia completa (validado pelo programa ValidadorTISS*)


            Figura 9 - Exemplo de XML de Recebimento de recurso de glosa de guia com itens (validado pelo programa ValidadorTISS*)


           

            Figura 10 - Exemplo de XML de Resposta a consulta de status do recurso de glosa (validado pelo programa ValidadorTISS*)

Programas de Apoio

  • Validador TISS - Programa que visa validar os arquivos XML no padrão TISS. Realiza a validação de arquivos de Envio e Retorno. O programa pode ser baixado no endereço: http://blog.aplataforma.com.br/validador-tiss/
  • SOAPUI - Programa Open Source, que pode ser utilizado para testar se as configurações do Webservice estão corretas. para maiores informações, consulte o endereço: https://www.soapui.org/