Histórico da Página

CONTEÚDO

1. Visão Geral
2. Detalhamento
3. Tela Integrações HealthMap 
   1. Outras Ações / Pedidos HealthMap
      
4. Tela Pedidos HealthMap
   
5. Classe para Gravar os Pedidos
6. Classe para Comunicar com o HealthMap
7. Tabelas utilizadas

01. VISÃO GERAL

A integração do produto TOTVS Saúde Planos Linha Protheus e o HealthMap tem como objetivo, enviar dados dos Beneficiários e Empresas para que possam ser tratados pelos serviços utilizados na plataforma HealthMap.

A comunicação entre as partes será realizada via comunicação API REST.

02. DETALHAMENTO

O processo de integração funcionará no seguinte panorama, que serão detalhados abaixo:

1. Nova tabela (BXX), com o nome de "Integrações HealthMap", essa tabela será utilizado para cadastrar todas integrações realizadas entre o SIGAPLS e o HealthMap, até o momento as integrações que serão realizadas são: Cadastro de Beneficiários e Cadastro de Empresas.
2. Nova tabela (BZZ), com o nome de "Pedidos HealthMap", essa tabela será utilizado para guardar todos os pedidos, ou seja, dados dos beneficiário ou Empresas que serão enviados para o HealtMap.
3. Classe para processar a tabela BXX (Integrações), por exemplo: Cadastro de Beneficiários, será feito uma verificação na tabela de Beneficiários (BA1) e tabelas segundarias (BA3,BJK etc) se houver alguma alteração em alguma dessas tabelas, o sistema irá gerar um novo pedido (Tabela BZZ) com a chave de busca daquele beneficiário (Se já houver algum pedido pendente de envio para o beneficiário, não será gravado um novo pedido).
4. Classe para processar a tabela BZZ (Pedidos), será realizado a montagem do Json de envio através dos dados do pedido, buscando dados do beneficiário por exemplo, através da chave do Alias que consta no Pedido. Realizado a comunicação com a HealthMap, será gravado o status do pedido, se foi enviado com sucesso ou se houve erro no envio.

03. TELA INTEGRAÇÕES HEALTHMAP

Tela em MVC da tabela BXX (Integrações HeathMap), onde será possível incluir, alterar e excluir registro. 

(Imagem ilustrativa, alterar para imagem do produto quando desenvolvido)

Detalhes dos campos da tabela BXX:

3.a.  Outras Ações / Pedidos HealthMap

Através desse botão será visualizado os pedidos relacionados a integração posicionada na tabela BXX, a tela de pedidos será detalhada no próximo tópico. 

04. TELA PEDIDOS HEALTHMAP

Tela em MVC da tabela BZZ (Pedidos), que será acessada através do botão outras ações da tela de Integrações HealthMap. O Browser dos pedidos será filtrado de acordo com a integração posicionada, ou seja, se for acessado via Integração do cadastro de beneficiários, só será exibido os pedidos relacionados ao cadastro de beneficiários na tabela BZZ e assim também para o cadastro de Empresas.

Aberto o Browser dos pedidos, no menu terá a opção de Alterar, Visualizar, Excluir, Cancelar e Comunicar (Inclusão será feita somente via Classe de Coleta de Dados):

1. Comunicar Pedido: Será feito o envio manual do Pedido para a HealthMap.
2. Cancelar Pedido: Será alterado o status do pedido para 3-Envio Cancelado.
3. Alterar/Visualizar Pedido: A tela irá mostrar os dados do pedido, além dos dados da integração, somente para visualização. (Alteração da tabela BXX somente pela tela de Integrações HealthMap como mostrado no tópico 3)

(Imagem ilustrativa, alterar para imagem do produto quando desenvolvido)

Detalhes dos Campos da tabela BZZ:

05. CLASSE PARA GRAVAR OS PEDIDOS 

A classe PLMapGrvPed, irá verificar as integração da HealthMap (Tabela BXX) se os Alias relacionados ao Cadastro de Beneficiários ou Empresa tiveram alguma alteração de acordo com o campo S_T_A_M_P_ das tabelas. Se houver alteração, será feito uma busca na tabela de pedido (BZZ) pelos campos: Cod. Integração + Alias Primário + Chave (Corresponde os dados que identificam o Beneficiário ou Empresa), para saber se tem algum pedido daquele Beneficiário ou Empresa pendente para não haver duplicidade de envio de dados.

Essa Classe possuirá alguns métodos como: 

• Método para receber as configurações da tabela de Integração da HealthMap (Tabela BXX)
• Método para buscar via Query os beneficiários ou Empresas que tiveram alteração de acordo com o S_T_A_M_P_, retornado somente os dados da chave do alias primário configurado para Beneficiário ou Empresa.
• Método para verificar se o Alias Primário + Chave já constam pedido em aberto.
• Método para gravar o pedido (Tabela BZZ) com o Alias Primário + Chave de cada Beneficiário ou Empresa encontrado com alteração.
  
  

Será criado um schedule, onde poderá ser configurado a quantidade de vezes em que a classe PLMapGrvPed, irá buscar e gravar os pedidos de acordo com as integrações. 

06. CLASSE PARA COMUNICAR COM O HEALTHMAP

Criado os pedidos, será feito a comunicação com a HealthMap pela Classe PLMapComPed, que herda métodos da classe PLSRest.

Mas antes de comunicar, será feito a montagem do json de cada pedido através da classe PLMapBenef para o Cadastro de Beneficiários e PLMapEmpre para o Cadastro de Empresas.

Essas classe de montagem do Json possuirá alguns métodos como: 

• Método para posicionar nas tabelas necessárias para montagem do Json, atráves da chave do alias primário.
• Método para montagem do Json de acordo com a documentação de layout da HealthMap de cada Integração.

Caso possua métodos em comum para montagem do Json, será criado a classe PLMapJson (se necessário)
Feito a montagem do Json, será instanciado a classe de comunicação para envio do Json para a HealthMap. 

A Classe de comunicação PLMapComPed possuirá alguns métodos como:

• Método para atualizar status do pedido, se foi enviado com sucesso ou ocorreu erro de envio.
• Método para autenticação com o HealthMap.
• Método para configurar da comunicação.

Será criado um schedule, onde poderá ser configurado a quantidade de vezes em que a classe PLMapComPed, irá realizar o envio dos pedidos pendentes para a HealthMap.

07. TABELAS UTILIZADAS

• BXX (Integrações HealthMap)
• BZZ (Pedidos HealthMap)
• BA1 (Cadastro dos Beneficiários)
• BA3 (Cadastro das Famílias)
  Necessário adicionar as tabelas utilizadas no desenvolvimento