Beta

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.

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	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		Não	Alterar	Real		B7APLS	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		B7APLS	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		B7BPLS	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		B7BPLS	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		B7CPLS	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		B7CPLS	Informe o código final do subcontrato que será utilizado neste range na busca dos beneficiários.
BPW_ANS	15	Caracter	1	Consid. ANS	Considera ANS no Filtro	@!	pertence("01")	Sim	Não		Não	Alterar	Real	0=Não;1=Sim		Informe se será considerado ANS na busca dos beneficiários.
BPW_SIB	16	Caracter	1	Consid. SIB	Considera SIB no Filtro	@!	pertence("01")	Sim	Não		Não	Alterar	Real	0=Não;1=Sim		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
BQC	BQC_SUBCON	BPW	BPW_SUBINI	1	N
BQC	BQC_SUBCON	BPW	BPW_SUBFIN	1	N
BT5	BT5_NUMCON	BPW	BPW_CONINI	1	N
BT5	BT5_NUMCON	BPW	BPW_CONFIN	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	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			Código identificador do Lote do beneficiário.
BPY_CODINT	03	Caracter	4	Operadora	Código da Operadora	@!		Sim		Sim	Visualizar	Real			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			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			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			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			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()	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		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		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			Código de Transação do PTU.
BPY_DATENV	12	Data	8	Data Envio	Data de Envio			Sim		Sim	Visualizar	Real			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			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			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			Response (json) de retorno da comunicação com o CadBenef.
BPY_RESULT	16	Caracter	150	Resultado	Resultado do Envio			Sim		Não	Visualizar	Real			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			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.

Cadastro do Beneficiário

Inclusão na tabela SX3 (Campos):

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

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.

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 "sem data".

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

Importante

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS