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 documentos documento para Auditoria
- Liberar documento do Revisão de Contas
- Central de Movimentação de Guias Tiss
- Exemplo de Como Validar as Informações
...
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.- 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 FaturaFatura "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 Documento.
Chave do Documento Tipo Descrição cdUnidade
Number unidadeCódigo da unidade. cdUnidadePrestadora NumberunidadePrestadora Código da unidade prestadora. cdTransacao transacaoNumber Código da transação. nrSerieDocOriginal StringserieDocumento Nome da serie do documento. nrDocOriginal documentoNumber Código do documento. nrDocSistema NumberdocumentoSistema Sequencia do documento no sistema. Fatura
Campos chave da Fatura.
Chave da Fatura Tipo Descrição cdUnidade
Number unidadeCódigo da unidade. cdUnidadePrestadora
unidadePrestadoraNumber Código da unidade prestadora. cdPrestadorPrincipal
Numberprestador Código do prestador. cdSerieNf
StringserieFatura Nome da serie da fatura. aaFatura
anoNumber Ano da fatura. nrFatura
faturaString 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 |
...
- 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)
...
- Auditoria
Incluindo documento.
Chamada a API
Requisição para Enviar documento para Auditoria.
Retorno:
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.
Movimentos.
Chamada da API para Liberação de Documento.
Retornando a chave do documento.
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).