Á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. Novo Protocolo de Bloqueio
    2. Consultar Dados de Bloqueio
    3. Tabela de Críticas
  3. Tela Bloqueio dos Beneficiários
    1. Outras Ações / Ações relacionadas
  4. Tela Bloqueio dos Beneficiários
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

...

Bloco de código
languagec#
themeMidnight
titleAPI Retorno - Sucesso
linenumberstrue
collapsetrue
{
    "blockingDate": "",
    "blockingReason": "",
    "blockingProtocol": [
        {
            "requestDate": "2022-06-24",
            "requestOrigin": "3",
            "status": "0",
            "protocol": "41750520220624000009"
        }
    ]
}


...

Dados Inválidos (400) 

code

StringCódigo identificador do erro. (Tabela de Críticas)*required

message

StringLiteral no idioma da requisição descrevendo o erro para o usuário.*required

detailedMessage

StringMensagem técnica e mais detalhada do erro.*required

helpUrl

StringURI para documentação do erro.

details

Array

Bloco de código
languagec#
themeMidnight
titleRetorno API - Falha
linenumberstrue
collapsetrue
{
    "code": "BL07",
    "message": "Beneficiário 00011008000016018 já tem uma solicitação pendente.",
    "detailedMessage": "Beneficiário com solicitação pendente na tabela B5J com o B5J_STATUS igual a 0.",
    "helpUrl": "",
    "details": [
        {
            "code": "",
            "message": "",
            "detailedMessage": "",
            "helpUrl": ""
        }
    ]
}

Consultar Dados de Bloqueio

Retorna os dados referente ao bloqueio do beneficiário solicitado.

Endpoint

Url

Verbo

https://<url>:porta>/rest/totvsHealthPlans/v1/beneficiaries/{subscriberId}/block GET

Parâmetros

subscriberId (path)StringNúmero da carteirinha do beneficiário a ser solicitado*required
Authorization (header)StringCabeçalho usado para autorização das requisições*required

Content-Type (header)

String'application/json' é o formato do conteúdo*required


...

Request

Exemplo

Sem Body

...

Operação realizada com sucesso (200)

blockingDate

DateData de bloqueio do beneficiário solicitado (BA1_DATBLO)

blockingReason

StringMotivo de bloqueio do beneficiário solicitado (BA1_MOTBLO)

blockingProtocol

ArrayDados do protocolo de bloqueio do beneficiário, caso tenha.

blockingProtocol.requestDate

DateData de solicitação do bloqueio (B5J_DATSOL)

blockingProtocol.requestOrigin

StringOrigem da solicitação do bloqueio (B5J_ORISOL)

blockingProtocol.status

StringStatus do protocolo de bloqueio (B5J_STATUS)

blockingProtocol.protocol

StringProtocolo de bloqueio (B5J_PROTOC)

Exemplo

Bloco de código
languagec#
themeMidnight
titleAPI Retorno - Sucesso
linenumberstrue
collapsetrue
{
    "blockingDate": "",
    "blockingReason": "",
    "blockingProtocol": [
        {
            "requestDate": "2022-06-24",
            "requestOrigin": "3",
            "status": "0",
            "protocol": "41750520220624000009"
        }
    ]
}


...

Dados Inválidos (400) 

code

StringCódigo identificador do erro. (Tabela de Críticas)*required

message

StringLiteral no idioma da requisição descrevendo o erro para o usuário.*required

detailedMessage

StringMensagem técnica e mais detalhada do erro.*required

helpUrl

StringURI para documentação do erro.

details

Array

Bloco de código
languagec#
themeMidnight
titleRetorno API - Falha
linenumberstrue
collapsetrue
{
    "code": "BL07BL03",
    "message": "BeneficiárioMatrícula 0001100800001601800011008000016019 não tem uma solicitação pendentefoi encontrada.",
    "detailedMessage": "BeneficiárioMatricula comnão solicitação pendenteencontrada na tabela BA1 B5Jpela com o B5J_STATUS igual a 0.chave: BA1_CODINT, BA1_CODEMP, BA1_MATRIC, BA1_TIPREG, BA1_DIGITO",
    "helpUrl": "",
    "details": [
        {
            "code": "",
            "message": "",
            "detailedMessage": "",
            "helpUrl": ""
        }
    ]
}

...