Árvore de páginas

Versões comparadas

Chave

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

...

Ao solicitar um protocolo de bloqueio para o títular, o mesmo também poderá solicitar o bloqueio de toda a família, através do atributo familyBlock igual a true, ou também poderá solicitar o bloqueio somente de determinados beneficiários. Ambos os atributos (familyBlock e beneficiaries) são opcionais.

Exemplo

Bloco de código
languagec#
themeMidnight
titleRequest body
linenumberstrue
collapsetrue
{
    "familyBlock": false,
    "beneficiaries":[
        {
            "subscriberId": "00011008000016034"
        }
    ]
}

...

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)

...


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

...

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

...

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)

...


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": "BL03",
    "message": "Matrícula 00011008000016019 não foi encontrada.",
    "detailedMessage": "Matricula não encontrada na tabela BA1 pela chave: BA1_CODINT, BA1_CODEMP, BA1_MATRIC, BA1_TIPREG, BA1_DIGITO",
    "helpUrl": "",
    "details": [
        {
            "code": "",
            "message": "",
            "detailedMessage": "",
            "helpUrl": ""
        }
    ]
}

...