Exibir origem

Funcionalidade em fase de testes.

01. DADOS GERAIS

Produto:	TOTVS Saúde Planos
Linha de Produto:	Linha Protheus
Segmento:	Saude
Módulo:	PTU
Função:	CADBENEF ONLINE
Ticket:
Story:	DSAUBE-22560

02. SITUAÇÃO/REQUISITO

Possibilitar que seja enviado a movimentação cadastral do beneficiário (Inclusão, Alteração e Exclusão) para o CadBenef.

Cadastro de Beneficiários On-line terá início em 15/04/2024, com obrigatoriedade em 12/08/2024, data em que o envio dos dados dos beneficiários à Unimed do Brasil através do PTU A1300 deixará de existir.

Nesse novo processo, o compartilhamento de risco através do PTU A100 também deixará de existir, tendo em vista já incorporado ao novo PTU de Integrações 8.0 por meio da mensagem de "Cadastro de Beneficiário", assim como o PTU A200, na mensagem "Retorno do Compartilhamento de Risco".

Vale lembrar que tais mudanças otimizarão o processo de cadastramento de beneficiários no intercâmbio, uma vez que os processos manuais serão extintos.

03. SOLUÇÃO

Implementada rotina do CadBenef Online (PLPTU001) no menu do Plano de Saúde (SIGAPLS), onde será possível enviar as movimentações cadastrais do beneficiário (Inclusão, alteração e exclusão) para o Cadastro Nacional de Beneficiários (CadBenef).

No processo serão utilizados os seguintes métodos (Rest Full):

POST – Inclusão de Beneficiários.
PATCH – Atualização dos dados beneficiários.
DELETE – Exclusão do beneficiário.

A API da Unimed Brasil só permite o envio de 1 beneficiário por requisição.

Compartilhamento de risco não implementado nessa primeira fase.

Atualização de Dicionário de Dados

Lote de Envio do CadBenef

Inclusão na tabela SX2 (Tabela):

Tabela	BPW
Modo	Compartilhado
Modo Unidade	Exclusivo
Modo Empresa	Exclusivo
Chave Única	BPW_FILIAL+BPW_CODIGO
Nome	CadBenef Online - Lote

Inclusão na tabela SX3 (Campos):

Campo	Ordem	Tipo	Tamanho	Titulo	Descrição	Picture	Validação	Usado	Obrigatório	Inic. Padrão	Exibe Browser	Visual	Contexto	Cbox	Consulta Padrão	Help
BPW_FILIAL	01	Caracter	8	Filial	Filial do Sistema			Não	Não		Não	Alterar	Real			Filial do sistema.
BPW_CODIGO	02	Caracter	8	Cod. Lote	Código do Lote	@!		Sim	Sim	getSXENum("BPW", "BPW_CODIGO")	Sim	Visualizar	Real			Código identificador do lote.
BPW_DTEMIS	03	Data	8	Dt. Emissão	Data de Emissão do Lote			Sim	Sim	dDataBase	Sim	Visualizar	Real			Data em que o lote foi lançado no sistema.
BPW_STATUS	04	Caracter	1	Status	Status do Lote	@!	pertence("12345")	Sim	Sim	1	Sim	Visualizar	Real	1=Recebido;2=Processando Envio;3=Falha de Envio;4=Finalizado com Sucesso;5=Finalizado Parcialmente		Indica o status em que o lote se encontra conforme a comunicação com o CadBenef.
BPW_UNIORI	05	Caracter	4	Unimed Orig.	Cod. Unimed Orig. Envio	@!		Sim	Sim	plsIntPad()	Sim	Visualizar	Real			Código da Unimed origem do envio do lote para o CadBenef.
BPW_TIPMOV	06	Caracter	1	Tipo de Mov.	Tipo de Mov. do Envio	@!	pertence("1234")	Sim	Sim		Sim	Alterar	Real	1=Cadastro Ativo;2=Cadastro Completo;3=Mov. Periódica;4=Somente Exclusão		Indica de qual forma o sistema irá buscar os beneficiários no cadastro, sendo: Cadastro Ativo: Beneficiários que tiveram inclusão no intervalo da data inicial e final informada no lote que estão sem data de bloqueio. Cadastro Completo: Todos os beneficiários. Mov. Periódica: Beneficiários que tiveram alterações/inclusões (BX1), via de cartão (BED), repasse, bloqueio e desbloqueio (BCA) no intervalo da data inicial e final informada no lote. Somente Exclusão: Beneficiários que tiveram bloqueio no intervalo da data inicial e final informada no lote e que já foram enviados para o CadBenef.
BPW_DATINI	07	Data	8	Data Inicial	Data de Início da Mov.			Sim	Sim		Não	Alterar	Real			Informe a data de Início que será utilizada para a busca dos beneficiários que irão compor este lote.
BPW_DATFIN	08	Data	8	Data Final	Data Final da Mov.			Sim	Sim		Não	Alterar	Real			Informe a data fim que será utilizada para a busca dos beneficiários que irão compor este lote.
BPW_EMPINI	09	Caracter	4	Empresa Ini.	Empresa Inicial do Filtro	@!		Sim			Não	Alterar	Real		B7APLS
BPW_EMPFIN	10	Caracter	4	Empresa Fin.	Empresa Final do Filtro	@!		Sim			Não	Alterar	Real		B7APLS
BPW_CONINI	11	Caracter	12	Contra. Ini.	Contr. Inicial do Fitro	@!		Sim			Não	Alterar	Real		B7BPLS
BPW_CONFIN	12	Caracter	12	Contra. Fin.	Contr. Final do Filtro	@!		Sim			Não	Alterar	Real		B7BPLS
BPW_SUBINI	13	Caracter	9	Subcon. Ini.	Subcont. Inicial Filtro	@!		Sim			Não	Alterar	Real		B7CPLS
BPW_SUBFIN	14	Caracter	9	Subcon. Fin.	Subcont. Final Filtro	@!		Sim			Não	Alterar	Real		B7CPLS
BPW_ANS	15	Caracter	1	Consid. ANS	Considera ANS no Filtro	@!	pertence("01")	Sim			Não	Alterar	Real	0=Não;1=Sim
BPW_SIB	16	Caracter	1	Consid. SIB	Considera SIB no Filtro	@!	pertence("01")	Sim			Não	Alterar	Real	0=Não;1=Sim

Inclusão na tabela SIX (Índices):

Ordem	Chave	Descrição
1	BPW_FILIAL + BPW_CODIGO	Filial + Código do Lote

Beneficiários do Lote

Inclusão na tabela SX2 (Tabelas):

Tabela	BPY
Modo	Compartilhado
Modo Unidade	Exclusivo
Modo Empresa	Exclusivo
Chave Única	BPY_FILIAL+BPY_CODLOT+BPY_MATBEN
Nome	CadBenef Online - Beneficiário

Inclusão na tabela SX3 (Campos):

Campo	Ordem	Tipo	Tamanho	Titulo	Descrição	Picture	Validação	Usado	Inic. Padrão	Exibe Browser	Visual	Contexto	Cbox	Inic. Browser
BPY_FILIAL	01	Caracter	8	Filial	Filial do Sistema			Não		Não	Alterar	Real
BPY_CODLOT	02	Caracter	8	Cod. Lote	Codigo do Lote	@!		Sim		Não	Visualizar	Real
BPY_MATBEN	03	Caracter	17	Matric. Ben.	Matricula do Beneficiário	@!		Sim		Sim	Visualizar	Real
BPY_NOMBEN	04	Caracter	70	Nome Benef.	Nome do Beneficiário	@!		Sim	iif(inclui, "", posicione("BA1", 2, xFilial("BA1") + BPY->BPY_MATBEN, "BA1_NOMUSR"))	Sim	Visualizar	Virtual		posicione("BA1", 2, xFilial("BA1") + BPY->BPY_MATBEN, "BA1_NOMUSR")
BPY_STATUS	05	Caracter	1	Status	Status do Envio	@!	pertence("123")	Sim		Sim	Visualizar	Real	1=Pendente de Envio;2=Envio Finalizado;3=Erro de Envio
BPY_TIPMOV	06	Caracter	1	Tipo de Mov.	Tipo de Envio	@!	pertence("123")	Sim		Sim	Visualizar	Real	1=Inclusão;2=Atualização;3=Exclusão
BPY_CODTRA	07	Caracter	20	Cd. Transac.	Cod. Transação do PTU			Sim		Sim	Visualizar	Real
BPY_DATENV	08	Data	8	Data Envio	Data de Envio			Sim		Sim	Visualizar	Real
BPY_HORENV	09	Caracter	8	Hora Envio	Hora de Envio			Sim		Sim	Visualizar	Real
BPY_MSGENV	10	Memo	10	Msg. Envio	Mensagem de Envio			Sim		Não	Visualizar	Real
BPY_MSGRES	11	Memo	10	Msg. Resp.	Mensagem de Resposta			Sim		Não	Visualizar	Real
BPY_RESULT	12	Caracter	150	Resultado	Resultado do Envio			Sim		Não	Visualizar	Real
BPY_TIMERP	13	Caracter	8	Tempo Resp.	Tempo de Resposta			Sim		Não	Visualizar	Real

Inclusão na tabela SIX (Índices):

Ordem	Chave	Descrição
1	BPY_FILIAL + BPY_CODLOT + BPY_MATBEN	Filial + Código do Lote + Matricula do Beneficiário
2	BPY_FILIAL + BPY_MATBEN	Filial + Matricula do Beneficiário

Cadastro da Operadora de Saúde

Inclusão na tabela SX3 (Campos):

Campo	Tipo	Tamanho	Titulo	Picture	Usado	Exibe Browser	Visual	Contexto	Folder
BA0_UBURL	Caracter	200	URL Token		Sim	Não	Alterar	Real	6
BA0_UBCLID	Caracter	100	ID Token		Sim	Não	Alterar	Real	6
BA0_UBCLSC	Caracter	100	Secret Token	@*	Sim	Não	Alterar	Real	6
BA0_UBACTK	Memo	10	Access Token		Sim	Não	Visualizar	Real	6
BA0_UBEXIN	Caracter	20	Expira Token		Sim	Não	Visualizar	Real	6
BA0_CDBURL	Caracter	200	URL CadBenef		Sim	Não	Alterar	Real	6
BA0_CDBPFX	Caracter	100	PFX CadBenef		Sim	Não	Alterar	Real	6
BA0_CDBPAS	Caracter	100	Pass CadBen.	@*	Sim	Não	Alterar	Real	6

Cadastro do Beneficiário

Inclusão na tabela SX3 (Campos):

Campo	Tipo	Tamanho	Decimal	Titulo	Descrição	Picture	Usado	Exibe Browser	Visual	Contexto
BA1_CODUBR	Caracter	17	0	Código UB	Cod. Controle Uni. Brasil		Sim	Não	Visualizar	Real

04. DEMAIS INFORMAÇÕES

Para mais informações de como utilizar essa funcionalidade, acesse a documentação de referência: CadBenef Online - Movimentação Cadastral de Beneficiarios - PLPTU001

05. ASSUNTOS RELACIONADOS

Manual do PTU de Integrações 8.0