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

B7APLS

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

FAMFIN

16

Caracter

1

6

0

Consid

Família Fin.

SIB

Família Final do

Considera SIB no

Filtro

@!

pertence("01")

Sim

Não

Alterar

Real

0=Não;1=Sim

002

Informe

se será considerado SIB na

a família final que será utilizada para a busca dos beneficiários

.

Inclusão na tabela SIX (Índices):

...

Beneficiários do Lote

Inclusão na tabela SX2 (Tabelas):

...

CadBenef Online - Beneficiário

Inclusão na tabela SX3 (Campos):

CampoOrdemTipoTamanhoDecimalTituloDescriçãoPictureValidaçãoUsadoInic. PadrãoExibe BrowserVisualContextoCboxInic. BrowserBPY_FILIAL01Caracter80FilialFilial do Sistema

que irão compor este lote.

BPW_ANS

17

Caracter

1

0

Consid. ANS

Considera ANS no Filtro

@!

pertence("01")

Sim

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

0

Consid. SIB

Considera SIB no Filtro

@!

pertence("01")

Sim

Não

Alterar

Real

BPY_CODLOT02Caracter80Cod. LoteCodigo do Lote@!SimNãoVisualizarRealBPY_MATBEN03Caracter170Matric. Ben.Matricula do Beneficiário@!SimSimVisualizarRealBPY_NOMBEN04Caracter700Nome Benef.Nome do Beneficiário@!Simiif(inclui, "", posicione("BA1", 2, xFilial("BA1") + BPY->BPY_MATBEN, "BA1_NOMUSR"))SimVisualizarVirtualposicione("BA1", 2, xFilial("BA1") + BPY->BPY_MATBEN, "BA1_NOMUSR")

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	Usado	Exibe Browser	Visual	Contexto	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	@!

BPY_STATUS05Caracter10StatusStatus do Envio@!pertence("123")SimSimVisualizarReal1=Pendente de Envio;2=Envio Finalizado;3=Erro de EnvioBPY_TIPMOV06Caracter10Tipo de Mov.Tipo de Envio@!pertence("123")SimSimVisualizarReal1=Inclusão;2=Atualização;3=Exclusão BPY_CODTRA07Caracter200Cd. Transac.Cod. Transação do PTUSimSimVisualizarRealBPY_DATENV08Data80Data EnvioData de Envio

Sim

Visualizar

Real

BPY_HORENV09Caracter80Hora Envio

		001	Código da operadora que compõe a matrícula do beneficiário pertencente neste lote.
BPY_CODEMP	04	Caracter	4	0	Cod. Empresa	Código da Empresa	@!

Hora de Envio

		Sim		Sim	Visualizar	Real			001	Código da empresa que compõe a matrícula do beneficiário pertencente neste lote.
BPY_

MSGENV

MATRIC

10

05

Memo

Caracter

10

6

0

Msg. Envio

Matrícula

Matrícula da Família

@!

Mensagem de Envio

Sim

Não

	Sim	Visualizar	Real			001	Matrícula da família que compõe a matrícula do beneficiário pertencente neste lote.
BPY_

MSGRES

TIPREG

11

06

Memo

Caracter

10

2

0

Msg. Resp.

Tp. Registro

Tipo Reg. Beneficiário

@!

Mensagem de Resposta

Sim

Não

Sim

Visualizar

Real

BPY_RESULT12Caracter1500Resultado Resultado do EnvioSimNãoVisualizarRealBPY_TIMERP13Caracter80Tempo Resp.Tempo de RespostaSimNãoVisualizarReal

Inclusão na tabela SIX (Índices):

...

001

Tipo do registro do beneficiário que compõe a matrícula do beneficiário pertencente neste lote.

BPY_DIGITO

07

Caracter

1

0

Dígito

Dígito Verificador

9

Sim

Visualizar

Real

001

Digito que compõe a matrícula do beneficiário pertencente neste lote.

BPY_NOMBEN

08

Caracter

70

0

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

0

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

0

Tipo de Mov.

Tipo de Envio

@!

pertence("123")

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

0

Cd. Transac.

Cod. Transação do PTU

Sim

Visualizar

Real

001

Código de Transação do PTU.

BPY_DATENV

12

Data

8

0

Data Envio

Data de Envio

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

0

Hora Envio

Hora de Envio

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

0

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

0

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

0

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

0

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\

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.

Cadastro da Operadora de Saúde

Inclusão na tabela SX3 (Campos):

CampoTipoTamanhoDecimalTituloDescriçãoPictureUsadoExibe BrowserVisualContextoFolderBA0_UBURL Caracter2000URL TokenSimNãoAlterarReal6BA0_UBCLIDCaracter1000ID TokenSimNãoAlterarReal6BA0_UBCLSCCaracter1000Secret Token@*

Sim

Caracter

Não

12

Alterar

0

Real

Get

6BA0

MV_

UBACTK

PAR07

Memo


PLSSCH001

100Access TokenSimNãoVisualizarReal6BA0_UBEXIN

08

Contra. Fin.

Caracter

20

12

0

Expira TokenSimNãoVisualizarReal6

Get

MV_PAR08

PLSSCH001

09

Subcon. Ini.

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.

BA0_CDBURLCaracter2000URL CadBenefSimNãoAlterarReal6BA0_CDBPFXCaracter1000PFX CadBenefSimNãoAlterarReal6BA0_CDBPASCaracter1000Pass CadBen.@*

	Caracter	6	0	Get	MV_PAR12
PLSSCH001	13	Consid. ANS	Numérico	1	0	Combo	MV_PAR13	Sim	Não

Alterar

Nenhum

Real


PLSSCH001

6

Cadastro do Beneficiário

Inclusão na tabela SX3 (Campos):

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

CampoTipoTamanhoDecimalTituloDescriçãoPictureUsadoExibe BrowserVisualContextoBA1_CODUBRCaracter170Código UBCod. Controle Uni. BrasilSimNãoVisualizarReal

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 21

Nova versão Atual

Chave

Atualização de Dicionário de Dados

Beneficiários do Lote

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

Cadastro da Operadora de Saúde

Cadastro do Beneficiário