Histórico da Página
CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Layout Genérico Web
- Get API
- Post API
- Put API
- Delete API
- Tela API PLIncBenModel Tela XXX
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela XXXAPI PLIncBenModel
- 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 api irá utilizar as configurações contidas nessa layout genérico.
Pelo Layout o sistema irá utilizar as seguintes regras no modelo de dados para inclusão de beneficiários:
- Se o campos da tabela B2N Campos que não permite edição: B91_EDITAR igual a .F.
- Inicializador padrão dos campos da tabela B2N: : B91_INIPAD com expressão em advpl para inicializar o campo.
- Validação dos campos: B91_VALID com expressão em advpl para validar o campo.
- Campos obrigatórios: B91_OBRIGA igual a .T.
Caso o parâmetro esteja em branco, o sistema irá seguir com as regra do padrão.
| Informações | ||
|---|---|---|
| ||
| O Layout utilizado na API, deverá utilizar exclusivamente a tabela B2N. |
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,
},
{ "value":"000001"
"id": "PLAltBenModel" },
{
"operation": 1,
"pkid": "TSBTUCAgICAwMDAwMDM=BBA_LOJA",
"models "order": [
25,
{
"value":"01"
}
"id": "MASTERBBA", ]
}
"modeltype": "FIELDS",
]
},
"fields": [{
"id": "PLAltBenModel",
{
"operation": 1,
"pk": "TSBTUCAgICAwMDAwMDM=",
"idmodels": "BBA_FILIAL",[
{
"order": 1,
"id": "MASTERBBA",
"valuemodeltype": "M SPFIELDS",
},"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:"20220310"
},
{
"id": "BBA_HORSOL",
"order": 16,
"value": "08:46"
},
{
"id": "BBA_NROPRO",
"order": 18,
"value": "41750520220310000003"
},
{
"id": "BBA_TIPMAN",
"order": 19,
"value": "2"
},
{
"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. | B2N|||||
| 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 | Nome do Beneficiário | B2N_DATNAS | Sim | Caracter | Data deNascimento 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"
}
]
}
]
}
]
}
]
} |
Exemplo de inclusão de um dependente em uma família já existente:
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"iderrorCode":"PLIncBenModel" 400,
"operationerrorMessage":3,
"models":[
{
"id":"MASTERBBA",
"\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":[ "modeltype":"FIELDS", "fields":[ { "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" } ] } ] } ] } ] } |
PUT API
...
Endpoint
...
Url |
|---|
...
{
"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"
}Método | Header Content-Type | Descrição |
|---|---|---|
https: |
PUT API PLINCBENMODEL
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
...
[]\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
04. TELA API PLINCBENMODEL
Principais Campos e Parâmetros
...
| Card documentos | ||||
|---|---|---|---|---|
|
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas