Árvore de páginas

Versões comparadas

Chave

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

...

  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 Integração tem o objetivo de enviar os beneficiários cadastradas no produto TOTVS Saúde Planos Linha Protheus para a HealthMap utilizando a rotina de Integrações (Integrações TOTVS Saúde Planos Linha Protheus (SIGAPLS))

...

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

Image Added

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:

Atributo HealthMap

Campo Protheus

Tipo

codigoExternoBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITOCaracter
codigoExternoEmpresaBA1_CODEMPCaracter
codigoExternoGestor(Vazio)Caracter
codigoExternoTitularPara o Titular será Vazio, para o dependente será a chave do titular: BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITOCaracter
codigoParentescoPara o Titular será Vazio, para o dependente será BA1_GRAUPACaracter
codigosProfSaudeRef(Vazio)Array
dataNascimentoBA1_DATNASCaracter - Formato DD/MM/AAAA
docIdentificacao(Vazio)Caracter
emailBA1_EMAILCaracter
enderecoBairroBA1_BAIRROCaracter
enderecoCepBA1_CEPUSRCaracter
enderecoCodigoIbgeCidadeBA1_CODMUNCaracter
enderecoDescricaoBA1_ENDERE+","+BA1_NR_END+","+BA1_COMENDCaracter
enderecoNomeCidadeBA1_MUNICICaracter
enderecoUfBA1_ESTADOCaracter
listaCarteirinhasRegistros da Tabela BED do BeneficiárioArray
codigoConvenioBA3_CODPLA+BA3_VERSAOCaracter
dataValidadeBED_DATVALCaracter - Formato DD/MM/AAAA
numeroCarteiraBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITOCaracter
listaContratante
Array
codigoContratanteBA0_CODIDE+BA0_CODINT

Para Pessoa Jurídica:
BQC_CODINT+BQC_CODEMP+BQC_NUMCON+BQC_VERCON+BQC_SUBCON+BQC_VERSUB
Para Pessoa Física:
BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO (Matricula do Titular)

Caracter
codigoModalidadePagamentoBA3_MODPAGCaracter
nomeContratantePara Pessoa Jurídica:
BQC_DESCRI
Para Pessoa Física:
BA1_NOMUSR (Nome do Titular)BA0_NOMINT
Caracter
loginBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITOCaracter
modalidade"H"Caracter
nomeBA1_NOMUSRCaracter
nomeParentescoPara o Titular será Vazio, para o dependente será BRP_DESCRI de acordo com o BA1_GRAUPACaracter
senha(Vazio)Caracter
sexoBA1_SEXO, sendo 1 para "M" e 2 para "F"Caracter
status"A" para Ativo e  "I" para Inativo, de acordo com o BA1_DATBLOCaracter
telCelularBA1_DDD+BA1_TELEFO, se o campo BA1_TIPTEL for vazio ou 3Caracter
telComercialBA1_DDD+BA1_TELEFO, se o campo BA1_TIPTEL for 2Caracter
telResidencialBA1_DDD+BA1_TELEFO, se o campo BA1_TIPTEL for 1Caracter
titularidadeBA1_TIPUSUCaracter
listaDocumentosLista de Documentos ObrigatóriosArray
codigoDocumento"1", para CPFCaracter
numeroDocumentoBA1_CPFUSRCaracter
codigoDocumento"2", para RGCaracter
numeroDocumentoBA1_DRGUSRCaracter
codigoDocumento"3", para CNSCaracter
numeroDocumentoBA1_NRCRNACaracter
codigoDocumento"4", para IdentificadorCaracter
numeroDocumentoBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITOCaracter

Exemplo:

Bloco de código
languagec#
themeRDark
titleJSON de Envio
linenumberstrue
{
   "docIdentificacaoenderecoCep": "",
   "codigoExternoEmpresa": "1008",
   "codigoExternoGestor": "",
   "enderecoCepstatus": "05541000A",
  "listaDocumentos": "status[
    {
      "codigoDocumento": "A1",
      "enderecoDescricaonumeroDocumento":"ALBERT BARTHOLOME",
 "74827314233"
    },
	{
      "modalidadecodigoDocumento": "H2",
      "telCelularnumeroDocumento": "489494262"
    },
    "listaDocumentos":[
{
      "codigoDocumento": "3",
      "numeroDocumento": "287611986630008"
  {  },
    {
      "codigoDocumento": "4",
      "numeroDocumento": "00011008000019017"
    }
  ],
  "numeroDocumentomodalidade": "00011008000014023H",
  "titularidade": "T",
   }"telCelular": "",
   ]"docIdentificacao": "",
   "titularidadecodigoParentesco": "D",
   "nomeParentesco": "FILHO",
   "enderecoCodigoIbgeCidade": "3550308",
   "enderecoNomeCidade": "SAO PAULO",
   "enderecoUf": "SP",
   "telComercial": "",
   "dataNascimento": "0103/0309/19981988",
   "codigoExterno": "0001100800001402300011008000019017",
   "senha": "",
   "codigoExternoTitular": "00011008000014015",
   "listaCarteirinhas": [
    {
      "numeroCarteira": "00011008000019017",
      ] "dataValidade": "25/10/2023",
      "codigosProfSaudeRefcodigoConvenio":[ "0001001"
    }
  ],
  "codigosProfSaudeRef": [],
   "telResidencial": "",
   "enderecoBairro": "JARDIM DAS VERTENTES",
   "sexo": "M",
   "listaContratante": [
      {
         "codigoContratante": "000100011008000000000001001000000003001",
         "codigoModalidadePagamento": "1",
         "nomeContratante": "OPERADORASUBCONTRATO USO 417505GERAL"
      }
   ],
   "nome": "FABIOPAULO KEVINVINICIUS HENRIQUE BAPTISTABARBOSA",
   "email": "",
   "login": "0001100800001402300011008000019017",
   "codigoParentescoenderecoDescricao": "0"
}

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

Image Added

05. TABELAS UTILIZADAS

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

05. DICIONÁRIO DE DADOS

Atualização do Arquivo SX1 (Pergunte): 

GrupoOrdemPerguntaVariávelTipoTamanhoDecimalObjetoConsulta Padrão
PLRMPEMP01Grupo/Empresa De ?MV_PAR01C401 - EditB7APLS
PLRMPEMP02Grupo/Empresa Ate ?MV_PAR02C401 - EditB7APLS

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

VarTipoDescriçãoConteúdo (Default)
MV_PLDTVIRC - CaracterData de Validade da Carteirinha Virtual no Json de Beneficiários na Integração do TOTVS Saúde Planos "01/01/2100"
MV_PLCTVIRL - LógicoHabilita o Envio da Validade da Carteira Virtual para os Beneficiários no Json de Integrações.  .F.


Card documentos
InformacaoA alteração de dicionário referente a essa implementação estará disponível no próximo pacote de Expedição Contínua do módulo SIGAPLS.
TituloImportante