Árvore de páginas

Versões comparadas

Chave

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

...

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

protocoloSimCaracterProtocolo da Atualização Cadastral, será gravado no campo BBA_NROPRO da Analise de Beneficiários
id_operadoraSimNumericoCaracterID da Operadora na Mobile Saúde
mshashSimCaracterHASH que identifica de qual ambiente (Homologação ou Produção) os dados serão buscados na Mobile Saúde.
tipoNãoCaracterTipo de beneficiário a que as informações se referem, conforme seu grau de dependência (t =Titular, d = Dependente, a = Agregado).
nomeSimCaracterNome do Beneficiário
matriculaSimCaracterMatricula do Beneficiários (Operadora + Empresa + Matricula + Tipo Registro + Digito)
matricula_titularSimCaracterMatricula do Títular do Plano (Operadora + Empresa + Matricula + Tipo Registro + Digito)
camposSimArrayLista de Objetos
idSimCaracterID do campo na Mobile Saúde
labelSimCaracterLabel da opção preenchida ou selecionada pelo usuário na Mobile Saúde
nameSimCaracterNome do Campo na Mobile Saúde
valueSimNãoCaracterValor do Campo

Exemplo

Bloco de código
languagec#
themeMidnight
titleRequest body
linenumberstrue
collapsetrue
{
   "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
languagec#
themeMidnight
titleRetorno API - Falha
linenumberstrue
collapsetrue
{
    "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]"
}

...

CampoDescrição

BA0_MSURST

Informe o Endpoint da API de atualização de status do protocolo de alteração cadastral
BBA_IDOPERID da Operadora na Mobile Saúde
BBA_MSHASHHASH que identifica de qual ambiente (Homologação ou Produção)
MV_PLURDOWDiretó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

...