CONTEÚDO

1. Visão Geral
   1. Rota
   2. Parâmetros de Entrada
   3. Retorno
2. Regras de Negócio Aplicadas
3. 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 com o APP da Unimed Brasil.

A API Extrato de Coparticipação do Beneficiário/DemonstrativoCoparticipacao 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ário.

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

a. Rota 

/Beneficiario/v1/DemonstrativoCoparticipacao

b. Parâmetros de Entrada

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

...

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

b. Retorno

O objeto Json de retorno da API possui a seguinte estrutura:

{
  "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": [
    {
      "categoria": "categoria",
      "valor": 0,
      "valorFormatado": "Valor total da seção no formato de exibição desejado",
      "itens": [
        {
          "valor": 0,
          "valorFormatado": "Valor do item no formato de exibição desejado",
          "detalhes": [
            {
              "Titulo": "Título apresentado para o detalhe do item",
              "Campo": "Campo com a descrição do detalhe do item"
            }
          ]
        }
      ]
    }
  ],
  "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.

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

...