Histórico da Página

...

Visão Geral
Exemplo de utilização
1. Autorizações
2. Dados da Autorização
3. Eventos da Autorização
Tela Autorizações do Beneficiário
1. Outras Ações / Ações relacionadas
Tela Autorizações do Beneficiário
1. Principais Campos e Parâmetros
Tabelas utilizadas

01. VISÃO GERAL

Este documento tem como objetivo demonstrar a utilização dos endpoints de autorizações do beneficiário, que faz parte da api beneficiaryPosition do Produto TOTVS Saúde Planos Linha Protheus (totvsHealthPlans).

/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/authorizations
/totvsHealthPlans/v1/beneficiaryPosition/authorizations/{authorizationId}
/totvsHealthPlans/v1/beneficiaryPosition/authorizations/{authorizationId}/events

Esses endpoints serão utilizados na nova tela de posição do beneficiário, desenvolvida em PO UI. (Biblioteca de componentes baseado em Angular)

Clique aqui para detalhes sobre como habilitar o serviço de APIs

02. EXEMPLO DE UTILIZAÇÃO

Autorizações

Retorna uma coleção com as autorizações do beneficiário

Endpoint

https://<url>:porta>/rest/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/authorizations

Image Added

Parâmetros

Authorization (header)	Image Added	Cabeçalho usado para autorização das requisições	*required
Content-Type (header)	Image Added	'application/json' é o formato do conteúdo	*required
SubscriberId (path)	Image Added	Número da carteirinha do beneficiário	*required
phases (query)	Image Added	Fases das autorizações, sendo: 1 = Em Digitação 2 = Conferência 3 = Pronta 4 = Faturada
formTypes (query)	Image Added	Tipos de autorizações, sendo: 01 = Guia de Consulta 02 = Guia de SP_SADT 03 = Guia de Sol. Internação 04 = Guia de Reembolso 05 = Guia de Resumo de Internação 06 = Guia de honorários 07 = Anexo Quimioterapia 08 = Anexo Radioterapia 09 = Anexo Opme 10 = Guia de Recurso de Glosa 11 = Guia de Sol. Prorrogação de Internação 12 = Guia de Outras despesas 13 = Guia de Odontologia Guias de acordo com o cadastro da tabela BCL
initialDate (query)	Image Added	Data inicial das autorizações: 'AAAA-MM-DD'
finalDate (query)	Image Added	Data final das autorizações: 'AAAA-MM-DD'
page (query)	Image Added	Paginação da Coleção
pageSize (query)	Image Added	Quantidade de Itens por Página
order (query)	Image Added	Ordenação da Coleção
fields (query)	Image Added	Filtro de campos dos registros
filter (query)	Image Added	Indica o filtro querystring recebido (pode se utilizar um filtro oData)

...

Request

Não possui body!

...

Operação realizada com sucesso (200)

items	Image Added	Grupos de cobertura do beneficiário
items.groupCode	Image Added	Código do grupo de cobertura Campo: BG7_CODGRU
items.coverageGroup	Image Added	Descrição do grupo de cobertura Campo: BG7_DESCRI
items.level	Image Added	Nível sendo: Usuario, Familia, Empresa e Produto
hasNext	Image Added	Indica se ainda existem registros a serem retornados
remainingRecords	Image Added	Quantidade de registros ainda existem para retorno

Bloco de código

language	c#
theme	Midnight
title	Exemplo de retorno - Sucesso
linenumbers	true
collapse	true

{
  "items": [
    {
      "bd5_codldp": "9999",
      "bd5_codpeg": "00000499",
      "bd5_numero": "00000001",
      "bd5_datpro": "2022-11-1",
      "bd5_codrda": "000004",
      "bd5_nomrda": "HOSPITAL BOM CLIMA",
      "bd5_tipgui": "01",
      "bd5_fase": "3",
      "bd5_situac": "1",
      "bcl_descri": "GUIA DE CONSULTA",
      "authorizationid": "BD5-000199990000049900000001"
    },
    {
      "bd5_codldp": "9999",
      "bd5_codpeg": "00000500",
      "bd5_numero": "00000001",
      "bd5_datpro": "2022-11-1",
      "bd5_codrda": "000004",
      "bd5_nomrda": "HOSPITAL BOM CLIMA",
      "bd5_tipgui": "02",
      "bd5_fase": "3",
      "bd5_situac": "1",
      "bcl_descri": "GUIA DE SP_SADT",
      "authorizationid": "BEA-000199990000050000000001"
    },
    {
      "bd5_codldp": "9999",
      "bd5_codpeg": "00000501",
      "bd5_numero": "00000001",
      "bd5_datpro": "2022-11-1",
      "bd5_codrda": "000004",
      "bd5_nomrda": "HOSPITAL BOM CLIMA",
      "bd5_tipgui": "03",
      "bd5_fase": "1",
      "bd5_situac": "1",
      "bcl_descri": "GUIA DE SOL. INTERNACAO",
      "authorizationid": "BE4-000199990000050100000001"
    }
  ],
  "hasNext": false,
  "remainingRecords": 0,
  "struct": [
    {
      "field": "BD5_CODLDP",
      "type": "C",
      "title": "Cd.Local Dig",
      "description": "Codigo Local Digitacao",
      "picture": "@!",
      "size": 4,
      "decimals": 0,
      "cbox": []
    },
    {
      "field": "BD5_CODPEG",
      "type": "C",
      "title": "Código PEG",
      "description": "Codigo PEG",
      "picture": "@!",
      "size": 8,
      "decimals": 0,
      "cbox": []
    },
    {
      "field": "BD5_NUMERO",
      "type": "C",
      "title": "Número",
      "description": "Numero da Movimentacao",
      "picture": "@!",
      "size": 8,
      "decimals": 0,
      "cbox": []
    },
    {
      "field": "BD5_DATPRO",
      "type": "D",
      "title": "Data Evento",
      "description": "Data Evento",
      "picture": "",
      "size": 8,
      "decimals": 0,
      "cbox": []
    },
    {
      "field": "BD5_CODRDA",
      "type": "C",
      "title": "Cd.Cred/Coop",
      "description": "Cod. Credenc",
      "picture": "@!",
      "size": 6,
      "decimals": 0,
      "cbox": []
    },
    {
      "field": "BD5_NOMRDA",
      "type": "C",
      "title": "Nm.Cred/Coop",
      "description": "credenciado",
      "picture": "@!",
      "size": 40,
      "decimals": 0,
      "cbox": []
    },
    {
      "field": "BD5_TIPGUI",
      "type": "C",
      "title": "Tp. Guia",
      "description": "Tipo de Guia",
      "picture": "@!",
      "size": 2,
      "decimals": 0,
      "cbox": []
    },
    {
      "field": "BD5_FASE",
      "type": "C",
      "title": "Fase",
      "description": "Fase",
      "picture": "@!",
      "size": 1,
      "decimals": 0,
      "cbox": [
        {
          "value": "1",
          "description": "Digitacao"
        },
        {
          "value": "2",
          "description": "Conferencia"
        },
        {
          "value": "3",
          "description": "Pronta"
        },
        {
          "value": "4",
          "description": "Faturada"
        },
        {
          "value": "5",
          "description": "Processando"
        }
      ]
    },
    {
      "field": "BD5_SITUAC",
      "type": "C",
      "title": "Situação",
      "description": "Situacao",
      "picture": "@!",
      "size": 1,
      "decimals": 0,
      "cbox": [
        {
          "value": "1",
          "description": "Ativa"
        },
        {
          "value": "2",
          "description": "Cancelada"
        },
        {
          "value": "3",
          "description": "Bloqueada"
        }
      ]
    },
    {
      "field": "BCL_DESCRI",
      "type": "C",
      "title": "Descricao",
      "description": "Descricao",
      "picture": "@!",
      "size": 30,
      "decimals": 0,
      "cbox": []
    }
  ]
}

Dados Inválidos (404)

code	Image Added	Código identificador do erro. (Tabela de Erros)
message	Image Added	Literal no idioma da requisição descrevendo o erro para o usuário.
detailedMessage	Image Added	Mensagem técnica e mais detalhada do erro.

Bloco de código

language	c#
theme	Midnight
title	Exemplo de retorno - Falha
linenumbers	true
collapse	true

{
  "code": "E001",
  "message": "Beneficiário não encontrado.",
  "detailedMessage": "Não foi encontrado nenhum Beneficiário com a matricula 00011008000027012"
}

Tabela de Código de Erros

Código de erros informado no Json de retorno com falha (404):

Code	message	detailedMessage
E001	Beneficiário não encontrado.	Não foi encontrado nenhum Beneficiário com a matricula {subscriberId}

03. TELA XXXXX

Outras Ações / Ações relacionadas

...

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave