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
4. Exemplo de Utilização

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 Utilização do Beneficiário tem por objetivo retornar o extrato de utilização do beneficiário, isto é, todos os procedimentos e insumos realizados pelo beneficiário em determinado período.

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

a. Rota 

/Beneficiario/v1/Extrato.

b. Parâmetros de Entrada

Para esta API devem ser informados os cabeçalhos abaixo no header da requisição:

Devem ser informados, obrigatoriamente, o CPF e/ou carteira do beneficiário e o período.

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": [
 	{
 	 "nome": "Nome da categoria de agrupamento do extrato",
 	 "valor": "Valor total da categoria de agrupamento do extrato",
 	 "procedimentos": [
		{
	 	 "procedimentoId": "Código do procedimento realizado",
	 	 "nomeProcedimento": "Nome do procedimento realizado",
	 	 "dtRealizacao": "Data de realização do procedimento em formato de exibição",
	 	 "nomePrestador": "Nome do prestador executante"
		}	
	 ]
 	}
 ],
 "DebugMessage": "string"
}

02. REGRAS DE NEGÓCIO APLICADAS

• A API irá retornar apenas os movimentos dos beneficiários que já estiverem sidos liberados.

• Os serviços serão classificados/agrupados por categoria de serviços. A categoria corresponderá ao valor do campo 'Tipo de Guia TISS' parametrizado na transação do serviço e pode ser classificadas como: 

  • Consultas: procedimentos em transação de Consulta;
  • Exames/Terapias: procedimentos em transação de SADT;
  • Internações: procedimentos em transações de Internação e Honorário Individual;
  • Outras Despesas: todos os insumos, independente de transação.
• O campo de valor será preenchido de acordo com o valor de cobrança do beneficiário e forma de pagamento:
  • Serviços cobrados em pré-pagamento e sem incidência de participação deverão serão listados com valor zerado;
  • Serviços cobrados em pré-pagamento com incidência de participação deverão serão listados apenas com o valor da participação;
  • Serviços cobrados em custo operacional serão listados com o valor integral do procedimento para cobrança.
• Procedimentos com equipe médica (auxiliares e anestesistas) serão listados apenas uma vez, considerando o movimento do Cirurgião.
• Procedimentos com divisão de honorários também serão listados apenas uma vez, considerando o movimento do prestador pessoa jurídica.

03. COMO VALIDAR AS INFORMAÇÕES

04. EXEMPLO DE UTILIZAÇÃO

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>