Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 17

changes.mady.by.user Alessandro Fagundes

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Juliana Mareco Medeiros

Gravado em

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

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çõesAutorizaçõ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,item5,item6,item7,item8,item9
Totvs custom tabs box items
defaultyes
referenciaitem1

Para negativas a nível de guia, foi incluído o campo Motivo de negativa complementar (com capacidade de 5000 caracteres) na Manutenção Motivo de Negativa - hcg.refusalReason:

Image Modified


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

Image Modified


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 negar totalmente realizar a negativa total de uma guia pelo por meio da Auditoria Médica, será carregado automaticamente o campo referente ao Motivo de negativa complementar do cadastro do motivo informado:

Image Removed

, conforme o motivo selecionado no cadastro.

Image Added

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

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 na guia será considerado na consulta da 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 negar totalmente realizar a negativa total de uma guia pelo por meio do AT0110Z, será carregado automaticamente o campo referente ao Motivo de negativa complementar do cadastro do motivo informado:

Image Removed

, conforme o motivo selecionado no cadastro.

Image Added

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

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

Image 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 Added

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

Image AddedImage Removed

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.

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 Added

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

Image AddedImage Removed

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 Removed

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

Image Removed

Image Added

O motivo de negativa complementar 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
API Autorizações por Período01. 

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.

02.

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  URL totvsrota: 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


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

03.


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


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 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 Modified


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 Modified


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

05.

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


Image RemovedImage Added


A API retornou os seguintes dados:

Image Modified


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 Modified

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