Histórico da Página

Ao atualizar o patch do dia 21/07/2025 nas versões 12.1.2507.1, 12.1.2503.7 e 12.1.2411.12 é necessário que seja rodada SPP. O processo e detalhes estão abaixo na aba de Utilização da SPP.

Além disso, é necessário atualizar o hau.war disponibilizado através do documento: Pacote de atualização - RN 623.

VISÃO GERAL

A API Autorizações por Período tem o objetivo de buscar e acompanhar as autorizações dando uma maior visibilidade para o cliente da situação da guia. Nessa API constarão os campos com o motivo da negativa para serem disponibilizados aos beneficiários, de acordo com as regras da RN.

FORMA DE CONSUMO DA API

Para utilização da API, deve-se informar a seguinte rota: http://<servidor>:<porta>/api/hat/v1/authorizationPeriods
Método HTTP: GET

Exemplo de rota completa: http://totvs-datasul:80/api/hat/v1/authorizationPeriods?dtInicio=30/04/2025&dtFim=13/05/2025

Autenticação:

• A autenticação para o consumo da API é feita por Basic Auth informando o usuário e senha respectivos do sistema.

Image Removed

Cabeçalho:

• No cabeçalho da requisição é possível informar parâmetros que servirão como filtro no consumo da API.

Image Removed

Parâmetros para busca e consumo:

• Além dos parâmetros de filtro utilizados no cabeçalho da requisição é necessário a utilização dos parâmetros dtInicio e dtFim via path parameters.

Image Removed

REGRAS DE NEGÓCIO APLICADAS 

será salvo vinculado aos movimentos. Os dados salvos podem ser consultados através do F5 - Detalhe → F6 - Dados de Negação (Alteração disponível a partir do patch do dia 21/07/2025 nas versões 12.1.2507.1, 12.1.2503.7 e 12.1.2411.12) :

Image Added

Glosa que não libera serviço: (Alteração liberada no patch do dia 01/09/2025 nas versões 12.1.2507.3, 12.1.2503.9 e 12.1.2411.14)

Ao receber uma guia de intercâmbio. Os movimentos da guia podem ser negados caso exista uma glosa e a mensagem de automação da mesma esteja para não liberar serviço.

Image Added

Através da classe de erro parametrizada na mensagem será verificado a glosa e salvo o texto de motivo complementar parametrizado nela.

Image Added

Na manutenção de guias (at0110z) é possível através do F5 - Detalhe → F6 - Dados de Negação visualizar o motivo de negativa complementar que foi salvo no movimento:

Image Added

VISÃO GERAL

A API Autorizações por Período tem o objetivo de buscar e acompanhar as autorizações dando uma maior visibilidade para o cliente da situação da guia. Nessa API constarão os campos com o motivo da negativa para serem disponibilizados aos beneficiários, de acordo com as regras da RN.

FORMA DE CONSUMO DA API

Para utilização da API, deve-se informar a seguinte rota: http://<servidor>:<porta>/api/hat/v1/authorizationPeriods
Método HTTP: GET

Exemplo de rota completa: http://totvs-datasul:80/api/hat/v1/authorizationPeriods?dtInicio=30/04/2025&dtFim=13/05/2025

Autenticação:

• A autenticação para o consumo da API é feita por Basic Auth informando o usuário e senha respectivos do sistema.

Image Added

Cabeçalho:

• No cabeçalho da requisição é possível informar parâmetros que servirão como filtro no consumo da API.

Image Added

Parâmetros para busca e consumo:

• Além dos parâmetros de filtro utilizados no cabeçalho da requisição é necessário a utilização dos parâmetros dtInicio e dtFim via path parameters.

Image Added

REGRAS DE NEGÓCIO APLICADAS 

• 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.

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

  Campo	Descrição
  Procedimentos	Procedimentos que foram solicitados Outros campos relacionados ao campo procedimento: Campo Relacionados 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 motivoNegativa Motivo negativa complementar - Motivo de negativa referente a glosa
  Status	Status da guia atualmente
  Medico	Prestador solicitante
  Especialidade	Especialidade do prestador
  Tipo	Tipo da guia
  Histórico	Histórico de Situação da Guia Outros campos relacionados ao campo Histórico: Campo Relacionados 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
  motivoNegativa	Motivo negativa complementar - Informado ao negar a guia por completa

• 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. 

COMO VALIDAR AS INFORMAÇÕES

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 Added

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

Image Added

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

Image Added

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 Added

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 Added

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

Image Added

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 Added

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

Image Added

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 Added

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

Image Added

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

Image Added

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 Added

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

Image Added

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

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:

Image Added

Image Added

A API retornou os seguintes dados:

Image Added

Pode-se observar que o retorno contém 3 guias: 202500001977, 202500001979 e 202500001992.

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:

Image Added

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

VISÃO GERAL

A funcionalidade da API Autorizações do Beneficiário por Período foi aprimorada, passando a disponibilizar, no campo "Anexo", a carta de negativa nos casos em que esta se aplica.

FORMA DE CONSUMO DA API

Para utilização da API, deve-se informar a seguinte rota: http://<servidor>:<porta>/api/appUnimedBrasil/Beneficiario/v1/AutorizacoesPeriodo
Método HTTP: GET

Exemplo de rota completa: http://totvs-datasul:80/api/appUnimedBrasil/Beneficiario/v1/AutorizacoesPeriodo?dtInicio=30/04/2025&dtFim=13/05/2025

Autenticação:

• A autenticação para o consumo da API é feita por Basic Auth informando o usuário e senha respectivos do sistema.

Image Added

Cabeçalho:

• No cabeçalho da requisição é possível informar parâmetros que servirão como filtro no consumo da API.

Image Added

Parâmetros para busca e consumo:

• Além dos parâmetros de filtro utilizados no cabeçalho da requisição é necessário a utilização dos parâmetros dtInicio e dtFim via path parameters.

Image Added

Para informações mais detalhadas, incluindo as regras de negócio aplicadas, orientações sobre validação de dados e exemplos de uso, consulte a documentação da API Autorizações do Beneficiário por Período.

Na impressão da carta de negativa, foi utilizado o recurso do SmartView, com a disponibilização de um layout padrão que pode ser customizado conforme a necessidade do cliente. A documentação completa da integração está disponível em: Smart View linha Datasul - Relatórios e Análises Integradas.

Com o SmartView devidamente configurado, devem ser realizados os passos para a utilização da impressão:

1 - Importação de menu:

Na tela Importação Menu Datasul (MEN706AA), importar o arquivo men_hac.d.

Deverão ser criados os registros svRefusalLetter e rpRefusalLetter:

Image AddedImage Added

2 - Importação de layout:

Para esse processo é necessário estar logado com o usuário administrador do SmartView (definido nas Propriedades da integração → Usuário Administrador).

Na tela Importação Layout SmartView (html.fwk-smartview-layout) localizar o registro rpRefusalLetter e realizar a importação (o recurso hsv/hat/report/rpRefusalLetter.treports deve estar disponível no propath).

Image Added

A partir desse momento, a impressão estará disponível para utilização via sistema.

AT0110Z

Na Manutenção Autorização Guias (at0110z) foi incluída a opção "3 - Carta de negativa" no botão "Relatório":

Image Added

Ao selecioná-la, deverá ser informada a guia a ser impressa a carta de negativa. A guia informada deve estar totalmente negada ou possuir algum movimento que tenha sido negado.

Image Added

Após informar a guia, será realizada a impressão da carta e o arquivo enviado para a Central de documentos do usuário:

Image Added

Image Added

Campos disponíveis no Smarview para alteração do layout:

No patch do dia 21/07/2025 nas versões 12.1.2507.1, 12.1.2503.7 e 12.1.2411.12 foi liberado uma SPP para ajustar o banco.

Nessa SPP será feito a carga dos novos campos do código e descrição do motivo de negativa dos movimentos, pegando eles da tabela temporária utilizada e salvando na tabela do movimento.

Para realizar o ajuste, no TOTVS, acesse o programa Rodar Programa Progress - TEEXCPRO e informe o programa spp-ajuste-RN623.r

Ao clicar em Executar será apresentada uma mensagem no termino do processo:

Image Added

E pode ser gerado dois arquivos no caminho C:\temp:

• param-geral-ajutados: CSV contendo todos os dados que foram migrados da tabela temporária.
• param-geral-nao-ajutados: CSV contendo todos os dados que não foram possível de ser migrados.

Para surprir a necessidade dos beneficiários que tivem guias guias negadas o direto de solicitar uma reanálise junto a operado foi criado um novo menu.

O novo menu Reanálise de guias (hat.guideReanalysis) permite: 

• Visualizar as guias negadas ou parcialmente autorizadas que são passíveis de reanálise.

• Executar a reanálise diretamente pelo sistema.

• Consultar a listagem das guias já reanalisadas.

Para mais detalhes de implatação e utilização acessar a documentação: https://tdn.totvs.com/x/P9FqP.