Exibir origem

01. DADOS GERAIS

Produto:	TOTVS Saúde Planos
Linha de Produto:	Linha Protheus
Segmento:	Saude
Módulo:	PTU
Função:	A1300
Ticket:	22473076
Issue:	DSAUBE-25736

02. SITUAÇÃO/REQUISITO

Houve a necessidade de adequar o produto TOTVS Saúde Planos - Linha Protheus com a versão 2.2025 referente ao CadBenef Online - Serviços de Movimentação Cadastral de Beneficiários, com a entrada em vigor para 14/02/2024.

03. SOLUÇÃO

Todas as alterações descritas neste documento foram implementadas de acordo com as regras impostas pela Unimed do Brasil em seus manuais e comunicados.

Para mais informações poderá ser consultado os manuais e comunicados no site http://www.unimed.coop.br/.

Novas Regras PTU Online Versão 2.2025:

Nos dados do cabeçalho foram realizadas as seguintes mudanças:

Código da Versão do PTU

Alterado o contéudo do bloco codigoVersaoPTU.

Tag	Contéudo
codigoVersaoPTU	F”011”

Nos dados do beneficiário foram realizadas as seguintes mudanças:

Código da Unidade Federativa do médico cooperado

Alterado o tipo do bloco codigoUfConselho.

Tag	Campo do Sistema	Tipo	Regra
codigoUfConselho	BAU_ESTCR	UF	Obrigatório quando indicadorBeneficiarioCooperado = True

Motivo de exclusão

Alterado o tipo do bloco motivoExclusaoBeneficiario.

Tag	Campo do Sistema	Tipo	Regra
motivoExclusaoBeneficiario	BG3_CODEDI, BG1_CODEDI ou BQU_CODEDI	UF	Obrigatório quando dataExclusaoBeneficiario estiver preenchido.

Novas tags

Foram incluidas as seguintes tags agrupador principal dadosBeneficiario:

Tag	Contéudo	Regra
valorMensalidade		Calculada baseada no mês e ano atual.
rendaMensal	BA3_VALSAL
carteirinhaAnterior	BA1_MATANT	Mandatório em casos de transferência de código de benefciciário.
idFilho	BTS_UNIVER, BTS_DEFFIS ou "Outros"	Obrigatório sempre que o código do dependente for 10, 70 ou 75 e que tenha atingido a maioridade. 01 – Filho Universitário 02 – Deficiente 99 – Outros

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_14-14-55.png

Produto Agregado

No agrupador secundário produtoAgregado, em dadosBeneficiario, foram incluidas as tags:

Tag	Campo do Sistema	Regra
indicadorCompartilhamento	Quando BA1_OPEORI for diferente do que BA1_OPEDES é igual .T.	Se o beneficiário for de compartilhamento de risco,preencher com TRUE (1)
codigoUnimedDestino	Op. Destino (BA1_OPEDES)	Obrigatório quando beneficiário tiver Produto Agregado
tipoProduto	Cod EDI (BI3_CODPTU)
codigoPlanoDestino	Quando houver compartilhamento de risco é o campo Cod EDI (BI3_CODPTU) buscado pelo campo Prod.Interc. (BA1_PLAINT) Caso contrário faz referência ao campo Cod EDI (BI3_CODPTU) buscado pelo campo Cód.Plano (BA1_CODPLA)
dataRepasseUnimedDestino	Quando houver compartilhamento de risco é o campo Data Repasse (BA1_DATREP) Caso contrário faz referência ao campo Dt. Inclusão (BA1_DATINC)
dataInicioVigenciaProduto	Data Base (BF4_DATBAS)
dataFimVigenciaProduto	Dt. Bloqueio (BF4_DATBLO)
dataBaseCarencia	Dt. Carência (BA1_DATCAR)	Obrigatório quando beneficiário tiver Produto Agregado

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_16-56-54.png

Mudanças no agrupador (dadosEmpresaContratante), referentes aos dados da empresa:

Data de Inclusão e Exclusão da Empresa na Umined.

Inclusão das seguintes tags:

Tag	Campo do Sistema	Regra
dataInclusaoEmpresaUnimed	BQC_DATCON	Obrigatorio quando Produtos
dataExclusaoEmpresaUnimed	BQC_DATBLO

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_14-51-31.png

Endereços

Na agrupadora segundária endereco, foi realizado a mudanças no tamanho das seguintes tags:

Tag

Campo do Sistema

Tamanho

Regra

logradouroPrincipal

BQC_LOGRAD

80

Obrigatório quando indicadores estiverem preenchidos:

indicadorAutoGestao /indicadorPlanoAcidenteTrabalho / indicadorPlanoSaudeOcupacional / indicadorPlanoAPS

complementoLogradouro

BQC_COMPLE

80

bairro

BQC_BAIRRO

45

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_15-0-53.png

Telefones

Inclusão de um novo bloco nomeado como "telefone" disposto na agrupadora dadosEmpresaContratante.

Tag	Campo do Sistema	Tamanho	Regra
tipoTelefone	BQC_TIPTEL	80	1 – Residencial 2 – Profissional 3 – Celular Quando telefone de empresa, valor do campo deverá ser 2
ddd	BQC_DDD	80	Obrigatório se tipoTelefone = 1, 2 ou 3
numero	BQC_TEL	45	Obrigatório se tipoTelefone = 1, 2 ou 3
ramal			Não Utilizado.

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_15-5-16.png

Mudanças no agrupador (dadosPlano), referentes aos dados da plano:

AdmBeneficios

Inclusão de novas regras referentes as seguintes tags:

Tag

Campo do Sistema

Regra

cnpjAdmBeneficios

BQC_CNPADM

Obrigatório quando tipoContratacao = 3

e (Coletivo por Adesão) e protocoloProspeccao ou
protocoloContrato preenchido

nomeAdmBeneficios

BQC_RAZSBE

nomeFantasiaAdmBeneficios

BQC_SEASPL

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_15-28-19.png

Registro ANS da Administradora Beneficios

Adicionado a tag de Registro ANS da AdministradoraBeneficios

Tag

Campo do Sistema

Regra

registroANSAdmBeneficios

BQC_RECANS

Obrigatório quando tipoContratacao = 3

e (Coletivo por Adesão) e protocoloProspeccao ou
protocoloContrato preenchido

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_15-33-50.png

Coberturas

As tags de carências, passou a ser nomeadas como "coberturas". Dessa forma, serão preenchidas de acordo com a cobertura do nível configurado.

Tag	Campo do Sistema	Regra
tipoCobertura		Obrigatório se Beneficiário possuir Cobertura
dataFimCobertura	BFE_DATCAR ou BA1_DATCAR	Obrigatório se campo tipoCobertura estiver preenchido

Obs: O contéudo do tipoCobertura/dataFimCobertura será preenchido a partir do cadastro referente a cobertura. Considerando que a cobertura do beneficiário pode ser parametrizada nos seguintes níveis:

Grupo Familiar (BA1): Grupos de Cobertura Usuários (BFE).
Grupo Familiar (BA3): Grupos de Cobertura Famílias (BFC).
Grupo Empresa - SubContrato (BQC): Empresa Grupo de Cobertura (BT7).
Produto Saúde (BI3): Planos e Grupos de Cobertura (BRV).

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_15-40-22.png

Carências

Inclusão das tags de Carências.

Tag	Campo do Sistema	Regra
tipoCarencia	BDL_CODEDI	Obrigatório se Beneficiário possuir Carencia
dataFimCarencia	BFO_DATCAR ou BA1_DATCAR	Obrigatório se campo tipoCarencia estiver preenchido

Obs: O contéudo do tipoCarencia/dataFimCarencia será preenchido a partir do cadastro referente a carência. Considerando que a carência do beneficiário pode ser parametrizada nos seguintes níveis:

Grupo Familiar (BA1): Classe de Carência do Usuário (BFO).
Grupo Familiar (BA3): Classes Carências da Família (BFJ).
Grupo Empresa - SubContrato (BQC): Subcont x Prod x Classe Car (BA6).
Produto Saúde (BI3): Produtos da Classe Carência (BAN).

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_15-39-56.png

No Compartilhamento de Risco, ocorreu as seguintes mudanças:

Indicador da geração código no cartão beneficiario

Remoção da Regra da tag indicadorGeracaoCodigo.

Tag	Regra
indicadorGeracaoCodigo	~~Quando tipoCompartilhamentoRisco preenchido como P, esse campo terá valor fixo igual a True;~~

Obs: Indica se Unimed Origem é a responsavel pela geração código no cartão beneficiario

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_16-55-8.png

Indicador de suspensão atendimento para compartilhamento de riscos

Inclusão de nova tag em dadosBeneficiario.

Tag	Contéudo do sistema	Regra
indicadorSuspensaoAtendimento		Indicador de suspensão atendimento para compartilhamento de riscos

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_16-59-40.png

Ocorreu mudanças na agrupador dadosPessoa:

Gênero Social do Beneficiário

Mudança da Regra, na tag generoSocial.

Tag	Contéudo do sistema	Regra
generoSocial	BTS_GENSOC	F = Feminino M = Masculino N = Não binário

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_17-2-48.png

Código da Unidade Federativa da carteira de identidade

Mudança no tipo, na tag "uf" do agrupador "rg".

Tag	Contéudo do sistema	Tipo
uf	BTS_RGEST	AN

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_17-7-48.png

Complementos Cadastrais

Tipo de Residência

Na agrupadora segundária enderecos, ocorreu a inclusão de nova regra na tag tipoResidencia.

Tag

Contéudo do sistema

Regra

tipoResidencia

BTS_RESEXT

1 – Brasil
2 – Exterio

Obrigatório quando indicadores estiverem preenchidos:

indicadorAutoGestao/indicadorPlanoAcidenteTrabalho /indicadorPlanoSaudeOcupacional/indicadorPlanoAPS

Manual PTU Online Versão 2.2025:

Linha Microsiga Protheus > DSAUBE-25736 DT CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024 > image-2025-2-10_17-12-21.png

Endereços

Na agrupadora segundária enderecos, foi realizado a mudanças no tamanho das seguintes tags:

Tag

Campo do Sistema

Tamanho

Regra

logradouro

BA1_ENDERE ou BTS_ENDERE

80

Obrigatorio no caso do tipoResidencia = 1

bairro

BA1_BAIRRO ou BTS_BAIRRO

45

complemento

BA1_COMEND ou BTS_COMEND

80

Manual PTU Online Versão 2.2025:

Atualização de Dicionário de Dados

Cadastro do Grupo Empresa - SubContrato

Inclusão na tabela SX3 (Campos):

Campo

Tipo

Tamanho

Decimal

Titulo

Descrição

Picture

Usado

Validação

Cbox

Exibe Browser

Folder

Visual

Contexto

Help

BQC_DDD

Caracter

3

0

DDD

Codigo do DDD

999

Sim

Não

5

Alterar

Real

Código do DDD referente ao Telefone.

BQC_TIPTEL

Caracter

1

0

Tipo Telefon

Tipo Telefone

@!

Sim

Pertence('123') .Or. Vazio()

1=Residencial.

2=Profissional.

3=Celular.

Não

5

Alterar

Real

Tipo de telefone:

Residencial, Profissional, ou Celular.

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