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 Coletar Dados
  6. Classe para Comunicar
  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:

CampoDescriçãoValidação
OperadoraOperadora do SistemaVerifica se a Operadora existe no cadastro BA0
Cod. IntegraçãoCódigo Incremental das Integrações
DescriçãoDescrição da Integração
Alias PrimárioTabela que será usada como principal para buscar registrosVerifica se a tabela informada existe no dicionário de dados
Chave AliasChave de busca da tabela primária, campos deveram ser informados separados por: +Verifica se os campos informados existem no dicionário de dados e pertence a tabela informada
Alias Secundários Tabelas segundarias para verificar se houve alteração, Tabelas separadas por: /Verifica se as tabelas informadas existem no dicionário de dados
EndPointEndereço de comunicação da API da HealthMap para a integração
AtivoSe a integração está ativa ou não.
Tent. EnvioTentativas de Envio, caso não consiga se comunicar com API.

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:

CampoDescrição
OperadoraOperadora do Sistema
Cod. IntegraçãoCódigo de relacionamento com a tabela de Integrações
Cod. PedidoCódigo Incremental dos Pedidos
AliasTabela chave do pedido para ser utilizado na busca de dados
ChaveChave de busca do Alias para posicionar nos registros
Dt. InclusãoData de Inclusão do Pedido
Dt. ComunicaçãoData em que foi realizado a comunicação com a HealthMap
StatusStatus do Pedido: 0-Pendente de Envio; 1-Envio Realizado; 2-Erro de Envio; 3-Envio Cancelado
Tent. EnvioTentativas de Comunicação com o HealthMap
Json EnvioJSON enviado para o HealthMap


05. CLASSE PARA COLETAR DADOS


06. CLASSE PARA COMUNICAR


07. TABELAS UTILIZADAS