Histórico da Página
CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Layout Genérico Web
- Get API PLINCBENMODELAPI
- Post API PLINCBENMODELAPI
- Put API PLINCBENMODEL
- Delete API PLINCBENMODELAPI
- Tela API PLINCBENMODELPLIncBenModel
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela API PLINCBENMODELPLIncBenModel
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
Este documento tem como objetivo demonstrar a utilização da API PLINCBENMODEL PLIncBenModel, onde será realizada a solicitação de um novo protocolo de inclusão de titulares e dependentes.
...
A API utilizará o padrão REST.
02. EXEMPLO DE UTILIZAÇÃO
Foi desenvolvido o modelo de dados (ModelDef) para incluir beneficiários, e através da classe FWRestModel foi feita a publicação do modelo para que seja consumido via API padrão REST.
...
A autenticação da API é realizado pelo headers Authorization, Type Basic Auth, Usuário e Senha do Protheus.
LAYOUT GENÉRICO WEB
Algumas regras na API poderão ser adicionadas pelo Layout genérico Web, o mesmo deverá ser adicionada no MV_PLLAYIN. Por exemplo: MV_PLLAYIN = PPLINCBEN, a api irá utilizar as configurações contidas nessa layout genérico.
...
Abaixo será apresentado um exemplo de cada método da API PLINCBENMODELPLIncBenModel.
GET API
...
Endpoint
Url | Método | Header Content-Type | Descrição |
|---|---|---|---|
https://<url>:<porta>/rest/fwmodel/PLINCBENMODELPLIncBenModel/[pk] | GET | application/json | Retorna os protocolo da analise de beneficiários, para retornar somente um protocolo deverá ser informado a pk do mesmo. |
Parâmetro <PK> é opcional, sendo usado pra retornar os detalhes de um protocolo.
Parâmetros de Entrada do Método
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| pk | Não | Caracter | Valor da chave primaria do alias do modelo em encodado em base64, esse valor será obtido ao consulta consultar todos os protocolos. |
Exemplo
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"total": 266,
"count": 2,
"startindex": 1,
"resources": [
{
"id": "PLAltBenModel",
"operation": 1,
"pk": "TSBTUCAgICAwMDAwMDE=",
"models": [
{
"id": "MASTERBBA",
"modeltype": "FIELDS",
"fields": [
{
"id": "BBA_FILIAL",
"order": 1,
"value": "M SP"
},
{
"id": "BBA_CODSEQ",
"order": 2,
"value": "000001"
},
{
"id": "BBA_TIPSOL",
"order": 3,
"value": "2"
},
{
"id": "BBA_STATUS",
"order": 4,
"value": "2"
},
{
"id": "BBA_CODINT",
"order": 5,
"value": "0001"
},
{
"id": "BBA_CODEMP",
"order": 6,
"value": "1007"
},
{
"id": "BBA_CONEMP",
"order": 7,
"value": "000000000001"
},
{
"id": "BBA_VERCON",
"order": 8,
"value": "001"
},
{
"id": "BBA_SUBCON",
"order": 9,
"value": "000000001"
},
{
"id": "BBA_VERSUB",
"order": 10,
"value": "001"
},
{
"id": "BBA_MATRIC",
"order": 11,
"value": "00011007000001012"
},
{
"id": "BBA_CODPRO",
"order": 13,
"value": "0005"
},
{
"id": "BBA_DATSOL",
"order": 15,
"value": "20220222"
},
{
"id": "BBA_HORSOL",
"order": 16,
"value": "14:35"
},
{
"id": "BBA_NROPRO",
"order": 18,
"value": "41750520220222000001"
},
{
"id": "BBA_TIPMAN",
"order": 19,
"value": "2"
},
{
"id": "BBA_CPFTIT",
"order": 20,
"value": "76461633090"
},
]
{
}
"id":"BBA_CODCLI",
]
} "order":24,
{
"id "value": "PLAltBenModel000001",
"operation": 1 },
{
"pk": "TSBTUCAgICAwMDAwMDM=",
"modelsid": ["BBA_LOJA",
{
"order":25,
"idvalue": "MASTERBBA01",
}
"modeltype": "FIELDS", ]
}
"fields": [
]
},
{
"id": "PLAltBenModel",
"idoperation": "BBA_FILIAL",1,
"pk": "TSBTUCAgICAwMDAwMDM=",
"ordermodels": 1,[
{
"value "id": "M SPMASTERBBA",
"modeltype": "FIELDS",
}, "fields": [
{
"id": "BBA_CODSEQFILIAL",
"order": 21,
"value": "000003M SP"
},
{
"id": "BBA_TIPSOLCODSEQ",
"order": 32,
"value": "2000003"
},
{
"id": "BBA_STATUSTIPSOL",
"order": 43,
"value": "2"
},
{
"id": "BBA_CODINTSTATUS",
"order": 54,
"value": "00012"
},
{
"id": "BBA_CODEMPCODINT",
"order": 65,
"value": "00220001"
},
{
"id": "BBA_MATRICCODEMP",
"order": 116,
"value": "000100220000120120022"
},
{
"id": "BBA_CODPROMATRIC",
"order": 1311,
"value": "000100010022000012012"
},
{
"id": "BBA_DATSOLCODPRO",
"order": 1513,
"value": "202203100001"
},
{
"id": "BBA_HORSOLDATSOL",
"order": 1615,
"value": "08:4620220310"
},
{
"id": "BBA_NROPROHORSOL",
"order": 1816,
"value": "4175052022031000000308:46"
},
{
"id": "BBA_TIPMANNROPRO",
"order": 1918,
"value": "241750520220310000003"
},
{
"id": "BBA_CPFTITTIPMAN",
"order": 2019,
"value": "426554364232"
},
] {
} "id": "BBA_CPFTIT",
]
}"order": 20,
]
} "value": "42655436423"
}
]
}
]
}
]
} |
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"errorCode": 404,
"errorMessage": "The server can't find the requested resource."
} |
POST API
...
Endpoint
Url | Método | Header Content-Type | Descrição |
|---|---|---|---|
https://<url>:<porta>/rest/fwmodel/PLINCBENMODELPLIncBenModel/ | POST | application/json | Realiza a inclusão de um novo protocolo na analise de beneficiários |
Parâmetros de Entrada do Método
Parâmetro (fields) | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| BBA_CODINT | Sim | Caracter | Código da Operadora (BA0) do Beneficiário |
| BBA_CODEMP | Sim | Caracter | Código da Empresa (BG9) do Beneficiário |
| BBA_CONEMP | Não | Caracter | Código do Contrato (BT5) do Beneficiário, Obrigatório em Empresa Jurídica. |
| BBA_VERCON | Não | Caracter | Versão do Contrato do Beneficiário, Obrigatório em Empresa Jurídica. |
| BBA_SUBCON | Não | Caracter | Código do SubContrato (BQC) do Beneficiário, Obrigatório em Empresa Jurídica. |
| BBA_VERSUB | Não | Caracter | Versão do SubContrato do Beneficiário, Obrigatório em Empresa Jurídica. |
| BBA_EMPBEN | Sim | Caracter | Nome do Beneficiário Titular. |
| BBA_CODPRO | Sim | Caracter | Código do Plano do Beneficiário Titular. |
| BBA_VERSAO | Sim | Caracter | Versão do Plano do Beneficiário Titular |
| BBA_CPFTIT | Sim | Caracter | CPF do Beneficiário Titular. |
| BBA_NROPRO | Não | Caracter | Numero do Protocolo, caso não seja informado o sistema irá gerar automaticamente um numero. |
| BBA_MATRIC | Não | Caracter | Matricula do titular ou responsável familiar, esse campo é utilizado quando for incluir um beneficiário em uma família já existente, caso seja uma nova família, o mesmo não deverá ser preenchido. |
| BBA_CODCLI | Não | Caracter | Código referente ao registro do Cadastro de Cliente (SA1). |
| BBA_LOJA | Não | Caracter | Código da loja referente ao registro do Cadastro de Cliente (SA1). |
| B2N_NOMUSR | Sim | Caracter | Nome do Beneficiário |
| B2N_DATNAS | Sim | Caracter | Data de Nascimento do Beneficiário |
| B2N_GRAUPA | Sim | Caracter | Código do Grau de parentesco (BRP) |
| B2N_ESTCIV | Sim | Caracter | Código do estado civil com base no SX5 tabela 33 |
| B2N_SEXO | Sim | Caracter | Sexo do Beneficiário, sendo 1 para Masculino e 2 para Feminino. |
| B2N_CPFUSR | Não | Caracter | CPF do Beneficiário, Sendo obrigatório para beneficiário titular (independentemente de idade) ou beneficiário dependente com idade igual ou superior a 18 anos. |
| B2N_DRGUSR | Não | Caracter | RG do Beneficiário. |
| B2N_ORGEM | Não | Caracter | Org. Emissor. |
| B2N_RGEST | Não | Caracter | Estado Emissor. |
| B2N_NRCRNA | Não | Caracter | Numero da Carteira nacional de saúde. |
| B2N_CEPUSR | Não | Caracter | CEP do Beneficiário (Tabela BC9). |
| B2N_ENDERE | Não | Caracter | Endereço do Beneficiário. |
| B2N_NR_END | Não | Caracter | Numero do Endereço do Beneficiário. |
| B2N_COMEND | Não | Caracter | Complemento do Endereço do Beneficiário. |
| B2N_UNIVER | Não | Caracter | Informa se o Beneficiário é Universitário. Sendo 1 pra Sim e 0 pra Não. |
| B2N_BAIRRO | Não | Caracter | Bairro do Beneficiário |
| B2N_EMAIL | Não | Caracter | E-mail do Beneficiário. |
| B2N_CODMUN | Não | Caracter | Código do Município (Tabela BID). |
| B2N_INVALI | Não | Caracter | Invalidez?, sendo 1 pra sim e 0 pra não; |
| B2N_MUNICI | Não | Caracter | Descrição do Município. |
| B2N_ESTADO | Não | Caracter | Estado. |
| B2N_TELEFO | Não | Caracter | Telefone do Beneficiário |
| B2N_DDD | Não | Caracter | DDD do Telefone. |
| B2N_MAE | SimNão | Caracter | Nome Mãe do Beneficiário (Será obrigatório caso se o campo BQC_INFANS esteja igual a "1 - Sim"). |
| B2N_PAI | Não | Caracter | Nome do Pai do Beneficiário. |
| B2N_COMUNI | Não | Caracter | Preferência de Comunicação: 0 para E-mail, 1 para SMS e 2 para Ambos |
| B2N_BANCO | Não | Caracter | Código do Banco (Tabela SA6). |
| B2N_AGENC | Não | Caracter | Agência correspondente ao Banco. |
| B2N_CONTA | Não | Caracter | Numero da Conta correspondente a Agência. |
| B2N_DATADT | Não | Caracter | Data de adoção do Beneficiário |
| B2N_CODPRO | Não | Caracter | Codigo do Plano do Beneficiário, caso não seja informado o sistema irá utilizar o do títular (BBA_CODPRO). |
| DIRECTORY | Não | Caracter | Diretório http do arquivo para anexar ao protocolo de inclusão. |
| FILENAME | Não | Caracter | Nome para ao arquivo. |
Os demais parâmetros do json, segue o mesmo padrão para toda requisição de POST.
Exemplo
Inclusão de uma família completa, com titular e dependente:
...
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"id": "PLIncBenModel",
"operation": 1,
"pk": "TSBTUCAgICAwMDA3Nzk=",
"models": [
{
"id": "MASTERBBA",
"modeltype": "FIELDS",
"fields": [
{
"id": "BBA_FILIAL",
"order": 1,
"value": "M SP"
},
{
"id": "BBA_CODSEQ",
"order": 2,
"value": "000779"
},
{
"id": "BBA_TIPSOL",
"order": 3,
"value": "2"
},
{
"id": "BBA_STATUS",
"order": 4,
"value": "2"
},
{
"id": "BBA_CODINT",
"order": 5,
"value": "0001"
},
{
"id": "BBA_CODEMP",
"order": 6,
"value": "1008"
},
{
"id": "BBA_CONEMP",
"order": 7,
"value": "000000000001"
},
{
"id": "BBA_VERCON",
"order": 8,
"value": "001"
},
{
"id": "BBA_SUBCON",
"order": 9,
"value": "000000004"
},
{
"id": "BBA_VERSUB",
"order": 10,
"value": "001"
},
{
"id": "BBA_EMPBEN",
"order": 12,
"value": "NOME BENEFICIARIO TITULAR"
},
{
"id": "BBA_CODPRO",
"order": 13,
"value": "0001"
},
{
"id": "BBA_VERSAO",
"order": 14,
"value": "001"
},
{
"id": "BBA_DATSOL",
"order": 15,
"value": "20220607"
},
{
"id": "BBA_HORSOL",
"order": 16,
"value": "10:24"
},
{
"id": "BBA_NROPRO",
"order": 18,
"value": "41750520220607000779"
},
{
"id": "BBA_TIPMAN",
"order": 19,
"value": "1"
},
{
"id": "BBA_CPFTIT",
"order": 20,
"value": "48273995496"
}
],
"models": [
{
"id": "DETAILB2N",
"modeltype": "GRID",
"struct": [
{
"id": "B2N_FILIAL",
"order": 1
},
{
"id": "B2N_STATUS",
"order": 2
},
{
"id": "B2N_PROTOC",
"order": 3
},
{
"id": "B2N_NOMUSR",
"order": 4
},
{
"id": "B2N_FLGCTR",
"order": 5
},
{
"id": "B2N_TIPUSU",
"order": 6
},
{
"id": "B2N_DATNAS",
"order": 7
},
{
"id": "B2N_GRAUPA",
"order": 8
},
{
"id": "B2N_ESTCIV",
"order": 10
},
{
"id": "B2N_SEXO",
"order": 11
},
{
"id": "B2N_CPFUSR",
"order": 12
},
{
"id": "B2N_DRGUSR",
"order": 13
},
{
"id": "B2N_ORGEM",
"order": 14
},
{
"id": "B2N_RGEST",
"order": 15
},
{
"id": "B2N_NRCRNA",
"order": 16
},
{
"id": "B2N_CEPUSR",
"order": 17
},
{
"id": "B2N_ENDERE",
"order": 18
},
{
"id": "B2N_NR_END",
"order": 19
},
{
"id": "B2N_COMEND",
"order": 20
},
{
"id": "B2N_UNIVER",
"order": 21
},
{
"id": "B2N_BAIRRO",
"order": 22
},
{
"id": "B2N_EMAIL",
"order": 23
},
{
"id": "B2N_CODMUN",
"order": 24
},
{
"id": "B2N_INVALI",
"order": 25
},
{
"id": "B2N_MUNICI",
"order": 26
},
{
"id": "B2N_DATOBI",
"order": 27
},
{
"id": "B2N_ESTADO",
"order": 28
},
{
"id": "B2N_TELEFO",
"order": 29
},
{
"id": "B2N_DDD",
"order": 30
},
{
"id": "B2N_MAE",
"order": 31
},
{
"id": "B2N_PAI",
"order": 32
},
{
"id": "B2N_COMUNI",
"order": 33
},
{
"id": "B2N_BANCO",
"order": 34
},
{
"id": "B2N_AGENC",
"order": 35
},
{
"id": "B2N_CONTA",
"order": 36
},
{
"id": "B2N_DATADT",
"order": 37
},
{
"id": "B2N_CODMOT",
"order": 38
},
{
"id": "B2N_CODSEQ",
"order": 40
},
{
"id": "B2N_BA1REC",
"order": 41
},
{
"id": "B2N_CODEMP",
"order": 42
},
{
"id": "B2N_CONEMP",
"order": 43
},
{
"id": "B2N_SUBCON",
"order": 44
},
{
"id": "B2N_CODPRO",
"order": 45
},
{
"id": "B2N_DTBLOQ",
"order": 46
},
{
"id": "B2N_TIPBLO",
"order": 47
}
],
"items": [
{
"id": 1,
"deleted": 0,
"fields": [
{
"id": "B2N_FILIAL",
"value": "M SP"
},
{
"id": "B2N_PROTOC",
"value": "000779"
},
{
"id": "B2N_NOMUSR",
"value": "NOME BENEFICIARIO TITULAR"
},
{
"id": "B2N_FLGCTR",
"value": "0"
},
{
"id": "B2N_TIPUSU",
"value": "T"
},
{
"id": "B2N_DATNAS",
"value": "19560523"
},
{
"id": "B2N_GRAUPA",
"value": "01"
},
{
"id": "B2N_ESTCIV",
"value": "C"
},
{
"id": "B2N_SEXO",
"value": "2"
},
{
"id": "B2N_CPFUSR",
"value": "48273995496"
},
{
"id": "B2N_DRGUSR",
"value": "446430211"
},
{
"id": "B2N_ORGEM",
"value": "SSP"
},
{
"id": "B2N_RGEST",
"value": "SP"
},
{
"id": "B2N_CEPUSR",
"value": "57490000"
},
{
"id": "B2N_ENDERE",
"value": "TESTE"
},
{
"id": "B2N_NR_END",
"value": "1140"
},
{
"id": "B2N_COMEND",
"value": "APTO 22"
},
{
"id": "B2N_BAIRRO",
"value": "CENTRO SUL"
},
{
"id": "B2N_EMAIL",
"value": "[email protected]"
},
{
"id": "B2N_CODMUN",
"value": "2700102"
},
{
"id": "B2N_MUNICI",
"value": "AGUA BRANCA"
},
{
"id": "B2N_ESTADO",
"value": "AL"
},
{
"id": "B2N_TELEFO",
"value": "21993595175"
},
{
"id": "B2N_DDD",
"value": "021"
},
{
"id": "B2N_MAE",
"value": "MAE DO BENEFICIARIO TITULAR"
},
{
"id": "B2N_PAI",
"value": "PAI DO BENEFICIARIO TITULAR"
},
{
"id": "B2N_CODSEQ",
"value": "000350"
},
{
"id": "B2N_CODEMP",
"value": "1008"
},
{
"id": "B2N_CONEMP",
"value": "000000000001"
},
{
"id": "B2N_SUBCON",
"value": "000000004"
},
{
"id": "B2N_CODPRO",
"value": "0001"
}
]
},
{
"id": 2,
"deleted": 0,
"fields": [
{
"id": "B2N_FILIAL",
"value": "M SP"
},
{
"id": "B2N_PROTOC",
"value": "000779"
},
{
"id": "B2N_NOMUSR",
"value": "BENEFICIARIO DEPENDENTE"
},
{
"id": "B2N_FLGCTR",
"value": "0"
},
{
"id": "B2N_TIPUSU",
"value": "D"
},
{
"id": "B2N_DATNAS",
"value": "19750217"
},
{
"id": "B2N_GRAUPA",
"value": "03"
},
{
"id": "B2N_ESTCIV",
"value": "C"
},
{
"id": "B2N_SEXO",
"value": "1"
},
{
"id": "B2N_CPFUSR",
"value": "89631553663"
},
{
"id": "B2N_DRGUSR",
"value": "490643784"
},
{
"id": "B2N_ORGEM",
"value": "SSP"
},
{
"id": "B2N_RGEST",
"value": "SP"
},
{
"id": "B2N_CEPUSR",
"value": "57490000"
},
{
"id": "B2N_ENDERE",
"value": "RUA DE ALAGOAS"
},
{
"id": "B2N_NR_END",
"value": "1140"
},
{
"id": "B2N_COMEND",
"value": "APTO 52"
},
{
"id": "B2N_BAIRRO",
"value": "CENTRO SUL"
},
{
"id": "B2N_EMAIL",
"value": "[email protected]"
},
{
"id": "B2N_CODMUN",
"value": "2700102"
},
{
"id": "B2N_MUNICI",
"value": "AGUA BRANCA"
},
{
"id": "B2N_ESTADO",
"value": "AL"
},
{
"id": "B2N_TELEFO",
"value": "81993910031"
},
{
"id": "B2N_DDD",
"value": "081"
},
{
"id": "B2N_MAE",
"value": "MAE DO DEPENDENTE"
},
{
"id": "B2N_PAI",
"value": "PAI DO DEPENDENTE"
},
{
"id": "B2N_CODSEQ",
"value": "000351"
},
{
"id": "B2N_CODEMP",
"value": "1008"
},
{
"id": "B2N_CONEMP",
"value": "000000000001"
},
{
"id": "B2N_SUBCON",
"value": "000000004"
},
{
"id": "B2N_CODPRO",
"value": "0001"
}
]
}
]
},
{
"id": "DETAILANEXO",
"modeltype": "GRID",
"optional": 1,
"struct": [
{
"id": "CODSEQ",
"order": 1
},
{
"id": "DIRECTORY",
"order": 2
},
{
"id": "FILENAME",
"order": 3
}
],
"items": [
{
"id": 1,
"deleted": 0,
"fields": [
{
"id": "CODSEQ",
"value": "000779"
},
{
"id": "DIRECTORY",
"value": "COMPROVANTE_TESTE.PNG"
},
{
"id": "FILENAME",
"value": "COMPROVANTE_TESTE"
}
]
}
]
}
]
}
]
} |
...
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"errorCode": 400,
"errorMessage": "\r\n --- Erro no Modelo ---\r\nId submodelo origem:[DETAILB2N]\r\nId campo origem:[VLDDATA_POST]\r\nId submodelo erro: [DETAILB2N]\r\nId campo erro: []\r\nId erro: [VALID ]\r\nMensagem de erro: [ O campo (B2N_NOMUSR) não foi preenchido.[Item: 1]]\r\nMensagem da solução: [\r\n]\r\nValor atribuído: []\r\nValor anterior: []\r\n"
} |
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"id":"PLIncBenModel",
"operation":3,
"models":[
{
"id":"MASTERBBA",
"modeltype":"FIELDS",
"fields":[
{
"id":"BBA_MATRIC",
"order":1,
"value":"00011008000019017"
}
],
"models":[
{
"id":"DETAILB2N",
"modeltype":"GRID",
"items":[
{
"id":1,
"deleted":0,
"fields":[
{
"id":"B2N_NOMUSR",
"value":"BENEFICIARIO DEPENDENTE"
},
{
"id":"B2N_DATNAS",
"value":"19750217"
},
{
"id":"B2N_GRAUPA",
"value":"03"
},
{
"id":"B2N_ESTCIV",
"value":"C"
},
{
"id":"B2N_SEXO",
"value":"1"
},
{
"id":"B2N_CPFUSR",
"value":"89631553663"
},
{
"id":"B2N_DRGUSR",
"value":"490643784"
},
{
"id":"B2N_ORGEM",
"value":"SSP"
},
{
"id":"B2N_RGEST",
"value":"SP"
},
{
"id":"B2N_CEPUSR",
"value":"57490000"
},
{
"id":"B2N_ENDERE",
"value":"RUA DE ALAGOAS"
},
{
"id":"B2N_NR_END",
"value":"1140"
},
{
"id":"B2N_COMEND",
"value":"APTO 52"
},
{
"id":"B2N_BAIRRO",
"value":"CENTRO SUL"
},
{
"id":"B2N_EMAIL",
"value":"[email protected]"
},
{
"id":"B2N_CODMUN",
"value":"2700102"
},
{
"id":"B2N_MUNICI",
"value":"AGUA BRANCA"
},
{
"id":"B2N_ESTADO",
"value":"AL"
},
{
"id":"B2N_TELEFO",
"value":"81993910031"
},
{
"id":"B2N_DDD",
"value":"081"
},
{
"id":"B2N_MAE",
"value":"MAE DO DEPENDENTE"
},
{
"id":"B2N_PAI",
"value":"PAI DO DEPENDENTE"
},
{
"id":"B2N_CODPRO",
"value":"0001"
}
]
}
]
},
{
"id": "DETAILANEXO",
"modeltype": "GRID",
"items": [
{
"id": 1,
"deleted": 0,
"fields": [
{
"id": "DIRECTORY",
"value": "https://centraldeatendimento.totvs.com/hc/article_attachments/360027449931/mceclip2.png"
},
{
"id": "FILENAME",
"value": "COMPROVANTE_TESTE_01"
}
]
}
]
}
]
}
]
} | ||||||||||
| Bloco de código | ||||||||||
| ||||||||||
{ "errorCode": 400, "errorMessage": "\r\n --- Erro no Modelo ---\r\nId submodelo origem:[DETAILB2N]\r\nId campo origem:[VLDDATA_POST]\r\nId submodelo erro: [DETAILB2N]\r\nId campo erro: []\r\nId erro: [VALID} ] ]\r\nMensagem de erro: [} O campo (B2N_NOMUSR) não foi preenchido.[Item: 1]]\r\nMensagem da solução: [\r\n]\r\nValor atribuído: []\r\nValor anterior: []\r\n"] } ] } |
PUT API
...
Endpoint
Url | Método | Header Content-Type | Descrição |
|---|---|---|---|
https://<url>:<porta>/rest/fwmodel/PLINCBENMODELPLIncBenModel/[pk] | PUT | application/json | Realiza a alteração de um protocolo de inclusão já existente na analise de beneficiários. (Somente os protocolos que não foram analisados ou finalizados poderão ser alterados) |
Parâmetro <PK> obtido através dos métodos POST ou GET.
Parâmetros de Entrada do Método
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| pk | Sim | Caracter | Valor da chave primaria do alias do modelo em encodado em base64. |
Exemplo
O JSON de envio do PUT é o mesmo realizado no POST, o que irá mudar é o atributo operation com o valor 4 e o valor dos campos que irá irão ser alteradoalterados.
O retorno da API será o mesmo do POST. Caso realizado a alteração com sucesso, será retornado o protocolo como se tivesse realizado um GET com a pk correspondente ao protocolo. Caso ocorra alguma validação será apresentada a critica.
DELETE API
...
Endpoint
Url | Método | Header Content-Type | Descrição |
|---|---|---|---|
https://<url>:<porta>/rest/fwmodel/PLINCBENMODELPLIncBenModel/[pk] | DELETE | application/json | Realiza a deleção exclusão de um protocolo já existente na analise de beneficiários. (Somente os protocolos que não foram analisados ou finalizados poderão ser excluídos). |
Parâmetro <PK> obtido através dos métodos POST ou GET.
Parâmetros de Entrada do Método
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| pk | Sim | Caracter | Valor da chave primaria do alias do modelo em encodado em base64. |
Exemplo
O JSON de envio do DELETE é o mesmo realizado no POST ou no PUT, o que irá mudar é o atributo operation com o valor 5.
...
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"errorCode": 400,
"errorMessage": "\r\n --- Erro no Modelo ---\r\nId submodelo origem:[]\r\nId campo origem:[]\r\nId submodelo erro: [PLIncBenModel]\r\nId campo erro: []\r\nId erro: [VALID ]\r\nMensagem de erro: [ Não é permitido excluir ou alterar protocolo de solicitação quando estiver em analise ou finalizado.]\r\nMensagem da soluçãoo: [\r\n]\r\nValor atribuído: []\r\nValor anterior: []\r\n"
} |
03. TELA API PLINCBENMODEL
Outras Ações / Ações relacionadas
| Ação | Descrição |
|---|---|
| Não se aplica | Não se aplica. |
04. TELA API PLINCBENMODEL
Principais Campos e Parâmetros
| Campo | Descrição |
|---|---|
| MV_PLLAYIN | Define Layout Genérico Web que estará vinculado a API de inclusão de Beneficiário para Analise. |
| BBA_MATRIC | Matricula do Titular ou responsável familiar quando for realizada a inclusão de dependentes na família, quando realizada a inclusão de uma nova família essa campo não deverá ser preenchido |
| MV_PLURDOW | Diretório web para salvar os arquivos recebidos via API do produto TOTVS Saúde Planos. |
05. TABELAS UTILIZADAS
- BBA - Cabeçalho Solic. Beneficiarios
- B2N - Inclusão de Beneficiários
- BA1 - Cadastro de Beneficiários
- BA3 - Família
- BRP - Graus de Parentesco
- SA6 - Bancos
- BC9 - CEPs
- BID - Municípios
- B90 - Layout Pag. Web
- B91 - Campos Layout
- ACB - Bancos de Conhecimentos
- AC9 - Relação de Objetos x Entidades
- BG9 - Grupos Empresas
- BQC - Subcontrato
- BT6 - Empresa Contrato Produto
- BI3 - Produtos de Saúde
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas