Á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

Porém o de/para de status precisa ser incluído manualmente, conforme tabela abaixo:

B7V_REFEREB7V_EXCAMPB7V_INCAMPB7V_TIPOB7V_EXVALOB7V_INVALOB7V_URLVALB7V_ATIVO
PMOBATUCADMOD       statusBBA_STATUS101
1
PMOBATUCADMOD       statusBBA_STATUS102
1
PMOBATUCADMOD       statusBBA_STATUS113
1
PMOBATUCADMOD       statusBBA_STATUS114
1
PMOBATUCADMOD       statusBBA_STATUS125
1
PMOBATUCADMOD       statusBBA_STATUS116
1
PMOBATUCADMOD       statusBBA_STATUS117
1


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]"
}

...

Também é possível atualizar o status do protocolo através do botão Outras Ações > Atualizar Status da Rotina de Analise de beneficiários.

Endpoint

Url

Método

Header Content-Type

Descrição

Endpoint informado no cadastro da Operadora > Aba Mobile Saúde > Campo URL Status (BA0_MSURST) POSTapplication/jsonAtualização dos protocolos solicitados pelos beneficiários na base da Mobile Saúde.

Parâmetros de Entrada do Método

Parâmetro

Obrigatório

Tipo

Descrição

id_operadoraSimCaracterID da Operadora na Mobile Saúde, será enviado o campo BBA_IDOPER
mshashSimCaracterHASH que identifica de qual ambiente (Homologação ou Produção) na Mobile Sáude, será enviado o campo BBA_MSHASH.
matriculaSimCaracterMatricula do Beneficiários (Operadora + Empresa + Matricula + Tipo Registro + Digito) no protocolo de Analise de beneficiários.
protocoloSimCaracterProtocolo da Atualização Cadastral, será enviado o campo BBA_NROPRO da Analise de Beneficiários.
statusSimCaracterStatus do protocolo, será feito o De/para do BBA_STATUS com o status da Mobile Saúde cadastrado na tabela B7V. 
observacaoNãoCaracterObservação informada no campo BBA_OBSERV do protocolo.


Veja um exemplo de como a comunicação com a API é feita na prática: 

Image Added

03. TELA ATUALIZAÇÃO CADASTRAL

...

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

...