Árvore de páginas

Versões comparadas

Chave

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

...

  1. Visão Geral
  2. Exemplo de utilização
    1. Authorizations/protocols - Inclusão de protocolo de autorização
  3. Tela api authorizations 
    1. Outras Ações / Ações relacionadas
  4. Tela XXX
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

...

01. VISÃO GERAL

API para a entidade authorauthorizations (ReembolsosAutorizações) do produto TOTVS Saúde Planos Linha Protheus.

...

02. EXEMPLO DE UTILIZAÇÃO

...

Âncora
protocolsPost
protocolsPost

Painel
titleColorOrange
borderStylesolid
titleAuthorizations/protocols - Inclusão de protocolo de autorização

Realiza a inclusão de um protocolo de solicitação de autorização para operadora.

/totvsHealthPlans/attendance/v1/authorizations/protocols

POST

Nota
Expandir
titleParameters
Authorization (header)

string

Cabeçalho usado para autorização das requisições (Bearer token)*required

Content-Type (header)

string

'application/json' é o formato do conteúdo*required
Dica
Expandir
titleRequest
subscriberIdstring

Matricula do beneficiário solicitante do protocolo de autorização

(obtido através da API Beneficiaries - v1.000 (Family Contract))

BKU_MATUSR*required

stateAbbreviation

stringEstado do conselho regional do profissional de saúde solicitanteBKU_UF
professionalCouncilstring

Sigla do conselho regional do profissional de saúde solicitante

(obtido através da API RegionalCouncils - v1.000 (Attendance Network))

BKU_SIGLA
professionalCouncilNumberstringNumero do conselho regional do profissional de saúde solicitanteBKU_REGSOL
professionalNamestring

Nome do profissional de saúde solicitante

(obtido através da API Professionals - v1.000 (Attendance Network))

BKU_NOMSOL*required
attachmentsarrayAnexos da solicitação de autorização
*required
attachments.hrefstringUrl do arquivo para que seja realizado o download
*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
	"subscriberId" : "00011008000027010",
	"stateAbbreviation" : "SP",
	"professionalCouncil" : "CRM",
	"professionalCouncilNumber" : "1234567",
	"professionalName" : "VINICIUS",
	"attachments" : [
        {
            "href" : "https://img.olhardigital.com.br/wp-content/uploads/2019/01/20190115163721.jpg"
        }
	]
}
Dica
Expandir
title(201) - Operação realizada com sucesso
protocolstringNumero do protocolo gerado para a solicitação de autorizaçãoBKU_NRPRO*required
namestring

Nome do beneficiário solicitante

BKU_NOMUSR*required
subscriberIdstringMatricula do beneficiário solicitanteBKU_MATUSR*required
professionalNamestringNome do profissional solicitanteBKU_NOMSOL*required
stateAbbreviationstringEstado do conselho regional do profissional solicitanteBKU_UF
professionalCouncilstringSigla do conselho regional do profissional solicitanteBKU_SIGLA
professionalCouncilNumberstring

Numero do conselho regional do profissional solicitante

BKU_REGSOL
statusstring

Status do protocolo de solicitação de autorização, sendo:

  • 1 = Autorizada
  • 2 = Autorizada Parcialmente
  • 3 = Não Autorizada
  • 6 = Em auditoria
  • 7 = Solicitação em analise
  • 8 = Negado
  • 9 = Aguardando Documento
BKU_STATUS
idOnHealthInsurerstringNumero da autorização gerada pelo sistema depois de aprovada a solicitação.BKU_NUMAUT
authTypestring

Tipo da solicitação, sendo:

  • 2 = SADT
  • 3 = Internação
  • 4 = Odontológico                                                                                              
BKU_TIPO
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "protocol": "41750520230620000003",
    "name": "HERNANDES ALVES DA SILVA",
    "subscriberId": "00011008000027010",
    "professionalName": "VINICIUS",
    "stateAbbreviation": "SP",
    "professionalCouncil": "CRM",
    "professionalCouncilNumber": "1234567",
    "status": "7",
    "idOnHealthInsurer": "",
    "authType": ""
}
Aviso
Expandir
title(406) - Json do body invalido
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E001",
    "message": "JSON inválido",
    "detailedMessage": "Json Error: >>\"professionalCouncilNumber\" : \"1234567\",\r\n\t\"professionalName\" : \"VINICIUS\",\r\n\t\"attachments\" : [\r\n        {\r\n            \"href\" : \"https://img.olhardigital.com.br/wp-content/uploads/2019/01/20190115163721.jpg\"\r\n        }\r\n\t]\r\n}<<"
}
Aviso
Expandir
title(406) - Campos inválidos
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
detailsarrayLista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E002",
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E002D-406",
            "message": "Tipo inválido para o campo professionalCouncilNumber",
            "detailedMessage": "O valor do campo professionalCouncilNumber deve ser do tipo (C)."
        },
        {
            "code": "E002B-406",
            "message": "Campo professionalName obrigatório",
            "detailedMessage": "Não foi informado valor do campo professionalName."
        }
    ]
}
Aviso
Expandir
title(404) - Beneficiário não encontrado
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E003",
    "message": "Beneficiário não encontrado",
    "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000027011"
}
Aviso
Expandir
title(400) - Dados inválidos
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
detailsarrayLista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E004",
    "message": "Erro ao incluir protocolo de autorização",
    "detailedMessage": "Verifique a lista de erros para mais detalhes",
    "details": [
        {
            "code": "E004-1",
            "message": "Erro ao realizar download do arquivo.",
            "detailedMessage": "Status code: 404; Erro: Not Found\r\n; Url: https://img.olhardigital.com.br/wp-content/ploads/2019/01/20190115163721.jpg"
        }
    ]
}

03. TELA AUTHORIZATIONS

Outras Ações / Ações relacionadas

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

04. TELA

...

AUTHORIZATIONS

Principais Campos e Parâmetros

CampoDescrição

...

BKU_NRPRONumero do protocolo gerado para a solicitação de autorização
BKU_STATUSStatus do protocolo de solicitação de autorização
BKU_NUMAUTNumero da autorização gerada pelo sistema depois de aprovada a solicitação.

...

05. TABELAS UTILIZADAS

  • Beneficiários (BA1)
  • Upload de Guia Beneficiário (BKU)