Histórico da Página
...
- Visão Geral
- Regras de Negócio Aplicadas
- Como Validar as Informações
- Central de Movimentação de Guias Tiss
- Enviar documento para Auditoria
- Liberar documento do Revisão de Contas
- Consulta Movimentos por Prestadores
- Enviar documento para Auditoria
- Liberar documento do Revisão de Contas
- Consulta Unificada de Pessoas
- Pesquisa e Listagem das Guias
- Situação das Guias
- Manutenção Autorização Guias
- Situação das Guias
- Histórico da Guia
- Central de Movimentação de Guias Tiss
- Exemplo de Como Validar as Informações
01. VISÃO GERAL Âncoravisao_geral visao_geral
visao_geral | |
visao_geral |
...
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 Âncoraregras_neg regras_neg
regras_neg | |
regras_neg |
- Para Enviar o documento para Auditoria a API realiza a busca do documento:
- Por Documento pela chave do documento
- : código da unidade, código da unidade prestadora, código da transação, serie do documento, número do documento e número do documento no sistema.
- Por Fatura enviando todos os documentos de uma mesma fatura para auditoria, utilizando a chave da fatura: ano da fatura, serie da fatura, número da fatura, código do prestador, código da unidade prestadora e código da unidade.
- A partir do documento encontrado será retornada a chave do documento Enviado para Auditoria .
- Para Liberar o documento do Revisão de Contas a o mesmo deve estar em Auditoria, não é permitida a liberação de documentos com outro status.
A API realiza a busca de duas formas, sendo a primeira .- Por Documento "DOC" pela chave do documento
- : código da unidade, código da unidade prestadora, código da transação, serie do documento, número do documento e número do documento no sistema.
- Por Fatura "FAT", liberando todos os documentos de uma mesma fatura, chave da fatura: ano da fatura, serie da fatura,
- número da fatura, código do prestador, código da unidade prestadora e código da unidade
- .
- 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.
Nota | ||
---|---|---|
| ||
Os documentos incluídos com fatura somente podem ser encaminhados para a auditoria e/ou liberados utilizando as requisições por fatura |
Os Campos apresentados estão detalhados na tabela abaixo:
Campo Descrição Documento Campos chave do documentoDocumento.
Chave do documentoDocumento Tipo Descrição cdUnidade
unidadeNumber Código da unidade. cdUnidadePrestadora NumberunidadePrestadora Código da unidade prestadora. cdTransacao Numbertransacao Código da transação. nrSerieDocOriginal serieDocumentoString Nome da serie do documento.documento nrDocOriginal Number Código do documento. nrDocSistema documentoSistemaNumber Sequencia do documento no sistema. Fatura
Campos chave da Fatura
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
- A conversão da situação da guia é realizada conforme a tabela abaixo:
...
Status da Guia
...
Descrição no APP
...
1
...
DIGITADA
...
2
...
AUTORIZADA
...
3
...
CANCELADA
...
4
...
EM EXECUÇÃO
...
5
...
FECHADA
...
6
...
ORÇAMENTO
...
7
...
FATURADA
...
8
...
NEGADA
...
9
...
EM ANÁLISE
...
10
...
EM ANÁLISE
...
11
...
EM ANÁLISE
...
12
...
EM ANÁLISE
...
13
...
EM ANÁLISE
...
14
...
AUTORIZADA PARCIAL
...
19
...
EM ANÁLISE
...
20
...
EM ANÁLISE
...
23
...
EM ANÁLISE
- Além da situação da guia, a API retorna a situação individual dos movimentos.
...
AUTORIZADO
Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO.
...
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.
...
NEGADO
...
.
Chave da Fatura Tipo Descrição cdUnidade
Number Código da unidade. cdUnidadePrestadora
Number Código da unidade prestadora. cdPrestadorPrincipal
Number Código do prestador. cdSerieNf
String Nome da serie da fatura. aaFatura
Number Ano da fatura. nrFatura
String Código da fatura. Parâmetros Parâmetros para liberar documentos do Revisão de Contas.
Campos Tipo Descrição Obrigatório tipo String Tipo da busca "DOC" ou "FAT". Sim consisteDiaria Boolean Consiste se documentos de internação possuem diária. Não validarDocumentosPendentes Boolean Valida se possuem documentos pendentes de vinculação. Não consistirDiferencaValores Boolean Consiste a diferença de valores cobrados. Não percentualDiferencaValores Decimal Margem de valor, para consistir. Não nomeUsuario caracter Nome do usuário que está efetivando a requisição. Sim Expandir title Exemplos JSON Requisição... Encaminhar para auditoria:
+ Por documento: http:/local-host:8080/api/hrc/v1/documentsExternal/auditory/doc/
{
"documentos": [
{
"cdUnidade": 1,
"cdUnidadePrestadora": 2,
"cdTransacao": 4,
"nrSerieDocOriginal": "DOC",
"nrDocOriginal": 12345678,
"nrDocSistema": 0
}
],
"parametros": [
{"nomeUsuario": "super"}
]
}+ Por fatura: http:/local-host:8080/api/hrc/v1/documentsExternal/auditory/fat/
{
"documentos": [
{
"cdUnidade": 1,
"cdUnidadePrestadora": 2,
"cdPrestadorPrincipal": 2,
"cdSerieNF": "FAT",
"aaFatura": 2023,
"nrFatura": "012345678907"
}
],
"parametros": [
{"nomeUsuario": "super"}
]
}Liberação da auditoria: http://local-host:8080/api/hrc/v1/documentsExternal/release/
+ Por documento:
{
"documentos": [
{
"cdUnidade": 1,
"cdUnidadePrestadora": 1,
"cdTransacao": 2,
"nrSerieDocOriginal": "SER",
"nrDocOriginal": 20230001,
"nrDocSistema": 0
}
],
"parametros": [
{
"tipo": "DOC",
"consisteDiaria": false,
"validarDocumentosPendentes": false,
"consistirDiferancaValores": false,
"percentualDiferencaValores": 0,
"nomeUsuario": "super"
}
]
}+ Por fatura:
{
"documentos": [
{
"cdUnidade": 1,
"cdUnidadePrestadora": 2,
"cdPrestadorPrincipal": 2,
"aaFatura": 2023,
"cdSerieNF": "FAT",
"nrFatura": "0123456789"
}
],
"parametros": [
{
"tipo": "FAT",
"consisteDiaria": false,
"validarDocumentosPendentes": false,
"consistirDiferancaValores": false,
"percentualDiferencaValores": 0,
"nomeUsuario": "super"
}
]
}
03. COMO VALIDAR AS INFORMAÇÕES Âncoravalida_inf valida_inf
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)
Central de Movimentação Guias 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 beneficiário pelo CPF ou pela Carteira do Beneficiáriodocumento:
Ao informar um dos alguns campos e clicar em buscar será retornado os dados do beneficiário e habilitado a opção Autorização:
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:
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.
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.
o documento encontrado:
- Enviar documento para Auditoria
Localizando o documento, ao clicar no botão Editar e em seguida Salvar a mensagem de erro é exibida, caso o documento possua movimentos em Auditoria.
- Liberar 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 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:
Ao apertar F8 aparecerá a opção Mov AT:
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:
Após a escolha serão exibidas todas as guias do beneficiário com sua situação:
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:
Ao apertar F3 irá aparecer a opção Guia:
Ao apertar na opção Guia irá aparecer uma dela com as informações sobre a guia e a opção Histórico:
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:
Será exibido também a data de atualização de cada status:
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.
- Liberar 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: https://tdn.totvs.com/x/CfhYDQ Consultas Movimentos por Prestador - rc0210b .
04. EXEMPLO DE COMO VALIDAR AS INFORMAÇÕES
...
...
Exemplo de como pode ser realizada a validação
...
do documento em Auditoria ou Liberação, explicada na sessão 3. Como Validar as Informações,
...
que utiliza o programa
...
Central de Movimentação de Guias Tiss(hrc.document).
Para isso, foi realizada uma requisição na API utilizando a
...
chave do documento.
Os parâmetros utilizados podem ser visualizados abaixo:
- Auditoria
Incluindo documento.
Requisição para Enviar documento para Auditoria.
POST - http://cxs-squad-sus01:
...
- 8080/dts/datasul-rest/resources/prg/hrc/v1/documentsExternal/auditory/doc/
Retorno.
Ao tentar editar.
Exemplo de requisição para Enviar para Auditoria via "FAT".
POST- http://cxs-squad-sus01:8080/dts/datasul-rest/resources/prg/hrc/v1/documentsExternal/auditory/fat/
Retorno. - Liberação de Documento
Documento localizado.
Requisição para Liberar Documento via "DOC".
POST - http://cxs-squad-sus01:8080/dts/datasul-rest/resources/prg/hrc/v1/documentsExternal/release/
Retorno.
Status do documento na Central de Movimentação de Guias Tiss.
Movimentos.
Exemplo de requisição para Liberar Documentos via "FAT".
POST - http://cxs-squad-sus01:8080/dts/datasul-rest/resources/prg/hrc/v1/documentsExternal/release/
Retorno.
Caso o documento não esteja com status em Auditoria para liberação, o retorno apresentará a seguinte mensagem:
Consultando usuário de Liberação- Consulta Movimentos por Prestador (RC0210B).
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:
...