Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

02. SITUAÇÃO/REQUISITO

Este documento detalha as implementações realizadas no TOTVS Saúde Planos - Linha Datasul para conformidade com a Resolução Normativa ANS Nº 623.

03. SOLUÇÃO

item1,item2,item3,item4,item5,item6
Aviso

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.

Totvs custom tabs box
tabsMotivo de negativa complementar,Auditoria Médica,AT0110Z,Negativa automática,API de Autorizações,Impressão da carta de negativa
ids

-itemsPara negativas a nível de guia, foi incluído o campo na Manutenção Motivo de Negativa - hcg.refusalReason:

Image Removed

Para negativas a nível de movimento, foi incluído o campo Motivo de negativa complementar na Manutenção Glosa - hrc.restrictionCode:

Image Removed

Não há carga automática de informações nesses campos, sendo necessária manutenção por parte da operadora.
  • 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 Removed

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

Image Removed

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

Image Removed

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 Removed

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 Removed

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 Removed

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 Removed

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

Image Removed

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 Removed

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

Image Removed

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 Removed

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

Image Removed

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

Image Removed

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 Removed

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

Image Removed

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 Removed

Image Removed

A API retornou os seguintes dados:
Image Removed

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 Removed

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

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: Integração Datasul x Smart View.

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 RemovedImage Removed

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 Removed

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 Removed
Totvs custom tabs box
defaultyes
referenciaitem1
tabs
Motivo de negativa complementar
Informações
titleImportante
,Auditoria Médica,AT0110Z,Negativa automática,API Autorizações do Beneficiário por Período,Impressão da carta de negativa, Utilização da SPP, Reanálise de Guias
idsitem1,item2,item3,item4,item6,item7,item8,item9
Totvs custom tabs box items
defaultnoyes
referenciaitem2item1

Ao realizar a negativa total de uma guia por meio da Auditoria Médica, será carregado automaticamente Para negativas a nível de guia, foi incluído o campo Motivo de negativa complementar, conforme o motivo selecionado no cadastro. (com capacidade de 5000 caracteres) na Manutenção Motivo de Negativa - hcg.refusalReason:

Image Added


Para negativas automáticas, foi incluído o campo Motivo de negativa complementar (com capacidade de 5000 caracteres) na Manutenção Glosa - hrc.restrictionCode:

Image Added


Informações
titleImportante

Não há carga automática de informações nesses campos, sendo necessária manutenção por parte da operadora.

Totvs custom tabs box items
defaultno
referenciaitem2

Ao realizar a negativa total de uma guia por meio da Auditoria Médica, será carregado automaticamente o campo Motivo de negativa complementar, conforme o motivo selecionado no cadastro.

Image Added

Esse texto pode ser alterado manualmente na tela e, ao efetivar a negativa, o conteúdo informado será salvo na guia.

Da mesma forma, ao editar a quantidade autorizada de um movimento para um valor menor do que o solicitado, também será necessário informar um motivo de negativa. O texto correspondente poderá ser ajustado e, uma vez confirmado, será registrado na guia.

Image Added

O motivo de negativa complementar salvo será

Image Removed

Esse texto pode ser alterado manualmente na tela e, ao efetivar a negativa, o conteúdo informado será salvo na guia.

Da mesma forma, ao editar a quantidade autorizada de um movimento para um valor menor do que o solicitado, também será necessário informar um motivo de negativa. O texto correspondente poderá ser ajustado e, uma vez confirmado, será registrado na guia.

Image Removed

O motivo de negativa complementar salvo será considerado nas consultas realizadas pela API de autorizações.


Informações
titleImportante

Para que esses campos sejam apresentados, é necessário que o parâmetro Motivo da negação da Manutenção Tipos de Guias - hat.guideType esteja como 1 - Pede ou 2 - Obriga.

Totvs custom tabs box items
defaultno
referenciaitem3

Ao realizar a negativa total de uma guia por meio do AT0110Z, será carregado automaticamente o campo Motivo de negativa complementar, conforme o motivo selecionado no cadastro.

Image RemovedImage Added

Esse texto pode ser alterado manualmente na tela e, ao efetivar a negativa, o conteúdo informado será salvo na guia.

Os dados salvos na guia podem ser consultados através do F3 → Guia → Mot.Neg.:

Image RemovedImage Added

Da mesma forma, ao editar a quantidade autorizada de um movimento para um valor menor do que o solicitado, também será necessário informar um motivo de negativa. O texto correspondente poderá ser ajustado e, uma vez confirmado, será registrado na guia.

Image RemovedImage Added

Os dados salvos na guia podem ser consultados através do F5 - Detalhe → F6 - Dados de Negação:

Image RemovedImage Added

O motivo de negativa complementar salvo na guia será considerado na consulta da API de autorizações.


Informações
titleImportante

Para que esses campos sejam apresentados, é necessário que o parâmetro Motivo da negação da Manutenção Tipos de Guias - hat.guideType esteja como 1 - Pede ou 2 - Obriga.

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.
Totvs custom tabs box items
defaultno
referenciaitem4

Ao negar uma guia automaticamente, sem passar por auditoria, será considerada a glosa do movimento.

Exemplo com regra Regra de auditoria para negar automaticamente:

Image Removed

Image Added

Para esse caso será considerado o motivo complementar cadastrado na Manutenção de Glosa (hrc.restrictionCode):

Image Added

Ao receber uma solicitação Ao receber uma solicitação de autorização, a guia será negada imediatamente e o(s) movimento(s) glosado(s) com a glosa da regra:

Image RemovedImage Added

Image RemovedImage Added

O motivo de negativa complementar informado no cadastro dessa glosa será considerado na consulta da API de autorizações:

Image Removed

Totvs custom tabs box items
defaultno
referenciaitem5
ParâmetrosDescrição
x-carteiraCarteira do beneficiário
x-cpfCPF do beneficiário

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.
ParâmetrosDescrição
dtInicioData de inicial das solicitações de guias
dtFimData final da solicitações de guias

Image Removed

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:
    CampoDescrição
    Procedimentos

    Procedimentos que foram solicitados

    • Outros campos relacionados ao campo procedimento:
    Campo RelacionadosDescrição
    QtSolicitadaQuantidade do procedimento que foi solicitada
    CodigoCódigo do procedimento
    QtAutorizadaQuantidade do procedimento que foi autorizada
    StatusStatus do Procedimento
    NomeNome do Procedimento
    motivoNegativaMotivo negativa complementar - Motivo de negativa referente a glosa

    Status

    Status da guia atualmente
    MedicoPrestador solicitante
    EspecialidadeEspecialidade do prestador
    TipoTipo da guia
    Histórico

    Histórico de Situação da Guia

    • Outros campos relacionados ao campo Histórico:
    Campo RelacionadosDescrição
    DtEventoData do Evento 
    StatusStatus do Evento
    SenhaEste campo não é utilizado
    DtSolicitacaoData de solicitação da guia
    DtValidadeSenhaData de validade da guia
    GuiaNúmero da guia
    motivoNegativaMotivo negativa complementar - Informado ao negar a guia por completa

    Status da Guia

    Descrição no TOTVS

    Descrição no APP

    1

    DIGITADA

    DIGITADA

    2

    AUTORIZADA

    AUTORIZADA

    3

    CANCELADA

    CANCELADA

    4

    PROCESSADO PELO CONTAS

    EM EXECUÇÃO

    5

    FECHADO

    FECHADA

    6

    ORÇAMENTO

    ORÇAMENTO

    7

    FATURADA

    FATURADA

    8

    NEGADA

    NEGADA

    9

    PENDENTE AUDITORIA

    EM ANÁLISE

    10

    PENDENTE LIBERAÇÃO

    EM ANÁLISE

    11

    PENDENTE LAUDO MÉDICO

    EM ANÁLISE

    12

    PENDENTE JUSTIFICATIVA

    EM ANÁLISE

    13

    PENDENTE PERICIA

    EM ANÁLISE

    14

    AUTORIZADA PARCIAL

    AUTORIZADA PARCIAL

    19

    EM AUDITORIA

    EM ANÁLISE

    20

    GUIA EM ATENDIMENTO

    EM ANÁLISE

    23

    EM PERICIA MÉDICA

    EM ANÁLISE

    Situação GuiaDescrição SituaçãoSituação Movimento
    1DIGITADADIGITADO
    2AUTORIZADA

    AUTORIZADO

    Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO.

    3CANCELADACANCELADO
    4PROCESSADO PELO CONTAS

    Se todas as quantidades do movimento já estiverem executadas pelo Contas, será considerado o status EXECUTADO.
    Se nenhuma quantidade do movimento estiver executada, será considerado o status AUTORIZADO.
    Se, pelo menos, uma quantidade do movimento tenha sido executada, porém ainda existe quantidade de procedimento para ser executada será considerado o status EM EXECUÇÃO.

    Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO.

    8NEGADA

    NEGADO

    14AUTORIZADA PARCIAL

    AUTORIZADA PARCIAL

    Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO.

    Quando o procedimento não se enquadrar nas situação acima, será considerado o status EM ANALISE.
    Totvs custom tabs box items
    defaultno
    referenciaitem6

    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) :

    Informações

    Como o motivo complementar está vinculado a glosa, não existe um código de motivo, dessa forma é exibido apenas o texto.

    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:

    Informações
    • Como o motivo complementar está vinculado a glosa, não existe um código de motivo, dessa forma é exibido apenas o texto.
    • Quando houver mais de uma glosa, será salvo a primeira que tiver o motivo de negativa complementar.

    Image Added


    Informações
    titleImportante

    Para que seja salvo o motivo de negativa da glosa manual, é necessário que o parâmetro Motivo da negação da Manutenção Tipos de Guias - hat.guideType esteja como 1 - Pede ou 2 - Obriga.

    Totvs custom tabs box items
    defaultno
    referenciaitem5

    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.
    ParâmetrosDescrição
    x-carteiraCarteira do beneficiário
    x-cpfCPF do beneficiário

    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.
    ParâmetrosDescrição
    dtInicioData de inicial das solicitações de guias
    dtFimData final da solicitações de guias

    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:

      CampoDescrição
      Procedimentos

      Procedimentos que foram solicitados

      • Outros campos relacionados ao campo procedimento:
      Campo RelacionadosDescrição
      QtSolicitadaQuantidade do procedimento que foi solicitada
      CodigoCódigo do procedimento
      QtAutorizadaQuantidade do procedimento que foi autorizada
      StatusStatus do Procedimento
      NomeNome do Procedimento
      motivoNegativaMotivo negativa complementar - Motivo de negativa referente a glosa

      Status

      Status da guia atualmente
      MedicoPrestador solicitante
      EspecialidadeEspecialidade do prestador
      TipoTipo da guia
      Histórico

      Histórico de Situação da Guia

      • Outros campos relacionados ao campo Histórico:
      Campo RelacionadosDescrição
      DtEventoData do Evento 
      StatusStatus do Evento
      SenhaEste campo não é utilizado
      DtSolicitacaoData de solicitação da guia
      DtValidadeSenhaData de validade da guia
      GuiaNúmero da guia
      motivoNegativaMotivo negativa complementar - Informado ao negar a guia por completa


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

    Status da Guia

    Descrição no TOTVS

    Descrição no APP

    1

    DIGITADA

    DIGITADA

    2

    AUTORIZADA

    AUTORIZADA

    3

    CANCELADA

    CANCELADA

    4

    PROCESSADO PELO CONTAS

    EM EXECUÇÃO

    5

    FECHADO

    FECHADA

    6

    ORÇAMENTO

    ORÇAMENTO

    7

    FATURADA

    FATURADA

    8

    NEGADA

    NEGADA

    9

    PENDENTE AUDITORIA

    EM ANÁLISE

    10

    PENDENTE LIBERAÇÃO

    EM ANÁLISE

    11

    PENDENTE LAUDO MÉDICO

    EM ANÁLISE

    12

    PENDENTE JUSTIFICATIVA

    EM ANÁLISE

    13

    PENDENTE PERICIA

    EM ANÁLISE

    14

    AUTORIZADA PARCIAL

    AUTORIZADA PARCIAL

    19

    EM AUDITORIA

    EM ANÁLISE

    20

    GUIA EM ATENDIMENTO

    EM ANÁLISE

    23

    EM PERICIA MÉDICA

    EM ANÁLISE



    • Além da situação da guia, a API retorna a situação individual dos movimentos. 
    Situação GuiaDescrição SituaçãoSituação Movimento
    1DIGITADADIGITADO
    2AUTORIZADA

    AUTORIZADO

    Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO.

    3CANCELADACANCELADO
    4PROCESSADO PELO CONTAS

    Se todas as quantidades do movimento já estiverem executadas pelo Contas, será considerado o status EXECUTADO.
    Se nenhuma quantidade do movimento estiver executada, será considerado o status AUTORIZADO.
    Se, pelo menos, uma quantidade do movimento tenha sido executada, porém ainda existe quantidade de procedimento para ser executada será considerado o status EM EXECUÇÃO.

    Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO.

    8NEGADA

    NEGADO

    14AUTORIZADO PARCIAL

    AUTORIZADA PARCIAL

    Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO.

    Quando o procedimento não se enquadrar nas situação acima, será considerado o status EM ANALISE.


    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.

    Totvs custom tabs box items
    defaultno
    referenciaitem6

    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.
    ParâmetrosDescrição
    x-carteiraCarteira do beneficiário
    x-cpfCPF do beneficiário

    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.
    ParâmetrosDescrição
    dtInicioData de inicial das solicitações de guias
    dtFimData final da solicitações de guias

    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.

    Totvs custom tabs box items
    defaultno
    referenciaitem7

    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.

    Aviso

    Em caso de customização do layout deve ser realizada a exportação (Exportação/Importação de Relatórios) e substituir a exportação no recurso hsv/hat/report/rpRefusalLetter.treports do propath pelo novo layout.

    Após isso é necessário ir à tela de Importação Layout SmartView e realizar a atualização:

    Image Added



    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:

    CampoDescriçãoData de Liberação
    dt-geracaoData da gerção da carta de negativaLiberado no patch do dia 30/06/2025 nas versões 12.1.2503.6, 12.1.2411.11 e 12.1.2407.17 (antecipação via TDN)
    nm-beneficiarioNome do beneficiário
    nr-carteiraCarteira do beneficiário
    ds-assuntoAssunto da carta
    nr-protocoloNúmero do protocolo
    nr-guia-atendNúmero da guia de atendimento
    ds-motivo-negaMotivo complementar da negativa da guia
    cd-motivo-negaCódigo do motivo complementar da negativaLiberado no patch do dia 11/08/2025 nas versões 12.1.2507.2, 12.1.2503.8 e 12.1.2411.13
    cd-plano-ansCódigo do plano ANS do beneficiário
    ds-plano-ansDescrição do plano ANS do beneficiário
    in-tipo-regulamentacaoTipo de regulamentação do contrato
    nm-contratanteNome do contratante do plano
    dt-inicio-termoData de início do termo
    cd-ibgeCódigo IBGE
    nm-cidade-ibgeNome da cidade do IBGE
    cd-uf-ibgeUF do IBGE
    dt-negativaData da negativa da guia
    nm-solicitanteNome do pretador solicitante
    ds-sigla-conselhoSigla do conselho do prestador solicitante
    nr-conselhoNúmero do conselho do prestador solicitante
    uf-solicitanteUF do prestador solicitante
    dt-emissao-guiaData da emissão da guia
    nm-social-benefNome social do beneficiário
    cr-solicitacaoCaráter do atendimento
    ds-status-guiaStatus da guia
    Procedimento
    cd-procedimentoCódigo do procedimentoLiberado no patch do dia 30/06/2025 nas versões 12.1.2503.6, 12.1.2411.11 e 12.1.2407.17 (antecipação via TDN)
    ds-procedimentoDescrição do procedimento
    ds-motivo-negaMotivo complementar da negativa do procedimento
    cd-motivo-negaCódigo do motivo de negativaLiberado no patch do dia 11/08/2025 nas versões 12.1.2507.2, 12.1.2503.8 e 12.1.2411.13
    qt-solicitadaQuantidade solicitade
    qt-autorizadaQuantidade autorizada
    cd-glosa-negaCódigo da glosa da negativa
    Insumo
    cd-insumoCódigo do insumoLiberado no patch do dia 30/06/2025 nas versões 12.1.2503.6, 12.1.2411.11 e 12.1.2407.17 (antecipação via TDN)
    ds-insumoDescrição do insumo
    ds-motivo-negaDescrição do motivo de negativa
    cd-motivo-negaCódigo do motivo de negativaLiberado no patch do dia 11/08/2025 nas versões 12.1.2507.2, 12.1.2503.8 e 12.1.2411.13
    qt-solicitadaQuantidade solicitada
    cd-glosa-negaCódigo da glosa da negativa
    Aviso

    Quando o serviço for negado por glosa é populado o campo cd-glosa-nega, quando for negado manualmente por motivo de negativa é populado o cd-motivo-nega.

    Totvs custom tabs box items
    defaultno
    referenciaitem8

    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.

    Aviso

    A SPP só deve ser rodada depois de atualizar o patch do dia 21/04/2025, onde existe a alteração de delta e criação dos campos em banco. Após atualizado e rodar uma vez, não é necessário mais realizar esse processo.

    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.


    Aviso

    Esses arquivos só serão criados caso haja dados para serem migrados.

    Totvs custom tabs box items
    defaultno
    referenciaitem9

    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.


    Informações

    A liberação oficial da correção ocorrerá no patch do dia 17/11/2024 nas versões 12.1.2511.1, 12.1.2507.7 e 12.1.2503.13 



    04. INFORMAÇÕES ADICIONAIS

    Pacote de atualização - RN 623

    API Autorizações do Beneficiário por Período