Histórico da Página
...
Para utilização do método é necessário realizar o de/para da Mobile Saúde com o TOTVS Saúde Planos Linha Protheus, através da rotina De/Para de Integrações (PLIntegDePara), esse cadastro ficará por padrão a partir da release 12.1.2210 na pasta: Atualizações > Integrações > De/Para Integrações (Documentação da Rotina: EM CONSTRUÇÃO)
Segue um exemplo do cadastro de de/para:
...
- Cadastro de De/para Normal: O campo externo é o conteúdo do atributo do JSON (campos.name) referente a Mobile Saúde, o campo interno é o campo cadastrado no Layout Genérico (Será sempre campos da tabela BA1), o tipo deverá ser igual a 0 - Campo.
- Cadastro de De/para de Arquivos para Download: O campo externo é o conteúdo do atributo do JSON (campos.name) referente a Mobile Saúde, não precisa informar o campo interno, é necessário colocar o Valor URL igual a 1 - Sim
- Cadastro de De/para de Valores: O campo externo é o conteúdo do atributo do JSON (campos.name) referente a Mobile Saúde, o campo interno é o campo cadastrado no Layout Genérico (Será sempre campos da tabela BA1), o tipo deverá ser igual a 1 - Campo, o valor externo é o conteúdo correspondente a Mobile Saúde e o valor interno é o conteúdo correspondendo a Protheus. Nesse caso, o status da Mobile 0 corresponde ao status 1 do Protocolo de Alteração (BBA_STATUS).
Para facilitar a implantação foi criado o CSV para importar os de/para da mobile automaticamente via Wizard: b7v-de_para_integracoes.csv
O método utiliza o layout genérico Web, portanto é necessário ter cadastrado o Layout PPLALTBEN para que o sistema valide os dados da API com base no Layout, será feita as seguintes validações:
- Se o campo encontra-se no Layout
- Se o campo está ativo (B91_VISUAL)Se o campo permite edição (B91_EDITAR)
Caso os dados informados na API sejam validados, o sistema irá gravar um novo protocolo na Analise de Beneficiários para o tipo Alteração. Além disso será verificado se os campos informados no protocolo estão configurados no Layout para aprovar automaticamente ou passar por analise.
Esse Essa configuração é realizada na Configuração Complementar (B2C) do Layout Genérico, informando a variável VALIDA e o valor .T., o campo irá passar por analise e não informando variável VALIDA, será feita a atualização automática dos dados no cadastro do beneficiário (BA1). Para mais informações sobre o cadastro do Layout Genérico Web, acessem esse link: Layout Genérico Web - PLSCADLAY
...
Parâmetro | Obrigatório | Tipo | Descrição |
---|---|---|---|
protocolo | Sim | Caracter | Protocolo da Atualização Cadastral, será gravado no campo BBA_NROPRO da Analise de Beneficiários |
id_operadora | Sim | NumericoCaracter | ID da Operadora na Mobile Saúde |
mshash | Sim | Caracter | HASH que identifica de qual ambiente (Homologação ou Produção) os dados serão buscados na Mobile Saúde. |
tipo | Não | Caracter | Tipo de beneficiário a que as informações se referem, conforme seu grau de dependência (t =Titular, d = Dependente, a = Agregado). |
nome | Sim | Caracter | Nome do Beneficiário |
matricula | Sim | Caracter | Matricula do Beneficiários (Operadora + Empresa + Matricula + Tipo Registro + Digito) |
matricula_titular | Sim | Caracter | Matricula do Títular do Plano (Operadora + Empresa + Matricula + Tipo Registro + Digito) |
campos | Sim | Array | Lista de Objetos |
id | Sim | Caracter | ID do campo na Mobile Saúde |
label | Sim | Caracter | Label da opção preenchida ou selecionada pelo usuário na Mobile Saúde |
name | Sim | Caracter | Nome do Campo na Mobile Saúde |
value | SimNão | Caracter | Valor do Campo |
Exemplo
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{ "protocolo":"41750520220318145554", "id_operadora":"1", "mshash":"ZDhkNjY0MDY3NTgwMTg0Y2I4ZWE3ZmZiZGEyNDM0NmMwZDI0YmQwYw==", "tipo":"", "nome":"SEBASTIAO CARLOS FELIPE MELO", "matricula":"00011008000007035", "matricula_titular":"00011008000007035", "campos":[ { "id":"10", "label":"bairro", "name":"atualizacao_cadastral_bairro", "value":"Centro" }, { "id":"11", "label":"endereco", "name":"atualizacao_cadastral_endereco", "value":"Rua Teste" }, { "id":"11", "label":"endereco", "name":"atualizacao_cadastral_comprovante_de_endereco", "value":"https://centraldeatendimento.totvs.com/hc/article_attachments/360027449931/mceclip2.png" } ] } |
...
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"timestamp": "2022-03-21T17:23:15-03:00",
"data": [],
"status": false,
"critica": [
{
"cod": 0,
"trace": "",
"origem": "/mobileSaude/submit_formulario",
"descricao": " Protocolo informado já existente no sistema. [41750520220318145551]"
}
],
"msg": "Protocolo informado já existente no sistema. [41750520220318145551]"
} |
...
Campo | Descrição |
---|---|
BA0_MSURST | Informe o Endpoint da API de atualização de status do protocolo de alteração cadastral |
BBA_IDOPER | ID da Operadora na Mobile Saúde |
BBA_MSHASH | HASH que identifica de qual ambiente (Homologação ou Produção) |
MV_PLURDOW | Diretório web para salvar os arquivos recebidos via API do produto TOTVS Saúde Planos. |
05. TABELAS UTILIZADAS
- BBA - Cabeçalho da Solicitação de Beneficiários
- B7L - Itens das Alterações Solicitadas
- BA0 - Cadastro de Operadoras
- B90 - Layout Genérico Web
- B7C - Grupos de Campos do Layout Genérico Web
- B91 - Campos do Layout Genérico Web
- B2C - Configurações dos Campos do Layout Genérico Web
- BA1 - Cadastro de Beneficiários
- B7V - Cadastro de De/para de Integrações
...