CONTEÚDO

1. Visão Geral
2. Cadastro da Integração
3. Classe PLMapStpBenef 
   
4. Classe PLMapJsBenef
5. Tabelas utilizadas
6. Dicionário de Dados

01. VISÃO GERAL

Essa API tem por objetivo receber dados dos beneficiários para inclusão, alteração e exclusão, e enviar dados do beneficiários utilizando as  tabelas (BA1/BA3).

Para uma boa funcionalidade do REST Protheus segue um passo a passo de como configura Documentação API TOTVS.

02. API DE INCLUSÃO/ALTERAÇÃO/EXCLUSÃO DE BENEFICIÁRIOS

A inclusão de beneficiários seguira as regras estabelecidas pela API reference TOTVS , segue a estrutura de requisição, com o preenchimento dos seguintes campos:

2.a) Inclusão.

2.b) Corpo.

A classe PLMapJsBenef, será responsável pela montagem do JSON para comunicar com a API da HealthMap. O JSON será enviado com os seguintes dados:

03. CLASSE PLMAPSTPBENEF

A Classe PLMapStpBenef será responsável por buscar alterações, inclusões e exclusões dos beneficiários nas tabelas BA3, BA1 e BTS pela coluna STAMP, para gravação dos pedidos na tela de Integrações, para posteriormente comunicar com a HealthMap. A periocidade da busca é configurada de acordo com o schedule.

Na questão do bloqueio do beneficiário, o sistema irá gravar o pedido com data em que o beneficiário será realmente bloqueado (Considerando também o parâmetro MV_PLDIABL), e esse pedido será enviado para a HealthMap somente após essa data.
Caso seja gerado pelo botão Gerar Pedidos, além de gerar o pedido programado para o bloqueio, também será gerado um outro pedido do beneficiário como ativo, ou seja, a HealthMap irá receber um pedido como ativo, e na data do bloqueio irá receber um pedido como Inativo.

Diagrama de Classes

04. CLASSE PLMAPJSBENEF

A classe PLMapJsBenef, será responsável pela montagem do JSON para comunicar com a API da HealthMap. O JSON será enviado com os seguintes dados:

Exemplo:

{
  "enderecoCep": "",
  "codigoExternoEmpresa": "1008",
  "codigoExternoGestor": "",
  "status": "A",
  "listaDocumentos": [
    {
      "codigoDocumento": "1",
      "numeroDocumento": "74827314233"
    },
	{
      "codigoDocumento": "2",
      "numeroDocumento": "489494262"
    },
    {
      "codigoDocumento": "3",
      "numeroDocumento": "287611986630008"
    },
    {
      "codigoDocumento": "4",
      "numeroDocumento": "00011008000019017"
    }
  ],
  "modalidade": "H",
  "titularidade": "T",
  "telCelular": "",
  "docIdentificacao": "",
  "codigoParentesco": "",
  "nomeParentesco": "",
  "enderecoCodigoIbgeCidade": "",
  "enderecoNomeCidade": "",
  "enderecoUf": "",
  "telComercial": "",
  "dataNascimento": "03/09/1988",
  "codigoExterno": "00011008000019017",
  "senha": "",
  "codigoExternoTitular": "",
  "listaCarteirinhas": [
    {
      "numeroCarteira": "00011008000019017",
      "dataValidade": "25/10/2023",
      "codigoConvenio": "0001001"
    }
  ],
  "codigosProfSaudeRef": [],
  "telResidencial": "",
  "enderecoBairro": "",
  "sexo": "M",
  "listaContratante": [
    {
      "codigoContratante": "00011008000000000001001000000003001",
      "codigoModalidadePagamento": "1",
      "nomeContratante": "SUBCONTRATO USO GERAL"
    }
  ],
  "nome": "PAULO VINICIUS BARBOSA",
  "email": "",
  "login": "00011008000019017",
  "enderecoDescricao": ""
}

Para alterar o JSON, poderá ser utilizado o Ponto de Entrada PLMPJSBE (DT PE Manipular JSON de Envio de Beneficiários para a HealthMap).

Diagrama de Classes

05. TABELAS UTILIZADAS

• BA1 (Cadastro dos Beneficiários)
• BA3 (Cadastro das Famílias)
• BTS (Cadastro de Vidas)
• BQC (Cadastro Subcontratos da Empresa)
  

  
  

05. DICIONÁRIO DE DADOS

Atualização do Arquivo SX1 (Pergunte): 

Atualização do Arquivo SX6 (Parâmetros):