Exibir origem

CONTEÚDO

Visão Geral
Regras de Negócio Aplicadas
Como Validar as Informações
1. Central de Movimentação de Guias Tiss
  1. Enviar documento para Auditoria
  2. Liberar documento do Revisão de Contas
2. Consulta Movimentos por Prestadores
  1. Enviar documento para Auditoria
  2. Liberar documento do Revisão de Contas
Exemplo de Como Validar as Informações

01. VISÃO GERAL

O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração.

A API Status do Documento/Movimentos tem o objetivo de buscar e enviar documentos para auditoria, e liberar documentos do Revisão de Contas.

02. REGRAS DE NEGÓCIO APLICADAS

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

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	Código da unidade.
cdUnidadePrestadora	Number	Código da unidade prestadora.
cdTransacao	Number	Código da transação.
nrSerieDocOriginal	String	Nome da serie do documento.
nrDocOriginal	Number	Código do documento.
nrDocSistema	Number	Sequencia do documento no sistema.

Fatura

Campos chave da Fatura.

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

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

Os resultados apresentados pela API podem ser validados e visualizados nos seguintes programas/relatórios:

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:

Linha Datasul > API de Status do Documento/Movimentos > image2020-9-26_20-33-10.png

Através da Busca Avançada é possível pesquisar o documento:

Linha Datasul > API de Status do Documento/Movimentos > image2020-9-26_20-35-33.png

Ao informar alguns campos e clicar em buscar será retornado 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)

Linha Datasul > API de Status do Documento/Movimentos > image2020-9-26_20-43-8.png

Caso o documento esteja liberado. (3- Liberado)

Mais detalhes sobre o programa Central Tiss podem ser visto através da documentação: 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:

Linha Datasul > API de Status do Documento/Movimentos > image2020-9-28_7-57-52.png

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:

Linha Datasul > API de Status do Documento/Movimentos > image2020-9-28_7-59-33.png

Ao clicar nessa opção será exibida informações sobre a liberação do documento.

Linha Datasul > API de Status do Documento/Movimentos > image2020-9-28_8-1-22.png

Mais detalhes sobre o programa Manutenção Autorização Guias pode ser visto através da documentação: 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/

   Linha Datasul > API de Status do Documento/Movimentos > image2020-10-5_8-43-46.png

Retorno.





Caso o documento não esteja com status em Auditoria para liberação, o retorno apresentará a seguinte mensagem:
Linha Datasul > API de Status do Documento/Movimentos > image2020-10-2_9-59-42.png

Consultando usuário de Liberação- Consulta Movimentos por Prestador (RC0210B).