Á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 PLMapJsBenefPLMapStpBenef 
    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))

...

Campo

Ação

Alias Prima.Preencher BA1
EndPointSolicita Solicitar pra HealthMap o Endpoint da Api de Beneficiarios
Classe STAMPPreencher PLMapStpBenef
Classe Comu.Preencher PLMapJsBenef
Login Auten.Login de acesso da HealthMap
Senha Auten.

Senha de acesso da HealthMap

EndPoint Aut.Solicita Solicitar pra HealthMap o Endpoint da Api de Token
Perg. GerarPreencher PLR660PLRMPEMP

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

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).

04. CLASSE PLMAPSTPBENEF

...

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