Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
3. Tela XXX
   1. Outras Ações / Ações relacionadas
      
4. Tela XXX
   1. Principais Campos e Parâmetros
      
5. Tabelas utilizadas

01. VISÃO GERAL

Este documento tem como objetivo orientar a utilização da API guiaAutorizacoes para utilizar na integração do TOTVS Saúde Planos Linha Protheus com a Mobile Saúde, onde será disponibilizado ao beneficiário a relação das suas autorizações, por status, e possibilitar a visualização dos itens da guia e imprimir a guia completa em PDF.

A API utilizará o padrão REST.

02. EXEMPLO DE UTILIZAÇÃO

Lista de métodos utilizados na API:

• guiaAutorizacoes: retorna uma lista com todos os protocolos de autorização do beneficiário e do seu grupo familiar, conforme regra de negócio da sua operadora.
• guiaDetalhe: retorna eventos (itens) da guia de autorização (método opcional)
• guiaPdf: retorna a URL ou a string BASE64 do arquivo PDF da guia completa.
• guiaStatus: retorna a tabela de domínio dos status de autorização, para que possamos montar as legendas da listagem.

A autenticação dos métodos listados abaixo é realizado através da Api /token, onde será retornado a chave e token a ser adicionado no header de cada método.

Método guiaAutorizacoes

Este método irá retornar a lista com todas as solicitações de autorização do usuário, conforme layout que será descrito abaixo. Este método deve retornar o cabeçalho da autorização.

Regras de Negocio do Método

Quando o beneficiário solicitado for o titular, será retornado as suas autorizações e de todo o grupo familiar.

Quando o beneficiário solicitado for um dependente, será retornado apenas as suas próprias autorizações.

Endpoint

Parâmetros de Entrada do Método

Exemplo

{
    "chaveBeneficiarioTipo": "CPF",
    "multiContract": true,
    "chaveBeneficiario": "53017895890",
    "dataInicial": "2022-01-27",
    "dataFinal": "2022-02-04"
}

Se os parâmetros Data Inicial e Final não forem informados, será retornado uma lista de autorizações de acordo com a quantidade de meses no campo BA0_MSGUIA (Campo do tipo numérico), caso o campo não seja encontrado na base de dados, será utilizado o período de verificação dos últimos 12 meses.

03. TELA XXXXX

Outras Ações / Ações relacionadas

04. TELA XXXXX

Principais Campos e Parâmetros

05. TABELAS UTILIZADAS

BEA - Cabeçalho das Guias de Autorizações

BE2 - Itens das Guias Autorizações

BE4 - Cabeçalho das Guias de Internações

BEJ - Itens das Guias de Internações

B4Q - Cabeçalho das Guias de Prorrogação de Internação

BQV - Itens das Guias de Prorrogação de Internação (Evolução das Diárias)

B4A - Cabeçalho das Guias de Anexos Clínicos 

B4C - Itens das Guias de Anexos Clínicos