CONTEÚDO

1. Visão Geral
2. Regras de Negócio Aplicadas
3. Como Validar as Informações
   1. Central de Movimentação de Guia Tiss
      1. Enviar documento para Auditoria
      2. Liberação de documentos
   2. Consulta Movimentos por Prestadores
      1. Enviar documentos para Auditoria
      2. Liberação de documentos 
4. Exemplo de Como Validar as Informações

01. VISÃO GERAL

O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração.

A API Status do Documento/Movimentos tem o objetivo de buscar e enviar documentos para auditoria, e liberar documentos do Revisão de Contas.

As APIs foram desenvolvidas seguindo as definições disponibilizadas no Swagger da Unimed Brasil. 

02. REGRAS DE NEGÓCIO APLICADAS 

• Para Enviar o documento para Auditoria a API realiza a busca do documento pela chave do documento, através da unidade, unidade prestadora, transação, serie do documento, documento e documento no sistema.
  • A partir do documento encontrado será retornada a chave  do documento Enviado para Auditoria .
• Para Liberar o documento do Revisão de Contas a API realiza a busca de duas formas, sendo a primeira Por Documento pela chave do documento, através da unidade, unidade prestadora, transação, serie do documento, documento e documento no sistema. Segunda forma Por Fatura, através do ano da fatura, serie da fatura, numero da fatura,código do prestador, unidade prestadora e unidade, liberando todos os documentos de uma mesma fatura.
  • Parâmetros  utilizados para fazer a liberação em ambos os métodos, através do; tipo de liberação, consiste diária, valida documentos pendentes, consistir diferença de valores, percentual diferencial de valor.   
  • Caso seja feita liberação por Fatura, o retorno irá informar a chave de todos os documentos liberados.
    
    

• Os Campos apresentados estão detalhados na tabela abaixo:

  Campo	Descrição
  Documento	Campos chave do Documento. Chave do Documento Descrição unidade Código da unidade. unidadePrestadora Código da unidade prestadora. transacao Código da transação. serieDocumento Nome da serie do documento. documento Código do documento. documentoSistema Sequencia do documento no sistema.
  Fatura	Campos chave da Fatura. Chave da Fatura Descrição unidade Código da unidade. unidadePrestadora Código da unidade prestadora. prestador Código do prestador. serieFatura Nome da serie da fatura. ano Ano da fatura. fatura Código da fatura.
  Parâmetros	Parâmetros para liberar documentos do Revisão de Contas. Campos Descrição tipo Tipo da busca "DOC" ou "FAT". consisteDiaria Consiste se documentos de internação possuem diária.  validarDocumentosPendentes Valida se possuem documentos pendentes de vinculação. consistirDiferencaValores Consiste a diferença de valores cobrados. percentualDiferencaValores Margem de valor, para consistir.

03. COMO VALIDAR AS INFORMAÇÕES

Os resultados apresentados pela API podem ser validados e visualizados nos seguintes programas/relatórios:

Central de Movimentação Guia Tiss (hrc.document)

Localize o documento que deseja consultar. 

Ao acessar o programa na tela inicial está disponível a opção de Busca Avançada:

Através da Busca Avançada é possível pesquisar o documento:

Ao informar alguns campos e clicar em buscar será retornado o documento encontrado: 

• Enviar documento para Auditoria
  
  
• Liberação de Documentos
• Verificamos o status do documento . ( 2- Pendente de Liberação)

• Caso o documento esteja liberado. (3- Liberado)
       

Mais detalhes sobre o programa Central Tiss podem ser visto através da documentação: Central de Movimentação Guia TISS HRC.document.

Consulta Movimentos por Prestadores (RC0210B)

Informações do documento. 

Ao localizar os movimentos a serem consultados, as informações estarão disponível na opção F3 - Inf. Movimentos:

• Enviar documento para Auditoria
         
       Consultamos o Status do documento, ao apertar F3 selecione a opção Dados Adic. 
       
  
       Ao clicar nessa opção serão exibidos informações de Liberação do Movimento e Histórico de Auditoria.
     
  
      Ao clicar em Histórico de Auditoria.
      
  
  
• Liberação de Documentos

Ao apertar F3 selecione a opção Datas:

Ao clicar nessa opção será exibida informações sobre a liberação do documento. 

Mais detalhes sobre o programa Manutenção Autorização Guias pode ser visto através da documentação:  Consultas Movimentos por Prestador - rc0210b  .

04. EXEMPLO DE COMO VALIDAR AS INFORMAÇÕES

Exemplo de como pode ser realizada a validação da Listagem e Busca de Guias, explicada na sessão 3. Como Validar as Informações, que utiliza o programa Consulta Unificada de Pessoas (hvp.personInformation).

Para isso, foi realizada uma requisição na API utilizando a carteira do beneficiário, a data inicial e final do período desejado. Para uma melhor visualização foi utilizada a mesma data inicial e final para retornar apenas as guias de um dia, neste caso do dia 01/07/2020. Os parâmetros utilizados podem ser visualizados abaixo:

A API retornou os seguintes dados:

Pode-se observar que o retorno contém 3 guias: 202000001997, 202000001994 e 202000001993.

No programa Consulta Unificada de Pessoas foram utilizados os mesmos parâmetros da requisição da API, ou seja, a carteira do beneficiário, data inicial e final. O resultado pode ser visto abaixo:

Observando o retorno da API e da Central Tiss  vemos que as chaves retornadas e seus dados são os mesmos.