Histórico da Página

...

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

...

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

...

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	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

B7APLS

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

0

Empresa Fin.

Empresa Final do Filtro

@!

Sim

Não

Alterar

Real

BG9PLS

B7APLS

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

0

Contra. Ini.

Contr. Inicial do Fitro

@!

Sim

Não

Alterar

Real

B7BPLS

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

0

Contra. Fin.

Contr. Final do Filtro

@!

Sim

Não

Alterar

Real

B7BPLS

002

Informe o código final do contrato que será utilizado neste range na busca dos beneficiários.

BPW_SUBINI

13

Caracter

9

0

Subcon. Ini.

Subcont. Inicial Filtro

@!

Sim

Não

Alterar

Real

B7CPLS

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

0

Subcon. Fin.

Subcont. Final Filtro

@!

Sim

Não

Alterar

Real

B7CPLS

		002	Informe o código final do subcontrato que será utilizado neste range na busca dos beneficiários.
BPW_

ANS

FAMINI

15

Caracter

1

6

0

Consid

Família Ini.

ANS

Família Inicial do

Considera ANS no

Filtro

@!

pertence("01")

Sim

Não

Alterar

Real

0=Não;1=Sim

002

Informe

se será considerado ANS na

a família de inicio que será utilizada para a busca dos beneficiários que irão compor este lote.

BPW_

SIB 16

FAMFIN

16

Caracter

6

0

Família Fin.

Família Final do Filtro

@!

Sim

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

0

Consid.

SIB

ANS

Considera

SIB

ANS no Filtro

@!

pertence("01")

Sim

Não

Alterar

Real

0=Não;1=Sim

002

Informe se será considerado

SIB

ANS na busca dos beneficiários.

Inclusão na tabela SIX (Índices):

...

BPW_SIB

18

Caracter

1

0

Consid. SIB

Considera SIB no Filtro

@!

pertence("01")

Sim

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.

Inclusão na tabela SX9 (Relacionamento):

N

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
BG9	BG9_CODIGO	BPW	BPW_EMPINIEMPFIN	1	N
BQCBG9BQC	BG9_SUBCONCODIGO	BPW	BPW_SUBINI	1	N	BQC	BQC_SUBCON	BPW	BPW_SUBFINEMPINI	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):

...

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):

...

@*

	Contexto	Folder	Help
Campo	Tipo	Tamanho	Decimal	Titulo	Descrição	Picture	Usado	Exibe Browser	Visual	Contexto	Folder	Help	BA0_UBURL	Caracter	200	0	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	0	ID Token	Client ID do Token	Sim	Não	Alterar	Real	6	Client ID solicitado previamente para Unimed Brasil.
BA0_UBCLSC	Caracter	100	0	Secret Token	Secret ID do Token	@*	Sim	Não	Alterar	Real	6	Secret ID solicitado previamente para Unimed Brasil.
BA0_UBACTK	Memo	10	0	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	0	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	0	URL CadBenef	Endpoint do CadBenef	Sim	Não	Alterar	Real	6	Endpoint de homologação/produção do CadBenef-Online	BA0_CDBPFX	Caracter	100	0	PFX CadBenef	Certificado do CadBenef	Sim	Não	Alterar	Real	6	O nome do certificado com extensão.	BA0_CDBPAS	Caracter	100	0	Pass CadBen.	Senha do Certificado
BA0_UBURL	Caracter	200	0	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	0	ID Token	Client ID do Token		Sim	Não	Alterar	Real	6	Client ID solicitado previamente para Unimed Brasil.
BA0_UBCLSC	Caracter	100	0	Secret Token	Secret ID do Token	@*	Sim	Não	Alterar	Real	6	Secret ID solicitado previamente para Unimed Brasil.
BA0_UBACTK	Memo	10	0	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	0	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	0	URL CadBenef	Endpoint do CadBenef		Sim	Não	Alterar	Real	6	Endpoint de homologação/produção do CadBenef-Online
BA0_CDBPFX	Caracter	100	0	PFX CadBenef	Certificado do CadBenef		Sim	Não	Alterar	Real	6	O nome do certificado com extensão.
BA0_CDBPAS	Caracter	100	0	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	0	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\

Nota

title	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	Decimal	Modo de Entrada	Variável	Def. 1	Def. 2	Def. 3	Def. 4	Cons. Padrão
PLSSCH001	01	Tipo de Mov.	Numérico	1	0	Combo	MV_PAR01	Cadastro Ativo	Cad. Completo	Mov. Periódica	Exclusão
PLSSCH001	02	Data Inicial	Data	8	0	Get	MV_PAR02
PLSSCH001	03	Data Final	Data	8	0	Get	MV_PAR03
PLSSCH001	04	Cons. Data Atual	Numérico	1	0	Combo	MV_PAR04	Sim	Não
PLSSCH001	05	Empresa Ini.	Caracter	4	0	Get	MV_PAR05					BG9PLS
PLSSCH001	06	Empresa Fin.	Caracter	4	0	Get	MV_PAR06					BG9PLS
PLSSCH001	07	Contra. Ini.	Caracter	12	0	Get	MV_PAR07
PLSSCH001	08	Contra. Fin.	Caracter	12	0	Get	MV_PAR08
PLSSCH001	09	Subcon. Ini.

SimNãoAlterarReal6Senha 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):

...

Código de Controle gerado pela Unimed do Brasil.

Caracter

9

0

Get

MV_PAR09

PLSSCH001

10

Subcon. Fin.

Caracter

9

0

Get

MV_PAR10

PLSSCH001

11

Família Ini.

Caracter

6

0

Get

MV_PAR11

PLSSCH001

12

Família Fin.

Caracter

6

0

Get

MV_PAR12

PLSSCH001

13

Consid. ANS

Numérico

1

0

Combo

MV_PAR13

Sim

Não

Nenhum

PLSSCH001

14

Consid. SIB

Numérico

1

0

Combo

MV_PAR14

Sim

Não

Nenhum

PLSSCH001

15

Enviar Lote

Numérico

1

0

Combo

MV_PAR15

Sim

Não

Beneficiários Pós Pagamento/Habitual

Inclusão na tabela SX3 (Campos):

...

Código de Transação do PTU.

Alteração na tabela SX3 (Campos):

CampoUsadoB5F_TPCONTSim

Card documentos

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

...

Árvore de páginas

Versões comparadas

Versão antiga 35

Nova versão Atual

Chave

Atualização de Dicionário de Dados

Beneficiários do Lote

Cadastro do Beneficiário

Beneficiários Pós Pagamento/Habitual

Produto Saúde

Parâmetros

Pergunte

Cadastro do Beneficiário

Beneficiários Pós Pagamento/Habitual