Árvore de páginas

Versões comparadas

Chave

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

...

  • O plano (produto no cadastro de produtos) que possui os opcionais vinculados deve estar associado ao subcontrato.
  • O código do plano (produto) deve ser informado na propriedade B2N_CODPRO no body da requisição, que será refletido no campo BA1_CODPLA no cadastro de beneficiários

...

  • O plano (produto no cadastro de produtos) deve estar configurado com os opcionais vinculados.
  • O código do plano (produto) deve ser informado na propriedade B2N_CODPRO no body da requisição, que será refletido no campo BA1_CODPLA no cadastro de beneficiários.

...

A gravação dos opcionais é controlada pelo parâmetro MV_PLCAROP, que pode assumir os seguintes valores:

...

ValorComportamento
0Não grava nenhum opcional.
1

Grava todos os opcionais ligados ao plano (configurados como vinculados e ou não vinculados).

2

Grava apenas os opcionais configurados como vinculados.

Quando houver a gravação de um ou mais opcionais, o response do endpoint exibirá uma seção identificada pelo ID DETAILOPC quando a inclusão de um ou mais beneficiários ocorrer com sucesso.

Essa seção conterá as seguintes propriedades principais:

  • MATRICULA
    Matrícula do beneficiário ao qual os opcionais foram vinculados.
  • RESULT
    Resultado da gravação.
  • Essa propriedade retorna uma string em formato JSON, contendo os detalhes da operação.


Estrutura do JSON em RESULT

O JSON retornado em RESULT possui as seguintes propriedades:

  • product
    Código do opcional (cadastrado como produto no cadastro de produtos) para o qual foi realizada a tentativa de gravação.
  • version
    Versão do opcional.
  • response
    Objeto que representa o resultado da tentativa de gravação do opcional, contendo:
  • success: indica se a gravação foi bem-sucedida.
    • true → gravação realizada com sucesso.
    • false → gravação não realizada.
  • message: em caso de falha (success = false), retorna o possível motivo da não gravação.


Bloco de código
languagec#
themeMidnight
titleRetorno API - Opcionais
linenumberstrue
collapsetrue
{
   "id": "DETAILOPC",
   "modeltype": "GRID",
   "optional": 1,
   "struct": [
       {
            "id": "MATRICULA",
            "order": 1
       },
       {
            "id": "RESULT",
            "order": 2
       }
   ],
   "items": [
       {
            "id": 1,
            "deleted": 0,
            "fields": [
                {
                    "id": "MATRICULA",
                    "value": "00010001000152008"
                },
                {
                    "id": "RESULT",
                    "value": "[{\"product\":\"9896\",\"version\":\"001\",\"response\":{\"success\":true,\"message\":\"\"}},{\"product\":\"9897\",\"version\":\"001\",\"response\":                       					\"success\":true,\"message\":\"\"}}]"
                }
            ]
       },
       {
            "id": 2,
            "deleted": 0,
            "fields": [
                {
                    "id": "MATRICULA",
                    "value": "00010001000152016"
                },
                {
                    "id": "RESULT",
                    "value": "[{\"product\":\"9896\",\"version\":\"001\",\"response\":{\"success\":true,\"message\":\"\"}},{\"product\":\"9897\",\"version\":\"001\",\"response\":{\"success\":true,\"message\":\"\"}}]"
               }
           ]
       }
    ]
}


04. DEMAIS INFORMAÇÕES

Não se aplica.

...