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 01/01/2025 , 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.

Criado nova api para receber os compartilhamentos de risco em pós-pagamento ou custo operacional: /totvsHealthPlans/unimed/cadbenef-online/v1/beneficiarios/compartilhamento-riscos

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	Agrupamento	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			001	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			001	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		001	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			001	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		001	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			001	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			001	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		Não	Alterar	Real		BG9PLS	002	Informe o código da empresa de início do range que será utilizado para a busca dos beneficiários que irão compor este lote.
BPW_EMPFIN	10	Caracter	4	Empresa Fin.	Empresa Final do Filtro	@!		Sim	Não		Não	Alterar	Real		BG9PLS	002	Informe o código da empresa final do range que será utilizado para a busca dos beneficiários que irão compor este lote.
BPW_CONINI	11	Caracter	12	Contra. Ini.	Contr. Inicial do Fitro	@!		Sim	Não		Não	Alterar	Real			002	Informe o código do contrato de início que será utilizado neste range na busca dos beneficiários.
BPW_CONFIN	12	Caracter	12	Contra. Fin.	Contr. Final do Filtro	@!		Sim	Não		Não	Alterar	Real			002	Informe o código final do contrato que será utilizado neste range na busca dos beneficiários.
BPW_SUBINI	13	Caracter	9	Subcon. Ini.	Subcont. Inicial Filtro	@!		Sim	Não		Não	Alterar	Real			002	Informe o código do subcontrato de início que será utilizado neste range na busca dos beneficiários.
BPW_SUBFIN	14	Caracter	9	Subcon. Fin.	Subcont. Final Filtro	@!		Sim	Não		Não	Alterar	Real			002	Informe o código final do subcontrato que será utilizado neste range na busca dos beneficiários.
BPW_FAMINI	15	Caracter	6	Família Ini.	Família Inicial do Filtro	@!		Sim	Não		Não	Alterar	Real			002	Informe a família de inicio que será utilizada para a busca dos beneficiários que irão compor este lote.
BPW_FAMFIN	16	Caracter	6	Família Fin.	Família Final do Filtro	@!		Sim	Não		Não	Alterar	Real			002	Informe a família final que será utilizada para a busca dos beneficiários que irão compor este lote.
BPW_ANS	17	Caracter	1	Consid. ANS	Considera ANS no Filtro	@!	pertence("01")	Sim	Não		Não	Alterar	Real	0=Não;1=Sim		002	Informe se será considerado ANS na busca dos beneficiários.
BPW_SIB	18	Caracter	1	Consid. SIB	Considera SIB no Filtro	@!	pertence("01")	Sim	Não		Não	Alterar	Real	0=Não;1=Sim		002	Informe se será considerado SIB na busca dos beneficiários.

Inclusão na tabela SIX (Índices):

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

Inclusão na tabela SX9 (Relacionamento):

Tabela Domínio	Exp. Domínio	Tabela Contra-Domínio	Exp. Contra-Domínio	Tp. Lig. Dom.	Tip. Lig. CDom.
BG9	BG9_CODIGO	BPW	BPW_EMPFIN	1	N
BG9	BG9_CODIGO	BPW	BPW_EMPINI	1	N

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_CODINT+BPY_CODEMP+BPY_MATRIC+BPY_TIPREG+BPY_DIGITO
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	Agrupamento	Help
BPY_FILIAL	01	Caracter	8	Filial	Filial do Sistema			Não		Não	Alterar	Real				Filial do sistema.
BPY_CODLOT	02	Caracter	8	Cod. Lote	Codigo do Lote	@!		Sim		Não	Visualizar	Real			001	Código identificador do Lote do beneficiário.
BPY_CODINT	03	Caracter	4	Operadora	Código da Operadora	@!		Sim		Sim	Visualizar	Real			001	Código da operadora que compõe a matrícula do beneficiário pertencente neste lote.
BPY_CODEMP	04	Caracter	4	Cod. Empresa	Código da Empresa	@!		Sim		Sim	Visualizar	Real			001	Código da empresa que compõe a matrícula do beneficiário pertencente neste lote.
BPY_MATRIC	05	Caracter	6	Matrícula	Matrícula da Família	@!		Sim		Sim	Visualizar	Real			001	Matrícula da família que compõe a matrícula do beneficiário pertencente neste lote.
BPY_TIPREG	06	Caracter	2	Tp. Registro	Tipo Reg. Beneficiário	@!		Sim		Sim	Visualizar	Real			001	Tipo do registro do beneficiário que compõe a matrícula do beneficiário pertencente neste lote.
BPY_DIGITO	07	Caracter	1	Dígito	Dígito Verificador	9		Sim		Sim	Visualizar	Real			001	Digito que compõe a matrícula do beneficiário pertencente neste lote.
BPY_NOMBEN	08	Caracter	70	Nome Benef.	Nome do Beneficiário	@!		Sim	iif(inclui,"",posicione("BA1", 2, xFilial("BA1")+BPY->(BPY_CODINT+BPY_CODEMP+BPY_MATRIC+BPY_TIPREG+BPY_DIGITO),"BA1_NOMUSR"))	Sim	Visualizar	Virtual		totvs.protheus.health.plan.unimed.cadBenefGetBenefNameBrowser()	001	Nome do beneficiário pertencente neste lote.
BPY_STATUS	09	Caracter	1	Status	Status do Envio	@!	pertence("123")	Sim	1	Sim	Visualizar	Real	1=Pendente de Envio;2=Envio Finalizado;3=Erro de Envio		001	Status em que se encontra o envio do beneficiário para o CadBenef.
BPY_TIPMOV	10	Caracter	1	Tipo de Mov.	Tipo de Envio	@!	pertence("123")	Sim		Sim	Visualizar	Real	1=Inclusão;2=Atualização;3=Exclusão		001	Indica o tipo da movimentação do beneficiário para envio ao CadBenef.
BPY_CODTRA	11	Caracter	20	Cd. Transac.	Cod. Transação do PTU			Sim		Sim	Visualizar	Real			001	Código de Transação do PTU.
BPY_DATENV	12	Data	8	Data Envio	Data de Envio			Sim		Sim	Visualizar	Real			001	Data em que foi realizado a ultima comunicação do envio do beneficiário para o CadBenef.
BPY_HORENV	13	Caracter	8	Hora Envio	Hora de Envio			Sim		Sim	Visualizar	Real			001	Hora em que foi realizado a ultima comunicação do envio do beneficiário para o CadBenef.
BPY_MSGENV	14	Memo	10	Msg. Envio	Mensagem de Envio			Sim		Não	Visualizar	Real			001	Request body (json) com os dados do beneficiário enviado para o CadBenef.
BPY_MSGRES	15	Memo	10	Msg. Resp.	Mensagem de Resposta			Sim		Não	Visualizar	Real			002	Response (json) de retorno da comunicação com o CadBenef.
BPY_RESULT	16	Caracter	150	Resultado	Resultado do Envio			Sim		Não	Visualizar	Real			002	Mensagem com o resultado da comunicação com o CadBenef.
BPY_TIMERP	17	Caracter	8	Tempo Resp.	Tempo de Resposta			Sim		Não	Visualizar	Real			002	Tempo total de resposta da comunicação com o CadBenef.

Inclusão na tabela SIX (Índices):

Ordem	Chave	Descrição
1	BPY_FILIAL + BPY_CODLOT + BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITO	Filial + Código do Lote + Operadora + Empresa + Matrícula+ Tipo Registro + Digito
2	BPY_FILIAL + BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITO	Filial + Operadora + Empresa + Matrícula+ Tipo Registro + Digito

Inclusão na tabela SX9 (Relacionamento):

Tabela Domínio	Exp. Domínio	Tabela Contra-Domínio	Exp. Contra-Domínio	Tp. Lig. Dom.	Tip. Lig. CDom.
BA1	BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO	BPY	BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITO	1	N

Cadastro da Operadora de Saúde

Inclusão na tabela SX3 (Campos):

Campo	Tipo	Tamanho	Titulo	Descrição	Picture	Usado	Exibe Browser	Visual	Contexto	Folder	Help
BA0_UBURL	Caracter	200	URL Token	Endpoint Autenticação		Sim	Não	Alterar	Real	6	Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação.
BA0_UBCLID	Caracter	100	ID Token	Client ID do Token		Sim	Não	Alterar	Real	6	Client ID solicitado previamente para Unimed Brasil.
BA0_UBCLSC	Caracter	100	Secret Token	Secret ID do Token	@*	Sim	Não	Alterar	Real	6	Secret ID solicitado previamente para Unimed Brasil.
BA0_UBACTK	Memo	10	Access Token	Bearer do Access Token		Sim	Não	Visualizar	Real	6	Bearer obtido pela api de Token para ser utilizado nas Integrações do PTU.
BA0_UBEXIN	Caracter	20	Expira Token	Tempo de Expiração Token		Sim	Não	Visualizar	Real	6	Tempo em que o access token irá expirar. Campo para controle interno do sistema.
BA0_CDBURL	Caracter	200	URL CadBenef	Endpoint do CadBenef		Sim	Não	Alterar	Real	6	Endpoint de homologação/produção do CadBenef-Online
BA0_CDBPFX	Caracter	100	PFX CadBenef	Certificado do CadBenef		Sim	Não	Alterar	Real	6	O nome do certificado com extensão.
BA0_CDBPAS	Caracter	100	Pass CadBen.	Senha do Certificado	@*	Sim	Não	Alterar	Real	6	Senha que será utilizada para a abertura da chave privada. Para uma chave privada que não possua senha, deve ser informada uma string vazia.
BA0_URLVTK	Caracter	200	URL Vd. Tok.	URL Validação do Token		Sim	Não	Alterar	Real	6	Endpoint de homologação/produção para validar o token no GIU para autorização das apis de integração com a Unimed Brasil.

Cadastro do Beneficiário

Inclusão na tabela SX3 (Campos):

Campo	Tipo	Tamanho	Titulo	Descrição	Usado	Exibe Browser	Folder	Visual	Contexto	Help
BA1_CODUBR	Caracter	17	Código UB	Cod. Controle Uni. Brasil	Sim	Não		Visualizar	Real	Código de Controle gerado pela Unimed do Brasil.
BA1_AEMAIL	Caracter	70	Email Alter.	Email Alternativo	Sim	Não	1	Alterar	Real	Informe um email alternativo para o beneficiário.
BA1_FINREP	Date	8	Fin. Repasse	Data final do Repasse	Sim	Não	3	Alterar	Real	Data final do compartilhamento de risco (repasse) do beneficiário.

Beneficiários Pós Pagamento/Habitual

Inclusão na tabela SX3 (Campos):

Campo	Ordem	Tipo	Tamanho	Decimal	Titulo	Descrição	Picture	Validação	Usado	Exibe Browser	Visual	Contexto	Help
B5F_CODTRA	24	Caracter	20	0	Cd. Transac.	Cod. Transação do PTU			Sim	Não	Visualizar	Real	Código de Transação do PTU.

Alteração na tabela SX3 (Campos):

Campo	Usado
B5F_TPCONT	Sim

Produto Saúde

Inclusão na tabela SX3 (Campos):

Campo	Ordem	Tipo	Tamanho	Decimal	Titulo	Descrição	Picture	Validação	Obrigatório	Usado	Exibe Browser	Visual	Contexto	cBox	Help
BI3_INDPLA	A7	Caracter	1	0	Indic. Plano	Indicação de Plano		pertence("1234 ")	Não	Sim	Não	Alterar	Real	1=Plano LowCost;2=Plano de Acidente de Trabalho;3=Plano de Saúde Ocupacional;4=Plano APS	Informe qual é a indicação do plano, sendo: Plano LowCost, Plano de Acidente de Trabalho, Plano de Saúde Ocupacional e Plano APS.

Parâmetros

Inclusão no arquivo SX6 (Parâmetros):

Var	Tipo	Descrição	Conteúdo (default)
MV_PLCBREP	L - Lógico	Habilita o recebimento (via api) do compartilhamento de risco em pré-pagamento ou repasse dos beneficiários de outra Unimed.	.F.
MV_PLCBEMP	C - Caracter	Dados da empresa do tipo pessoa juridica, aonde os beneficiários serão cadastrados no compartilhamento de risco em pré-pagamento.
MV_PLCBCER	C - Caracter	Informe o diretório onde ficará o certificado a ser utilizado na autenticação do CadBenef Online.	\cadbenef\certificados\

Parâmetro MV_PLCBEMP

O conteúdo do parâmetro deve ser a seguinte estrutura: codigoEmpresa-numeroContrato-versaoContrato-subcontrato-versaoSubcontrato-produto-versaoProduto

Exemplo: 1008-000000000001-001-000000003-001-0001-001

Código da empresa: 1008
Contrato: 000000000001
Versão do Contrato: 001
Subcontrato: 000000003
Versão do Subcontrato: 001
Produto: 0001
Versão do Produto: 001

Pergunte

Inclusão no arquivo SX1 (Pergunte):

Grupo	Ordem	Pergunta	Tipo	Tamanho	Modo de Entrada	Variável	Def. 1	Def. 2	Def. 3	Def. 4	Cons. Padrão
PLSSCH001	01	Tipo de Mov.	Numérico	1	Combo	MV_PAR01	Cadastro Ativo	Cad. Completo	Mov. Periódica	Exclusão
PLSSCH001	02	Data Inicial	Data	8	Get	MV_PAR02
PLSSCH001	03	Data Final	Data	8	Get	MV_PAR03
PLSSCH001	04	Cons. Data Atual	Numérico	1	Combo	MV_PAR04	Sim	Não
PLSSCH001	05	Empresa Ini.	Caracter	4	Get	MV_PAR05					BG9PLS
PLSSCH001	06	Empresa Fin.	Caracter	4	Get	MV_PAR06					BG9PLS
PLSSCH001	07	Contra. Ini.	Caracter	12	Get	MV_PAR07
PLSSCH001	08	Contra. Fin.	Caracter	12	Get	MV_PAR08
PLSSCH001	09	Subcon. Ini.	Caracter	9	Get	MV_PAR09
PLSSCH001	10	Subcon. Fin.	Caracter	9	Get	MV_PAR10
PLSSCH001	11	Família Ini.	Caracter	6	Get	MV_PAR11
PLSSCH001	12	Família Fin.	Caracter	6	Get	MV_PAR12
PLSSCH001	13	Consid. ANS	Numérico	1	Combo	MV_PAR13	Sim	Não	Nenhum
PLSSCH001	14	Consid. SIB	Numérico	1	Combo	MV_PAR14	Sim	Não	Nenhum
PLSSCH001	15	Enviar Lote	Numérico	1	Combo	MV_PAR15	Sim	Não

Importante

As alterações de dicionário referente a essa implementação estarão disponíveis através de pacote de expedição contínua do plano de saúde com data igual ou superior 19/11/2024..

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

Árvore de páginas

DSAUBE-22560 DT CadBenef Online - PTU Integrações 8.0

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

Atualização de Dicionário de Dados

Lote de Envio do CadBenef

Beneficiários do Lote

Cadastro da Operadora de Saúde

Cadastro do Beneficiário

Beneficiários Pós Pagamento/Habitual

Produto Saúde

Parâmetros

Pergunte

Importante

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS