Árvore de páginas

Versões comparadas

Chave

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

...

  1. Visão Geral
  2. Regras de Negócio Aplicadas
  3. Como Validar as Informações
    1. Central de Movimentação de Guia Guias Tiss
      1. Enviar documento para Auditoria
      2. Liberar documento do Revisão de Contas
    2. Consulta Movimentos por Prestadores
      1. Enviar documentos documento para Auditoria
      2. Liberar documento do Revisão de Contas 
  4. 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 
Âncora
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
titleInformações Importantes:

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:

    CampoDescrição
    Documento

    Campos chave do Documento.

    Chave do DocumentoTipo Descrição

    cdUnidade

    unidade
    NumberCódigo da unidade.
    cdUnidadePrestadoraNumberunidadePrestadoraCódigo da unidade prestadora.
    cdTransacaoNumbertransacaoCódigo da transação.
    nrSerieDocOriginalStringserieDocumentoNome da serie do documento.
    nrDocOriginaldocumentoNumberCódigo do documento.
    nrDocSistemaNumberdocumentoSistemaSequencia do documento no sistema.

    Fatura

    Campos chave da Fatura.

    unidade
    Chave da FaturaTipo Descrição

    cdUnidade

    NumberCódigo da unidade.

    cdUnidadePrestadora

    unidadePrestadoraNumberCódigo da unidade prestadora.

    cdPrestadorPrincipal

    prestadorNumberCódigo do prestador.

    cdSerieNf

    StringserieFaturaNome da serie da fatura.

    aaFatura

    NumberanoAno da fatura.

    nrFatura

    faturaStringCódigo da fatura.
    Parâmetros

    Parâmetros para liberar documentos do Revisão de Contas.

    CamposTipo DescriçãoObrigatório
    tipoStringTipo da busca "DOC" ou "FAT".Sim
    consisteDiariaBooleanConsiste se documentos de internação possuem diária. Não
    validarDocumentosPendentesBooleanValida se possuem documentos pendentes de vinculação.Não
    consistirDiferencaValoresBooleanConsiste a diferença de valores cobrados.Não
    percentualDiferencaValoresDecimalMargem de valor, para consistir.Não
    nomeUsuariocaracterNome do usuário que está efetivando a requisição.Sim


    Expandir
    titleExemplos 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
Âncora
valida_inf
valida_inf

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. 

...

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

...

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

...


            
            Exemplo de requisição para Liberar Documentos via "FAT".
            
            POST - http://cxs-squad-sus01:8080/dts/datasul-rest/resources/prg/hrc/v1/documentsExternal/release/
            
            Image Added
             Image Added
             

             Retorno.

                Image Added

              Image Added

                 
                 Caso o documento não esteja com status em Auditoria  para liberação, o retorno apresentará a seguinte mensagem:
                 Image Added

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