Árvore de páginas

Versões comparadas

Chave

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

...

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

A API B Beneficiário - Histórico de Boletos/TitulosLiquidados tem por objetivo retornar o extrato de coparticipação do beneficiário, isto é, todos os procedimentos e insumos realizados pelo beneficiário em determinado período e que tiveram coparticipação cobrada do beneficiárioa lista de títulos já pagos pelo beneficiário.

A API foi desenvolvida seguindo as definições disponibilizadas no Swagger da Unimed Brasil. 

a. Rota 

/Beneficiario/v1/DemonstrativoCoparticipacaoTitulosLiquidados

b. Parâmetros de Entrada

Esta API deve receber os seguintes parâmetros via header ou via query parameters:

Parâmetro

Tipo de Parâmetro

Tipo de dados

Formato

Obrigatório?

headerString99999999999
headerString99999999999999999periodoIdqueryStringMM/AAAA

Sim


Deve ser informado obrigatoriamente um CPF ou uma carteira de beneficiário.

...

Bloco de código
{
  "Result": "Domínio: 0 = Erro na execução do serviço, 1 = Processamento Ok",
  "Message": "Mensagem de retorno que deverá ser exibida ao usuário (obrigatória em caso de erro, ou seja, Result = 0)",
  "Data": {
    "tituloTotal": "Titulo do totalizador de valores",
    "valorTotal": "Somatório de valores dos títulos",
    "titulos": [
      {
        "categoriatituloId": "categoriaIdentificador do título",
        "valordtVencimento": 0"Data de vencimento do título em formato de exibição",
        "valorFormatadodtVencimentoAtualizado": "Valor total da seção noData de vencimento do título atualizado em formato de exibição desejado, caso seja uma prorrogação ou algo do tipo",
        "itensstatusId": ["Identificador de status do título",
        {
   "status": "Descrição de status do título: PAGO, ABERTO, VENCIDO",
        "valor": 0"Valor do título em formato numérico",
        "valorFormatado": "Valor "valorFormatadodo título formatado para exibição",
        "valorAtualizado": "Valor atualizado do itemtítulo noem formato de exibição desejado numérico",
        "valorAtualizadoFormatado": "Valor atualizado do título formatado para exibição",
          "detalheslinhaDigitavel": [
"Linha digital do boleto, possibilitando que o cliente possa copiar e realizar o {pagamento",
        "cedente": "Nome do cedente",
        "TitulourlBoleto": "TítuloURL apresentadoExterna para download do boleto",
        "exibirBotaoSegundaVia": "Indica que o botão de segunda via do boleto deve ou não ser exibido no detalhe do itemtítulo",
        "detalhamento": [
     "Campo     {
            "descricao": "CampoDescrição comda acomposição descriçãode dovalores detalheo do itemboleto",
            }"quantidade": "Quantidade do item descrito",
            "valorFormatado": "Valor formatado para ]exibição"
          }
        ]
      }
    ]
  },
  "DebugMessage": "string"
}

02. REGRAS DE NEGÓCIO APLICADAS

  • A API irá retornar os movimentos (procedimentos/insumos) onde a data de realização esteja dentro do primeiro e último dia do período selecionado.
    • Sempre que o movimento indicar que houve recolhimento de valor no prestador (vl-desconto-prestador) será apresentado no demonstrativo.
    • Sempre que o movimento estiver amarrado a uma nota de coparticipação, e essa nota amarrada a uma fatura integrada ao financeiro (contas a receber) será apresentado no demonstrativo.

...

  • verificar se o beneficiário consultado é cliente (contratante), e irá listar todos os títulos pagos desse cliente. Somente irá apresentar no APP os títulos que já foram gerados os boletos (processo de boletos do sistema).

O

...

VALIDAR AS INFORMAÇÕES

Os resultados apresentados pela API podem ser validados e visualizados no programa 'Central de Movimentação Guias TISS - hrc-document'.
Para tanto, deve-se realizar a busca por beneficiário e data de realização do movimento conforme período desejado.

...