Histórico da Página

CONTEÚDO

Visão Geral
Detalhamento
Tela Integrações
Tela Pedidos da Integração
1. Comunicar
Schedules
1. Gravar Pedidos
2. Comunicar Pedidos
Tabelas Utilizadas
Dicionário de Dados

01. VISÃO GERAL Âncora
VIS
VIS

A integração do produto TOTVS Saúde Planos Linha Protheus tem como objetivo, enviar dados do sistema para que possam ser tratados pelos serviços utilizados nos sistemas parceiros da TOTVS.

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

02. DETALHAMENTO Âncora
DET
DET

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

A tabela de Integrações (B7E), será utilizada para cadastrar todas integrações realizadas entre o Protheus e o sistema parceiro, até o momento as integrações que estão homologadas são:
1. Cadastro de Beneficiários.
2. Cadastro de Empresas.
A tabela de Pedidos da Integração (B7F), será utilizada para guardar todos os pedidos a serem enviados, já enviados ou com problema de envio para cada integração cadastrada.
A Carga dos pedidos da integração para envio, será feita manualmente através do botão Gerar Pedidos da Tela de Integrações ou via schedule (O processo de schedule será apresentado no tópico 5).
A comunicação será feita manualmente através do botão Comunicar da Tela de Pedidos da Integração, ou poderá ser feita uma comunicação de todos os pedidos pendentes de envio de cada integração, pelo botão Comunicar Pedidos da tela de Integrações. A comunicação também será feita via schedule (O processo de schedule será apresentado no tópico 5).

03. TELA INTEGRAÇÕES Âncora
INT
INT

Ao acessar a rotina de Integrações (PLMapIntegra), será mostrado o browser com todas as Integrações cadastrada, a tela de inclusão terá os seguintes campos a serem preenchidos:

...

Campo	Descrição	Preenchimento
Operadora	Código da Operadora do sistema.	Obrigatório.
Codigo Integ.	Código Incremental das Integrações.	Preenchimento automático, não editável .
Descrição	Descrição da Integração.	Obrigatório.
Alias Prima.	Tabela do cadastro que será utilizada para envio.	Obrigatório, essa tabela será detalhado o preenchimento no próximo tópico.
EndPoint	Endereço de comunicação da API do sistema parceiro.	Opcional no cadastro, mas necessário para comunicação dos pedidos.
Ativo	Definição se a Integração está ativa, essa informação é usada em alguns processos do sistema.	Obrigatório.
Máximo Envio	Quantidade máxima de tentativas de comunicação para cancelar o pedido, caso não tenha sucesso.	Obrigatório.
Classe Stamp	Classe do sistema que será utilizada para gravar os pedidos via schedule.	Opcional no cadastro, mas necessário para realizar a gravação dos pedidos via schedule, será detalhado o preenchimento no próximo tópico.
Classe Comu.	Classe do sistema que será utilizada para montagem do json da integração, além da comunicação.	Opcional no cadastro, mas necessário para a comunicação dos pedidos, será detalhado o preenchimento no próximo tópico.
Login Auten.	Login para autenticar no sistema parceiro da Integração.	Opcional no cadastro, mas necessário para comunicação dos pedidos.
Senha Auten.	Senha para autenticar no sistema parceiro da Integração.	Opcional no cadastro, mas necessário para comunicação dos pedidos.
EndPoint Aut	Endereço de comunicação da API de Autenticação do sistema parceiro.	Opcional no cadastro, mas necessário para comunicação dos pedidos.
Bearer Aut.	Bearer utilizado pelo sistema para autenticação na API do sistema parceiro.	Não editável, o sistema utiliza esse campo para controle interno ao realizar a comunicação.
Cookie Aut.	Cookie utilizado pelo sistema para autenticação na API do sistema parceiro.	Não editável, o sistema utiliza esse campo para controle interno ao realizar a comunicação.
Tempo Expe.	Tempo de Expiração do Bearer e Cookie.	Não editável, o sistema utiliza esse campo para controle interno ao realizar a comunicação.
Perg. Gerar	Pergunte (SX1) do sistema para gerar os pedidos	Opcional no cadastro, mas necessário no botão Gerar Pedidos, esse pergunte será para os filtros da geração, será detalhado o preenchimento no próximo tópico.

a. INTEGRAÇÕES DISPONÍVEIS Âncora
INTDIS
INTDIS

As Integrações disponíveis para cadastrar são:

Integração	Sistema Parceiro	Alias Prima.	Classe Stamp	Classe Comu.	Perg. Gerar	Documentação
Cadastro de Empresas	HealthMap	BG9	PLMapStpEmpre	PLMapJsEmpre	PLRMPEMP	Integração do Cadastro de Empresas com a HealthMap
Cadastro de Beneficiários	HealthMap	BA1	PLMapStpBenef	PLMapJsBenef	PLRMPEMP	Integração do Cadastro de Beneficiários com a HealthMap
Aviso de Internação	HealthMap	BE4	PLMapStpInter	PLMapJsInter	PLRMPINTER	Integração do Aviso de Internações com a HealthMap
Aviso de Pronto Socorro	HealthMap	BEA	PLMapStpSocor	PLMapJsSocor	PLRMPSOCOR	Integração do Aviso de Pronto Socorro com a HealthMap
Pré-Cadastro de Beneficiário	Unimed	BA1	PLPtuStpPCad	PLPtuJsPCad	PLPTUCADBE	Integração do Pré-Cadastro de Beneficiários com a Unimed

Essas são informações a serem preenchidas no cadastro da Integração para cada sistema parceiro.

b. OUTRAS AÇÕES / CONSULTAR PEDIDOS Âncora
INTCON
INTCON

Através dessa opção, será possível visualizar os pedidos da Integração posicionada, ao clicar será aberto um outro browser com os pedidos.

c. OUTRAS AÇÕES / COMUNICAR PEDIDOS Âncora
INTCOM
INTCOM

Através dessa opção, será possível realizar a comunicação de todos os pedidos, com o status pendente de envio e erro de envio da Integração posicionada. Ao clicar, o sistema irá perguntar:

Finalizado o processo, será apresentado um resumo da comunicação:

d. OUTRAS AÇÕES / GERAR PEDIDOS EM MASSA Âncora
INTGER
INTGER

Através dessa opção, será possível gerar uma carga de pedidos para a Integração posicionada.

...

Finalizado o processo, será apresentado um resumo da geração:

e. OUTRAS AÇÕES / GERAR PEDIDOS PELO STAMP Âncora
INTGERSTP
INTGERSTP

Através dessa opção, será possível gerar uma carga de pedidos através do campo STAMP, esse botão é semelhante ao schedule PLMAPGRVSCHE.

...

Finalizado o processo, será apresentado um resumo da geração:

f. OUTRAS AÇÕES / STATUS DOS PEDIDOS Âncora
INTSTATUS
INTSTATUS

Através dessa opção, é possível consultar o status dos pedidos da Integração posicionada:

...

Card documentos

Informacao	Essa opção deverá ser adicionada no menu do SIGAPLS > Atualizações > Integrações, com o programa: PLMapIntegra (Integrações)
Titulo	Importante

04. TELA PEDIDOS DA INTEGRAÇÃO Âncora
PED
PED

Ao consultar os pedidos da Integração através do botão Consultar Pedidos da Rotina de Integração, será exibido um browser com todos os pedidos daquela Integração.

...

Os dados da tela inferior, correspondem a Integração, somente para visualização. Para Altera-los deverá ser utilizada a rotina de Integrações.

a. COMUNICAR Âncora
PEDCOM
PEDCOM

Através do botão Comunicar da rotina de pedidos, será feito o envio manual do pedido posicionado, essa opcional é somente para enviar um pedido, caso queria enviar todos os pedido, deverá ser utilizado o botão Comunicar Pedidos da tela de Integrações, como mostra o tópico 3.c.

...

Confirmando, caso o sistema realize a comunicação com sucesso com a Integração, será apresentado a mensagem:

Validações para o Envio do Pedido

A Integração do pedido deverá está ativa.
Deverá ser informado o Endpoint da Integração.
Deverá ser informada a classe de Comunicação na Integração.
Pedido com o status 1 - Envio Realizado e 3 - Cancelado, não será feita a comunicação.
Tentativas de envio maior que a quantidade máxima da Integração, não será feita a comunicação.
Data de Inclusão do Pedido maior que a data do Sistema. Nessa situação é porque foi programado para o pedido ser enviado somente em determinado dia, Exemplo: Bloqueio futuro de Beneficiários.

Resultados da Comunicação

Pedido enviado com sucesso, o status do pedido passará a ser 1 - Envio Realizado.
Falha ao realizar a autenticação com a Integração, nesse caso deverá ser analisado o Endpoint, Login e senha da Autenticação se estão corretos.
Falha no envio do pedido, o status do pedido passará a ser 2 - Erro de Envio, nesse caso deverá analisar o EndPoint da Integração e também o JSON de retorno.

05. SCHEDULE Âncora
SCH
SCH

Além do processo manualmente para gravação do pedidos e comunicação, os mesmo poderão ser feito de forma automática via schedule.

a. GRAVAR PEDIDOS Âncora
SCHGRV
SCHGRV

A gravação dos pedidos da Integração será feita pelo schedule PLMapGrvSche. Diferentemente do processo manual, onde é configurado os parâmetros para a geração, pelo schedule a busca é feito pelo campo STAMP de cada tabela, ou seja, será gravado somente os registros que sofreram alguma alteração de cadastro.

...

Card documentos

Informacao	Como o sistema utiliza o campo STAMP das tabelas para buscar alterações, se o mesmo não estiver na base, será feita criação na primeira execução do schedule.
Titulo	Importante

b. COMUNICAR PEDIDOS Âncora
SCHCOM
SCHCOM

A comunicação dos pedidos, assim como a gravação além de ser feita manualmente pela Rotina de Integração, poderá ser realizada pelo schedule PLMapComSche. O sistema irá comunicar todos pedidos com o status 0 - Pendente de Envio e 2 - Erro de Envio de todas as Integrações Ativas.

...

O resultado do schedule, poderá ser acessado pelo log: /logpls/data/plmapcomsche.log

06. TABELAS UTILIZADAS Âncora
TAB
TAB

B7E (Integrações)
B7F (Pedidos da Integração)

07. DICIONÁRIO DE DADOS Âncora
DICIO
DICIO

Atualização do Arquivo SX2 (Tabelas):

...

Tabela	Campo	Tipo	Tamanho	Decimal	Titulo	Descrição	Picture	Validação	Inicializador Padrão	Consulta Padrão	cBox	Usado	Exibe Browser	Visual?	Contexto	Obrigatório	When
B7E	B7E_FILIAL	C	8	0	Filial	Filial do Sistema
B7E	B7E_CODOPE	C	4	0	Operadora	Operadora	@R !.!!!	Vazio() .Or. ExistCpo("BA0",FWFldGet("B7E_CODOPE"),1)	PLSINTPAD(RETCODUSR())	B89PLS		Sim	Sim	Alterar	Real	Sim	INCLUI
B7E	B7E_CODIGO	C	4	0	Codigo Integ	Código da Integração	@!		GETSXENUM( "B7E", "B7E_CODIGO" )			Sim	Sim	Visualizar	Real	Sim
B7E	B7E_DESCRI	C	40	0	Descrição	Descrição da Integração	@!					Sim	Sim	Alterar	Real	Sim
B7E	B7E_ALIAS	C	3	0	Alias Prima.	Alias Primário	@!	Vazio() .Or. PlsAliasExi(FWFldGet("B7E_ALIAS"))				Sim	Sim	Alterar	Real	Sim	INCLUI
B7E	B7E_ENDPOI	C	100	0	EndPoint	EndPoint da Integracaoo						Sim	Sim	Alterar	Real	Não
B7E	B7E_ATIVO	C	1	0	Ativo	Ativo	@!		1		0=Nao;1=Sim	Sim	Não	Alterar	Real	Sim
B7E	B7E_MAXENV	N	3	0	Máximo Envio	Máximo de Envio	@E 999	FWFldGet("B7E_MAXENV") > 0				Sim	Sim	Alterar	Real	Sim
B7E	B7E_CLASTP	C	20	0	Classe Stamp	Classe Stamp da Integ.		Vazio() .Or. FindClass(FWFldGet("B7E_CLASTP"))				Sim	Não	Alterar	Real	Não
B7E	B7E_CLACOM	C	20	0	Classe Comu.	Classe para Comunicação		Vazio() .Or. FindClass(FWFldGet("B7E_CLACOM"))				Sim	Não	Alterar	Real	Não
B7E	B7E_USRAUT	C	20	0	Login Auten.	Login Autenticação						Sim	Não	Alterar	Real	Não
B7E	B7E_PASAUT	C	50	0	Senha Auten.	Senha Autenticação	@*					Sim	Não	Alterar	Real	Não
B7E	B7E_ENDAUT	C	100	0	EndPoint Aut	EndPoint Autenticação						Sim	Não	Alterar	Real	Não
B7E	B7E_BEAAUT	M	10	0	Bearer Aute.	Bearer Autenticação						Sim	Não	Visualizar	Real	Não
B7E	B7E_COOAUT	M	10	0	Cookie Aut.	Cookie Autenticação						Sim	Não	Visualizar	Real	Não
B7E	B7E_TMPAUT	C	20	0	Tempo Expe.	Tempo de Expiração						Sim	Não	Visualizar	Real	Não
B7E	B7E_PERGGE	C	10	0	Perg. Gerar	Pergunta Gerar Pedidos	@!					Sim	Não	Alterar	Real	Não

Tabela	Campo	Tipo	Tamanho	Decimal	Titulo	Descrição	Picture	Validação	Inicializador Padrão	Consulta Padrão	cBox	Usado	Exibe Browser	Visual?	Contexto	Obrigatório	When
B7F	B7F_FILIAL	C	8	0	Filial	Filial do Sistema
B7F	B7F_CODOPE	C	4	0	Operadora	Operadora	@R !.!!!	Vazio() .Or. ExistCpo("BA0",FWFldGet("B7F_CODOPE"),1)	IIF(IsInCallstack("PLMapIntegra"),B7E->B7E_CODOPE,PLSINTPAD(RETCODUSR()))	B89PLS		Sim	Sim	Alterar	Real	Sim	IIF(IsInCallstack("PLMapIntegra"),.F.,INCLUI)
B7F	B7F_CODIGO	C	4	0	Codigo Integ	Codigo da Integração	@!	Vazio() .Or. ExistCpo("B7E",FWFldGet("B7F_CODOPE")+ FWFldGet("B7F_CODIGO"),1)	IIF(IsInCallstack("PLMapIntegra"),B7E->B7E_CODIGO," ")			Sim	Sim	Alterar	Real	Sim	IIF(IsInCallstack("PLMapIntegra"),.F.,INCLUI)
B7F	B7F_CODPED	C	9	0	Cod. Pedido	Codigo do Pedido	@!		GETSXENUM("B7F", "B7F_CODPED")			Sim	Sim	Visualizar	Real	Sim
B7F	B7F_ALIAS	C	3	0	Alias Prima.	Alias Primário	@!	Vazio() .Or. ExistCpo("B7E",FWFldGet("B7F_CODOPE")+ FWFldGet("B7F_CODIGO")+FWFldGet("B7F_ALIAS"),1)	IIF(IsInCallstack("PLMapIntegra"),B7E->B7E_ALIAS," ")			Sim	Sim	Alterar	Real	Sim	IIF(IsInCallstack("PLMapIntegra"),.F.,INCLUI)
B7F	B7F_CHAVE	C	60	0	Chave	Chave de Busca	@!	Vazio() .OR. ExistCpo(FWFldGet("B7F_ALIAS"),FWFldGet("B7F_CHAVE"), IIF(FWFldGet("B7F_ALIAS") $ "BA1/BE4",2,1))				Sim	Sim	Alterar	Real	Sim
B7F	B7F_DATINC	D	8	0	Dt. Inclusão	Data de Inclusão			dDataBase			Sim	Sim	Alterar	Real	Sim
B7F	B7F_DATCOM	D	8	0	Dt. Comunica	Data de Comunicação						Sim	Sim	Visualizar	Real	Não
B7F	B7F_STATUS	C	1	0	Status	Status do Pedido	@!		0		0=Pendente de Envio;1=Envio Realizado;2=Erro de Envio;3=Envio Cancelado	Sim	Não	Alterar	Real	Não
B7F	B7F_TENVIO	N	3	0	Tent. Envio	Tentativas de Envio	@E 999	FWFldGet("B7F_TENVIO") <= FWFldGet("B7E_MAXENV")				Sim	Não	Alterar	Real	Não
B7F	B7F_ENVJSO	M	10	0	Json Envio	Json Enviado						Sim	Não	Visualizar	Real	Não
B7F	B7F_RECJSO	M	10	0	Json Receb.	Json Recebido						Sim	Não	Visualizar	Real	Não

Atualização do Arquivo SIX (Índices):

Tabela	Ordem	Chave	Descrição
B7E	1	B7E_FILIAL+B7E_CODOPE+B7E_CODIGO+B7E_ALIAS	Operadora + Codigo Integ + Alias Prima.
Tabela	Ordem	Chave	Descrição
B7F	1	B7F_FILIAL+B7F_CODOPE+B7F_CODIGO+B7F_CODPED	Operadora + Codigo Integ + Cod. Pedido
B7F	2	B7F_FILIAL+B7F_CODOPE+B7F_ALIAS+B7F_CHAVE	Operadora + Alias Prima. + Chave

Atualização do Arquivo SX9 (Relacionamento):

Identi.	Tabela Domínio	Expressão Domínio	Tabela Contra-Domínio	Expressão Contra-Domínio	Lig. Domínio	Lig. Contra-Domínio
001	B7E	B7E_CODOPE+B7E_CODIGO+B7E_ALIAS	B7F	B7F_CODOPE+B7F_CODIGO+B7F_ALIAS	1	N

Atualização do Arquivo SX1 (Pergunte):

Grupo	Ordem	Pergunta	Variável	Tipo	Tamanho	Decimal	Objeto	Consulta Padrão
PLRMPSTAMP	01	Operadora ?	MV_PAR01	C	4	0	1 - Edit	B89PLS
PLRMPSTAMP	02	Data do STAMP ?	MV_PAR02	D	8	0	1 - Edit

Card documentos

Informacao	A 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.
Titulo	Importante

...

Árvore de páginas

Versões comparadas

Versão antiga 73

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL Âncora
VIS
VIS

02. DETALHAMENTO Âncora
DET
DET

03. TELA INTEGRAÇÕES Âncora
INT
INT

a. INTEGRAÇÕES DISPONÍVEIS Âncora
INTDIS
INTDIS

b. OUTRAS AÇÕES / CONSULTAR PEDIDOS Âncora
INTCON
INTCON

c. OUTRAS AÇÕES / COMUNICAR PEDIDOS Âncora
INTCOM
INTCOM

d. OUTRAS AÇÕES / GERAR PEDIDOS EM MASSA Âncora
INTGER
INTGER

e. OUTRAS AÇÕES / GERAR PEDIDOS PELO STAMP Âncora
INTGERSTP
INTGERSTP

f. OUTRAS AÇÕES / STATUS DOS PEDIDOS Âncora
INTSTATUS
INTSTATUS

04. TELA PEDIDOS DA INTEGRAÇÃO Âncora
PED
PED

a. COMUNICAR Âncora
PEDCOM
PEDCOM

Validações para o Envio do Pedido

Resultados da Comunicação

05. SCHEDULE Âncora
SCH
SCH

a. GRAVAR PEDIDOS Âncora
SCHGRV
SCHGRV

b. COMUNICAR PEDIDOS Âncora
SCHCOM
SCHCOM

06. TABELAS UTILIZADAS Âncora
TAB
TAB

07. DICIONÁRIO DE DADOS Âncora
DICIO
DICIO

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 73

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL ÂncoraVISVIS

02. DETALHAMENTO ÂncoraDETDET

03. TELA INTEGRAÇÕES ÂncoraINTINT

a. INTEGRAÇÕES DISPONÍVEIS ÂncoraINTDISINTDIS

b. OUTRAS AÇÕES / CONSULTAR PEDIDOS ÂncoraINTCONINTCON

c. OUTRAS AÇÕES / COMUNICAR PEDIDOS ÂncoraINTCOMINTCOM

d. OUTRAS AÇÕES / GERAR PEDIDOS EM MASSA ÂncoraINTGERINTGER

e. OUTRAS AÇÕES / GERAR PEDIDOS PELO STAMP ÂncoraINTGERSTPINTGERSTP

f. OUTRAS AÇÕES / STATUS DOS PEDIDOS ÂncoraINTSTATUSINTSTATUS

04. TELA PEDIDOS DA INTEGRAÇÃO ÂncoraPEDPED

a. COMUNICAR ÂncoraPEDCOMPEDCOM

Validações para o Envio do Pedido

Resultados da Comunicação

05. SCHEDULE ÂncoraSCHSCH

a. GRAVAR PEDIDOS ÂncoraSCHGRVSCHGRV

b. COMUNICAR PEDIDOS ÂncoraSCHCOMSCHCOM

06. TABELAS UTILIZADAS ÂncoraTABTAB

07. DICIONÁRIO DE DADOS ÂncoraDICIODICIO

01. VISÃO GERAL Âncora
VIS
VIS

02. DETALHAMENTO Âncora
DET
DET

03. TELA INTEGRAÇÕES Âncora
INT
INT

a. INTEGRAÇÕES DISPONÍVEIS Âncora
INTDIS
INTDIS

b. OUTRAS AÇÕES / CONSULTAR PEDIDOS Âncora
INTCON
INTCON

c. OUTRAS AÇÕES / COMUNICAR PEDIDOS Âncora
INTCOM
INTCOM

d. OUTRAS AÇÕES / GERAR PEDIDOS EM MASSA Âncora
INTGER
INTGER

e. OUTRAS AÇÕES / GERAR PEDIDOS PELO STAMP Âncora
INTGERSTP
INTGERSTP

f. OUTRAS AÇÕES / STATUS DOS PEDIDOS Âncora
INTSTATUS
INTSTATUS

04. TELA PEDIDOS DA INTEGRAÇÃO Âncora
PED
PED

a. COMUNICAR Âncora
PEDCOM
PEDCOM

05. SCHEDULE Âncora
SCH
SCH

a. GRAVAR PEDIDOS Âncora
SCHGRV
SCHGRV

b. COMUNICAR PEDIDOS Âncora
SCHCOM
SCHCOM

06. TABELAS UTILIZADAS Âncora
TAB
TAB

07. DICIONÁRIO DE DADOS Âncora
DICIO
DICIO