Histórico da Página
...
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? | ||||
---|---|---|---|---|---|---|---|---|
header | String | 99999999999 | ||||||
header | String | 99999999999999999periodoId | query | String | MM/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.
...