Árvore de páginas

Versões comparadas

Chave

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

...

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

A API utilizará o padrão REST.

02. EXEMPLO DE UTILIZAÇÃO

Lista de Segue os métodos utilizados na API:

  • guiaAutorizacoes: Retorna uma lista com todas as guias de autorização do beneficiário e do seu grupo familiar, conforme regra de negócio.
  • guiaDetalhe: Retorna eventos (itens) da guia de autorização.
  • guiaPdf: Retorna a URL ou a string BASE64 do arquivo PDF da guia completa.
  • guiaStatus: Retorna os status das guias de autorização, para montagem das legendas da listagem.


Abaixo serão apresentados exemplos de cada método. 

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

...

As guias que o sistema irá retornar são: SP/SADT, Consulta e , Odontológica (BEA); Solicitação de Internação (BE4); Prorrogação de Internação (B4Q); Anexo Clínico (B4A). 

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

Se o Login for realizado por CPF, o sistema irá listar as autorizações de todos os contratos vinculado aquele CPF.

Se o Login for realizado por matricula, o sistema irá listar somente as autorizações daquele contrato.

...

Este método irá retornar os detalhes dos eventos (itens) de uma guia de autorização.

...

Os itens das guias que o sistema irá retornar são: SP/SADT, Consulta e , Odontológica (BE2); Solicitação de Internação (BEJ); Prorrogação de Internação (BQV); Anexo Clínico (B4C). 

Esse método irá receber a chave de autorização que foi retornado no método guiaAutorizacoes. A Chave deverá conter a tabela do cabeçalho e o numero da guia.

...

O PDF das guias que o sistema irá retornar são: SP/SADT, Consulta e , Odontológica (BEA); Solicitação de Internação (BE4); Prorrogação de Internação (B4Q); Anexo Clínico (B4A).

Esse método irá receber a chave de autorização que foi retornado no método guiaAutorizacoes. A Chave deverá conter a tabela do cabeçalho e o numero da guia.

O sistema não irá gerar o PDF , para o seguintes casos: guia cancelada, guia não autorizada ou guia em analise. Nos casos da guia não autorizada e também em analise é possível habilitar a impressão pelo parâmetro MV_IGUINE, exceto em guias de anexo clínico.

Para guias de liberação SADT, o sistema não irá gerar o PDF quando não tiver saldo disponível, ou seja, a liberação já foi executada em uma guia de autorização. Através do parâmetro MV_PLIMSAE é possível permite permitir a geração quando não houver saldo.

Através da configuração da Mobile Saúde do campo BA0_MSPDFM no cadastro da operadora, pelo campo BA0_MSPDFM, será definido o tipo de PDF que será gerado (URL ou base64). Quando utilizado via URL, deverá informar no campo BA0_MSPDFU o caminho para acessar pela internet.

...

Veja um exemplo de como a comunicação com a API é feita na prática: 

API Extrato de AutorizaçõesImage Modified


03. TELA EXTRATO DE AUTORIZAÇÕES

Outras Ações / Ações relacionadas

AçãoDescrição
Não se aplicaNão se aplica

04. TELA EXTRATO DE AUTORIZAÇÕES

...