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.

TagConté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.

TagCampo do SistemaTipoRegra

codigoUfConselho

BAU_ESTCRUFObrigatório quando indicadorBeneficiarioCooperado = True 

Motivo de exclusão

Alterado o tipo do bloco motivoExclusaoBeneficiario.

TagCampo do SistemaTipoRegra

motivoExclusaoBeneficiario

BG3_CODEDI, BG1_CODEDI ou BQU_CODEDI

UFObrigatório quando dataExclusaoBeneficiario estiver preenchido. 

Novas tags

 Foram incluidas as seguintes tags agrupador principal dadosBeneficiario:

TagContéudoRegra

valorMensalidade


Calculada baseada no mês e ano atual.

rendaMensal

BA3_VALSAL


carteirinhaAnterior

BA1_MATANTMandató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:

Produto Agregado

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

TagCampo do SistemaRegra

indicadorCompartilhamento 

BA1_OPEORI <> BA1_OPEDESSe o beneficiário for de compartilhamento de risco,preencher com TRUE (1) 

codigoUnimedDestino

BA1_OPEDES



Obrigatório quando beneficiário tiver Produto Agregado

codigoPlanoDestino

BT6_CODPRO ou BI3_CODIGO

dataRepasseUnimedDestino 

BA1_DATREP

dataInicioVigenciaProduto

BA1_DATINC

dataFimVigenciaProduto

BA1_DATBLO

dataBaseCarencia

BF3_DATCPT ou BA1_DATCPTObrigatório quando beneficiário tiver Produto Agregado

Manual PTU Online Versão 2.2025:


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:

TagCampo do SistemaRegra

dataInclusaoEmpresaUnimed 

BQC_DATCONObrigatorio quando Produtos 

dataExclusaoEmpresaUnimed

BQC_DATBLO

Manual PTU Online Versão 2.2025:

Endereços 

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

TagCampo do SistemaTamanhoRegra

logradouroPrincipal

BQC_LOGRAD80

Obrigatório quando indicadores estiverem preenchidos:

indicadorAutoGestao /indicadorPlanoAcidenteTrabalho / indicadorPlanoSaudeOcupacional / indicadorPlanoAPS

complementoLogradouro 

BQC_COMPLE80

bairro

BQC_BAIRRO45

Manual PTU Online Versão 2.2025:


Telefones

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

TagCampo do SistemaTamanhoRegra

tipoTelefone

BQC_TIPTEL80

1 – Residencial
2 – Profissional
3 – Celular

Quando telefone de empresa, valor do campo deverá ser 2 

ddd

BQC_DDD80


Obrigatório se tipoTelefone = 1, 2 ou 3 

numero

BQC_TEL45

ramal



Não Utilizado.

Manual PTU Online Versão 2.2025:


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

AdmBeneficios

Inclusão de novas regras referentes as seguintes tags

TagCampo do SistemaRegra

cnpjAdmBeneficios

BQC_CNPADM

Obrigatório quando tipoContratacao = 3

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

nomeAdmBeneficios

BQC_RAZSBE

nomeFantasiaAdmBeneficios

BQC_SEASPL

Manual PTU Online Versão 2.2025:

 Registro ANS da Administradora Beneficios 

Adicionado a tag de Registro ANS da AdministradoraBeneficios 

TagCampo do SistemaRegra

registroANSAdmBeneficios

BQC_RECANS

Obrigatório quando tipoContratacao = 3

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

Manual PTU Online Versão 2.2025:


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.

TagCampo do SistemaRegra

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:

Carências

Inclusão das tags de Carências.

TagCampo do SistemaRegra

tipoCarencia


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:


Atualização de Dicionário de Dados



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