Histórico da Página

...

1. Visão Geral
2. Regras de Negócio Aplicadas
3. Como Validar as Informações
   1. Consulta Unificada de Pessoas
      1. Pesquisa e Listagem das Guias
      2. Situação das Guias
   2. Manutenção Autorização Guias
      1. Situação das Guias
      2. Histórico da Guia
4. Exemplo de Como Validar as Informações

01. VISÃO GERAL

Âncora
visao_geral visao_geral

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

...

• A API realiza as buscas através da carteira ou CPF do beneficiário e um intervalo inicial e final de datas.
  • A partir das guias encontradas será retornado o histórico da situação de cada guia.
• É considerado todos os contratos da pessoa informada na requisição, seja um contrato ativo ou inativo.
• Devido ao Swagger da Unimed do Brasil não conter a estrutura para o retorno dos insumos das autorizações, estes não são exibidos na resposta. Como consequência desse comportamento, as guias que contiverem apenas insumos não são retornadas na resposta da API.

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

  Campo	Descrição
  Procedimentos	Procedimentos que foram solicitados Outros campos relacionados ao campo procedimento: Campo VinculadoRelacionados Descrição QtSolicitada Quantidade do procedimento que foi solicitada Codigo Código do procedimento QtAutorizada Quantidade do procedimento que foi autorizada Status Status do Procedimento Nome Nome do Procedimento
  Status	Status da guia atualmente
  Medico	Prestador Solicitantesolicitante
  Especialidade	Especialidade do Prestadorprestador
  Tipo	Tipo da Guiaguia
  Histórico	Histórico de Situação da Guia Outros campos relacionados ao campo Histórico: Campo VinculadoRelacionados Descrição DtEvento Data do Evento  Status Status do Evento
  Senha	Este campo não é utilizado
  DtSolicitacao	Data de solicitação da guia
  DtValidadeSenha	Data de validade da guia
  Guia	Número da guia

• A conversão da situação da guia é realizada conforme a tabela abaixo:

• Além da situação da guia, a API retorna a situação individual dos movimentos. 

03. COMO VALIDAR AS INFORMAÇÕES

Âncora
valida_inf valida_inf

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

Consulta Unificada de Pessoas (hvp.personInformation)

Pesquisa e Listagem das Guias

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

Image Modified

Através da Busca Avançada é possível pesquisar o beneficiário pelo CPF ou pela Carteira do Beneficiário

...

:

Image Modified

Ao informar um dos campos e clicar em buscar será retornado os dados do beneficiário e habilitado a opção Autorização:

Image Modified

Ao clicar em Autorização abrirá uma tela onde é possível selecionar o intervalo inicial e final. Ao

...

clicar em pesquisar será retornado uma lista com todas as guias do beneficiário no período determinado:

Image Modified

Situação das Guias

Ao realizar a pesquisa através do programa Consulta Unificada de Pessoas ficará disponibilizado a opção Autorizações no menu. Ao clicar nesta opção o programa permitirá visualizar as guias de atendimento que estão associados ao beneficiário. Nesta tela estará presente o status da guia através da coluna Situação.

...

Image Added

Ao clicar no número da guia será aberta o programa Manutenção Autorização Guias

...

AT0110Z

...

onde é possível verificar os dados da guia e seu status.

...

Esta tela é apenas para consulta.

...

Image Added

Mais detalhes sobre o programa Consulta Unificada de Pessoas pode ser visto através da documentação: https://tdn.totvs.com/x/oHQxHQ.

Manutenção Autorização Guias (AT0110Z)

Situação das Guias

Ao clicar em Autorização e pesquisar uma guia será exibido os detalhes e disponibilizado a opção F8 - Infor. Adic:

Image Modified

Ao apertar F8 aparecerá a opção Mov AT:

Image Modified

Ao clicar nessa opção será exibida um filtro para selecionar as situações das guias. No caso deste exemplo

...

serão retornadas as guias com as situações de 1- Digitada até 23 - Em Pericia: 

Image Modified

Após a escolha serão exibidas todas as guias do beneficiário com sua situação:

Image Modified

Histórico das Guias

Ao clicar em Autorização e pesquisar uma guia será exibido os detalhes e disponibilizado a opção F3 - Inf. Guia:

Image Modified

Ao apertar F3 irá aparecer a opção Guia:

Image Modified

Ao apertar na opção Guia irá aparecer uma dela com as informações sobre a guia e a opção Histórico:

Image Modified

Ao selecionar a opção será exibido uma tela com o histórico da situação da guia contendo todos os status e descrições que a guia teve:

Image Modified

Será exibido também a data de atualização de cada status:

Image Modified

Mais detalhes sobre o programa Manutenção Autorização Guias pode ser visto através da documentação: https://tdn.totvs.com/x/CfhYDQ

04. EXEMPLO DE COMO VALIDAR AS INFORMAÇÕES

Âncora
ex_valid ex_valid

Neste exemplo foi 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 foram utilizados 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:

Image Added

Image Added

A API retornou os seguintes dados que podem ser comparados:

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

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

Image Modified

Observando o retorno da API e da Consulta Unificada de Pessoas vemos que as guias retornadas e seus dados são os mesmos.